test/langtools/tools/javac/danglingDocComments/DanglingDocCommentsClass_Line.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;
    }
}