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

Generated docs should contain correct Legal Documents

XMLWordPrintable

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

      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.

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

              Created:
              Updated:
              Resolved: