0a58cffe88
8329296: Update Elements for '///' documentation comments Co-authored-by: Jim Laskey <jlaskey@openjdk.org> Reviewed-by: prappo, darcy, hannesw
56 lines
1.5 KiB
Java
56 lines
1.5 KiB
Java
/*
|
|
* @test /nodynamiccopyright/
|
|
* @compile -Xlint:dangling-doc-comments DanglingDocCommentsClass_Line.java
|
|
* @compile/ref=empty.out -XDrawDiagnostics DanglingDocCommentsClass_Line.java
|
|
* @compile/ref=DanglingDocCommentsClass_Line.enabled.out -XDrawDiagnostics -Xlint:dangling-doc-comments DanglingDocCommentsClass_Line.java
|
|
* @compile/ref=empty.out -XDrawDiagnostics --disable-line-doc-comments -Xlint:dangling-doc-comments DanglingDocCommentsClass_Line.java
|
|
*/
|
|
|
|
// This is a test of duplicate and misplaced doc comments in a class, using end-of-line comments
|
|
|
|
/// Bad/Extra Class Comment.
|
|
|
|
/// Good Class Comment.
|
|
@Deprecated
|
|
/// Misplaced: after anno.
|
|
public
|
|
/// Misplaced: after mods.
|
|
class DanglingDocCommentsClass_Line
|
|
/// Misplaced: after ident
|
|
{
|
|
/// Bad/Extra Field Comment.
|
|
|
|
/// Good Field Comment.
|
|
public int i;
|
|
|
|
/// Bad/Extra Method Comment.
|
|
|
|
/// Good Method Comment.
|
|
public void m1() { }
|
|
|
|
@SuppressWarnings("dangling-doc-comments")
|
|
/// Bad/misplaced/suppressed comment.
|
|
public void m2() { }
|
|
|
|
public void m3(boolean b) {
|
|
///------------------
|
|
/// Box comment
|
|
///------------------
|
|
if (b) return;
|
|
}
|
|
|
|
public void m4a() {
|
|
/// Not a doc comment.
|
|
System.out.println();
|
|
/// Not a doc comment; not dangling for m4b
|
|
}
|
|
|
|
/// Good comment for m4b; no dangling comments.
|
|
public void m4b() { }
|
|
|
|
/// Comment ignored here: does not affect decls in block
|
|
static {
|
|
/// Good comment.
|
|
int i = 0;
|
|
}
|
|
} |