Debian navigation

Notes about issue random_order_in_documentation_generated_by_javadoc in unstable

Identifier: random_order_in_documentation_generated_by_javadoc
Suites: stretch / buster / bullseye / unstable / experimental
Description: Some entries inside individual "class-use" documentation pages are emitted in different orders.
This appears to only happen with multi-module maven projects, i.e. possibly during
`mvn javadoc:aggregate`.
.
In `jacoco`, you can observe files are generated consistently in the individual submodule
documentation folders, but then differently when aggregated. Maybe a coincidence.
.
Historically, there were some other issues. These have disappeared, but it's not clear why.
The major version of OpenJDK has changed since these issues were reported (was 7, now 8),
although the code that was believed to be at fault remains unchanged. These are detailed below.
.
The `package-tree.html` file generated by javadoc used to contain an unsorted index.
.
Perhaps caused by packageFiles is a Map> in
openjdk-7-jdk -> ./langtools.tar.bz2 ->
src/share/classes/com/sun/tools/javadoc/JavadocTool.java
.
There was also a locale-specific wrapping issue, which has disappeared.
This may be because enough things are using javahelper, which sets the locale.
.
Likely cause is
jdk9_dev/langtools/src/jdk.javadoc/share/classes/com/sun/tools/javadoc/DocLocale.java +172
.
Workaround is
https://sources.debian.net/src/maven-debian-helper/latest/share/cdbs/1/class/maven.mk/?hl=136#L136
Packages in 'unstable' known to be affected by this issue:
(the 1/4 most-popular ones (within this issue) are underlined)

reproducible icon 223 reproducible packages in unstable/amd64: access-modifier-checker activemq activemq-protobuf adql android-platform-libcore antlr3 antlr4 apache-log4j-extras1.2 apache-log4j1.2 apache-mime4j args4j asm async-http-client atinject-jsr330 axis axmlrpc beansbinding biojava-live bouncycastle bsaf byte-buddy canl-java castor cdi-api cglib classycle commons-beanutils commons-configuration commons-configuration2 commons-io commons-jci commons-math commons-math3 commons-vfs cssparser csvjdbc dbus-java derby dokujclient dom4j doxia doxia-sitetools dtd-parser easymock eclipselink felix-bundlerepository felix-framework felix-gogo-runtime felix-gogo-shell felix-main felix-shell fest-assert fest-reflect fest-test geronimo-jpa-2.0-spec geronimo-jta-1.1-spec geronimo-validation-1.0-spec geronimo-validation-1.1-spec gluegen2 guice hawtjni htsjdk httpunit icu4j imagej insubstantial isorelax ivy jackson-annotations jackson-dataformat-cbor jackson-dataformat-smile jackson-dataformat-yaml jackson-datatype-joda jacoco jansi jasypt java-gnome javamail javassist javatuples javawriter jaxe jboss-classfilewriter jboss-jdeparser2 jboss-logging-tools jboss-logmanager jboss-modules jebl2 jenkins-trilead-ssh2 jericho-html jglobus jimfs jmock2 jmol jnr-constants jnr-ffi jnr-unixsocket jnr-x86asm joda-convert josql jsamp jsap jsemver jtharness jtidy jts lgooddatepicker libasm4-java libcommons-codec-java libcommons-collections3-java libcommons-discovery-java libcommons-fileupload-java libcommons-jxpath-java libcommons-net-java libfastutil-java libformula libfreemarker-java libhamcrest-java libhibernate3-java libhtml5parser-java libhtmlparser-java libidw-java libimglib2-java libirclib-java libiscwt-java libisrt-java libitext5-java libj2ssh-java libjackson-json-java libjlatexmath-java libjoda-time-java libjogl2-java libjsonp-java libjsr305-java libjsr311-api-java libjung-free-java libkryo-java libloader libowasp-antisamy-java libpgjava libpicocontainer-java libquartz-java librepository libspin-java libtwelvemonkeys-java libxbean-java libxmlenc-java libxpp2-java libxpp3-java mac-widgets maven-antrun-extended-plugin maven-archiver maven-bundle-plugin maven-common-artifact-filters maven-compiler-plugin maven-dependency-tree maven-jar-plugin maven-reporting-impl maven-scm maven-shared-io maven-shared-utils mockito mockobjects modello mojarra mvel nekohtml objenesis okio opencsv openid4java osgi-annotation osgi-compendium osgi-foundation-ee owasp-java-html-sanitizer plexus-build-api plexus-cipher plexus-classworlds plexus-compiler plexus-containers plexus-digest plexus-interactivity-api plexus-interpolation plexus-sec-dispatcher plexus-utils2 png-sixlegs portlet-api-2.0-spec rdp-classifier rhino robocode rome saxonb sdes4j serp service-wrapper-java sitemesh skyview slixmpp snakeyaml sqljet statcvs sunflow svnkit swtchart t-digest tagsoup timingframework truffle truffle-dsl-processor uima-as vecmath velocity voms-api-java wagon wala werken.xpath weupnp wsdl4j xhtmlrenderer xmlbeans-maven-plugin xmlgraphics-commons xom zookeeper

FTBR icon 72 unreproducible packages in unstable/amd64: activemq-activeio akuma apache-log4j2 argparse4j bcel biojava4-live bytecode codenarc docbook-xsl-saxon elki flute fop guava-libraries hessian i2p ini4j invokebinder jackson-jr jam-lib jargs javahelp2 javaparser jaxb jblas jboss-logging jenkins-json jgit jmdns joptsimple json-simple jsoup libandroid-json-org-java libcds-moc-java libcobra-java libcommons-collections4-java libcommons-dbcp-java libcommons-digester-java libcommons-lang-java libcommons-lang3-java libdecentxml-java libglazedlists-java libjaxen-java libjchart2d-java libjemmy2-java libjfreechart-java libjgraph-java libjgraphx-java libjlha-java libjpf-java libjtds-java libjuniversalchardet-java libmetadata-extractor-java libonemind-commons-java-java libowasp-esapi-java libpal-java libpdfbox-java libregexp-java libswingx-java libvldocking-java libvt-ldap-java libxml-security-java libxmlrpc3-java localizer logback maven-doxia-tools multiverse-core naga openjfx tiles uima-addons uimaj undertow

timeout icon 1 build timeout packages in unstable/amd64: gradle

 

Our notes about issues affecting packages are stored in notes.git and are targeted at packages in Debian in 'unstable/amd64' (unless they say otherwise).

A package name displayed with a bold font is an indication that this package has a note. Visited packages are linked in green, those which have not been visited are linked in blue.
A # sign after the name of a package indicates that a bug is filed against it. Likewise, a + sign indicates there is a patch available, a P means a pending bug while # indicates a closed bug. In cases of several bugs, the symbol is repeated.