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

Improve javadoc tag specification.

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 12
    • 10
    • tools
    • b15
    • generic
    • generic
    • Not verified

      The following specification needs some cleanup.
      https://docs.oracle.com/javase/10/docs/specs/doc-comment-spec.html

      1. The table at the end which contains valid locations for javadoc tags, this could be re-written in a nicer way, suggestion is to have a matrix and use a bullet for each application location, the locations are along the X-axis and the tags are on the Y-axis.

      At the very least, duplications can be eliminated using a All declarations with Overview.

      2. The serialField tag erroneously appears in overview, this should not be the case as serialField can only be used fields.

            jjg Jonathan Gibbons
            ksrini Kumar Srinivasan
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: