This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-javadoc-plugin.git
The following commit(s) were added to refs/heads/master by this push:
new ee5cba11 Link the JDK 25 javadoc documentation instead of Java 7
ee5cba11 is described below
commit ee5cba11d5fb130d44c77919582d0345d5ab6774
Author: Sylwester Lachiewicz <[email protected]>
AuthorDate: Sun Nov 1 16:17:24 2026 +0000
Link the JDK 25 javadoc documentation instead of Java 7
---
src/site/markdown/examples/alternate-doclet.md.vm | 2 +-
src/site/markdown/examples/exclude-package-names.md | 2 +-
src/site/markdown/examples/group-configuration.md.vm | 2 +-
src/site/markdown/examples/javadoc-resources.md.vm | 8 ++++----
src/site/markdown/examples/links-configuration.md.vm | 2 +-
src/site/markdown/examples/taglet-configuration.md.vm | 2 +-
src/site/markdown/faq.md | 4 ++--
src/site/markdown/index.md | 4 ++--
src/site/site.xml | 2 +-
9 files changed, 14 insertions(+), 14 deletions(-)
diff --git a/src/site/markdown/examples/alternate-doclet.md.vm
b/src/site/markdown/examples/alternate-doclet.md.vm
index 25f1b353..41b0d496 100644
--- a/src/site/markdown/examples/alternate-doclet.md.vm
+++ b/src/site/markdown/examples/alternate-doclet.md.vm
@@ -38,7 +38,7 @@ In this example, the doclet is UmlGraph
([https://www.spinellis.gr/umlgraph/](ht
**Note**:
- [<additionalOptions/>](../javadoc-mojo.html#additionalOptions)
parameter could be used to set additional parameters on the command line,
specifically for doclet options.
--
[<useStandardDocletOptions/>](../javadoc-mojo.html#useStandardDocletOptions)
parameter could be used to specify that the given doclet should use the
[options provided by the Standard
Doclet](http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#standard).
+-
[<useStandardDocletOptions/>](../javadoc-mojo.html#useStandardDocletOptions)
parameter could be used to specify that the given doclet should use the
[options provided by the Standard
Doclet](https://docs.oracle.com/en/java/javase/25/docs/specs/man/javadoc.html#standard-options-for-the-standard-doclet).
- If you need more artifacts in the docletpath, you could use the
[<docletArtifacts/>](../javadoc-mojo.html#docletArtifacts) parameter.
After executing `mvn site`, you will see that a UML graph (.dot file) will be
generated in the destination directory.
diff --git a/src/site/markdown/examples/exclude-package-names.md
b/src/site/markdown/examples/exclude-package-names.md
index 0a71ed32..be01da0a 100644
--- a/src/site/markdown/examples/exclude-package-names.md
+++ b/src/site/markdown/examples/exclude-package-names.md
@@ -26,7 +26,7 @@ under the License.
# Excluding Packages
-To exclude specific packages, use
[<excludePackageNames/>](../javadoc-mojo.html#excludePackageNames)
parameter as shown below. The parameter accepts wildcard (*) characters in its
value but the wildcards should either be at the start or the end of the package
name. If more than one package is to be excluded, each package name must be
separated either with a colon (':'), a comma (',') or a semicolon (';').
(similar to the [Javadoc Tool](http://docs.oracle.com/javase/7/docs/technotes
[...]
+To exclude specific packages, use
[<excludePackageNames/>](../javadoc-mojo.html#excludePackageNames)
parameter as shown below. The parameter accepts wildcard (*) characters in its
value but the wildcards should either be at the start or the end of the package
name. If more than one package is to be excluded, each package name must be
separated either with a colon (':'), a comma (',') or a semicolon (';').
(similar to the [Javadoc Tool](https://docs.oracle.com/en/java/javase/25/docs
[...]
For instance, with the following packages:
diff --git a/src/site/markdown/examples/group-configuration.md.vm
b/src/site/markdown/examples/group-configuration.md.vm
index 8e3081d6..1cc2da52 100644
--- a/src/site/markdown/examples/group-configuration.md.vm
+++ b/src/site/markdown/examples/group-configuration.md.vm
@@ -27,7 +27,7 @@ under the License.
# Grouping Packages
-To set a grouping for different packages, use the
[<groups/>](../javadoc-mojo.html#groups) parameter as shown below. Each
group will be consist of a <title/> and a <packages/> (as String).
The <packages/> element supports wildcard (*) to allow subpackages. If
more than one package is to be included, each package name must be separated
colon (:) separated (similar to the [Javadoc
Tool](http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#group)).
+To set a grouping for different packages, use the
[<groups/>](../javadoc-mojo.html#groups) parameter as shown below. Each
group will be consist of a <title/> and a <packages/> (as String).
The <packages/> element supports wildcard (*) to allow subpackages. If
more than one package is to be included, each package name must be separated
colon (:) separated (similar to the [Javadoc
Tool](https://docs.oracle.com/en/java/javase/25/docs/specs/man/javadoc.html#option-group)).
For instance, with the following packages:
diff --git a/src/site/markdown/examples/javadoc-resources.md.vm
b/src/site/markdown/examples/javadoc-resources.md.vm
index 218491eb..262c287d 100644
--- a/src/site/markdown/examples/javadoc-resources.md.vm
+++ b/src/site/markdown/examples/javadoc-resources.md.vm
@@ -57,7 +57,7 @@ Overview Comment File: _overview.html_
These contain comments about the set of packages. The _overview.html_ is a
general documentation that applies to the entire application or set of packages.
-For more information, see [ javadoc - The Java API Documentation Generator,
Overview Comment
File](http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#overviewcomment).
+For more information, see [Documentation Comment
Specification](https://docs.oracle.com/en/java/javase/25/docs/specs/javadoc/doc-comment-spec.html#documentation-comments).
Here is an example of an _overview.html_ file, located in
_${esc.d}{basedir}/src/main/javadoc/overview.html_:
@@ -102,7 +102,7 @@ Package Comment File: _package.html_
These contain package comments. The _package.html_ is a brief summary of each
packages in the list of all packages.
-For more information, see [ javadoc - The Java API Documentation Generator,
Package Comment
Files](http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#packagecomment)
and [ How to Write Doc Comments for the Javadoc Tool, Package-Level
Comments](http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#packagecomments).
+For more information, see [Documentation Comment
Specification](https://docs.oracle.com/en/java/javase/25/docs/specs/javadoc/doc-comment-spec.html#documentation-comments)
and [ How to Write Doc Comments for the Javadoc Tool, Package-Level
Comments](http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#packagecomments).
Here is an example of a _package.html_ file, located in
_${esc.d}{basedir}/src/main/javadoc/org/apache/myapp/package.html_:
@@ -121,7 +121,7 @@ Here is an example of a _package.html_ file, located in
_${esc.d}{basedir}/src/m
**Note**: With Javadoc 5.0, this file becomes _package-info.java_ and is
preferred over _package.html_.
-For more information, see [ javadoc - The Java API Documentation Generator,
Package Comment
Files](http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#packagecomment).
+For more information, see [Documentation Comment
Specification](https://docs.oracle.com/en/java/javase/25/docs/specs/javadoc/doc-comment-spec.html#documentation-comments).
Here is an example of a _package-info.java_ file, located in
_${esc.d}{basedir}/src/main/java/org/apache/myapp/package-info.java_:
@@ -138,7 +138,7 @@ Miscellaneous Unprocessed Files: _doc-files_
These include images, sample source code, class files, applets, HTML files...
-For more information, see [ javadoc - The Java API Documentation Generator,
Miscellaneous Unprocessed
Files](http://docs.oracle.com/javase/7/docs/technotes/tools/solaris/javadoc.html#unprocessed)
and [How to Write Doc Comments for the Javadoc Tool, Including Images
](http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#images).
+For more information, see [Documentation Comment
Specification](https://docs.oracle.com/en/java/javase/25/docs/specs/javadoc/doc-comment-spec.html#documentation-comments)
and [How to Write Doc Comments for the Javadoc Tool, Including Images
](http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#images).
In addition to _doc-files_ directories, since 2.6.1, the specific
_src/main/javadoc/resources_ directory will be copied to the generated Javadoc
resources directory (i.e. _apidocs/resources_). This is usefull when you want
to overwite default Javadoc tool resources, like the default _inherit.gif_ to
one with a transparent background (See [GIF](../images/inherit.gif) or
[PSD](../images/inherit.psd)).
diff --git a/src/site/markdown/examples/links-configuration.md.vm
b/src/site/markdown/examples/links-configuration.md.vm
index d0018b04..59ad6eb0 100644
--- a/src/site/markdown/examples/links-configuration.md.vm
+++ b/src/site/markdown/examples/links-configuration.md.vm
@@ -53,7 +53,7 @@ You can add cross reference links to external projects using
the [<links/>
</project>
```
-**Important Note**: according the [Javadoc
specifications](http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#package-list),
all given links **should** have a fetchable `/package-list` file.
+**Important Note**: according the [Javadoc
specifications](https://docs.oracle.com/en/java/javase/25/docs/specs/man/javadoc.html#option-link),
all given links **should** have a fetchable `/package-list` or `/element-list`
file.
You can try to detect all Javadoc links for the project's dependencies. You
need to use the [<detectLinks/>](../javadoc-mojo.html#detectLinks)
parameter. Detected links are based on the default Maven conventions. For
instance, if your project has a dependency on [Apache Commons
Lang](https://commons.apache.org/lang/) such as:
diff --git a/src/site/markdown/examples/taglet-configuration.md.vm
b/src/site/markdown/examples/taglet-configuration.md.vm
index 97e18880..1eb3b5e2 100644
--- a/src/site/markdown/examples/taglet-configuration.md.vm
+++ b/src/site/markdown/examples/taglet-configuration.md.vm
@@ -28,7 +28,7 @@ under the License.
You could configure any custom taglets in your Javadoc Plugin configuration
via the [<taglet/>](../javadoc-mojo.html#taglet),
[<taglets/>](../javadoc-mojo.html#taglets), or
[<tagletArtifacts/>](../javadoc-mojo.html#tagletArtifacts) parameters,
depending the number of taglets used.
-For more information about the taglet technology, please refer to
[http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/taglet/overview.html](http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/taglet/overview.html).
+For more information about the taglet technology, please refer to [the
`Taglet`
interface](https://docs.oracle.com/en/java/javase/25/docs/api/jdk.javadoc/jdk/javadoc/doclet/Taglet.html).
One Taglet
----------
diff --git a/src/site/markdown/faq.md b/src/site/markdown/faq.md
index e8a05b57..1bbe1e0b 100644
--- a/src/site/markdown/faq.md
+++ b/src/site/markdown/faq.md
@@ -78,7 +78,7 @@ See [Using Javadoc
Resources](examples/javadoc-resources.html) for more informat
### How to know exactly the Javadoc command line?
The Javadoc Plugin calls the Javadoc tool with
-[argument
files](https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#argumentfiles),
+[argument
files](https://docs.oracle.com/en/java/javase/25/docs/specs/man/javac.html#command-line-argument-files),
i.e. files called 'options', 'packages' and 'argfile' (or 'files' with Jdk
< 1.4):
```
@@ -189,7 +189,7 @@ ${project.reporting.outputDirectory}/apidocs/javadoc.exe(or
.sh) \
```
**Note**: If your proxy needs more JVM
-[networking
properties](https://docs.oracle.com/javase/7/docs/technotes/guides/net/properties.html)
(like
+[networking
properties](https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/doc-files/net-properties.html)
(like
NTLM), you could always add JVM options using the *<additionalJOption/>*
parameter in your Javadoc
Plugin configuration, e.g.:
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index c375b60f..87a2f92c 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -27,9 +27,9 @@ under the License.
-->
# Apache Maven Javadoc Plugin
-The Javadoc Plugin uses the Javadoc tool to generate javadocs for the
specified project. For more information about the standard Javadoc tool, please
refer to [Reference
Guide](https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html).
+The Javadoc Plugin uses the Javadoc tool to generate javadocs for the
specified project. For more information about the standard Javadoc tool, please
refer to [Reference
Guide](https://docs.oracle.com/en/java/javase/25/docs/specs/man/javadoc.html).
-The Javadoc Plugin gets the parameter values that will be used from the plugin
configuration specified in the pom. To hold all javadoc arguments, packages or
files, the Javadoc Plugin generates [argument
files](https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#argumentfiles)
and calls the Javadoc tool as follows:
+The Javadoc Plugin gets the parameter values that will be used from the plugin
configuration specified in the pom. To hold all javadoc arguments, packages or
files, the Javadoc Plugin generates [argument
files](https://docs.oracle.com/en/java/javase/25/docs/specs/man/javac.html#command-line-argument-files)
and calls the Javadoc tool as follows:
```text
javadoc.exe(or .sh) @options @packages | @argfile
diff --git a/src/site/site.xml b/src/site/site.xml
index e6f3ffee..7b52a2db 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -23,7 +23,7 @@ under the License.
xsi:schemaLocation="http://maven.apache.org/SITE/2.1.0
https://maven.apache.org/xsd/site-2.1.0.xsd">
<body>
<links>
- <item name="Javadoc Tool"
href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/"/>
+ <item name="Javadoc Tool"
href="https://docs.oracle.com/en/java/javase/25/javadoc/index.html"/>
</links>
<menu name="Overview">