Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8367342

Doclet documentation is incomplete

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Unresolved
    • Icon: P4 P4
    • None
    • None
    • tools

      ADDITIONAL SYSTEM INFORMATION :
      Java 24, Linux

      A DESCRIPTION OF THE PROBLEM :
      https://docs.oracle.com/en/java/javase/24/docs/api/jdk.javadoc/jdk/javadoc/doclet/package-summary.html#migration says "// Note: imports deleted for clarity", but excluding imports does not improve clarity. It might improve brevity, but in this case the code is already over 100 lines long. Adding 14 lines of imports would not harm brevity, but it would make the example more usable.

      Another improvement would be to order the methods in the same order that they appear in the source code of `src/jdk.javadoc/share/classes/jdk/javadoc/doclet/Doclet.java`, for consistency.


            Unassigned Unassigned
            webbuggrp Webbug Group
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated: