Bug#903428: javadocs generated by javahelper include jquery

Markus Koschany apo at debian.org
Mon Jul 9 22:29:57 BST 2018


Am 09.07.2018 um 23:26 schrieb Emmanuel Bourg:
> Le 09/07/2018 à 23:14, Markus Koschany a écrit :
> 
>> I believe the use case of viewing javadoc outside of a Debian
>> system is negligible and we should just symlink jquery.
> 
> Viewing an API documentation from a lib*-java-doc package outside of a
> Debian system is indeed a negligible use case. But if the javadoc tool
> was to be patched to link any javadoc generated with the system jquery,
> this would render our openjdk package unfit for many development scenarios.
> 
> If the jquery substitution is implemented directly in the javadoc tool
> it must be limited to documentation aimed at lib*-java-doc packages
> (either with an extra parameter passed by the helpers, or by detecting a
> debian specific environment variable, like DEB_BUILD_ARCH).

We should really aim for the simplest solution. Actually I don't see any
need to patch the javadoc tool because we could easily solve this at the
packaging level. Just replace the embedded jquery library with symlinks
to Debian's system library and let openjdk depend on jquery. Problem solved.

Regards,

Markus

-------------- 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/pkg-java-maintainers/attachments/20180709/eb602355/attachment.sig>


More information about the pkg-java-maintainers mailing list