Fix warnings when running cargo doc --document-private-items
These were the warnings previously: ``` warning: could not parse code block as Rust code --> crates/stdx/src/lib.rs:137:9 | 137 | /// ∀ x in slice[..idx]: pred(x) | _________^ 138 | | /// && ∀ x in slice[idx..]: !pred(x) | |____^ | = note: error from rustc: unknown start of token: \u{2200} warning: 1 warning emitted warning: unresolved link to `package` --> crates/base_db/src/input.rs:181:15 | 181 | /// it's [package].name, can be different for other project types or even | ^^^^^^^ no item named `package` in scope | = note: `#[warn(broken_intra_doc_links)]` on by default = help: to escape `[` and `]` characters, add '\' before them like `\[` or `\]` warning: unresolved link to `package` --> crates/base_db/src/input.rs:181:15 | 181 | /// it's [package].name, can be different for other project types or even | ^^^^^^^ no item named `package` in scope | = help: to escape `[` and `]` characters, add '\' before them like `\[` or `\]` warning: 2 warnings emitted warning: unresolved link to `package` --> crates/base_db/src/input.rs:181:15 | 181 | /// it's [package].name, can be different for other project types or even | ^^^^^^^ no item named `package` in scope | = note: `#[warn(broken_intra_doc_links)]` on by default = help: to escape `[` and `]` characters, add '\' before them like `\[` or `\]` warning: unresolved link to `package` --> crates/base_db/src/input.rs:181:15 | 181 | /// it's [package].name, can be different for other project types or even | ^^^^^^^ no item named `package` in scope | = help: to escape `[` and `]` characters, add '\' before them like `\[` or `\]` warning: 2 warnings emitted ``` This does *not* fix the following warning, because it is actually rust code and rustdoc is being over eager: ``` warning: Rust code block is empty --> crates/parser/src/grammar.rs:16:5 | 16 | //! ``` | _____^ 17 | | //! // test function_with_zero_parameters 18 | | //! // fn foo() {} 19 | | //! ``` | |_______^ | help: mark blocks that do not contain Rust code as text | 16 | //! ```text | ^^^^^^^ ``` https://github.com/rust-lang/rust/pull/79816 should make this configurable so the warning can be `allow`ed.
This commit is contained in:
parent
39282ec419
commit
e7d1f30cb3
@ -178,7 +178,7 @@ pub struct CrateData {
|
|||||||
pub root_file_id: FileId,
|
pub root_file_id: FileId,
|
||||||
pub edition: Edition,
|
pub edition: Edition,
|
||||||
/// A name used in the package's project declaration: for Cargo projects,
|
/// A name used in the package's project declaration: for Cargo projects,
|
||||||
/// it's [package].name, can be different for other project types or even
|
/// its `[package].name` can be different for other project types or even
|
||||||
/// absent (a dummy crate for the code snippet, for example).
|
/// absent (a dummy crate for the code snippet, for example).
|
||||||
///
|
///
|
||||||
/// For purposes of analysis, crates are anonymous (only names in
|
/// For purposes of analysis, crates are anonymous (only names in
|
||||||
|
@ -38,14 +38,16 @@ pub(crate) enum Event {
|
|||||||
///
|
///
|
||||||
/// The events for it would look like this:
|
/// The events for it would look like this:
|
||||||
///
|
///
|
||||||
///
|
/// ```text
|
||||||
/// START(PATH) IDENT('foo') FINISH START(PATH) T![::] IDENT('bar') FINISH
|
/// START(PATH) IDENT('foo') FINISH START(PATH) T![::] IDENT('bar') FINISH
|
||||||
/// | /\
|
/// | /\
|
||||||
/// | |
|
/// | |
|
||||||
/// +------forward-parent------+
|
/// +------forward-parent------+
|
||||||
|
/// ```
|
||||||
///
|
///
|
||||||
/// And the tree would look like this
|
/// And the tree would look like this
|
||||||
///
|
///
|
||||||
|
/// ```text
|
||||||
/// +--PATH---------+
|
/// +--PATH---------+
|
||||||
/// | | |
|
/// | | |
|
||||||
/// | | |
|
/// | | |
|
||||||
@ -54,6 +56,7 @@ pub(crate) enum Event {
|
|||||||
/// PATH
|
/// PATH
|
||||||
/// |
|
/// |
|
||||||
/// 'foo'
|
/// 'foo'
|
||||||
|
/// ```
|
||||||
///
|
///
|
||||||
/// See also `CompletedMarker::precede`.
|
/// See also `CompletedMarker::precede`.
|
||||||
Start {
|
Start {
|
||||||
|
@ -134,8 +134,10 @@ fn next(&mut self) -> Option<&'a str> {
|
|||||||
|
|
||||||
/// Returns `idx` such that:
|
/// Returns `idx` such that:
|
||||||
///
|
///
|
||||||
|
/// ```text
|
||||||
/// ∀ x in slice[..idx]: pred(x)
|
/// ∀ x in slice[..idx]: pred(x)
|
||||||
/// && ∀ x in slice[idx..]: !pred(x)
|
/// && ∀ x in slice[idx..]: !pred(x)
|
||||||
|
/// ```
|
||||||
///
|
///
|
||||||
/// https://github.com/rust-lang/rust/issues/73831
|
/// https://github.com/rust-lang/rust/issues/73831
|
||||||
pub fn partition_point<T, P>(slice: &[T], mut pred: P) -> usize
|
pub fn partition_point<T, P>(slice: &[T], mut pred: P) -> usize
|
||||||
|
Loading…
Reference in New Issue
Block a user