changeset 59803:7ee4492cb21b

8247382: doclint errors (missing comments) in jdk.compiler and jdk.javadoc Reviewed-by: darcy
author jjg
date Mon, 15 Jun 2020 16:05:47 -0700
parents 624948a92351
children 80cbb6242147
files src/jdk.compiler/share/classes/com/sun/tools/javac/Main.java src/jdk.javadoc/share/classes/jdk/javadoc/doclet/DocletEnvironment.java src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java
diffstat 3 files changed, 9 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/src/jdk.compiler/share/classes/com/sun/tools/javac/Main.java	Mon Jun 15 21:52:25 2020 +0200
+++ b/src/jdk.compiler/share/classes/com/sun/tools/javac/Main.java	Mon Jun 15 16:05:47 2020 -0700
@@ -38,6 +38,8 @@
     /** Main entry point for the launcher.
      *  Note: This method calls System.exit.
      *  @param args command line arguments
+     *  @throws Exception only if an uncaught internal exception occurs;
+     *      just retained for historical compatibility
      */
     public static void main(String[] args) throws Exception {
         System.exit(compile(args));
--- a/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/DocletEnvironment.java	Mon Jun 15 21:52:25 2020 +0200
+++ b/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/DocletEnvironment.java	Mon Jun 15 16:05:47 2020 -0700
@@ -138,6 +138,9 @@
      */
     Kind getFileKind(TypeElement type);
 
+    /**
+     * The mode specifying the level of detail of module documentation.
+     */
     enum ModuleMode {
         /** Indicate API level documentation is required */
         API,
--- a/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java	Mon Jun 15 21:52:25 2020 +0200
+++ b/src/jdk.javadoc/share/classes/jdk/javadoc/doclet/StandardDoclet.java	Mon Jun 15 16:05:47 2020 -0700
@@ -70,6 +70,10 @@
 
     private final HtmlDoclet htmlDoclet;
 
+    /**
+     * Creates an instance of the standard doclet, used to generate HTML-formatted
+     * documentation.
+     */
     public StandardDoclet() {
         htmlDoclet = new HtmlDoclet(this);
     }