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 __ This is the maintainer address of Debian's Java team <https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/pkg-java-maintainers>. Please use [email protected] for discussions and questions.
