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

Improve `@see` output

    XMLWordPrintable

    Details

    • Type: Enhancement
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: 17
    • Fix Version/s: 17
    • Component/s: tools

      Description

      There are some invalid uses of `@see` in JDK API docs, apparently to work around the shortcomings of the current output.

      The current output is simply a comma-space separated list of `@see` items.

      It would be better if the list used `<ul>` if there are long items or items containing whitespace or commas. Put the other way, use `<ul>` by default, unless all the items are simple words, e.g. like type-names.

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              hannesw Hannes Wallnoefer
              Reporter:
              jjg Jonathan Gibbons
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: