mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2026-07-22 03:27:30 -04:00
6c77b5f4d7
Somehow the rustdoc heuristics determined that a large chunk of the items found in prelude should have documentation inlined. This bloats the generated documentation size. Also, for crates that optimize documentation with `cfg(doc)`, as the documentation inlining makes use of the metadata compiled by just rustc, it will not pick up the `cfg(doc)` attributes from the inlined documentation. pin-init for example optimizes tuple/fn rendering using the nightly fake_variadic feature [1], but this is missing from the inlined version [2]. Thus, mark all prelude items as `#[doc(no_inline)]`. Link: https://rust.docs.kernel.org/next/pin_init/trait.Zeroable.html#impl-Zeroable-for-(J,) [1] Link: https://rust.docs.kernel.org/next/kernel/prelude/trait.Zeroable.html#impl-Zeroable-for-(J,) [2] Signed-off-by: Gary Guo <gary@garyguo.net> Reviewed-by: Alice Ryhl <aliceryhl@google.com> Link: https://patch.msgid.link/20260420161636.1790502-1-gary@kernel.org [ Reworded for typo. - Miguel ] Signed-off-by: Miguel Ojeda <ojeda@kernel.org>
113 lines
1.7 KiB
Rust
113 lines
1.7 KiB
Rust
// SPDX-License-Identifier: GPL-2.0
|
|
|
|
//! The `kernel` prelude.
|
|
//!
|
|
//! These are the most common items used by Rust code in the kernel,
|
|
//! intended to be imported by all Rust code, for convenience.
|
|
//!
|
|
//! # Examples
|
|
//!
|
|
//! ```
|
|
//! use kernel::prelude::*;
|
|
//! ```
|
|
|
|
#[doc(no_inline)]
|
|
pub use core::{
|
|
mem::{
|
|
align_of,
|
|
align_of_val,
|
|
size_of,
|
|
size_of_val, //
|
|
},
|
|
pin::Pin, //
|
|
};
|
|
|
|
#[doc(no_inline)]
|
|
pub use ::ffi::{
|
|
c_char,
|
|
c_int,
|
|
c_long,
|
|
c_longlong,
|
|
c_schar,
|
|
c_short,
|
|
c_uchar,
|
|
c_uint,
|
|
c_ulong,
|
|
c_ulonglong,
|
|
c_ushort,
|
|
c_void,
|
|
CStr, //
|
|
};
|
|
|
|
#[doc(no_inline)]
|
|
pub use macros::{
|
|
export,
|
|
fmt,
|
|
kunit_tests,
|
|
module,
|
|
vtable, //
|
|
};
|
|
|
|
#[doc(no_inline)]
|
|
pub use pin_init::{
|
|
init,
|
|
pin_data,
|
|
pin_init,
|
|
pinned_drop,
|
|
InPlaceWrite,
|
|
Init,
|
|
PinInit,
|
|
Zeroable, //
|
|
};
|
|
|
|
#[doc(no_inline)]
|
|
pub use super::{
|
|
alloc::{
|
|
flags::*,
|
|
Box,
|
|
KBox,
|
|
KVBox,
|
|
KVVec,
|
|
KVec,
|
|
VBox,
|
|
VVec,
|
|
Vec, //
|
|
},
|
|
build_assert,
|
|
build_error,
|
|
const_assert,
|
|
current,
|
|
dev_alert,
|
|
dev_crit,
|
|
dev_dbg,
|
|
dev_emerg,
|
|
dev_err,
|
|
dev_info,
|
|
dev_notice,
|
|
dev_warn,
|
|
error::{
|
|
code::*,
|
|
Error,
|
|
Result, //
|
|
},
|
|
init::InPlaceInit,
|
|
pr_alert,
|
|
pr_crit,
|
|
pr_debug,
|
|
pr_emerg,
|
|
pr_err,
|
|
pr_info,
|
|
pr_notice,
|
|
pr_warn,
|
|
static_assert,
|
|
str::CStrExt as _,
|
|
try_init,
|
|
try_pin_init,
|
|
uaccess::UserPtr,
|
|
ThisModule, //
|
|
};
|
|
|
|
// `super::std_vendor` is hidden, which makes the macro inline for some reason.
|
|
#[doc(no_inline)]
|
|
pub use super::dbg;
|