slachiewicz opened a new pull request, #1450:
URL: https://github.com/apache/maven-javadoc-plugin/pull/1450

   Brings the site and README in line with what 3.12.x does on current JDKs, 
ahead of 3.12.1 (https://github.com/apache/maven/issues/13085).
   
   - The index leads with the four common tasks, states the Maven 3.9.0 and 
Java 8 floor, and lists all 15 goals (`javadoc:help` was missing). It becomes 
`index.md.vm` so the snippet shows the plugin version; the output URL and 
anchors stay.
   - The alternate-doclet examples used UmlGraph 5.x and DocCheck, which need 
the `com.sun.javadoc` API removed in JDK 13, and the second-doclet pattern 
relied on a second report in the site, which is skipped because its 
`apidocs/index.html` already exists. Both examples now use UMLDoclet, the 
second one as a build execution with its own `outputDirectory`.
   - The FAQ no longer claims that `-X` keeps the argument files, or that proxy 
credentials and `http.proxySet` reach the Javadoc tool; its command lines are 
now the plugin's real output. It no longer refers to the removed `aggregate` 
parameter (also fixed in the aggregate example).
   - The links example now covers how the Java API link is chosen (`release`, 
then `source`, no link from Java 16 on). The alternate-tool example adds 
`jdkToolchain`.
   - The README follows the shape of the other Maven READMEs: CI badge instead 
of Jenkins, the build and IT commands, and a short contributing paragraph.
   
   Verified: each documented command and configuration was run against a 
scratch project with the 3.12.1-SNAPSHOT build on JDK 21 (JDK 17 for the 
toolchain); `mvn site -Preporting` → every relative link and anchor resolves, 
and no live anchor is lost.
   
   ---
   
   To make clear that you license your contribution under
   the [Apache License Version 2.0, January 
2004](https://www.apache.org/licenses/LICENSE-2.0)
   check one of the following:
   
   - [x] I hereby declare this contribution to be licensed under the [Apache 
License Version 2.0, January 2004](https://www.apache.org/licenses/LICENSE-2.0)
   - [x] I hereby declare that I have filed an [Apache Individual Contributor 
License Agreement](https://www.apache.org/licenses/icla.pdf).
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to