Path: csiph.com!feeder.erje.net!2.eu.feeder.erje.net!news.unit0.net!news.mixmin.net!aioe.org!bofh.it!news.nic.it!robomod
From: =?UTF-8?B?Q2FybsOrIERyYXVn?= <carandraug+dev@gmail.com>
Newsgroups: linux.debian.maint.java
Subject: Re: javadocs links with maven-debian-helper
Date: Fri, 08 Sep 2017 17:10:01 +0200
Message-ID: <unt4R-jD-5@gated-at.bofh.it>
References: <ukAcz-7O1-23@gated-at.bofh.it> <ukAPg-81j-15@gated-at.bofh.it> <ukAYX-85f-27@gated-at.bofh.it> <ukYeS-8i9-11@gated-at.bofh.it>
Old-Return-Path: <carandraug@gmail.com>
MIME-Version: 1.0
Sender: robomod@news.nic.it
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Approved: robomod@news.nic.it
Lines: 54
Organization: linux.* mail to news gateway
Xref: csiph.com linux.debian.maint.java:9987

On 31 August 2017 at 17:03, Carn=C3=AB Draug <carandraug+dev@gmail.com> wro=
te:
> Hi
>
> I am packaging some java libraries with maven-debian-helper but having
> problems setting the javadocs links properly.  I have done this for
> ant based projects but I can't figure out how to do it for maven
> projects.
>
> I took a look on a few other *-java-doc packages that are maven only
> projects (libjgoodies-looks-java-doc, libakuma-java, and
> libmetadata-extractor-java-doc) hoping to find the answer.  However,
> they all are linking do docs.oracle.com too instead of the local
> javadocs.  libmetadata-extractor-java-doc on Stretch had the correct
> javadoc links, back when upstream made use of ant and not maven.
>
> I have  tried to set user  property links [1] in  the maven.properties
> file as described in the javadoc plugin documentation but no avail.
>
> How do I set the path for the javadocs of other java libraries when
> using maven-debian-helper?
>
> Thank you
> Carn=C3=AB
>
> [1] https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.ht=
ml#links

Hi

I solved this problem.  The solution is to pass the -link command line
options directly to the javadoc program via the additionalparam
property on the debian.properties file.  Like so [2]:

    additionalparam =3D -link /usr/share/doc/default-jdk-doc/api/ \
                      -link /usr/share/doc/libcommons-math3-java/api/

This whole problem exists because maven's javadoc plugin, which is
being used to generate the javadocs, ignores the links property when
in offline mode.  This would work fine if using javadoc directly but
the maven plugin adds extra incompatible logic to it.  In addition,
the offlineLinks option seems to only work when extdocURL really is an
external url.  I'm unsure if the problem with offlineLink is a maven
javadoc plugin issue or the javadoc program.

Because the maven plugin is ignore the links option, we have to pass
the flags directly to javadoc with additionalparam.  However, it seems
that additionalparam is deprecated but I see no other alternative to
pass options directly.

Carn=C3=AB

[2] https://github.com/carandraug/debian-libjlargearrays-java/commit/777a58=
05082216a86d50cd98bc517ddab1035433