Re: javascript included in javadocs with jdk 10

[Carnë Draug <carandraug+dev@gmail.com>]

On 20 June 2018 at 14:05, Emmanuel Bourg <ebourg@apache.org> wrote:
> Hi Carnë,
>
> Le 20/06/2018 à 14:54, Carnë Draug a écrit :
>
>> I'm trying to prepare a new release of imagej [1].  When building in
>> sid with openjdk-10 the java-doc packages includes jquery, jquery-ui,
>> jszip, and jszip-utils.  I'm guessing this should be using the system
>> versions of those javascript libraries.  Even lintian says so.
>>
>> How can I fix this?
>
> You can't, and IMHO this Lintian warning should be ignored as far as
> javadocs are concerned. The javadoc isn't bound to the system it was
> produced on, it can be zipped and exported to another system.
>
> That's why the javadoc tool can't be patched to replace its copy of
> jquery with a symlink to the script provided by the Debian jquery
> package. This would render the javadoc produced non exportable.
>
> Emmanuel Bourg

Hi

Thanks for the answer.  That explains why the javadoc tool can't be
patched in Debian to do it.

But javadoc has options to replace links to referenced classes to
javadocs in the local filesystem.  Following that logic, this would
render the javadoc produced non exportable.  Still, not only is that
not a problem, it's part of the Debian java policy.

I just noticed that even openjdk-10-doc has them.  The easiest fix for
libraries would be to, after the javadoc build, replace the jquery
directory with a symlink to the openjdk documentation if the jquery
directory exists there.  I'm not sure how to go about doing that or
how to find the correct path for the symlink.

Thank you
David