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

tag added wrongly in Docs.gmk

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 11
    • Component/s: infrastructure
    • Labels:
      None
    • Subcomponent:
    • Resolved In Build:
      b16

      Backports

        Description

        This line in Docs.gmk is incorrect, and should be removed.

            -tag version \

        It incorrectly enables support for the @version tag, which should only be enabled by the (poorly-named) -version option. (@version and -version are a similar pair to @author and -author).

        A small number of java SE API files contain a very-old @version tag, and this started showing up in JavaSE docs in JDK 8. You can find these files by grepping recursively for @version. The change that added this line is probably a side-effect of adding support for the @apiNote, @implNote, @implSpec tags.

        Note that removing this line will change the Java SE API docs, reverting the handling of @version back to its original treatment of being ignored up through and including JDK 7.

          Attachments

            Issue Links

              Activity

                People

                Assignee:
                ihse Magnus Ihse Bursie
                Reporter:
                jjg Jonathan Gibbons
                Votes:
                0 Vote for this issue
                Watchers:
                1 Start watching this issue

                  Dates

                  Created:
                  Updated:
                  Resolved: