Package: src:openjdk-9
Version: 9~b170-2
Severity: wishlist

Please disable javadoc's doclint feature by default.

In src:openjdk-8, javadoc's doclint feature has been disabled by
default. This allows older software, that happens to have cosmetic
javadoc problems, to continue to build.

openjdk-8 patch and discussion:
https://sources.debian.net/src/openjdk-8/8u111-b14-2/debian/patches/disable-doclint-by-default.diff/

openjdk-9 patch, which is apparently not working:
https://sources.debian.net/src/openjdk-9/9~b170-2/debian/patches/disable-doclint-by-default.diff/

This is causing around 80 packages to fail to build,
a guess of the list is: https://paste.debian.net/974395/
'shrinksafe' is a simple package that's definitely broken:

find src -name *.java -and -type f -print0 | xargs -s 512000 -0
/usr/lib/jvm/default-java/bin/javadoc -locale en_US
  -classpath /usr/share/java/js.jar:debian/_jh_build.shrinksafe
  -d debian/_jh_build.javadoc/api -quiet -notimestamp -source 1.7
Creating destination directory: "debian/_jh_build.javadoc/api/"
src/org/dojotoolkit/shrinksafe/TokenMapper.java:232: error: @param name not 
found
         * @param parseTree



Tiny testcase, which succeeds on Java 8 and fails on Java 9:

% cat A.java
/** <br/>Hi! */
public class A {}


% javadoc A.java
Loading source file A.java...
Constructing Javadoc information...
Standard Doclet version 9-Debian
Building tree for all the packages and classes...
A.java:1: error: self-closing element not allowed
/** <br/>Hi! */
    ^
Generating ./A.html...
[...]
1 error


Thanks.

Reply via email to