You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by kw...@apache.org on 2022/09/15 10:13:28 UTC
[maven-javadoc-plugin] branch master updated: [MJAVADOC-729] Link to Javadoc references from JDK 17 (#161)
This is an automated email from the ASF dual-hosted git repository.
kwin 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 7cbf4349 [MJAVADOC-729] Link to Javadoc references from JDK 17 (#161)
7cbf4349 is described below
commit 7cbf43499fa801ed633462ce590284667ac8898a
Author: Konrad Windszus <kw...@apache.org>
AuthorDate: Thu Sep 15 12:13:21 2022 +0200
[MJAVADOC-729] Link to Javadoc references from JDK 17 (#161)
Remove mentions when something has been added to ancient JDK 1.4 or 5
---
.../plugins/javadoc/AbstractFixJavadocMojo.java | 17 +-
.../maven/plugins/javadoc/AbstractJavadocMojo.java | 427 ++++++---------------
.../plugins/javadoc/AggregatorJavadocJar.java | 3 +-
.../javadoc/AggregatorJavadocNoForkReport.java | 2 +-
.../plugins/javadoc/AggregatorJavadocReport.java | 2 +-
.../plugins/javadoc/AggregatorTestJavadocJar.java | 3 +-
.../javadoc/AggregatorTestJavadocNoForkReport.java | 2 +-
.../javadoc/AggregatorTestJavadocReport.java | 2 +-
.../maven/plugins/javadoc/FixJavadocMojo.java | 5 +-
.../apache/maven/plugins/javadoc/JavadocJar.java | 6 +-
.../maven/plugins/javadoc/JavadocNoForkReport.java | 4 +-
.../maven/plugins/javadoc/JavadocReport.java | 5 +-
.../maven/plugins/javadoc/TestFixJavadocMojo.java | 3 +-
.../maven/plugins/javadoc/TestJavadocJar.java | 23 +-
.../plugins/javadoc/TestJavadocNoForkReport.java | 4 +-
.../maven/plugins/javadoc/TestJavadocReport.java | 23 +-
16 files changed, 160 insertions(+), 371 deletions(-)
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/AbstractFixJavadocMojo.java b/src/main/java/org/apache/maven/plugins/javadoc/AbstractFixJavadocMojo.java
index fac56cce..61ff1abe 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/AbstractFixJavadocMojo.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/AbstractFixJavadocMojo.java
@@ -89,10 +89,8 @@ import java.util.regex.Pattern;
/**
* Abstract class to fix Javadoc documentation and tags in source files.
- * <br>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#wheretags">Where Tags
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/javadoc/doc-comment-spec.html#where-tags-can-be-used">Where Tags
* Can Be Used</a>.
- *
* @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
* @since 2.6
*/
@@ -346,15 +344,12 @@ public abstract class AbstractFixJavadocMojo
* Specifies the access level for classes and members to show in the Javadocs.
* Possible values are:
* <ul>
- * <li><a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#public">public</a>
- * (shows only public classes and members)</li>
- * <li><a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#protected">protected</a>
- * (shows only public and protected classes and members)</li>
- * <li><a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#package">package</a>
- * (shows all classes and members not marked private)</li>
- * <li><a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#private">private</a>
- * (shows all classes and members)</li>
+ * <li>public (shows only public classes and members)</li>
+ * <li>protected (shows only public and protected classes and members)</li>
+ * <li>package (shows all classes and members not marked private)</li>
+ * <li>private (shows all classes and members)</li>
* </ul>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">private, protected, public, package options for Javadoc</a>
*/
@Parameter ( property = "level", defaultValue = "protected" )
private String level;
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java b/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java
index 5e8bd072..91d734ff 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java
@@ -151,8 +151,7 @@ import static org.apache.maven.plugins.javadoc.JavadocUtil.isNotEmpty;
*
* @author <a href="mailto:brett@apache.org">Brett Porter</a>
* @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
- * @see <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html">
- * The Java API Documentation Generator, 7</a>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">The javadoc Command</a>
* @since 2.0
*/
public abstract class AbstractJavadocMojo
@@ -371,17 +370,17 @@ public abstract class AbstractJavadocMojo
private String[] additionalOptions;
/**
- * Set an additional Javadoc option(s) (i.e. JVM options) on the command line.
+ * Sets additional Javadoc options (e.g. JVM options) on the command line.
* Example:
* <pre>
* <additionalJOption>-J-Xss128m</additionalJOption>
* </pre>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#J">Jflag</a>.
- * <br/>
- * See <a href="http://java.sun.com/javase/technologies/hotspot/vmoptions.jsp">vmoptions</a>.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/net/properties.html">Networking
- * Properties</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">
+ * Javadoc Options</a>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options">
+ * VM Options</a>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html">
+ * Networking Properties</a>
*
* @since 2.3
*/
@@ -389,7 +388,7 @@ public abstract class AbstractJavadocMojo
private String additionalJOption;
/**
- * Set additional JVM options for the execution of the javadoc command via the '-J' option to javadoc.
+ * Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc.
* Example:
* <pre>
* <additionalJOptions>
@@ -397,6 +396,7 @@ public abstract class AbstractJavadocMojo
* </additionalJOptions>
* </pre>
* @since 2.9
+ * @see #additionalJOption
*/
@Parameter
private String[] additionalJOptions;
@@ -495,7 +495,7 @@ public abstract class AbstractJavadocMojo
/**
* Specifies to use the
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#standard">
+ * <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">
* options provided by the Standard Doclet</a> for a custom doclet.
* <br>
* Example:
@@ -605,11 +605,10 @@ public abstract class AbstractJavadocMojo
/**
* Specifies the paths where the boot classes reside. The <code>bootclasspath</code> can contain multiple paths
- * by separating them with a colon (<code>:</code>) or a semi-colon (<code>;</code>).
- * <br/>
- * See <a href=
- * "https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#bootclasspath">bootclasspath</a>.
- *
+ * by separating them with a colon (<code>:</code>) or a semicolon (<code>;</code>).
+ * @see <a href=
+ * "https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path">
+ * Javadoc option bootclasspath</a>.
* @since 2.5
*/
@Parameter( property = "bootclasspath" )
@@ -618,9 +617,6 @@ public abstract class AbstractJavadocMojo
/**
* Specifies the artifacts where the boot classes reside.
* <br/>
- * See <a href=
- * "https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#bootclasspath">bootclasspath</a>.
- * <br/>
* Example:
* <pre>
* <bootclasspathArtifacts>
@@ -633,8 +629,10 @@ public abstract class AbstractJavadocMojo
* </pre>
* <br/>
* See <a href="./apidocs/org/apache/maven/plugins/javadoc/options/BootclasspathArtifact.html">Javadoc</a>.
- * <br/>
*
+ * @see <a href=
+ * "https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path">
+ * Javadoc option bootclasspath</a>
* @since 2.5
*/
@Parameter( property = "bootclasspathArtifacts" )
@@ -642,32 +640,24 @@ public abstract class AbstractJavadocMojo
/**
* Uses the sentence break iterator to determine the end of the first sentence.
- * <br/>
- * See <a href=
- * "https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#breakiterator">breakiterator</a>.
- * <br/>
- * Since <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java
- * 1.4</a>.
- * <br/>
+ * @see <a href=
+ * "https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">
+ * Javadoc option breakiterator</a>.
*/
@Parameter( property = "breakiterator", defaultValue = "false" )
private boolean breakiterator;
/**
* Specifies the class file that starts the doclet used in generating the documentation.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#doclet">doclet</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc option doclet</a>.
*/
@Parameter( property = "doclet" )
private String doclet;
/**
- * Specifies the artifact containing the doclet starting class file (specified with the <code>-doclet</code>
+ * Specifies the artifact containing the doclet starting class file (specified with the {@link #doclet}
* option).
* <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#docletpath">docletpath</a>.
- * <br/>
* Example:
* <pre>
* <docletArtifact>
@@ -679,16 +669,14 @@ public abstract class AbstractJavadocMojo
* <br/>
* See <a href="./apidocs/org/apache/maven/plugins/javadoc/options/DocletArtifact.html">Javadoc</a>.
* <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc option docletpath</a>.
*/
@Parameter( property = "docletArtifact" )
private DocletArtifact docletArtifact;
/**
* Specifies multiple artifacts containing the path for the doclet starting class file (specified with the
- * <code>-doclet</code> option).
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#docletpath">docletpath</a>.
+ * {@link #doclet} option).
* <br/>
* Example:
* <pre>
@@ -703,32 +691,28 @@ public abstract class AbstractJavadocMojo
* <br/>
* See <a href="./apidocs/org/apache/maven/plugins/javadoc/options/DocletArtifact.html">Javadoc</a>.
* <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc option docletpath</a>.
* @since 2.1
*/
@Parameter( property = "docletArtifacts" )
private DocletArtifact[] docletArtifacts;
/**
- * Specifies the path to the doclet starting class file (specified with the <code>-doclet</code> option) and
+ * Specifies the path to the doclet starting class file (specified with the {@link #doclet} option) and
* any jar files it depends on. The <code>docletPath</code> can contain multiple paths by separating them with
- * a colon (<code>:</code>) or a semi-colon (<code>;</code>).
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#docletpath">docletpath</a>.
+ * a colon (<code>:</code>) or a semicolon (<code>;</code>).
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc option docletpath</a>.
*/
@Parameter( property = "docletPath" )
private String docletPath;
/**
- * Specifies the encoding name of the source files. If not specificed, the encoding value will be the value of the
+ * Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the
* <code>file.encoding</code> system property.
* <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#encoding">encoding</a>.
- * <br/>
* <b>Note</b>: In 2.4, the default value was locked to <code>ISO-8859-1</code> to ensure reproducing build, but
* this was reverted in 2.5.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding">Javadoc option encoding</a>.
*/
@Parameter( property = "encoding", defaultValue = "${project.build.sourceEncoding}" )
private String encoding;
@@ -744,34 +728,26 @@ public abstract class AbstractJavadocMojo
* <li>any other wildcard must match exactly one folder</li>
* </ul>
* </p>
- * <p>
* Example:
* <pre>
* <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames>
* </pre>
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#exclude">exclude</a>.
- * <br/>
- * Since <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java
- * 1.4</a>.
- * </p>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc option exclude</a>.
*/
@Parameter( property = "excludePackageNames" )
private String excludePackageNames;
/**
* Specifies the directories where extension classes reside. Separate directories in <code>extdirs</code> with a
- * colon (<code>:</code>) or a semi-colon (<code>;</code>).
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#extdirs">extdirs</a>.
+ * colon (<code>:</code>) or a semicolon (<code>;</code>).
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs">Javadoc option extdirs</a>.
*/
@Parameter( property = "extdirs" )
private String extdirs;
/**
* Specifies the locale that javadoc uses when generating documentation.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#locale">locale</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc option locale</a>.
*/
@Parameter( property = "locale" )
private String locale;
@@ -798,10 +774,8 @@ public abstract class AbstractJavadocMojo
/**
* This option creates documentation with the appearance and functionality of documentation generated by
- * Javadoc 1.1.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#1.1">1.1</a>.
- * <br/>
+ * Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4)
+ * @see <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1">Javadoc option 1.1</a>.
*/
@Parameter( property = "old", defaultValue = "false" )
private boolean old;
@@ -810,9 +784,8 @@ public abstract class AbstractJavadocMojo
* Specifies that javadoc should retrieve the text for the overview documentation from the "source" file
* specified by path/filename and place it on the Overview page (overview-summary.html).
* <br/>
- * <b>Note</b>: could be in conflict with <nooverview/>.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#overview">overview</a>.
+ * <b>Note</b>: could be in conflict with {@link #nooverview}.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Javadoc option overview</a>.
* <br/>
*/
@Parameter( property = "overview", defaultValue = "${basedir}/src/main/javadoc/overview.html" )
@@ -825,10 +798,8 @@ public abstract class AbstractJavadocMojo
* Note: was a standard doclet in Java 1.4.2 (refer to bug ID
* <a href="https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350">4714350</a>).
* <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#quiet">quiet</a>.
- * <br/>
* Since Java 5.0.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc option quiet</a>.
*/
@Parameter( property = "quiet", defaultValue = "false" )
private boolean quiet;
@@ -837,35 +808,26 @@ public abstract class AbstractJavadocMojo
* Specifies the access level for classes and members to show in the Javadocs.
* Possible values are:
* <ul>
- * <li><a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#public">public</a>
- * (shows only public classes and members)</li>
- * <li><a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#protected">protected</a>
- * (shows only public and protected classes and members)</li>
- * <li><a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#package">package</a>
- * (shows all classes and members not marked private)</li>
- * <li><a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#private">private</a>
- * (shows all classes and members)</li>
+ * <li>public (shows only public classes and members)</li>
+ * <li>protected (shows only public and protected classes and members)</li>
+ * <li>package (shows all classes and members not marked private)</li>
+ * <li>private (shows all classes and members)</li>
* </ul>
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc options private, protected, public and package</a>
*/
@Parameter( property = "show", defaultValue = "protected" )
private String show;
/**
- * Necessary to enable javadoc to handle assertions introduced in J2SE v 1.4 source code or generics introduced in
- * J2SE v5.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#source">source</a>.
- * <br/>
- * Since <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java
- * 1.4</a>.
+ * Provide source compatibility with specified release. Since JDK 9 rather use {@link #release}.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source">Javadoc option source</a>.
*/
@Parameter( property = "source", defaultValue = "${maven.compiler.source}" )
private String source;
/**
* Provide source compatibility with specified release
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release">Javadoc option release</a>.
* @since JDK 9
* @since 3.1.0
*/
@@ -874,10 +836,8 @@ public abstract class AbstractJavadocMojo
/**
* Specifies the source paths where the subpackages are located. The <code>sourcepath</code> can contain
- * multiple paths by separating them with a colon (<code>:</code>) or a semi-colon (<code>;</code>).
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#sourcepath">sourcepath</a>.
+ * multiple paths by separating them with a colon (<code>:</code>) or a semicolon (<code>;</code>).
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path">Javadoc option sourcepath</a>.
*/
@Parameter( property = "sourcepath" )
private String sourcepath;
@@ -885,21 +845,14 @@ public abstract class AbstractJavadocMojo
/**
* Specifies the package directory where javadoc will be executed. Multiple packages can be separated by
* colons (<code>:</code>).
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#subpackages">subpackages</a>.
- * <br/>
- * Since <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java
- * 1.4</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc option subpackages</a>.
*/
@Parameter( property = "subpackages" )
private String subpackages;
/**
* Provides more detailed messages while javadoc is running.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#verbose">verbose</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc">Javadoc option verbose</a>.
*/
@Parameter( property = "verbose", defaultValue = "false" )
private boolean verbose;
@@ -910,9 +863,7 @@ public abstract class AbstractJavadocMojo
/**
* Specifies whether or not the author text is included in the generated Javadocs.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#author">author</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option author</a>.
*/
@Parameter( property = "author", defaultValue = "true" )
private boolean author;
@@ -924,9 +875,7 @@ public abstract class AbstractJavadocMojo
* <br>
* <strong>Note:<strong>If the project has the property <code>project.build.outputTimestamp</code>, its year will
* be used as {currentYear}. This way it is possible to generate reproducible javadoc jars.
- * <br>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#bottom">bottom</a>.
- * <br>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option bottom</a>.
*/
@Parameter( property = "bottom",
defaultValue = "Copyright © {inceptionYear}–{currentYear} {organizationName}. "
@@ -934,21 +883,17 @@ public abstract class AbstractJavadocMojo
private String bottom;
/**
- * Specifies the HTML character set for this document. If not specificed, the charset value will be the value of
- * the <code>docencoding</code> parameter.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#charset">charset</a>.
- * <br/>
+ * Specifies the HTML character set for this document. If not specified, the charset value will be the value of
+ * the {@link #docencoding} parameter.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option charset</a>.
*/
@Parameter( property = "charset" )
private String charset;
/**
- * Specifies the encoding of the generated HTML files. If not specificed, the docencoding value will be
+ * Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be
* <code>UTF-8</code>.
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#docencoding">docencoding</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option docencoding</a>.
*/
@Parameter( property = "docencoding", defaultValue = "${project.reporting.outputEncoding}" )
private String docencoding;
@@ -957,16 +902,7 @@ public abstract class AbstractJavadocMojo
* Enables deep copying of the <code>**/doc-files</code> directories and the specifc <code>resources</code>
* directory from the <code>javadocDirectory</code> directory (for instance,
* <code>src/main/javadoc/com/mycompany/myapp/doc-files</code> and <code>src/main/javadoc/resources</code>).
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#docfilessubdirs">
- * docfilessubdirs</a>.
- * <br/>
- * Since <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java
- * 1.4</a>.
- * <br/>
- * See <a href="#javadocDirectory">javadocDirectory</a>.
- * <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option docfilessubdirs</a>.
* @see #excludedocfilessubdir
* @see #javadocDirectory
*/
@@ -975,8 +911,7 @@ public abstract class AbstractJavadocMojo
/**
* Specifies specific checks to be performed on Javadoc comments.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#BEJEFABE">doclint</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet">Additional Doclet option Xdoclint</a>.
*
* @since 3.0.0
*/
@@ -985,9 +920,7 @@ public abstract class AbstractJavadocMojo
/**
* Specifies the title to be placed near the top of the overview summary file.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#doctitle">doctitle</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option doctitle</a>.
*/
@Parameter( property = "doctitle", defaultValue = "${project.name} ${project.version} API" )
private String doctitle;
@@ -995,13 +928,7 @@ public abstract class AbstractJavadocMojo
/**
* Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded
* by separating them with colons (<code>:</code>).
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#excludedocfilessubdir">
- * excludedocfilessubdir</a>.
- * <br/>
- * Since <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java
- * 1.4</a>.
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option excludedocfilessubdir</a>.
* @see #docfilessubdirs
*/
@Parameter( property = "excludedocfilessubdir" )
@@ -1009,8 +936,7 @@ public abstract class AbstractJavadocMojo
/**
* Specifies the footer text to be placed at the bottom of each output file.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#footer">footer</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option footer</a>.
*/
@Parameter( property = "footer" )
private String footer;
@@ -1041,19 +967,15 @@ public abstract class AbstractJavadocMojo
* </pre>
* <b>Note</b>: using <code>java.lang.*</code> for <code>packages</code> would omit the <code>java.lang</code>
* package but using <code>java.lang*</code> will include it.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#group">group</a>.
- * <br/>
- * See <a href="./apidocs/org/apache/maven/plugins/javadoc/options/Group.html">Javadoc</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option group</a>.
+ * @see Group
*/
@Parameter
private Group[] groups;
/**
* Specifies the header text to be placed at the top of each output file.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#header">header</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option header</a>.
*/
@Parameter( property = "header" )
private String header;
@@ -1097,25 +1019,14 @@ public abstract class AbstractJavadocMojo
* </pre>
* Where <code>path/to/your/resource/yourhelp-doc.html</code> is defined in the
* <code>groupId:artifactId:version</code> javadoc plugin dependency.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#helpfile">helpfile</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option helpfile</a>.
*/
@Parameter( property = "helpfile" )
private String helpfile;
/**
* Adds HTML meta keyword tags to the generated file for each class.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#keywords">keywords</a>.
- * <br/>
- * Since
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.2.html#commandlineoptions">
- * Java 1.4.2</a>.
- * <br/>
- * Since
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.5.0.html#commandlineoptions">
- * Java 5.0</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option keywords</a>.
*
* @since 2.1
*/
@@ -1128,26 +1039,27 @@ public abstract class AbstractJavadocMojo
* <b>Notes</b>:
* <ol>
* <li>only used if {@code isOffline} is set to <code>false</code>.</li>
- * <li>all given links should have a fetchable <code>/package-list</code> file. For instance:
+ * <li>all given links should have a fetchable <code>/package-list</code> or <code>/element-list</code>
+ * (since Java 10). For instance:
* <pre>
* <links>
- * <link>https://docs.oracle.com/javase/1.4.2/docs/api</link>
+ * <link>https://docs.oracle.com/en/java/javase/17/docs/api</link>
* <links>
* </pre>
- * will be used because <code>https://docs.oracle.com/javase/1.4.2/docs/api/package-list</code> exists.</li>
- * <li>if {@code detectLinks} is defined, the links between the project dependencies are
+ * will be used because <code>https://docs.oracle.com/en/java/javase/17/docs/api/element-list</code> exists.</li>
+ * <li>if {@link #detectLinks} is defined, the links between the project dependencies are
* automatically added.</li>
- * <li>if {@code detectJavaApiLink} is defined, a Java API link, based on the Java version of the
+ * <li>if {@link #detectJavaApiLink} is defined, a Java API link, based on the Java version of the
* project's sources, will be added automatically.</li>
* </ol>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#linkTag">link</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option link</a>.
*/
@Parameter( property = "links" )
protected ArrayList<String> links;
/**
- * Redefine the apidoc URL for specific dependencies when using {@code detectLinks}.
+ * Redefine the apidoc URL for specific dependencies when using {@link #detectLinks}.
* Useful if the dependency wasn't build with Maven or when the apidocs have been moved.
* <pre>
* <dependencyLinks>
@@ -1169,12 +1081,7 @@ public abstract class AbstractJavadocMojo
/**
* Creates an HTML version of each source file (with line numbers) and adds links to them from the standard
* HTML documentation.
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#linksource">linksource</a>.
- * <br/>
- * Since <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java
- * 1.4</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option linksource/a>.
* <br/>
*/
@Parameter( property = "linksource", defaultValue = "false" )
@@ -1182,22 +1089,14 @@ public abstract class AbstractJavadocMojo
/**
* Suppress the entire comment body, including the main description and all tags, generating only declarations.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#nocomment">nocomment</a>.
- * <br/>
- * Since <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java
- * 1.4</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option nocomment</a>.
*/
@Parameter( property = "nocomment", defaultValue = "false" )
private boolean nocomment;
/**
* Prevents the generation of any deprecated API at all in the documentation.
- * <br/>
- * See
- * <a
- * href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#nodeprecated">nodeprecated</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option nodeprecated</a>.
* <br/>
*/
@Parameter( property = "nodeprecated", defaultValue = "false" )
@@ -1206,10 +1105,8 @@ public abstract class AbstractJavadocMojo
/**
* Prevents the generation of the file containing the list of deprecated APIs (deprecated-list.html) and the
* link in the navigation bar to that page.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#nodeprecatedlist">
- * nodeprecatedlist</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">
+ * Doclet option nodeprecatedlist</a>.
*/
@Parameter( property = "nodeprecatedlist", defaultValue = "false" )
private boolean nodeprecatedlist;
@@ -1217,10 +1114,8 @@ public abstract class AbstractJavadocMojo
/**
* Omits the HELP link in the navigation bars at the top and bottom of each page of output.
* <br/>
- * <b>Note</b>: could be in conflict with <helpfile/>.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#nohelp">nohelp</a>.
- * <br/>
+ * <b>Note</b>: could be in conflict with {@link #helpfile}.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option nohelp</a>.
*/
@Parameter( property = "nohelp", defaultValue = "false" )
private boolean nohelp;
@@ -1228,19 +1123,15 @@ public abstract class AbstractJavadocMojo
/**
* Omits the index from the generated docs.
* <br/>
- * <b>Note</b>: could be in conflict with <splitindex/>.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#noindex">noindex</a>.
- * <br/>
+ * <b>Note</b>: could be in conflict with {@link #splitindex}
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option noindex</a>.
*/
@Parameter( property = "noindex", defaultValue = "false" )
private boolean noindex;
/**
* Omits the navigation bar from the generated docs.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#nonavbar">nonavbar</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option nonavbar</a>.
*/
@Parameter( property = "nonavbar", defaultValue = "false" )
private boolean nonavbar;
@@ -1248,7 +1139,7 @@ public abstract class AbstractJavadocMojo
/**
* Omits the entire overview page from the generated docs.
* <br/>
- * <b>Note</b>: could be in conflict with <overview/>.
+ * <b>Note</b>: could be in conflict with {@link #overview}.
* <br/>
* Standard Doclet undocumented option.
* <br/>
@@ -1266,20 +1157,14 @@ public abstract class AbstractJavadocMojo
* or
* <noqualifier>packagename1:packagename2</noqualifier>
* </pre>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#noqualifier">noqualifier</a>.
- * <br/>
- * Since <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java
- * 1.4</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option noqualifier</a>.
*/
@Parameter( property = "noqualifier" )
private String noqualifier;
/**
* Omits from the generated docs the "Since" sections associated with the since tags.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#nosince">nosince</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option nosince</a>.
*/
@Parameter( property = "nosince", defaultValue = "false" )
private boolean nosince;
@@ -1289,13 +1174,7 @@ public abstract class AbstractJavadocMojo
* <br><br>
* <strong>Note:</strong> If the project has the property <code>project.build.outputTimestamp</code>, the value
* will be overwritten to true. This way it is possible to generate reproducible javadoc jars.
- * <br><br>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#notimestamp">notimestamp</a>.
- * <br>
- * Since
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.5.0.html#commandlineoptions">
- * Java 5.0</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option notimestamp</a>.
*
* @since 2.1
*/
@@ -1304,19 +1183,15 @@ public abstract class AbstractJavadocMojo
/**
* Omits the class/interface hierarchy pages from the generated docs.
- * <br>
- * @see <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#notree">notree</a> option
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option notree</a>
*/
@Parameter( property = "notree", defaultValue = "false" )
private boolean notree;
/**
- * This option is a variation of <code>-link</code>; they both create links to javadoc-generated documentation
+ * This option is a variation of {@link #links}; they both create links to javadoc-generated documentation
* for external referenced classes.
* <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#linkoffline">linkoffline</a>.
- * <br/>
* Example:
* <pre>
* <offlineLinks>
@@ -1327,18 +1202,17 @@ public abstract class AbstractJavadocMojo
* </offlineLinks>
* </pre>
* <br/>
- * <b>Note</b>: if {@code detectOfflineLinks} is defined, the offline links between the project modules are
+ * <b>Note</b>: if {@link #detectOfflineLinks} is defined, the offline links between the project modules are
* automatically added if the goal is calling in a non-aggregator way.
- * <br>
- * @see <a href="./apidocs/org/apache/maven/plugins/javadoc/options/OfflineLink.html">Javadoc</a>.
+ * @see OfflineLink.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet">Doclet option linkoffline</a>
*/
@Parameter( property = "offlineLinks" )
private OfflineLink[] offlineLinks;
/**
* Specifies the destination directory where javadoc saves the generated HTML files.
- * <br>
- * @see <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#d">javadoc d</a>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet">Doclet option d</a>
*/
@Parameter( property = "destDir", alias = "destDir", defaultValue = "${project.build.directory}/apidocs",
required = true )
@@ -1346,11 +1220,7 @@ public abstract class AbstractJavadocMojo
/**
* Specify the text for upper left frame.
- * <br/>
- * Since
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.2.html#commandlineoptions">
- * Java 1.4.2</a>.
- *
+ * @see <a href="https://bugs.openjdk.org/browse/JDK-4770521">Bug Report about missing documentation</a>
* @since 2.1
*/
@Parameter( property = "packagesheader" )
@@ -1358,8 +1228,7 @@ public abstract class AbstractJavadocMojo
/**
* Generates compile-time warnings for missing serial tags.
- * <br/>
- * @see <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#serialwarn">serialwarn</a> option
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option serialwarn</a>
*/
@Parameter( property = "serialwarn", defaultValue = "false" )
private boolean serialwarn;
@@ -1367,16 +1236,8 @@ public abstract class AbstractJavadocMojo
/**
* Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default
* space is used.
- * <br/>
- * Note: was <code>linksourcetab</code> in Java 1.4.2 (refer to bug ID
- * <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4788919">4788919</a>).
- * <br/>
- * Since
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.2.html#commandlineoptions">
- * 1.4.2</a>.
- * <br/>
- * Since Java 5.0.
*
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option sourcetab</a>
* @since 2.1
*/
@Parameter( property = "sourcetab", alias = "linksourcetab" )
@@ -1386,11 +1247,8 @@ public abstract class AbstractJavadocMojo
* Splits the index file into multiple files, alphabetically, one file per letter, plus a file for any index
* entries that start with non-alphabetical characters.
* <br/>
- * <b>Note</b>: could be in conflict with <noindex/>.
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#splitindex">splitindex</a>.
- * <br/>
+ * <b>Note</b>: could be in conflict with {@link #noindex}.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option splitindex</a>.
*/
@Parameter( property = "splitindex", defaultValue = "false" )
private boolean splitindex;
@@ -1441,8 +1299,7 @@ public abstract class AbstractJavadocMojo
* </pre>
* Where <code>path/to/your/resource/yourstylesheet.css</code> is defined in the
* <code>groupId:artifactId:version</code> javadoc plugin dependency.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#stylesheetfile">
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option
* stylesheetfile</a>.
*/
@Parameter( property = "stylesheetfile" )
@@ -1463,11 +1320,7 @@ public abstract class AbstractJavadocMojo
/**
* Specifies the class file that starts the taglet used in generating the documentation for that tag.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#taglet">taglet</a>.
- * <br/>
- * Since
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java 1.4</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option taglet</a>.
*/
@Parameter( property = "taglet" )
private String taglet;
@@ -1475,9 +1328,6 @@ public abstract class AbstractJavadocMojo
/**
* Specifies the Taglet artifact containing the taglet class files (.class).
* <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#tagletpath">tagletpath</a>.
- * <br/>
* Example:
* <pre>
* <taglets>
@@ -1497,8 +1347,7 @@ public abstract class AbstractJavadocMojo
* </pre>
* <br/>
* See <a href="./apidocs/org/apache/maven/plugins/javadoc/options/TagletArtifact.html">Javadoc</a>.
- * <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option tagletpath</a>.
* @since 2.1
*/
@Parameter( property = "tagletArtifact" )
@@ -1508,11 +1357,6 @@ public abstract class AbstractJavadocMojo
* Specifies several Taglet artifacts containing the taglet class files (.class). These taglets class names will be
* auto-detect and so no need to specify them.
* <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#taglet">taglet</a>.
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#tagletpath">tagletpath</a>.
- * <br/>
* Example:
* <pre>
* <tagletArtifacts>
@@ -1526,8 +1370,7 @@ public abstract class AbstractJavadocMojo
* </pre>
* <br/>
* See <a href="./apidocs/org/apache/maven/plugins/javadoc/options/TagletArtifact.html">Javadoc</a>.
- * <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet options taglet and tagletpath</a>
* @since 2.5
*/
@Parameter( property = "tagletArtifacts" )
@@ -1535,13 +1378,8 @@ public abstract class AbstractJavadocMojo
/**
* Specifies the search paths for finding taglet class files (.class). The <code>tagletpath</code> can contain
- * multiple paths by separating them with a colon (<code>:</code>) or a semi-colon (<code>;</code>).
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#tagletpath">tagletpath</a>.
- * <br/>
- * Since
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java 1.4</a>.
+ * multiple paths by separating them with a colon (<code>:</code>) or a semicolon (<code>;</code>).
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option tagletpath</a>.
*/
@Parameter( property = "tagletpath" )
private String tagletpath;
@@ -1549,11 +1387,6 @@ public abstract class AbstractJavadocMojo
/**
* Enables the Javadoc tool to interpret multiple taglets.
* <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#taglet">taglet</a>.
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#tagletpath">tagletpath</a>.
- * <br/>
* Example:
* <pre>
* <taglets>
@@ -1571,7 +1404,7 @@ public abstract class AbstractJavadocMojo
* <br/>
* See <a href="./apidocs/org/apache/maven/plugins/javadoc/options/Taglet.html">Javadoc</a>.
* <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet options taglet and tagletpath</a>
* @since 2.1
*/
@Parameter( property = "taglets" )
@@ -1580,11 +1413,6 @@ public abstract class AbstractJavadocMojo
/**
* Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments.
* <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#tag">tag</a>.
- * <br/>
- * Since
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/whatsnew-1.4.html#summary">Java 1.4</a>.
- * <br/>
* Example:
* <pre>
* <tags>
@@ -1607,18 +1435,15 @@ public abstract class AbstractJavadocMojo
* <li><b><code>f</code></b> (fields)</li>
* </ul>
* See <a href="./apidocs/org/apache/maven/plugins/javadoc/options/Tag.html">Javadoc</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option tag</a>.
*/
@Parameter( property = "tags" )
private Tag[] tags;
/**
* Specifies the top text to be placed at the top of each output file.
- * <br/>
- * See <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6227616">6227616</a>.
- * <br/>
- * Since Java 6.0
- *
+ * @see <a href="https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616">Java Bug 6227616</a>.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option top</a>.
* @since 2.4
*/
@Parameter( property = "top" )
@@ -1626,28 +1451,21 @@ public abstract class AbstractJavadocMojo
/**
* Includes one "Use" page for each documented class and package.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#use">use</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option use</a>.
*/
@Parameter( property = "use", defaultValue = "true" )
private boolean use;
/**
- * Includes the version text in the generated docs.
- * <br/>
- * See <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#version">version</a>.
- * <br/>
+ * Includes the given version text in the generated docs.
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option version</a>.
*/
@Parameter( property = "version", defaultValue = "true" )
private boolean version;
/**
* Specifies the title to be placed in the HTML title tag.
- * <br/>
- * See
- * <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#windowtitle">windowtitle</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option windowtitle</a>.
*/
@Parameter( property = "windowtitle", defaultValue = "${project.name} ${project.version} API" )
private String windowtitle;
@@ -1755,7 +1573,8 @@ public abstract class AbstractJavadocMojo
private List<String> sourceFileExcludes;
/**
- * To apply the security fix on generated javadoc see http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2013-1571
+ * To apply a security fix on generated javadoc, see
+ * <a href="https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2013-1571>CVE-2013-157</a>.
* @since 2.9.1
*/
@Parameter( defaultValue = "true", property = "maven.javadoc.applyJavadocSecurityFix" )
@@ -2724,7 +2543,7 @@ public abstract class AbstractJavadocMojo
*
* @param sourcePaths the list of paths to the source files that will be included in the javadoc.
* @return a String that contains the formatted source path argument, separated by the System pathSeparator
- * string (colon (<code>:</code>) on Solaris or semi-colon (<code>;</code>) on Windows).
+ * string (colon (<code>:</code>) on Solaris or semicolon (<code>;</code>) on Windows).
* @see File#pathSeparator
*/
private String getSourcePath( Collection<Path> sourcePaths )
@@ -3230,7 +3049,7 @@ public abstract class AbstractJavadocMojo
* Method to get the path of the bootclass artifacts used in the <code>-bootclasspath</code> option.
*
* @return a string that contains bootclass path, separated by the System pathSeparator string
- * (colon (<code>:</code>) on Solaris or semi-colon (<code>;</code>) on Windows).
+ * (colon (<code>:</code>) on Solaris or semicolon (<code>;</code>) on Windows).
* @throws MavenReportException if any
* @see File#pathSeparator
*/
@@ -3271,7 +3090,7 @@ public abstract class AbstractJavadocMojo
* definition.
*
* @return a string that contains doclet path, separated by the System pathSeparator string
- * (colon (<code>:</code>) on Solaris or semi-colon (<code>;</code>) on Windows).
+ * (colon (<code>:</code>) on Solaris or semicolon (<code>;</code>) on Windows).
* @throws MavenReportException if any
* @see File#pathSeparator
*/
@@ -3327,7 +3146,7 @@ public abstract class AbstractJavadocMojo
* Method to get the path of the taglet artifacts used in the <code>-tagletpath</code> option.
*
* @return a string that contains taglet path, separated by the System pathSeparator string
- * (colon (<code>:</code>) on Solaris or semi-colon (<code>;</code>) on Windows).
+ * (colon (<code>:</code>) on Solaris or semicolon (<code>;</code>) on Windows).
* @throws MavenReportException if any
* @see File#pathSeparator
*/
@@ -4379,7 +4198,7 @@ public abstract class AbstractJavadocMojo
* @throws MavenReportException issue while generating report
* @see #detectLinks
* @see #getDependenciesLinks()
- * @see <a href="https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#package-list">package-list spec</a>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">link option</a>
*/
private void addLinkArguments( List<String> arguments )
throws MavenReportException
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocJar.java b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocJar.java
index 9e4f3cc4..aa16c72a 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocJar.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocJar.java
@@ -26,7 +26,8 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
/**
* <p>Bundles the Javadoc documentation for main <code>Java code</code> in an <b>aggregator</b> project into a jar
- * using the standard <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.</p>
+ * using the standard <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>.
+ * </p>
*
* <p>Since version 3.1.0 an aggregated jar is created for every module of a Maven multimodule project.</p>
*
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocNoForkReport.java b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocNoForkReport.java
index d5897907..64867fd4 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocNoForkReport.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocNoForkReport.java
@@ -26,7 +26,7 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
/**
* Generates documentation for the <code>Java code</code> in an <b>aggregator</b> project using the standard
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.
+ * <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>.
*
* @since 3.1.0
*/
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocReport.java b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocReport.java
index 0f42aa25..0d6f793c 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocReport.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorJavadocReport.java
@@ -26,7 +26,7 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
/**
* <p>Generates documentation for the <code>Java code</code> in an <b>aggregator</b> project using the standard
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.</p>
+ * <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>.</p>
*
* <p>Since version 3.1.0 an aggregated report is created for every module of a Maven multimodule project.</p>
*
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocJar.java b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocJar.java
index e25e0a4f..f79b8530 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocJar.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocJar.java
@@ -26,7 +26,8 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
/**
* <p>Bundles the Javadoc documentation for <code>Java Test code</code> in an <b>aggregator</b> project into a jar
- * using the standard <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.</p>
+ * using the standard <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>.
+ * </p>
*
* <p>Since version 3.1.0 an aggregated jar is created for every module of a Maven multimodule project.</p>
*
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocNoForkReport.java b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocNoForkReport.java
index 6e061674..dbd127a1 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocNoForkReport.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocNoForkReport.java
@@ -26,7 +26,7 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
/**
* Generates documentation for the <code>Java Test code</code> in an <b>aggregator</b> project using the standard
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.
+ * <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>.
*
* @version $Id$
* @since 3.0.1
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocReport.java b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocReport.java
index 8bf44d93..66e08cd4 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocReport.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/AggregatorTestJavadocReport.java
@@ -26,7 +26,7 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
/**
* <p>Generates documentation for the <code>Java Test code</code> in an <b>aggregator</b> project using the standard
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.</p>
+ * <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>.</p>
*
* <p>Since version 3.1.0 an aggregated report is created for every module of a Maven multimodule project.</p>
*
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/FixJavadocMojo.java b/src/main/java/org/apache/maven/plugins/javadoc/FixJavadocMojo.java
index 128c04d0..216a7a28 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/FixJavadocMojo.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/FixJavadocMojo.java
@@ -26,9 +26,8 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
/**
* Fix Javadoc documentation and tags for the <code>Java code</code> for the project.
- * See <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#wheretags">Where Tags Can
- * Be Used</a>.
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/javadoc/doc-comment-spec.html#where-tags-can-be-used">Where Tags
+ * Can Be Used</a>
* @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
* @since 2.6
*/
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/JavadocJar.java b/src/main/java/org/apache/maven/plugins/javadoc/JavadocJar.java
index 2a20bb8c..73cdf745 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/JavadocJar.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/JavadocJar.java
@@ -44,7 +44,8 @@ import java.util.Locale;
/**
* Bundles the Javadoc documentation for <code>main Java code</code> in an <b>NON aggregator</b> project into
- * a jar using the standard <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.
+ * a jar using the standard <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">
+ * Javadoc Tool</a>.
*
* @since 2.0
*/
@@ -95,8 +96,7 @@ public class JavadocJar
/**
* Specifies the destination directory where javadoc saves the generated HTML files.
- * See <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#d">d</a>.
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option d</a>.
* @deprecated
*/
@Deprecated
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/JavadocNoForkReport.java b/src/main/java/org/apache/maven/plugins/javadoc/JavadocNoForkReport.java
index a68f2575..a796bd63 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/JavadocNoForkReport.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/JavadocNoForkReport.java
@@ -26,12 +26,12 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
/**
* Generates documentation for the <code>Java code</code> in an <b>NON aggregator</b> project using the standard
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>. Note that this
+ * <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>. Note that this
* goal does require generation of sources before site generation, e.g. by invoking {@code mvn clean deploy site}.
*
* @author <a href="mailto:mfriedenhagen@apache.org">Mirko Friedenhagen</a>
* @since 2.10
- * @see <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>
* @see <a href="http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/javadoc.html#options">Javadoc Options</a>
*/
@Mojo( name = "javadoc-no-fork", requiresDependencyResolution = ResolutionScope.COMPILE, threadSafe = true )
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/JavadocReport.java b/src/main/java/org/apache/maven/plugins/javadoc/JavadocReport.java
index 4ba2f67c..ebdfccd5 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/JavadocReport.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/JavadocReport.java
@@ -44,13 +44,12 @@ import org.codehaus.plexus.util.StringUtils;
/**
* Generates documentation for the <code>Java code</code> in an <b>NON aggregator</b> project using the standard
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.
+ * <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>.
*
* @author <a href="mailto:evenisse@apache.org">Emmanuel Venisse</a>
* @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
* @since 2.0
- * @see <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>
- * @see <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#options">Javadoc Options</a>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>
*/
@Mojo( name = "javadoc", requiresDependencyResolution = ResolutionScope.COMPILE, threadSafe = true )
@Execute( phase = LifecyclePhase.GENERATE_SOURCES )
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/TestFixJavadocMojo.java b/src/main/java/org/apache/maven/plugins/javadoc/TestFixJavadocMojo.java
index f20ac441..c652a927 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/TestFixJavadocMojo.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/TestFixJavadocMojo.java
@@ -34,9 +34,8 @@ import java.util.List;
/**
* Fix Javadoc documentation and tags for the <code>Test Java code</code> for the project.
- * See <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#wheretags">Where Tags Can
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/javadoc/doc-comment-spec.html#where-tags-can-be-used">Where Tags Can
* Be Used</a>.
- *
* @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
* @since 2.6
*/
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocJar.java b/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocJar.java
index e78b8865..ed725c7c 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocJar.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocJar.java
@@ -36,7 +36,8 @@ import java.util.List;
/**
* Bundles the Javadoc documentation for <code>test Java code</code> in an <b>NON aggregator</b> project into
- * a jar using the standard <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.
+ * a jar using the standard <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">
+ * Javadoc Tool</a>.
*
* @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
* @since 2.5
@@ -52,19 +53,14 @@ public class TestJavadocJar
/**
* Specifies the destination directory where Javadoc saves the generated HTML files.
- * <br/>
- * See <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#d">d</a>.
- * <br/>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option d</a>.
*/
@Parameter( defaultValue = "${project.build.directory}/testapidocs", required = true )
private File outputDirectory;
/**
* Specifies the Test title to be placed near the top of the overview summary file.
- * <br/>
- * See <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#doctitle">doctitle</a>.
- * <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option doctitle</a>.
* @since 2.5
*/
@Parameter( property = "testDoctitle", alias = "doctitle",
@@ -74,10 +70,7 @@ public class TestJavadocJar
/**
* Specifies that Javadoc should retrieve the text for the Test overview documentation from the "source" file
* specified by path/filename and place it on the Overview page (overview-summary.html).
- * <br/>
- * See <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#overview">overview</a>.
- * <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option overview</a>.
* @since 2.5
*/
@Parameter( property = "testOverview", alias = "overview",
@@ -86,11 +79,7 @@ public class TestJavadocJar
/**
* Specifies the Test title to be placed in the HTML title tag.
- * <br/>
- * See
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#windowtitle">windowtitle</a>.
- * <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option windowtitle</a>.
* @since 2.5
*/
@Parameter( property = "testWindowtitle", alias = "windowtitle",
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocNoForkReport.java b/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocNoForkReport.java
index 2346814f..7e64b954 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocNoForkReport.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocNoForkReport.java
@@ -26,13 +26,13 @@ import org.apache.maven.plugins.annotations.ResolutionScope;
/**
* Generates documentation for the <code>Java Test code</code> in an <b>NON aggregator</b> project using the standard
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>. Note that this
+ * <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>. Note that this
* goal does require generation of test sources before site generation, e.g. by invoking
* {@code mvn clean deploy site}.
*
* @author <a href="mailto:mfriedenhagen@apache.org">Mirko Friedenhagen</a>
* @since 2.10
- * @see <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>
* @see <a href="http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/javadoc.html#options">Javadoc Options </a>
*/
@Mojo( name = "test-javadoc-no-fork", requiresDependencyResolution = ResolutionScope.TEST, threadSafe = true )
diff --git a/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocReport.java b/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocReport.java
index 07e941d6..72b1a57c 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocReport.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/TestJavadocReport.java
@@ -41,12 +41,11 @@ import java.util.ResourceBundle;
/**
* Generates documentation for the <code>Java Test code</code> in an <b>NON aggregator</b> project using the standard
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>.
+ * <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>.
*
* @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
* @since 2.3
- * @see <a href="http://docs.oracle.com/javase/7/docs/technotes/guides/javadoc/">Javadoc Tool</a>
- * @see <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#options">Javadoc Options </a>
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html">Javadoc Tool</a>
*/
@Mojo( name = "test-javadoc", requiresDependencyResolution = ResolutionScope.TEST, threadSafe = true )
@Execute( phase = LifecyclePhase.GENERATE_TEST_SOURCES )
@@ -59,10 +58,7 @@ public class TestJavadocReport
/**
* Specifies the Test title to be placed near the top of the overview summary file.
- * <br/>
- * See <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#doctitle">doctitle</a>.
- * <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option doctitle</a>.
* @since 2.5
*/
@Parameter( property = "testDoctitle", alias = "doctitle",
@@ -72,12 +68,7 @@ public class TestJavadocReport
/**
* Specifies that Javadoc should retrieve the text for the Test overview documentation from the "source" file
* specified by path/filename and place it on the Overview page (overview-summary.html).
- * <br/>
- * <b>Note</b>: could be in conflict with <nooverview/>.
- * <br/>
- * See <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#overview">overview</a>.
- * <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option overview</a>.
* @since 2.5
*/
@Parameter( property = "testOverview", alias = "overview",
@@ -86,11 +77,7 @@ public class TestJavadocReport
/**
* Specifies the Test title to be placed in the HTML title tag.
- * <br/>
- * See
- * <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#windowtitle">windowtitle</a>.
- * <br/>
- *
+ * @see <a href="https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options">Doclet option windowtitle</a>.
* @since 2.5
*/
@Parameter( property = "testWindowtitle", alias = "windowtitle",