Improve javadoc tag specification.

XMLWordPrintable

    • Type: Bug
    • Resolution: Fixed
    • Priority: P3
    • 12
    • Affects Version/s: 10
    • Component/s: 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.

            Assignee:
            Jonathan Gibbons
            Reporter:
            Kumar Srinivasan
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: