Robbie Gemmell created AMQ-9074:
-----------------------------------
Summary: remove various .js dependencies and source listing from
javadoc output
Key: AMQ-9074
URL: https://issues.apache.org/jira/browse/AMQ-9074
Project: ActiveMQ
Issue Type: Task
Components: Documentation
Affects Versions: 5.17.2
Reporter: Robbie Gemmell
Fix For: 5.18.0
Following https://openjdk.org/jeps/225), the javadoc output on JDK9+ has
included a search box. To enable this various javascript files and a zipped
index are included in the javadoc output. This means they were introduced to
the javadoc output once the project required Java 11, i.e from 5.17.0, as
previously Java 8 was used to run the release builds. These files are of
whatever version the JDK used to run the build has included, and can tend to
get stale (as per ARTEMIS-3971)
Setting the -noindex option when building the javadoc removes the search, so we
can add this option and remove the need to deal with these files going stale in
future.
Many of the javadoc build configs currently configure inclusion of an HTML
source listing, which results in a fairly huge (>200MB) and yet often redundant
output. Complete sources are easily available via github etc, and the sources
and javadocs are also published to Maven Central where IDEs will grab them,
which is likely how/where many people will look at sources+javadocs these days.
There seems to be little need to burn the time and space including a HTML
source listing, so this also looks to disable that.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
