Bug#873977: Please override <javadoc source= version to at least 1.6

[Chris West]

Package: ant
Version: 1.9.9-4
Severity: wishlist
User: debian-java at lists.debian.org
Usertags: default-java9

ant is upgrading the -source and -target options passed to javac, such
that they are a minimum of 1.6, to fix projects compiling with Java 9.

However, as we still have this crazy notion that we should ship javadoc,
many packages are immediately trying to build javadoc after the code has
compiled, and are passing "-source 1.4" along to their javadoc
invocation too.

Please also fix the source version, to a minimum of 1.6, in this case.



A good, small, fast example package for this is docbook-xsl-saxon. It
even builds with a different JAVA_HOME if you delete the JAVA_HOME
declaration from debian/rules:

-do-compile:
    [javac] Use of a source 1.4 is no longer supported, switching to 1.6
    [javac] Use of a target 1.4 is no longer supported, switching to 1.6
    [javac] Compiling 21 source files to /var/tmp/faux170901.pimiento/docbook-xsl-saxon-1.00.dfsg.1/classes

...

jar:

-javadoc-build:
    [mkdir] Created dir: /var/tmp/faux170901.pimiento/docbook-xsl-saxon-1.00.dfsg.1/api
  [javadoc] Warning: Leaving out empty argument '-windowtitle'
  [javadoc] Generating Javadoc
  [javadoc] Javadoc execution
  [javadoc] 1 error
  [javadoc] error: Source option 1.4 is no longer supported. Use 1.6 or later.

BUILD FAILED


The -source argument comes from the nbproject, via.
https://sources.debian.net/src/docbook-xsl-saxon/1.00.dfsg.1-7/nbproject/build-impl.xml/#L425
https://sources.debian.net/src/docbook-xsl-saxon/1.00.dfsg.1-7/nbproject/project.properties/#L26


Cheers,
Chris.