Static rustc_lint_defs::builtin::UNUSED_DOC_COMMENTS

source · 
pub static UNUSED_DOC_COMMENTS: &Lint
Expand description

The unused_doc_comments lint detects doc comments that aren’t used by rustdoc.

§Example

/// docs for x
let x = 12;

{{produces}}

§Explanation

rustdoc does not use doc comments in all positions, and so the doc comment will be ignored. Try changing it to a normal comment with // to avoid the warning.