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

Incorrect Man pages of Javadocs tool

    XMLWordPrintable

    Details

    • Subcomponent:
    • Resolved In Build:
      b24
    • CPU:
      generic
    • OS:
      linux

      Description

      While changing our build tools we were stumbling on outdated Man pages.

      Although HTML4 support was already removed from Javadoc, the Man pages still show:
      - default is HTML4 (incorrect) - this is not even true in LTS release 11
      - shows options -html4 (no longer existing) and -html5 (now new default, but obsolete to show at all)
      - allows to enable frames, which does not work

      Interesting source parts: https://hg.openjdk.java.net/jdk/jdk/file/51fb05ec531d/src/jdk.javadoc/share/man/javadoc.1

      Specifically:
      - https://hg.openjdk.java.net/jdk/jdk/file/51fb05ec531d/src/jdk.javadoc/share/man/javadoc.1#l688
      - https://hg.openjdk.java.net/jdk/jdk/file/51fb05ec531d/src/jdk.javadoc/share/man/javadoc.1#l636

        Attachments

          Activity

            People

            Assignee:
            jjg Jonathan Gibbons
            Reporter:
            uschindler Uwe Schindler
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved: