[Debian-med-packaging] Bug#923756: libhac-java: FTBFS in buster/sid

[Markus Koschany]

Hello Andreas,

Am 05.03.19 um 06:11 schrieb Andreas Tille:
[...]
> Any idea how to fix this?

In my opinion this is a bug in OpenJDK and the new javadoc behavior is
too strict but it is probably useless to argue about it.

We currently work around this error in Maven by setting
detectJavaApiLinks to false by default. We could do a similar change in
javahelper.

jh_build, which is responsible for calling the javadoc command,
automatically tries to link against external classes with

-link /usr/share/doc/default-jdk-doc/api -link
/usr/share/doc/default-jre-headless/api

This way users can click on a link to an external class. If Debian's
corresponding -doc package is installed, the javadoc for this external
class would have been displayed in the past. This is why we recommend to
build-depend on -doc packages because jh_build scans the control file
for -doc packages and links against them. Now there is an
incompatibility between your documented code and the documented code in
default-jdk-doc. The workaround for javahelper could be to remove the
-link option and to not try to link against external classes by default.
The result would be links to external classes would be no longer
displayed but at least your own package with its own classes would be
documented again.

Maybe we should change our javadoc policy too. Developers shall not
build-depend on other -doc packages by default and override jh_build if
they wish to link against external packages. This way they have more
fine grained control about their -doc packages and we don't have to
worry about those errors anymore.

Here is my proposed patch for jh_build against src:javatools master.

Regards,

Markus
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-jh_build-Remove-CLASSPATHDOCS-variable-and-do-not-li.patch
Type: text/x-patch
Size: 2920 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/debian-med-packaging/attachments/20190305/9f8ae692/attachment.bin>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 963 bytes
Desc: OpenPGP digital signature
URL: <http://alioth-lists.debian.net/pipermail/debian-med-packaging/attachments/20190305/9f8ae692/attachment.sig>