rust/src/test/ui/parser/doc-before-semi.rs

fn main() {
    /// hi
    //~^ ERROR found a documentation comment that doesn't document anything
    //~| HELP maybe a comment was intended
    ;
}
libsyntax: Explicit error message for sugared doc comments. Display an explicit message about items missing after sugared doc comment attributes. References #2789. 2014-09-11 21:07:07 -04:00			`fn main() {`
			`/// hi`
Specific error message for missplaced doc comments Identify when documetation comments have been missplaced in the following places: * After a struct element: ```rust // file.rs: struct X { a: u8 /** document a /, } ``` ```bash $ rustc file.rs file.rs:2:11: 2:28 error: found documentation comment that doesn't document anything file.rs:2 a: u8 /* document a /, ^~~~~~~~~~~~~~~~~ file.rs:2:11: 2:28 help: doc comments must come before what they document, maybe a comment was intended with `//`? ``` As the last line of a struct: ```rust // file.rs: struct X { a: u8, /// incorrect documentation } ``` ```bash $ rustc file.rs file.rs:3:5: 3:27 error: found a documentation comment that doesn't document anything file.rs:3 /// incorrect documentation ^~~~~~~~~~~~~~~~~~~~~~ file.rs:3:5: 3:27 help: doc comments must come before what they document, maybe a comment was intended with `//`? ``` * As the last line of a `fn`: ```rust // file.rs: fn main() { let x = 1; /// incorrect documentation } ``` ```bash $ rustc file.rs file.rs:3:5: 3:27 error: found a documentation comment that doesn't document anything file.rs:3 /// incorrect documentation ^~~~~~~~~~~~~~~~~~~~~~ file.rs:3:5: 3:27 help: doc comments must come before what they document, maybe a comment was intended with `//`? ``` Fix #27429, #30322 2016-05-27 19:05:22 -07:00			`//~^ ERROR found a documentation comment that doesn't document anything`
			`//~\| HELP maybe a comment was intended`
libsyntax: Explicit error message for sugared doc comments. Display an explicit message about items missing after sugared doc comment attributes. References #2789. 2014-09-11 21:07:07 -04:00			`;`
			`}`