Accepted joptsimple 5.0.4-6 (source) into unstable

[Emmanuel Bourg]

Hi Samuel,

Le 28/10/2024 à 11:44, Samuel Thibault a écrit :

> Why removing the documentation?
> 
> Did I perhaps miss a discussion on pkg-java-maintainers about removing
> javadoc documentations?

The removal targets the documentation packages containing only the 
Javadoc of the API. The maintenance of these packages is time consuming 
and they are mostly unused.

We've seen countless failures related to the Javadoc generation (due to 
JDK or Maven changes changes), there are concerns caused by the addition 
of an embedded copy of jquery in every Javadoc, and the resolution of 
the doc dependencies by maven-debian-helper is extremely slow, 
increasing the build time significantly. Also proper inter linking of 
Javadocs require patching the packages to add and maintain the right 
<link> elements. And there are reproducibility issues related to the 
Javadoc.

This could be bearable if the Javadoc packages they were really used, 
but most of them have a very low popcon (only 4 for libjoptsimple-java-doc).

The latest upgrade of maven-javadoc-plugin broke again the Maven based 
packages building the Javadoc. The output path has been changed from 
target/site/apidocs to target/reports/apidocs, so we would have to 
update all the debian/libfoo-java-doc.install files to change the path. 
This is what triggered the recent removal of libjoptsimple-java-doc and 
others.

There are better alternatives nowadays such as the excellent 
https://javadoc.io site. I don't think it's worth maintaining these 
packages in Debian anymore, it's just a waste of time.

Emmanuel Bourg