error: unused doc comment
  --> $DIR/useless-comment.rs:9:1
   |
LL | /// foo
   | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ rustdoc does not generate documentation for macro invocations
   |
note: the lint level is defined here
  --> $DIR/useless-comment.rs:3:9
   |
LL | #![deny(unused_doc_comments)]
   |         ^^^^^^^^^^^^^^^^^^^
   = help: to document an item produced by a macro, the macro must produce the documentation as part of its expansion

error: unused doc comment
  --> $DIR/useless-comment.rs:32:5
   |
LL |     /// bar
   |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ rustdoc does not generate documentation for macro invocations
   |
   = help: to document an item produced by a macro, the macro must produce the documentation as part of its expansion

error: unused doc comment
  --> $DIR/useless-comment.rs:13:5
   |
LL |     /// a
   |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
LL |     let x = 12;
   |     ----------- rustdoc does not generate documentation for statements
   |
   = help: use `//` for a plain comment

error: unused doc comment
  --> $DIR/useless-comment.rs:16:5
   |
LL | /     /// multi-line
LL | |     /// doc comment
LL | |     /// that is unused
   | |______________________^
LL | /     match x {
LL | |         /// c
LL | |         1 => {},
LL | |         _ => {}
LL | |     }
   | |_____- rustdoc does not generate documentation for expressions
   |
   = help: use `//` for a plain comment

error: unused doc comment
  --> $DIR/useless-comment.rs:20:9
   |
LL |         /// c
   |         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
LL |         1 => {},
   |         ------- rustdoc does not generate documentation for match arms
   |
   = help: use `//` for a plain comment

error: unused doc comment
  --> $DIR/useless-comment.rs:25:5
   |
LL |     /// foo
   |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
LL |     unsafe {}
   |     --------- rustdoc does not generate documentation for expressions
   |
   = help: use `//` for a plain comment

error: unused doc comment
  --> $DIR/useless-comment.rs:28:5
   |
LL |     #[doc = "foo"]
   |     ^^^^^^^^^^^^^^
LL |     #[doc = "bar"]
LL |     3;
   |     - rustdoc does not generate documentation for expressions
   |
   = help: use `//` for a plain comment

error: unused doc comment
  --> $DIR/useless-comment.rs:29:5
   |
LL |     #[doc = "bar"]
   |     ^^^^^^^^^^^^^^
LL |     3;
   |     - rustdoc does not generate documentation for expressions
   |
   = help: use `//` for a plain comment

error: unused doc comment
  --> $DIR/useless-comment.rs:35:13
   |
LL |     let x = /** comment */ 47;
   |             ^^^^^^^^^^^^^^ -- rustdoc does not generate documentation for expressions
   |
   = help: use `/* */` for a plain comment

error: unused doc comment
  --> $DIR/useless-comment.rs:37:5
   |
LL |       /// dox
   |       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
LL | /     {
LL | |
LL | |     }
   | |_____- rustdoc does not generate documentation for expressions
   |
   = help: use `//` for a plain comment

error: aborting due to 10 previous errors

