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

Generated docs should contain correct Legal Documents

    XMLWordPrintable

Details

    • Bug
    • Resolution: Fixed
    • P3
    • 22
    • None
    • tools
    • None
    • b22
    • generic
    • windows

    Description

      Generated docs by javadoc contains some legal documents, such as LICENSE, ADDITIONAL_LICENSE_INFO and ASSEMBLY_EXCEPTION.
      However, these documents only contain paths to other documents included in the JDK binaries and do not contain any license text.
      This may contribute users to violate the license.

      How to reproduce:

      1. Generate the javadoc for any sourcefiles on Winodws.
      >javadoc Test.java -d doc -encoding UTF-8

      2. Check legal files in generated javadoc
      >type doc\legal\ADDITIONAL_LICENSE_INFO
      Please see ..\java.base\ADDITIONAL_LICENSE_INFO

      >type doc\legal\ASSEMBLY_EXCEPTION
      Please see ..\java.base\ASSEMBLY_EXCEPTION

      >type doc\legal\LICENSE
      Please see ..\java.base\LICENSE

      Only the generated "doc" does not allow us to see the real legal files they represent, such as ..\java.base\ADDITIONAL_LICENSE_INFO.
      This problem only occurs on Windows. I am attaching the "doc" generated using OpenJDK 20 on Windows.

      Attachments

        Issue Links

          Activity

            People

              jjg Jonathan Gibbons
              tkiriyama Takuya Kiriyama
              Votes:
              0 Vote for this issue
              Watchers:
              5 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: