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

Interim javadoc build does not support platform links

    XMLWordPrintable

Details

    • Bug
    • Resolution: Fixed
    • P3
    • 17
    • 16
    • infrastructure
    • None
    • b31
    • generic
    • generic

    Backports

      Description

        Platform links, introduced in JDK-8216497, rely on package/element lists for each version of Java supported by javadoc. Element lists for JDK >= 11 are created dynamically at build time. However, these lists are only available in the javadoc version built as part of the JDK image, not the interim version of javadoc used to create the documentation.

        This went unnoticed because the interim version of javadoc does not use the platform link feature when producing documentation for the platform libraries themselves. However, using it to document select platform modules that do not include java.base triggers the following warning:

        javadoc: warning - Error reading resource: resources/releases/element-list-16.txt

        List of package/element lists in JDK build dir:

        build/macosx-x64/buildtools/interim_langtools_modules/jdk.javadoc.interim/jdk/javadoc/internal/doclets/toolkit/resources/releases/element-list-10.txt
        build/macosx-x64/buildtools/interim_langtools_modules/jdk.javadoc.interim/jdk/javadoc/internal/doclets/toolkit/resources/releases/package-list-8.txt
        build/macosx-x64/buildtools/interim_langtools_modules/jdk.javadoc.interim/jdk/javadoc/internal/doclets/toolkit/resources/releases/package-list-9.txt
        build/macosx-x64/buildtools/interim_langtools_modules/jdk.javadoc.interim/jdk/javadoc/internal/doclets/toolkit/resources/releases/package-list-7.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/element-list-14.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/element-list-15.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/element-list-16.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/element-list-12.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/element-list-13.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/element-list-11.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/element-list-10.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/package-list-8.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/package-list-9.txt
        build/macosx-x64/jdk/modules/jdk.javadoc/jdk/javadoc/internal/doclets/toolkit/resources/releases/package-list-7.txt

        Attachments

          Issue Links

            backported by

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8270429 Interim javadoc build does not support platform links

            • P3 - Major loss of function.
            • Resolved

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8270753 Interim javadoc build does not support platform links

            • P3 - Major loss of function.
            • Resolved
            relates to

            Bug - A problem which impairs or prevents the functions of the product. JDK-8270422 Test build/AbsPathsInImage.java fails after JDK-8259848

            • P3 - Major loss of function.
            • Resolved
            links to

            Commit Commit openjdk/jdk17/e631addd

            Review Review openjdk/jdk17/227

            Activity

              People

                erikj Erik Joelsson
                hannesw Hannes Wallnoefer
                Votes:
                0 Vote for this issue
                Watchers:
                3 Start watching this issue

                Dates

                  Created:
                  Updated:
                  Resolved: