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

Improve/fix javadoc support for linking to docs for automatic modules

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: P3
    • Resolution: Duplicate
    • Affects Version/s: 9, 10, 11, 12, 13, 14, 15
    • Fix Version/s: 15
    • Component/s: tools
    • Labels:

      Description

      Imagine this scenario:

      Write a package-oriented library PL1 (i.e. no module-info.java) and use javadoc to generate documentation. The generated docs will (obviously) have no mention of any module.

      Write a second library PL2 that is also package-oriented and which references PL1 on the classpath, run javadoc and -linkoffine to the docs for PL1 All should be OK.

      Now write a third library ML3 that *is* a module, that references PL1 as an automatic module on the module path. javac will be quite happy, because PL1 will be treated as an automatic module, synthesizing a module name from the name of the jar file. But javadoc will have trouble, because if you link to the docs for PL1, javadoc will not see any module info, and will thus have problems.

      javadoc should be able to handle this case.

        Attachments

          Issue Links

            Activity

              People

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

                Dates

                Created:
                Updated:
                Resolved: