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

issues linking to external documentation (was: missing package-list for JDK10 / JDK11 documentation)

XMLWordPrintable

    • 10
    • generic
    • generic

      ADDITIONAL SYSTEM INFORMATION :
      affects JDK10 and JDK11. The package-list is present in JDK9 docs...

      A DESCRIPTION OF THE PROBLEM :
      According to this https://docs.oracle.com/en/java/javase/11/javadoc/javadoc-command.html, a package-list file should be present at this location https://docs.oracle.com/en/java/javase/11/docs/api/ for javadoc to correctly link to api packages. Since this file does not currently exist, if javadoc is run with -link https://docs.oracle.com/en/java/javase/11/docs/api/, a link that is created (e.g. https://docs.oracle.com/en/java/javase/11/docs/api/java/io/InputStream.html?is-external=true) does not include the full package link (java.base) https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/InputStream.html

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      run javadoc -d /tmp Foo.java -link 'https://docs.oracle.com/en/java/javase/11/docs/api/'

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      docs link API objects to package documentation
      ACTUAL -
      docs do not link to package documentation

            pmuthuswamy Priya Lakshmi Muthuswamy (Inactive)
            webbuggrp Webbug Group
            Votes:
            0 Vote for this issue
            Watchers:
            6 Start watching this issue

              Created:
              Updated:
              Resolved: