Bug#981962: libgetopt-java: FTBFS with OpenJDK 17 due to javadoc errors

[Emmanuel Bourg]

Source: libgetopt-java
Severity: important
Tags: ftbfs sid bookworm
User: debian-java at lists.debian.org
Usertags: default-java17

libgetopt-java fails to build with OpenJDK 17 due to javadoc errors:


  javadoc -link /usr/share/doc/default-jdk-doc/api -d api/ gnu/getopt/Getopt.java gnu/getopt/LongOpt.java
  Loading source file gnu/getopt/Getopt.java...
  Loading source file gnu/getopt/LongOpt.java...
  Constructing Javadoc information...
  Creating destination directory: "api/"
  Building index for all the packages and classes...
  Standard Doclet version 17-ea+8-Debian-1
  Building tree for all the packages and classes...
  gnu/getopt/Getopt.java:88: warning: empty <p> tag
    * <p>
      ^
  gnu/getopt/Getopt.java:263: warning: empty <p> tag
    * <p>
      ^
  gnu/getopt/Getopt.java:339: error: malformed HTML
    * for (int i = g.getOptind(); i < argv.length ; i++)
                                    ^
  Generating api/gnu/getopt/Getopt.html...
  gnu/getopt/Getopt.java:685: warning: no @return
  getOptind()
  ^
  gnu/getopt/Getopt.java:734: warning: no @return
  getOptarg()
  ^
  gnu/getopt/Getopt.java:748: warning: no @param for opterr
  setOpterr(boolean opterr)
  ^
  gnu/getopt/Getopt.java:761: warning: no @return
  getOptopt()
  ^
  gnu/getopt/Getopt.java:773: warning: no @return
  getLongind()
  ^
  gnu/getopt/Getopt.java:788: warning: no @param for argv
  exchange(String[] argv)
  ^
  gnu/getopt/Getopt.java:844: error: @param name not found
    * @param longind A buffer in which to store the 'val' field of found LongOpt
             ^
  Generating api/gnu/getopt/LongOpt.html...
  Generating api/gnu/getopt/package-summary.html...
  Generating api/gnu/getopt/package-tree.html...
  Generating api/constant-values.html...
  Generating api/overview-tree.html...
  Building index for all classes...
  Generating api/allclasses-index.html...
  Generating api/allpackages-index.html...
  Generating api/index-all.html...
  Generating api/index.html...
  Generating api/help-doc.html...
  2 errors
  8 warnings