android-platform-external-doclava: FTBFS with OpenJDK 17 due to com.sun.javadoc removal

[Vladimir Petko]

ndroid-platform-external-doclava because it uses classes from
the com.sun.javadoc package which was removed:

  :compileJava
  Putting task artifact state for task ':compileJava' into context took 0.0 secs.
  Up-to-date check for task ':compileJava' took 0.447 secs. It is not up-to-date because:
    No history is available.
  All input files are considered out-of-date for incremental task ':compileJava'.
  Compiling with JDK Java compiler API.
  warning: [options] source value 7 is obsolete and will be removed in a future release
  warning: [options] target value 7 is obsolete and will be removed in a future release
  warning: [options] To suppress warnings about obsolete options, use -Xlint:-options.
  /<<PKGBUILDDIR>>/src/com/google/doclava/ClassInfo.java:20: error: package com.sun.javadoc does not exist
  import com.sun.javadoc.ClassDoc;
                        ^
  /<<PKGBUILDDIR>>/src/com/google/doclava/ClassInfo.java:91: error: cannot find symbol
    public ClassInfo(ClassDoc cl, String rawCommentText, SourcePositionInfo position,
                     ^
    symbol: class ClassDoc
    location: class ClassInfo
  /<<PKGBUILDDIR>>/src/com/google/doclava/ClassInfo.java:1849: error: cannot find symbol
    private ClassDoc mClass;
            ^
    symbol: class ClassDoc
    location: class ClassInfo
  /<<PKGBUILDDIR>>/src/com/google/doclava/PackageInfo.java:34: error: cannot find symbol
    public PackageInfo(PackageDoc pkg, String name, SourcePositionInfo position) {
                       ^
    symbol: class PackageDoc
    location: class PackageInfo
  /<<PKGBUILDDIR>>/src/com/google/doclava/PackageInfo.java:291: error: cannot find symbol
    private PackageDoc mPackage;
            ^
    symbol: class PackageDoc
    location: class PackageInfo
  /<<PKGBUILDDIR>>/src/com/google/doclava/PackageInfo.java:21: error: package com.sun.javadoc does not exist
  import com.sun.javadoc.*;
  ^
  /<<PKGBUILDDIR>>/src/com/google/doclava/Doclava.java:81: error: cannot find symbol
    public static RootDoc root;
                  ^
    symbol: class RootDoc
    location: class Doclava
  /<<PKGBUILDDIR>>/src/com/google/doclava/Doclava.java:145: error: cannot find symbol
    public static boolean start(RootDoc r) {
                                ^
    symbol: class RootDoc
    location: class Doclava

[Vladimir Petko (vpa1977)]

The issue is resolved with new upstream release from git clone https://android.googlesource.com/platform/external/doclava

I have tried to build it with Java 21 and it is failing due to missing exports.
Building with Java 17 has the same issue.
Also upgrade will require a new upstream release/ffe.

Discussed with mwhudson - the "temporary" Ubuntu-only solution will be to depend on openjdk-8 explicitly.

[Vladimir Petko (vpa1977)]

piuparts install/upgrade/purge test (pass)

[Launchpad Janitor (janitor)]

This bug was fixed in the package android-platform-external-doclava - 6.0.1+r55-1.1ubuntu1

---------------
android-platform-external-doclava (6.0.1+r55-1.1ubuntu1) noble; urgency=medium

  * d/{control/doclava}, d/p/build_script.diff: use openjdk-8 as the
    build and runtime dependency (LP: #2056082).

 -- Vladimir Petko <email address hidden> Thu, 07 Mar 2024 11:37:19 +1300