git: openjdk/jdk: 8303689: javac -Xlint could/should report on "dangling" doc comments

[Jonathan Gibbons]

Changeset: a920af23
Author:    Jonathan Gibbons <jjg at openjdk.org>
Date:      2024-04-26 19:47:06 +0000
URL:       https://git.openjdk.org/jdk/commit/a920af233a11592af113f456f7608cb59dd1617e

8303689: javac -Xlint could/should report on "dangling" doc comments

Reviewed-by: vromero, ihse, prr

! make/CompileDemos.gmk
! make/CompileToolsJdk.gmk
! make/GenerateLinkOptData.gmk
! make/modules/java.desktop/Java.gmk
! make/modules/java.management/Java.gmk
! make/modules/java.naming/Java.gmk
! make/modules/java.security.jgss/Java.gmk
! make/modules/java.security.sasl/Java.gmk
! make/modules/java.sql.rowset/Java.gmk
! make/modules/java.sql/Java.gmk
! make/modules/java.xml.crypto/Java.gmk
! make/modules/java.xml/Java.gmk
= make/modules/jdk.accessibility/Java.gmk
= make/modules/jdk.crypto.cryptoki/Java.gmk
! make/modules/jdk.hotspot.agent/Java.gmk
! make/modules/jdk.internal.le/Java.gmk
! make/modules/jdk.internal.vm.ci/Java.gmk
! make/modules/jdk.jdi/Java.gmk
! make/modules/jdk.jfr/Java.gmk
= make/modules/jdk.security.auth/Java.gmk
= make/modules/jdk.zipfs/Java.gmk
! make/test/BuildTestLib.gmk
! src/jdk.compiler/share/classes/com/sun/tools/javac/api/JavacTrees.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/code/DeferredLintHandler.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/code/Lint.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Annotate.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Attr.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/comp/Check.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/comp/TypeEnter.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/parser/JavaTokenizer.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/parser/JavacParser.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/parser/Lexer.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/parser/ParserFactory.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/parser/Scanner.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/parser/Tokens.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/parser/VirtualParser.java
! src/jdk.compiler/share/classes/com/sun/tools/javac/resources/compiler.properties
! src/jdk.compiler/share/classes/com/sun/tools/javac/resources/javac.properties
! src/jdk.compiler/share/classes/com/sun/tools/javac/tree/DocTreeMaker.java
! src/jdk.compiler/share/classes/module-info.java
! src/jdk.compiler/share/man/javac.1
! src/jdk.javadoc/share/classes/jdk/javadoc/internal/tool/JavadocMemberEnter.java
! src/jdk.javadoc/share/man/javadoc.1
! test/langtools/tools/javac/OverrideChecks/6199153/T6199153.java
+ test/langtools/tools/javac/danglingDocComments/DanglingDocCommentsClass.enabled.out
+ test/langtools/tools/javac/danglingDocComments/DanglingDocCommentsClass.java
+ test/langtools/tools/javac/danglingDocComments/DanglingDocCommentsEnum.enabled.out
+ test/langtools/tools/javac/danglingDocComments/DanglingDocCommentsEnum.java
= test/langtools/tools/javac/danglingDocComments/empty.out
! test/langtools/tools/javac/depDocComment/DeprecatedDocComment3.java
+ test/langtools/tools/javac/diags/examples/DanglingDocCommentWarning/DanglingDocCommentWarning.java
! test/langtools/tools/javac/platform/PreviewAPIsWithRelease.java
! test/langtools/tools/javac/warnings/DepAnn.java
! test/langtools/tools/javac/warnings/Deprecation.java
! test/langtools/tools/javac/warnings/NestedDeprecation/NestedDeprecation.java
! test/langtools/tools/javac/warnings/Unchecked.java
! test/langtools/tools/javac/warnings/VerifyLintDescriptions.java
! test/langtools/tools/javac/warnings/suppress/T6480588.java