commit 6a317bd5300e12b8a5a64cd7ceeb12b734173520d14365257b9ea6dc8e2e0893 Author: Fridrich Strba Date: Sun Dec 8 19:52:15 2024 +0000 OBS-URL: https://build.opensuse.org/package/show/Java:packages/maven-javadoc-plugin?expand=0&rev=65 diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..9b03811 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,23 @@ +## Default LFS +*.7z filter=lfs diff=lfs merge=lfs -text +*.bsp filter=lfs diff=lfs merge=lfs -text +*.bz2 filter=lfs diff=lfs merge=lfs -text +*.gem filter=lfs diff=lfs merge=lfs -text +*.gz filter=lfs diff=lfs merge=lfs -text +*.jar filter=lfs diff=lfs merge=lfs -text +*.lz filter=lfs diff=lfs merge=lfs -text +*.lzma filter=lfs diff=lfs merge=lfs -text +*.obscpio filter=lfs diff=lfs merge=lfs -text +*.oxt filter=lfs diff=lfs merge=lfs -text +*.pdf filter=lfs diff=lfs merge=lfs -text +*.png filter=lfs diff=lfs merge=lfs -text +*.rpm filter=lfs diff=lfs merge=lfs -text +*.tbz filter=lfs diff=lfs merge=lfs -text +*.tbz2 filter=lfs diff=lfs merge=lfs -text +*.tgz filter=lfs diff=lfs merge=lfs -text +*.ttf filter=lfs diff=lfs merge=lfs -text +*.txz filter=lfs diff=lfs merge=lfs -text +*.whl filter=lfs diff=lfs merge=lfs -text +*.xz filter=lfs diff=lfs merge=lfs -text +*.zip filter=lfs diff=lfs merge=lfs -text +*.zst filter=lfs diff=lfs merge=lfs -text diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..57affb6 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +.osc diff --git a/_multibuild b/_multibuild new file mode 100644 index 0000000..93032d2 --- /dev/null +++ b/_multibuild @@ -0,0 +1,3 @@ + + bootstrap + diff --git a/_service b/_service new file mode 100644 index 0000000..1178ccb --- /dev/null +++ b/_service @@ -0,0 +1,15 @@ + + + git + https://github.com/apache/maven-javadoc-plugin.git + maven-javadoc-plugin-3.11.2 + maven-javadoc-plugin-* + @PARENT_TAG@ + maven-javadoc-plugin-(.*) + + + *.tar + xz + + + diff --git a/maven-javadoc-plugin-3.10.1.tar.xz b/maven-javadoc-plugin-3.10.1.tar.xz new file mode 100644 index 0000000..d837f04 --- /dev/null +++ b/maven-javadoc-plugin-3.10.1.tar.xz @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a388ba730f6587358c4c2a056522cc4b510de0e857ca169b03dccc3a5f244db1 +size 818540 diff --git a/maven-javadoc-plugin-3.11.1.tar.xz b/maven-javadoc-plugin-3.11.1.tar.xz new file mode 100644 index 0000000..4d270c1 --- /dev/null +++ b/maven-javadoc-plugin-3.11.1.tar.xz @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:874d9531ca9d5807a595c119f571e7b723ac35e98f9117173c6dddf45887e643 +size 818276 diff --git a/maven-javadoc-plugin-3.11.2.tar.xz b/maven-javadoc-plugin-3.11.2.tar.xz new file mode 100644 index 0000000..bac8802 --- /dev/null +++ b/maven-javadoc-plugin-3.11.2.tar.xz @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:cfafd165e65ddc70ebe90d74700e50d5125b56f6f71dbb88ba1e172086ddcc6d +size 819928 diff --git a/maven-javadoc-plugin-bootstrap-resources.patch b/maven-javadoc-plugin-bootstrap-resources.patch new file mode 100644 index 0000000..7c13e11 --- /dev/null +++ b/maven-javadoc-plugin-bootstrap-resources.patch @@ -0,0 +1,33491 @@ +--- a/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-javadoc-plugin/plugin-help.xml 1970-01-01 01:00:00.000000000 +0100 ++++ b/src/main/filtered-resources/META-INF/maven/org.apache.maven.plugins/maven-javadoc-plugin/plugin-help.xml 2024-11-04 11:07:28.436706316 +0100 +@@ -0,0 +1,15697 @@ ++ ++ ++ ++ ++ ++ ${project.name} ++ ${project.description} ++ ${project.groupId} ++ ${project.artifactId} ++ ${project.version} ++ javadoc ++ ++ ++ aggregate ++ ++Generates documentation for the Java code in an aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ ++Since version 3.1.0 an aggregated report is created for every module of a Maven multimodule project. ++ ++ compile ++ false ++ true ++ false ++ true ++ false ++ true ++ compile ++ org.apache.maven.plugins.javadoc.AggregatorJavadocReport ++ java ++ per-lookup ++ once-per-session ++ 2.5 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ aggregate-jar ++ ++Bundles the Javadoc documentation for main Java code in an aggregator project into a jar using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ ++Since version 3.1.0 an aggregated jar is created for every module of a Maven multimodule project. ++ ++ compile ++ false ++ true ++ false ++ true ++ false ++ true ++ package ++ compile ++ org.apache.maven.plugins.javadoc.AggregatorJavadocJarMojo ++ java ++ per-lookup ++ once-per-session ++ 2.6 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ archive ++ org.apache.maven.archiver.MavenArchiveConfiguration ++ 2.5 ++ false ++ true ++ The archive configuration to use. See Maven Archiver Reference <http://maven.apache.org/shared/maven-archiver/index.html>. ++ ++ ++ attach ++ boolean ++ false ++ true ++ Specifies whether to attach the generated artifact to the project helper. ++ ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ classifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ true ++ Specifies the filename that will be used for the generated jar file. Please note that -javadoc or -test-javadoc will be appended to the file name. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ jarOutputDirectory ++ java.lang.String ++ false ++ true ++ Specifies the directory where the generated jar file will be put. ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useDefaultManifestFile ++ boolean ++ 2.5 ++ false ++ true ++ Set this to true to enable the use of the defaultManifestFile. ++ ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${attach} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${maven.javadoc.classifier} ++ ${debug} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ${project.build.finalName} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${project.build.directory} ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ aggregate-no-fork ++ Generates documentation for the Java code in an aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.javadoc.AggregatorJavadocNoForkReport ++ java ++ per-lookup ++ once-per-session ++ 3.1.0 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ fix ++ Fix Javadoc documentation and tags for the Java code for the project. ++See also: Where Tags Can Be Used <https://docs.oracle.com/en/java/javase/17/docs/specs/javadoc/doc-comment-spec.html#where-tags-can-be-used> ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ compile ++ org.apache.maven.plugins.javadoc.FixJavadocMojo ++ java ++ per-lookup ++ once-per-session ++ 2.6 ++ true ++ ++ ++ comparisonVersion ++ java.lang.String ++ false ++ true ++ Version to compare the current code against using the Clirr Maven Plugin <https://www.mojohaus.org/clirr-maven-plugin/>. ++See defaultSince. ++ ++ ++ defaultAuthor ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @author. ++ ++ ++ defaultSince ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @since. ++ ++ ++ defaultVersion ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @version. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ The file encoding to use when reading the source files. If the property project.build.sourceEncoding is not set, the platform default encoding is used. ++ ++ ++ excludes ++ java.lang.String ++ false ++ true ++ Comma separated excludes Java files, i.e. **/*Test.java. ++ ++ ++ fixClassComment ++ boolean ++ false ++ true ++ Flag to fix the classes or interfaces Javadoc comments according the level. ++ ++ ++ fixFieldComment ++ boolean ++ false ++ true ++ Flag to fix the fields Javadoc comments according the level. ++ ++ ++ fixMethodComment ++ boolean ++ false ++ true ++ Flag to fix the methods Javadoc comments according the level. ++ ++ ++ fixTags ++ java.lang.String ++ false ++ true ++ Comma separated tags to fix in classes, interfaces or methods Javadoc comments. Possible values are: ++* all (fix all Javadoc tags) ++* author (fix only @author tag) ++* version (fix only @version tag) ++* since (fix only @since tag) ++* param (fix only @param tag) ++* return (fix only @return tag) ++* throws (fix only @throws tag) ++* link (fix only @link tag) ++ ++ ++ force ++ boolean ++ false ++ true ++ Forcing the goal execution i.e. skip warranty messages (not recommended). ++ ++ ++ ignoreClirr ++ boolean ++ false ++ true ++ Flag to ignore or not Clirr. ++ ++ ++ includes ++ java.lang.String ++ false ++ true ++ Comma separated includes Java files, i.e. **/*Test.java. ++ ++Note: default value is **\/*.java. ++ ++ ++ level ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: private, protected, public, package options for Javadoc <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ outputDirectory ++ java.io.File ++ false ++ true ++ Output directory where Java classes will be rewritten. ++ ++ ++ removeUnknownThrows ++ boolean ++ false ++ true ++ ++Flag to remove throws tags from unknown classes. ++ ++NOTE:Since 3.1.0 the default value has been changed to true, due to JavaDoc 8 strictness. ++ ++ ++ ++ ++ ${comparisonVersion} ++ ${defaultAuthor} ++ ${defaultSince} ++ ${defaultVersion} ++ ${encoding} ++ ${excludes} ++ ${fixClassComment} ++ ${fixFieldComment} ++ ${fixMethodComment} ++ ${fixTags} ++ ${force} ++ ${ignoreClirr} ++ ${includes} ++ ${level} ++ ${outputDirectory} ++ ${removeUnknownThrows} ++ ++ ++ ++ help ++ Display help information on maven-javadoc-plugin. ++Call mvn javadoc:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ false ++ false ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.maven_javadoc_plugin.HelpMojo ++ java ++ per-lookup ++ once-per-session ++ true ++ ++ ++ detail ++ boolean ++ false ++ true ++ If true, display all settable properties for each goal. ++ ++ ++ goal ++ java.lang.String ++ false ++ true ++ The name of the goal for which to show help. If unspecified, all goals will be displayed. ++ ++ ++ indentSize ++ int ++ false ++ true ++ The number of spaces per indentation level, should be positive. ++ ++ ++ lineLength ++ int ++ false ++ true ++ The maximum length of a display line, should be positive. ++ ++ ++ ++ ${detail} ++ ${goal} ++ ${indentSize} ++ ${lineLength} ++ ++ ++ ++ jar ++ Bundles the Javadoc documentation for main Java code in an NON aggregator project into a jar using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ package ++ org.apache.maven.plugins.javadoc.JavadocJarMojo ++ java ++ per-lookup ++ once-per-session ++ 2.0 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ archive ++ org.apache.maven.archiver.MavenArchiveConfiguration ++ 2.5 ++ false ++ true ++ The archive configuration to use. See Maven Archiver Reference <http://maven.apache.org/shared/maven-archiver/index.html>. ++ ++ ++ attach ++ boolean ++ false ++ true ++ Specifies whether to attach the generated artifact to the project helper. ++ ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ classifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ true ++ Specifies the filename that will be used for the generated jar file. Please note that -javadoc or -test-javadoc will be appended to the file name. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ jarOutputDirectory ++ java.lang.String ++ false ++ true ++ Specifies the directory where the generated jar file will be put. ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useDefaultManifestFile ++ boolean ++ 2.5 ++ false ++ true ++ Set this to true to enable the use of the defaultManifestFile. ++ ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${attach} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${maven.javadoc.classifier} ++ ${debug} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ${project.build.finalName} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${project.build.directory} ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ javadoc ++ Generates documentation for the Java code in a NON aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++See also: Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html> ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ generate-sources ++ org.apache.maven.plugins.javadoc.JavadocReport ++ java ++ per-lookup ++ once-per-session ++ 2.0 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ javadoc-no-fork ++ Generates documentation for the Java code in an NON aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. Note that this goal does require generation of sources before site generation, e.g. by invoking mvn clean deploy site. ++See also: Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>, Javadoc Options <http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/javadoc.html#options> ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.javadoc.JavadocNoForkReport ++ java ++ per-lookup ++ once-per-session ++ 2.10 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ resource-bundle ++ Bundle javadocDirectory, along with javadoc configuration options such as taglet, doclet, and link information into a deployable artifact. This artifact can then be consumed by the javadoc plugin mojos when used by the includeDependencySources option, to generate javadocs that are somewhat consistent with those generated in the original project itself. ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ package ++ org.apache.maven.plugins.javadoc.ResourcesBundleMojo ++ java ++ per-lookup ++ once-per-session ++ 2.7 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ test-aggregate ++ ++Generates documentation for the Java Test code in an aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ ++Since version 3.1.0 an aggregated report is created for every module of a Maven multimodule project. ++ ++ test ++ false ++ true ++ false ++ true ++ false ++ true ++ test-compile ++ org.apache.maven.plugins.javadoc.AggregatorTestJavadocReport ++ java ++ per-lookup ++ once-per-session ++ 2.5 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testDescription ++ description ++ java.lang.String ++ 2.5 ++ false ++ true ++ The description of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++ ++ ++ testName ++ name ++ java.lang.String ++ 2.5 ++ false ++ true ++ The name of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${testDescription} ++ ${testDoctitle} ++ ++ ${testName} ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ test-aggregate-jar ++ ++Bundles the Javadoc documentation for Java Test code in an aggregator project into a jar using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ ++Since version 3.1.0 an aggregated jar is created for every module of a Maven multimodule project. ++ ++ test ++ false ++ true ++ false ++ true ++ false ++ true ++ package ++ test-compile ++ org.apache.maven.plugins.javadoc.AggregatorTestJavadocJarMojo ++ java ++ per-lookup ++ once-per-session ++ 2.6 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ archive ++ org.apache.maven.archiver.MavenArchiveConfiguration ++ 2.5 ++ false ++ true ++ The archive configuration to use. See Maven Archiver Reference <http://maven.apache.org/shared/maven-archiver/index.html>. ++ ++ ++ attach ++ boolean ++ false ++ true ++ Specifies whether to attach the generated artifact to the project helper. ++ ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ classifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ true ++ Specifies the filename that will be used for the generated jar file. Please note that -javadoc or -test-javadoc will be appended to the file name. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ jarOutputDirectory ++ java.lang.String ++ false ++ true ++ Specifies the directory where the generated jar file will be put. ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testClassifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useDefaultManifestFile ++ boolean ++ 2.5 ++ false ++ true ++ Set this to true to enable the use of the defaultManifestFile. ++ ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${attach} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${maven.javadoc.classifier} ++ ${debug} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ${project.build.finalName} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${project.build.directory} ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${maven.javadoc.testClassifier} ++ ${testDoctitle} ++ ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ test-aggregate-no-fork ++ Generates documentation for the Java Test code in an aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.javadoc.AggregatorTestJavadocNoForkReport ++ java ++ per-lookup ++ once-per-session ++ 3.0.1 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testDescription ++ description ++ java.lang.String ++ 2.5 ++ false ++ true ++ The description of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++ ++ ++ testName ++ name ++ java.lang.String ++ 2.5 ++ false ++ true ++ The name of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${testDescription} ++ ${testDoctitle} ++ ++ ${testName} ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ test-fix ++ Fix Javadoc documentation and tags for the Test Java code for the project. ++See also: Where Tags Can Be Used <https://docs.oracle.com/en/java/javase/17/docs/specs/javadoc/doc-comment-spec.html#where-tags-can-be-used> ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ test-compile ++ org.apache.maven.plugins.javadoc.TestFixJavadocMojo ++ java ++ per-lookup ++ once-per-session ++ 2.6 ++ true ++ ++ ++ comparisonVersion ++ java.lang.String ++ false ++ true ++ Version to compare the current code against using the Clirr Maven Plugin <https://www.mojohaus.org/clirr-maven-plugin/>. ++See defaultSince. ++ ++ ++ defaultAuthor ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @author. ++ ++ ++ defaultSince ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @since. ++ ++ ++ defaultVersion ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @version. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ The file encoding to use when reading the source files. If the property project.build.sourceEncoding is not set, the platform default encoding is used. ++ ++ ++ excludes ++ java.lang.String ++ false ++ true ++ Comma separated excludes Java files, i.e. **/*Test.java. ++ ++ ++ fixClassComment ++ boolean ++ false ++ true ++ Flag to fix the classes or interfaces Javadoc comments according the level. ++ ++ ++ fixFieldComment ++ boolean ++ false ++ true ++ Flag to fix the fields Javadoc comments according the level. ++ ++ ++ fixMethodComment ++ boolean ++ false ++ true ++ Flag to fix the methods Javadoc comments according the level. ++ ++ ++ fixTags ++ java.lang.String ++ false ++ true ++ Comma separated tags to fix in classes, interfaces or methods Javadoc comments. Possible values are: ++* all (fix all Javadoc tags) ++* author (fix only @author tag) ++* version (fix only @version tag) ++* since (fix only @since tag) ++* param (fix only @param tag) ++* return (fix only @return tag) ++* throws (fix only @throws tag) ++* link (fix only @link tag) ++ ++ ++ force ++ boolean ++ false ++ true ++ Forcing the goal execution i.e. skip warranty messages (not recommended). ++ ++ ++ ignoreClirr ++ boolean ++ false ++ true ++ Flag to ignore or not Clirr. ++ ++ ++ includes ++ java.lang.String ++ false ++ true ++ Comma separated includes Java files, i.e. **/*Test.java. ++ ++Note: default value is **\/*.java. ++ ++ ++ level ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: private, protected, public, package options for Javadoc <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ outputDirectory ++ java.io.File ++ false ++ true ++ Output directory where Java classes will be rewritten. ++ ++ ++ removeUnknownThrows ++ boolean ++ false ++ true ++ ++Flag to remove throws tags from unknown classes. ++ ++NOTE:Since 3.1.0 the default value has been changed to true, due to JavaDoc 8 strictness. ++ ++ ++ ++ ++ ${comparisonVersion} ++ ${defaultAuthor} ++ ${defaultSince} ++ ${defaultVersion} ++ ${encoding} ++ ${excludes} ++ ${fixClassComment} ++ ${fixFieldComment} ++ ${fixMethodComment} ++ ${fixTags} ++ ${force} ++ ${ignoreClirr} ++ ${includes} ++ ${level} ++ ${outputDirectory} ++ ${removeUnknownThrows} ++ ++ ++ ++ test-jar ++ Bundles the Javadoc documentation for test Java code in an NON aggregator project into a jar using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ package ++ org.apache.maven.plugins.javadoc.TestJavadocJarMojo ++ java ++ per-lookup ++ once-per-session ++ 2.5 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ archive ++ org.apache.maven.archiver.MavenArchiveConfiguration ++ 2.5 ++ false ++ true ++ The archive configuration to use. See Maven Archiver Reference <http://maven.apache.org/shared/maven-archiver/index.html>. ++ ++ ++ attach ++ boolean ++ false ++ true ++ Specifies whether to attach the generated artifact to the project helper. ++ ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ classifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ true ++ Specifies the filename that will be used for the generated jar file. Please note that -javadoc or -test-javadoc will be appended to the file name. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ jarOutputDirectory ++ java.lang.String ++ false ++ true ++ Specifies the directory where the generated jar file will be put. ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testClassifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useDefaultManifestFile ++ boolean ++ 2.5 ++ false ++ true ++ Set this to true to enable the use of the defaultManifestFile. ++ ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${attach} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${maven.javadoc.classifier} ++ ${debug} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ${project.build.finalName} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${project.build.directory} ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${maven.javadoc.testClassifier} ++ ${testDoctitle} ++ ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ test-javadoc ++ Generates documentation for the Java Test code in an NON aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++See also: Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html> ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ generate-test-sources ++ org.apache.maven.plugins.javadoc.TestJavadocReport ++ java ++ per-lookup ++ once-per-session ++ 2.3 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testDescription ++ description ++ java.lang.String ++ 2.5 ++ false ++ true ++ The description of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++ ++ ++ testName ++ name ++ java.lang.String ++ 2.5 ++ false ++ true ++ The name of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${testDescription} ++ ${testDoctitle} ++ ++ ${testName} ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ test-javadoc-no-fork ++ Generates documentation for the Java Test code in an NON aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. Note that this goal does require generation of test sources before site generation, e.g. by invoking mvn clean deploy site. ++See also: Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>, Javadoc Options <http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/javadoc.html#options> ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.javadoc.TestJavadocNoForkReport ++ java ++ per-lookup ++ once-per-session ++ 2.10 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testDescription ++ description ++ java.lang.String ++ 2.5 ++ false ++ true ++ The description of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++ ++ ++ testName ++ name ++ java.lang.String ++ 2.5 ++ false ++ true ++ The name of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${testDescription} ++ ${testDoctitle} ++ ++ ${testName} ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ test-resource-bundle ++ Bundle TestJavadocJarMojo.testJavadocDirectory, along with javadoc configuration options from such as taglet, doclet, and link information into a deployable artifact. This artifact can then be consumed by the javadoc plugin mojos when used by the includeDependencySources option, to generate javadocs that are somewhat consistent with those generated in the original project itself. ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ package ++ org.apache.maven.plugins.javadoc.TestResourcesBundleMojo ++ java ++ per-lookup ++ once-per-session ++ 2.7 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List<org.apache.maven.plugins.javadoc.AdditionalDependency> ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List<org.apache.maven.plugins.javadoc.DependencyLink> ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List<java.lang.String> ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map<java.lang.String, java.lang.String> ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList<java.lang.String> ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List<java.lang.String> ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ${quiet} ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ +--- a/src/main/filtered-resources/META-INF/maven/plugin.xml 1970-01-01 01:00:00.000000000 +0100 ++++ b/src/main/filtered-resources/META-INF/maven/plugin.xml 2024-11-04 11:07:58.820245262 +0100 +@@ -0,0 +1,17337 @@ ++ ++ ++ ++ ++ ++ ${project.name} ++ ${project.description} ++ ${project.groupId} ++ ${project.artifactId} ++ ${project.version} ++ javadoc ++ false ++ true ++ 1.8 ++ 3.5.0 ++ ++ ++ aggregate ++ ++Generates documentation for the Java code in an aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ ++Since version 3.1.0 an aggregated report is created for every module of a Maven multimodule project. ++ ++ compile ++ false ++ true ++ false ++ true ++ false ++ true ++ compile ++ org.apache.maven.plugins.javadoc.AggregatorJavadocReport ++ java ++ per-lookup ++ once-per-session ++ 2.5 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ aggregate-jar ++ ++Bundles the Javadoc documentation for main Java code in an aggregator project into a jar using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ ++Since version 3.1.0 an aggregated jar is created for every module of a Maven multimodule project. ++ ++ compile ++ false ++ true ++ false ++ true ++ false ++ true ++ package ++ compile ++ org.apache.maven.plugins.javadoc.AggregatorJavadocJarMojo ++ java ++ per-lookup ++ once-per-session ++ 2.6 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ archive ++ org.apache.maven.archiver.MavenArchiveConfiguration ++ 2.5 ++ false ++ true ++ The archive configuration to use. See Maven Archiver Reference <http://maven.apache.org/shared/maven-archiver/index.html>. ++ ++ ++ attach ++ boolean ++ false ++ true ++ Specifies whether to attach the generated artifact to the project helper. ++ ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ classifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ defaultManifestFile ++ java.io.File ++ 2.5 ++ true ++ false ++ Path to the default MANIFEST file to use. It will be used if useDefaultManifestFile is set to true. ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ true ++ Specifies the filename that will be used for the generated jar file. Please note that -javadoc or -test-javadoc will be appended to the file name. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ jarOutputDirectory ++ java.lang.String ++ false ++ true ++ Specifies the directory where the generated jar file will be put. ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useDefaultManifestFile ++ boolean ++ 2.5 ++ false ++ true ++ Set this to true to enable the use of the defaultManifestFile. ++ ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${attach} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${maven.javadoc.classifier} ++ ${debug} ++ ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ${project.build.finalName} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${project.build.directory} ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.codehaus.plexus.archiver.Archiver ++ jar ++ jarArchiver ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.apache.maven.project.MavenProjectHelper ++ projectHelper ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ aggregate-no-fork ++ Generates documentation for the Java code in an aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.javadoc.AggregatorJavadocNoForkReport ++ java ++ per-lookup ++ once-per-session ++ 3.1.0 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ fix ++ Fix Javadoc documentation and tags for the Java code for the project. ++See also: Where Tags Can Be Used <https://docs.oracle.com/en/java/javase/17/docs/specs/javadoc/doc-comment-spec.html#where-tags-can-be-used> ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ compile ++ org.apache.maven.plugins.javadoc.FixJavadocMojo ++ java ++ per-lookup ++ once-per-session ++ 2.6 ++ true ++ ++ ++ comparisonVersion ++ java.lang.String ++ false ++ true ++ Version to compare the current code against using the Clirr Maven Plugin <https://www.mojohaus.org/clirr-maven-plugin/>. ++See defaultSince. ++ ++ ++ defaultAuthor ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @author. ++ ++ ++ defaultSince ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @since. ++ ++ ++ defaultVersion ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @version. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ The file encoding to use when reading the source files. If the property project.build.sourceEncoding is not set, the platform default encoding is used. ++ ++ ++ excludes ++ java.lang.String ++ false ++ true ++ Comma separated excludes Java files, i.e. **/*Test.java. ++ ++ ++ fixClassComment ++ boolean ++ false ++ true ++ Flag to fix the classes or interfaces Javadoc comments according the level. ++ ++ ++ fixFieldComment ++ boolean ++ false ++ true ++ Flag to fix the fields Javadoc comments according the level. ++ ++ ++ fixMethodComment ++ boolean ++ false ++ true ++ Flag to fix the methods Javadoc comments according the level. ++ ++ ++ fixTags ++ java.lang.String ++ false ++ true ++ Comma separated tags to fix in classes, interfaces or methods Javadoc comments. Possible values are: ++* all (fix all Javadoc tags) ++* author (fix only @author tag) ++* version (fix only @version tag) ++* since (fix only @since tag) ++* param (fix only @param tag) ++* return (fix only @return tag) ++* throws (fix only @throws tag) ++* link (fix only @link tag) ++ ++ ++ force ++ boolean ++ false ++ true ++ Forcing the goal execution i.e. skip warranty messages (not recommended). ++ ++ ++ ignoreClirr ++ boolean ++ false ++ true ++ Flag to ignore or not Clirr. ++ ++ ++ includes ++ java.lang.String ++ false ++ true ++ Comma separated includes Java files, i.e. **/*Test.java. ++ ++Note: default value is **\/*.java. ++ ++ ++ level ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: private, protected, public, package options for Javadoc <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ outputDirectory ++ java.io.File ++ false ++ true ++ Output directory where Java classes will be rewritten. ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object. ++ ++ ++ removeUnknownThrows ++ boolean ++ false ++ true ++ ++Flag to remove throws tags from unknown classes. ++ ++NOTE:Since 3.1.0 the default value has been changed to true, due to JavaDoc 8 strictness. ++ ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ true ++ false ++ The current user system settings for use in Maven. ++ ++ ++ ++ ${comparisonVersion} ++ ${defaultAuthor} ++ ${defaultSince} ++ ${defaultVersion} ++ ${encoding} ++ ${excludes} ++ ${fixClassComment} ++ ${fixFieldComment} ++ ${fixMethodComment} ++ ${fixTags} ++ ${force} ++ ${ignoreClirr} ++ ${includes} ++ ${level} ++ ${outputDirectory} ++ ++ ${removeUnknownThrows} ++ ++ ++ ++ ++ ++ org.codehaus.plexus.components.interactivity.InputHandler ++ inputHandler ++ ++ ++ ++ ++ help ++ Display help information on maven-javadoc-plugin. ++Call mvn javadoc:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ false ++ false ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.maven_javadoc_plugin.HelpMojo ++ java ++ per-lookup ++ once-per-session ++ true ++ ++ ++ detail ++ boolean ++ false ++ true ++ If true, display all settable properties for each goal. ++ ++ ++ goal ++ java.lang.String ++ false ++ true ++ The name of the goal for which to show help. If unspecified, all goals will be displayed. ++ ++ ++ indentSize ++ int ++ false ++ true ++ The number of spaces per indentation level, should be positive. ++ ++ ++ lineLength ++ int ++ false ++ true ++ The maximum length of a display line, should be positive. ++ ++ ++ ++ ${detail} ++ ${goal} ++ ${indentSize} ++ ${lineLength} ++ ++ ++ ++ jar ++ Bundles the Javadoc documentation for main Java code in an NON aggregator project into a jar using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ package ++ org.apache.maven.plugins.javadoc.JavadocJarMojo ++ java ++ per-lookup ++ once-per-session ++ 2.0 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ archive ++ org.apache.maven.archiver.MavenArchiveConfiguration ++ 2.5 ++ false ++ true ++ The archive configuration to use. See Maven Archiver Reference <http://maven.apache.org/shared/maven-archiver/index.html>. ++ ++ ++ attach ++ boolean ++ false ++ true ++ Specifies whether to attach the generated artifact to the project helper. ++ ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ classifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ defaultManifestFile ++ java.io.File ++ 2.5 ++ true ++ false ++ Path to the default MANIFEST file to use. It will be used if useDefaultManifestFile is set to true. ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ true ++ Specifies the filename that will be used for the generated jar file. Please note that -javadoc or -test-javadoc will be appended to the file name. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ jarOutputDirectory ++ java.lang.String ++ false ++ true ++ Specifies the directory where the generated jar file will be put. ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useDefaultManifestFile ++ boolean ++ 2.5 ++ false ++ true ++ Set this to true to enable the use of the defaultManifestFile. ++ ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${attach} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${maven.javadoc.classifier} ++ ${debug} ++ ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ${project.build.finalName} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${project.build.directory} ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.codehaus.plexus.archiver.Archiver ++ jar ++ jarArchiver ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.apache.maven.project.MavenProjectHelper ++ projectHelper ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ javadoc ++ Generates documentation for the Java code in a NON aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++See also: Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html> ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ generate-sources ++ org.apache.maven.plugins.javadoc.JavadocReport ++ java ++ per-lookup ++ once-per-session ++ 2.0 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ javadoc-no-fork ++ Generates documentation for the Java code in an NON aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. Note that this goal does require generation of sources before site generation, e.g. by invoking mvn clean deploy site. ++See also: Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>, Javadoc Options <http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/javadoc.html#options> ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.javadoc.JavadocNoForkReport ++ java ++ per-lookup ++ once-per-session ++ 2.10 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ resource-bundle ++ Bundle javadocDirectory, along with javadoc configuration options such as taglet, doclet, and link information into a deployable artifact. This artifact can then be consumed by the javadoc plugin mojos when used by the includeDependencySources option, to generate javadocs that are somewhat consistent with those generated in the original project itself. ++ compile ++ false ++ true ++ false ++ false ++ false ++ true ++ package ++ org.apache.maven.plugins.javadoc.ResourcesBundleMojo ++ java ++ per-lookup ++ once-per-session ++ 2.7 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ false ++ Base name of artifacts produced by this project. This will be combined with getAttachmentClassifier() to produce the name for this bundle jar. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.apache.maven.project.MavenProjectHelper ++ projectHelper ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ test-aggregate ++ ++Generates documentation for the Java Test code in an aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ ++Since version 3.1.0 an aggregated report is created for every module of a Maven multimodule project. ++ ++ test ++ false ++ true ++ false ++ true ++ false ++ true ++ test-compile ++ org.apache.maven.plugins.javadoc.AggregatorTestJavadocReport ++ java ++ per-lookup ++ once-per-session ++ 2.5 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testDescription ++ description ++ java.lang.String ++ 2.5 ++ false ++ true ++ The description of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++ ++ ++ testName ++ name ++ java.lang.String ++ 2.5 ++ false ++ true ++ The name of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${testDescription} ++ ${testDoctitle} ++ ++ ${testName} ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ test-aggregate-jar ++ ++Bundles the Javadoc documentation for Java Test code in an aggregator project into a jar using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ ++Since version 3.1.0 an aggregated jar is created for every module of a Maven multimodule project. ++ ++ test ++ false ++ true ++ false ++ true ++ false ++ true ++ package ++ test-compile ++ org.apache.maven.plugins.javadoc.AggregatorTestJavadocJarMojo ++ java ++ per-lookup ++ once-per-session ++ 2.6 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ archive ++ org.apache.maven.archiver.MavenArchiveConfiguration ++ 2.5 ++ false ++ true ++ The archive configuration to use. See Maven Archiver Reference <http://maven.apache.org/shared/maven-archiver/index.html>. ++ ++ ++ attach ++ boolean ++ false ++ true ++ Specifies whether to attach the generated artifact to the project helper. ++ ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ classifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ defaultManifestFile ++ java.io.File ++ 2.5 ++ true ++ false ++ Path to the default MANIFEST file to use. It will be used if useDefaultManifestFile is set to true. ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ true ++ Specifies the filename that will be used for the generated jar file. Please note that -javadoc or -test-javadoc will be appended to the file name. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ jarOutputDirectory ++ java.lang.String ++ false ++ true ++ Specifies the directory where the generated jar file will be put. ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testClassifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useDefaultManifestFile ++ boolean ++ 2.5 ++ false ++ true ++ Set this to true to enable the use of the defaultManifestFile. ++ ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${attach} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${maven.javadoc.classifier} ++ ${debug} ++ ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ${project.build.finalName} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${project.build.directory} ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${maven.javadoc.testClassifier} ++ ${testDoctitle} ++ ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.codehaus.plexus.archiver.Archiver ++ jar ++ jarArchiver ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.apache.maven.project.MavenProjectHelper ++ projectHelper ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ test-aggregate-no-fork ++ Generates documentation for the Java Test code in an aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.javadoc.AggregatorTestJavadocNoForkReport ++ java ++ per-lookup ++ once-per-session ++ 3.0.1 ++ false ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testDescription ++ description ++ java.lang.String ++ 2.5 ++ false ++ true ++ The description of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++ ++ ++ testName ++ name ++ java.lang.String ++ 2.5 ++ false ++ true ++ The name of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${testDescription} ++ ${testDoctitle} ++ ++ ${testName} ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ test-fix ++ Fix Javadoc documentation and tags for the Test Java code for the project. ++See also: Where Tags Can Be Used <https://docs.oracle.com/en/java/javase/17/docs/specs/javadoc/doc-comment-spec.html#where-tags-can-be-used> ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ test-compile ++ org.apache.maven.plugins.javadoc.TestFixJavadocMojo ++ java ++ per-lookup ++ once-per-session ++ 2.6 ++ true ++ ++ ++ comparisonVersion ++ java.lang.String ++ false ++ true ++ Version to compare the current code against using the Clirr Maven Plugin <https://www.mojohaus.org/clirr-maven-plugin/>. ++See defaultSince. ++ ++ ++ defaultAuthor ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @author. ++ ++ ++ defaultSince ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @since. ++ ++ ++ defaultVersion ++ java.lang.String ++ false ++ true ++ Default value for the Javadoc tag @version. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ The file encoding to use when reading the source files. If the property project.build.sourceEncoding is not set, the platform default encoding is used. ++ ++ ++ excludes ++ java.lang.String ++ false ++ true ++ Comma separated excludes Java files, i.e. **/*Test.java. ++ ++ ++ fixClassComment ++ boolean ++ false ++ true ++ Flag to fix the classes or interfaces Javadoc comments according the level. ++ ++ ++ fixFieldComment ++ boolean ++ false ++ true ++ Flag to fix the fields Javadoc comments according the level. ++ ++ ++ fixMethodComment ++ boolean ++ false ++ true ++ Flag to fix the methods Javadoc comments according the level. ++ ++ ++ fixTags ++ java.lang.String ++ false ++ true ++ Comma separated tags to fix in classes, interfaces or methods Javadoc comments. Possible values are: ++* all (fix all Javadoc tags) ++* author (fix only @author tag) ++* version (fix only @version tag) ++* since (fix only @since tag) ++* param (fix only @param tag) ++* return (fix only @return tag) ++* throws (fix only @throws tag) ++* link (fix only @link tag) ++ ++ ++ force ++ boolean ++ false ++ true ++ Forcing the goal execution i.e. skip warranty messages (not recommended). ++ ++ ++ ignoreClirr ++ boolean ++ false ++ true ++ Flag to ignore or not Clirr. ++ ++ ++ includes ++ java.lang.String ++ false ++ true ++ Comma separated includes Java files, i.e. **/*Test.java. ++ ++Note: default value is **\/*.java. ++ ++ ++ level ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: private, protected, public, package options for Javadoc <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ outputDirectory ++ java.io.File ++ false ++ true ++ Output directory where Java classes will be rewritten. ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object. ++ ++ ++ removeUnknownThrows ++ boolean ++ false ++ true ++ ++Flag to remove throws tags from unknown classes. ++ ++NOTE:Since 3.1.0 the default value has been changed to true, due to JavaDoc 8 strictness. ++ ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ true ++ false ++ The current user system settings for use in Maven. ++ ++ ++ ++ ${comparisonVersion} ++ ${defaultAuthor} ++ ${defaultSince} ++ ${defaultVersion} ++ ${encoding} ++ ${excludes} ++ ${fixClassComment} ++ ${fixFieldComment} ++ ${fixMethodComment} ++ ${fixTags} ++ ${force} ++ ${ignoreClirr} ++ ${includes} ++ ${level} ++ ${outputDirectory} ++ ++ ${removeUnknownThrows} ++ ++ ++ ++ ++ ++ org.codehaus.plexus.components.interactivity.InputHandler ++ inputHandler ++ ++ ++ ++ ++ test-jar ++ Bundles the Javadoc documentation for test Java code in an NON aggregator project into a jar using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ package ++ org.apache.maven.plugins.javadoc.TestJavadocJarMojo ++ java ++ per-lookup ++ once-per-session ++ 2.5 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ archive ++ org.apache.maven.archiver.MavenArchiveConfiguration ++ 2.5 ++ false ++ true ++ The archive configuration to use. See Maven Archiver Reference <http://maven.apache.org/shared/maven-archiver/index.html>. ++ ++ ++ attach ++ boolean ++ false ++ true ++ Specifies whether to attach the generated artifact to the project helper. ++ ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ classifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ defaultManifestFile ++ java.io.File ++ 2.5 ++ true ++ false ++ Path to the default MANIFEST file to use. It will be used if useDefaultManifestFile is set to true. ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ true ++ Specifies the filename that will be used for the generated jar file. Please note that -javadoc or -test-javadoc will be appended to the file name. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ jarOutputDirectory ++ java.lang.String ++ false ++ true ++ Specifies the directory where the generated jar file will be put. ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testClassifier ++ java.lang.String ++ 2.10 ++ true ++ true ++ ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useDefaultManifestFile ++ boolean ++ 2.5 ++ false ++ true ++ Set this to true to enable the use of the defaultManifestFile. ++ ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${attach} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${maven.javadoc.classifier} ++ ${debug} ++ ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ${project.build.finalName} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${project.build.directory} ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${maven.javadoc.testClassifier} ++ ${testDoctitle} ++ ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.codehaus.plexus.archiver.Archiver ++ jar ++ jarArchiver ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.apache.maven.project.MavenProjectHelper ++ projectHelper ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ test-javadoc ++ Generates documentation for the Java Test code in an NON aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. ++See also: Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html> ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ generate-test-sources ++ org.apache.maven.plugins.javadoc.TestJavadocReport ++ java ++ per-lookup ++ once-per-session ++ 2.3 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testDescription ++ description ++ java.lang.String ++ 2.5 ++ false ++ true ++ The description of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++ ++ ++ testName ++ name ++ java.lang.String ++ 2.5 ++ false ++ true ++ The name of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${testDescription} ++ ${testDoctitle} ++ ++ ${testName} ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ test-javadoc-no-fork ++ Generates documentation for the Java Test code in an NON aggregator project using the standard Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>. Note that this goal does require generation of test sources before site generation, e.g. by invoking mvn clean deploy site. ++See also: Javadoc Tool <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html>, Javadoc Options <http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/javadoc.html#options> ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ org.apache.maven.plugins.javadoc.TestJavadocNoForkReport ++ java ++ per-lookup ++ once-per-session ++ 2.10 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ description ++ java.lang.String ++ 2.1 ++ false ++ true ++ The description of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ name ++ java.lang.String ++ 2.1 ++ false ++ true ++ The name of the Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testDescription ++ description ++ java.lang.String ++ 2.5 ++ false ++ true ++ The description of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testDoctitle ++ doctitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ 2.5 ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++ ++ ++ testName ++ name ++ java.lang.String ++ 2.5 ++ false ++ true ++ The name of the Test Javadoc report to be displayed in the Maven Generated Reports page (i.e. project-reports.html). ++ ++ ++ testOverview ++ overview ++ java.io.File ++ 2.5 ++ false ++ true ++ 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). ++See also: Doclet option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testWindowtitle ++ windowtitle ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the Test title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${description} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${name} ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ${testDescription} ++ ${testDoctitle} ++ ++ ${testName} ++ ${testOverview} ++ ${testWindowtitle} ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ test-resource-bundle ++ Bundle TestJavadocJarMojo.testJavadocDirectory, along with javadoc configuration options from such as taglet, doclet, and link information into a deployable artifact. This artifact can then be consumed by the javadoc plugin mojos when used by the includeDependencySources option, to generate javadocs that are somewhat consistent with those generated in the original project itself. ++ test ++ false ++ true ++ false ++ false ++ false ++ true ++ package ++ org.apache.maven.plugins.javadoc.TestResourcesBundleMojo ++ java ++ per-lookup ++ once-per-session ++ 2.7 ++ true ++ ++ ++ addStylesheets ++ java.lang.String[] ++ 3.3.0 ++ false ++ true ++ Specifies the path of an additional HTML stylesheet file relative to the javadocDirectory Example: <addStylesheets> <addStylesheet>resources/addstylesheet.css</addStylesheet> </addStylesheets> ++ ++ ++ additionalDependencies ++ java.util.List ++ 2.8.1 ++ false ++ true ++ Capability to add additional dependencies to the javadoc classpath. Example: <additionalDependencies> <additionalDependency> <groupId>geronimo-spec</groupId> <artifactId>geronimo-spec-jta</artifactId> <version>1.0.1B-rc4</version> </additionalDependency> </additionalDependencies> ++ ++ ++ additionalJOption ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets additional Javadoc options (e.g. JVM options) on the command line. Example: <additionalJOption>-J-Xss128m</additionalJOption> ++See also: Javadoc Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>, VM Options <https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#overview-of-java-options>, Networking Properties <https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/net/doc-files/net-properties.html> ++ ++ ++ additionalJOptions ++ java.lang.String[] ++ 2.9 ++ false ++ true ++ Sets additional Javadoc options for the execution of the javadoc command via the '-J' option to javadoc. Example: <additionalJOptions> <additionalJOption>-J-Xmx1g </additionalJOption> </additionalJOptions> ++See also: additionalJOption ++ ++ ++ additionalOptions ++ java.lang.String[] ++ 3.0.0 ++ false ++ true ++ Set an additional option(s) on the command line. All input will be passed as-is to the @options file. You must take care of quoting and escaping. Useful for a custom doclet. ++ ++ ++ applyJavadocSecurityFix ++ boolean ++ 2.9.1 ++ false ++ true ++ To apply a security fix on generated javadoc, see ++ ++ ++ author ++ boolean ++ false ++ true ++ Specifies whether or not the author text is included in the generated Javadocs. ++See also: Doclet option author <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ bootclasspath ++ java.lang.String ++ 2.5 ++ false ++ true ++ Specifies the paths where the boot classes reside. The bootclasspath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path>. ++ ++ ++ bootclasspathArtifacts ++ org.apache.maven.plugins.javadoc.options.BootclasspathArtifact[] ++ 2.5 ++ false ++ true ++ Specifies the artifacts where the boot classes reside. ++Example: <bootclasspathArtifacts> <bootclasspathArtifact> <groupId>my-groupId</groupId> <artifactId>my-artifactId</artifactId> <version>my-version</version> </bootclasspathArtifact> </bootclasspathArtifacts> ++See Javadoc. ++See also: Javadoc option bootclasspath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-boot-class-path> ++ ++ ++ bottom ++ java.lang.String ++ false ++ true ++ Specifies the text to be placed at the bottom of each output file. ++If you want to use html, you have to put it in a CDATA section, ++e.g. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]> ++Note:If the project has the property project.build.outputTimestamp, its year will be used as {currentYear}. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option bottom <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ breakiterator ++ boolean ++ false ++ true ++ Uses the sentence break iterator to determine the end of the first sentence. ++See also: Javadoc option breakiterator <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ charset ++ java.lang.String ++ false ++ true ++ Specifies the HTML character set for this document. If not specified, the charset value will be the value of the docencoding parameter. ++See also: Doclet option charset <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ debug ++ boolean ++ 2.1 ++ false ++ true ++ Set this to true to debug the Javadoc plugin. With this, javadoc.bat(or.sh), options, @packages or argfile files are provided in the output directory. ++ ++ ++ ++ dependencyLinks ++ java.util.List ++ 3.3.0 ++ false ++ true ++ Redefine the apidoc URL for specific dependencies when using detectLinks. Useful if the dependency wasn't build with Maven or when the apidocs have been moved. <dependencyLinks> <dependencyLink> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <classifier>classifier</classifier> <!-- optional --> <url>version</url> </dependencyLink> </dependencyLinks> ++See also: detectLinks ++ ++ ++ dependencySourceExcludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of excluded dependency-source patterns. Example: org.apache.maven.shared:* ++See also: includeDependencySources ++ ++ ++ dependencySourceIncludes ++ java.util.List ++ 2.7 ++ false ++ true ++ List of included dependency-source patterns. Example: org.apache.maven:* ++See also: includeDependencySources ++ ++ ++ detectJavaApiLink ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Java API link for the current build, e.g. https://docs.oracle.com/javase/1.4.2/docs/api/ for Java source 1.4. ++By default, the goal detects the Javadoc API link depending the value of the source parameter in the org.apache.maven.plugins:maven-compiler-plugin (defined in ${project.build.plugins} or in ${project.build.pluginManagement}), or try to compute it from the javadocExecutable version. ++See also: links, javaApiLinks ++ ++ ++ detectLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the Javadoc links for all dependencies defined in the project. The detection is based on the default Maven conventions, i.e.: ${project.url}/apidocs. ++For instance, if the project has a dependency to Apache Commons Lang <http://commons.apache.org/lang/> i.e.: <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> </dependency> The added Javadoc -link parameter will be http://commons.apache.org/lang/apidocs. ++See also: links, dependencyLinks ++ ++ ++ detectOfflineLinks ++ boolean ++ 2.6 ++ false ++ true ++ Detect the links for all modules defined in the project. ++If reactorProjects is defined in a non-aggregator way, it generates default offline links between modules based on the defined project's urls. For instance, if a parent project has two projects module1 and module2, the -linkoffline will be: ++The added Javadoc -linkoffline parameter for module1 will be /absolute/path/to/module2/target/site/apidocs ++The added Javadoc -linkoffline parameter for module2 will be /absolute/path/to/module1/target/site/apidocs ++See also: offlineLinks ++ ++ ++ docencoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding of the generated HTML files. If not specified, the docencoding value will be UTF-8. ++See also: Doclet option docencoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ docfilessubdirs ++ boolean ++ false ++ true ++ Enables deep copying of the **/doc-files directories and the specifc resources directory from the javadocDirectory directory (for instance, src/main/javadoc/com/mycompany/myapp/doc-files and src/main/javadoc/resources). ++See also: Doclet option docfilessubdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., excludedocfilessubdir, javadocDirectory ++ ++ ++ doclet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the doclet used in generating the documentation. ++See also: Javadoc option doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifact ++ org.apache.maven.plugins.javadoc.options.DocletArtifact ++ false ++ true ++ Specifies the artifact containing the doclet starting class file (specified with the doclet option). ++Example: <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletArtifacts ++ org.apache.maven.plugins.javadoc.options.DocletArtifact[] ++ 2.1 ++ false ++ true ++ Specifies multiple artifacts containing the path for the doclet starting class file (specified with the doclet option). ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> ++See Javadoc. ++ ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ docletPath ++ java.lang.String ++ false ++ true ++ Specifies the path to the doclet starting class file (specified with the doclet option) and any jar files it depends on. The docletPath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option docletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ doclint ++ java.lang.String ++ 3.0.0 ++ false ++ true ++ Specifies specific checks to be performed on Javadoc comments. ++See also: Additional Doclet option Xdoclint <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet>. ++ ++ ++ doctitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed near the top of the overview summary file. ++See also: Doclet option doctitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ encoding ++ java.lang.String ++ false ++ true ++ Specifies the encoding name of the source files. If not specified, the encoding value will be the value of the file.encoding system property. ++Note: In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5. ++See also: Javadoc option encoding <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-encoding>. ++ ++ ++ excludePackageNames ++ java.lang.String ++ false ++ true ++ Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by commas (,), colons (:) or semicolons (;). ++Wildcards work as followed: ++ ++* a wildcard at the beginning should match one or more directories ++* any other wildcard must match exactly one directory ++ ++Example: <excludePackageNames>*.internal:org.acme.exclude1.*:org.acme.exclude2</excludePackageNames> ++See also: Javadoc option exclude <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ excludedocfilessubdir ++ java.lang.String ++ false ++ true ++ Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:). ++See also: Doclet option excludedocfilessubdir <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., docfilessubdirs ++ ++ ++ extdirs ++ java.lang.String ++ false ++ true ++ Specifies the directories where extension classes reside. Separate directories in extdirs with a colon (:) or a semicolon (;). ++See also: Javadoc option extdirs <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-extdirs>. ++ ++ ++ failOnError ++ boolean ++ 2.5 ++ false ++ true ++ Specifies if the build will fail if there are errors during javadoc execution or not. ++ ++ ++ failOnWarnings ++ boolean ++ 3.0.1 ++ false ++ true ++ Specifies if the build will fail if there are warning during javadoc execution or not. ++ ++ ++ finalName ++ java.lang.String ++ false ++ false ++ Base name of artifacts produced by this project. This will be combined with getAttachmentClassifier() to produce the name for this bundle jar. ++ ++ ++ footer ++ java.lang.String ++ false ++ true ++ Specifies the footer text to be placed at the bottom of each output file. ++See also: Doclet option footer <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ forceRootLocale ++ boolean ++ 3.8.0 ++ false ++ true ++ Forces the Javadoc JVM locale to be java.util.Locale.ROOT. This will force the Javadoc output on stdout and stderr to be in English only and the generated HTML content in English as well. If you need the generated HTML content in another supported language use locale. ++ ++ ++ groups ++ org.apache.maven.plugins.javadoc.options.Group[] ++ false ++ true ++ Separates packages on the overview page into whatever groups you specify, one group per table. The packages pattern can be any package name, or can be the start of any package name followed by an asterisk (*) meaning "match any characters". Multiple patterns can be included in a group by separating them with colons (:). ++Example: <groups> <group> <title>Core Packages</title> <!-- To includes java.lang, java.lang.ref, java.lang.reflect and only java.util (i.e. not java.util.jar) --> <packages>java.lang*:java.util</packages> </group> <group> <title>Extension Packages</title> <!-- To include javax.accessibility, javax.crypto, ... (among others) --> <packages>javax.*</packages> </group> </groups> Note: using java.lang.* for packages would omit the java.lang package but using java.lang* will include it. ++See also: Doclet option group <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>., org.apache.maven.plugins.javadoc.options.Group ++ ++ ++ header ++ java.lang.String ++ false ++ true ++ Specifies the header text to be placed at the top of each output file. ++See also: Doclet option header <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ helpfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate help file path\filename that the HELP link in the top and bottom navigation bars link to. ++Note: could be in conflict with <nohelp/>. ++The helpfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> Where path/to/your/resource/yourhelp-doc.html could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <helpfile>path/to/your/resource/yourhelp-doc.html</helpfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourhelp-doc.html is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option helpfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ includeDependencySources ++ boolean ++ 2.7 ++ false ++ true ++ Whether dependency -sources jars should be resolved and included as source paths for javadoc generation. This is useful when creating javadocs for a distribution project. ++ ++ ++ includeTransitiveDependencySources ++ boolean ++ 2.7 ++ if these sources depend on transitive dependencies, those dependencies should be added to the pom as direct dependencies ++ false ++ true ++ Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc run. ++See also: includeDependencySources ++ ++ ++ javaApiLinks ++ java.util.Properties ++ 2.6 ++ false ++ true ++ Use this parameter only if if you want to override the default URLs. The key should match api_x, where x matches the Java version. For example: api_1.5 ++https://docs.oracle.com/javase/1.5.0/docs/api/ ++api_1.8 ++ ++https://docs.oracle.com/javase/8/docs/api/ ++api_9 ++https://docs.oracle.com/javase/9/docs/api/ ++ ++ ++ ++ javadocDirectory ++ java.io.File ++ 2.1 ++ false ++ true ++ Specifies the Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++Could be used in addition of docfilessubdirs parameter. ++See docfilessubdirs. ++See also: docfilessubdirs ++ ++ ++ javadocExecutable ++ java.lang.String ++ 2.3 ++ false ++ true ++ Sets the absolute path of the Javadoc Tool executable to use. Since version 2.5, a mere directory specification is sufficient to have the plugin use "javadoc" or "javadoc.exe" respectively from this directory. ++ ++ ++ javadocOptionsDir ++ java.io.File ++ 2.7 ++ false ++ false ++ Directory into which assembled org.apache.maven.plugins.javadoc.options.JavadocOptions instances will be written before they are added to javadoc resources bundles. ++ ++ ++ javadocVersion ++ java.lang.String ++ 2.3 ++ false ++ true ++ Version of the Javadoc Tool executable to use, ex. "1.3", "1.5". ++ ++ ++ jdkToolchain ++ java.util.Map ++ 3.0.0 ++ false ++ true ++ ++Allow for configuration of the javadoc tool via maven toolchains. This overrules the toolchain selected by the maven-toolchain-plugin. ++ ++Examples: ++(see Guide to Toolchains <https://maven.apache.org/guides/mini/guide-using-toolchains.html> for more info) <configuration> ... <jdkToolchain> <version>11</version> </jdkToolchain> </configuration> <configuration> ... <jdkToolchain> <version>1.8</version> <vendor>zulu</vendor> </jdkToolchain> </configuration> note: requires at least Maven 3.3.1 ++ ++ ++ keywords ++ boolean ++ 2.1 ++ false ++ true ++ Adds HTML meta keyword tags to the generated file for each class. ++See also: Doclet option keywords <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ legacyMode ++ boolean ++ 3.6.0 ++ false ++ true ++ Run the javadoc tool in pre-Java 9 (non-modular) style even if the java version is post java 9. This allows non-JPMS projects that have moved to newer Java versions to create javadocs without having to use JPMS modules. ++ ++ ++ links ++ java.util.ArrayList ++ false ++ true ++ Creates links to existing javadoc-generated documentation of external referenced classes. ++Notes: ++ ++* This option is ignored if the plugin is run in offline mode (using the <offline> setting or specifying -o, --offline or -Dmaven.javadoc.offline=true on the command line. ++* all given links should have a fetchable /package-list or /element-list (since Java 10). For instance: <links> <link>https://docs.oracle.com/en/java/javase/17/docs/api</link> <links> will be used because https://docs.oracle.com/en/java/javase/17/docs/api/element-list exists. ++* If detectLinks is defined, the links between the project dependencies are automatically added. ++* If detectJavaApiLink is defined, a Java API link, based on the Java version of the project's sources, will be added automatically. ++See also: Doclet option link <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ linksource ++ boolean ++ false ++ true ++ Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation. ++See also: Doclet option linksource/a>. ++<https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ locale ++ java.lang.String ++ false ++ true ++ Specifies the locale that javadoc uses when generating documentation. ++See also: Javadoc option locale <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ maxmemory ++ java.lang.String ++ false ++ true ++ Specifies the maximum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xmx parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ minmemory ++ java.lang.String ++ false ++ true ++ Specifies the minimum Java heap size to be used when launching the Javadoc tool. JVMs refer to this property as the -Xms parameter. Example: '512' or '512m'. The memory unit depends on the JVM used. The units supported could be: k, kb, m, mb, g, gb, t, tb. If no unit specified, the default unit is m. ++ ++ ++ mojoExecution ++ org.apache.maven.plugin.MojoExecution ++ true ++ false ++ ++ ++ ++ nocomment ++ boolean ++ false ++ true ++ Suppress the entire comment body, including the main description and all tags, generating only declarations. ++See also: Doclet option nocomment <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nodeprecated ++ boolean ++ false ++ true ++ Prevents the generation of any deprecated API at all in the documentation. ++See also: Doclet option nodeprecated <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ nodeprecatedlist ++ boolean ++ false ++ true ++ 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. ++See also: Doclet option nodeprecatedlist <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nohelp ++ boolean ++ false ++ true ++ Omits the HELP link in the navigation bars at the top and bottom of each page of output. ++Note: could be in conflict with helpfile. ++See also: Doclet option nohelp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ noindex ++ boolean ++ false ++ true ++ Omits the index from the generated docs. ++Note: could be in conflict with splitindex ++See also: Doclet option noindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nonavbar ++ boolean ++ false ++ true ++ Omits the navigation bar from the generated docs. ++See also: Doclet option nonavbar <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nooverview ++ boolean ++ 2.4 ++ false ++ true ++ Omits the entire overview page from the generated docs. ++Note: could be in conflict with overview. ++Standard Doclet undocumented option. ++ ++ ++ ++ noqualifier ++ java.lang.String ++ false ++ true ++ Omits qualifying package name from ahead of class names in output. Example: <noqualifier>all</noqualifier> or <noqualifier>packagename1:packagename2</noqualifier> ++See also: Doclet option noqualifier <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ nosince ++ boolean ++ false ++ true ++ Omits from the generated docs the "Since" sections associated with the since tags. ++See also: Doclet option nosince <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notimestamp ++ boolean ++ 2.1 ++ false ++ true ++ Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page. ++ ++Note: If the project has the property project.build.outputTimestamp, the value will be overwritten to true. This way it is possible to generate reproducible javadoc jars. ++See also: Doclet option notimestamp <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ notree ++ boolean ++ false ++ true ++ Omits the class/interface hierarchy pages from the generated docs. ++See also: Doclet option notree <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ offline ++ boolean ++ 3.6.0 ++ false ++ true ++ Specify if the Javadoc plugin should operate in offline mode. If maven is run in offline mode (using -o or --offline on the command line), this option has no effect and the plugin is always in offline mode. ++ ++ ++ offlineLinks ++ org.apache.maven.plugins.javadoc.options.OfflineLink[] ++ false ++ true ++ This option is a variation of links; they both create links to javadoc-generated documentation for external referenced classes. ++Example: <offlineLinks> <offlineLink> <url>https://docs.oracle.com/javase/1.5.0/docs/api/</url> <location>../javadoc/jdk-5.0/</location> </offlineLink> </offlineLinks> ++Note: if detectOfflineLinks is defined, the offline links between the project modules are automatically added if the goal is calling in a non-aggregator way. ++See also: org.apache.maven.plugins.javadoc.options.OfflineLink, Doclet option linkoffline <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ old ++ boolean ++ No reason given ++ false ++ true ++ This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1. This is no longer supported since Javadoc 1.4 (shipped with JDK 1.4) ++See also: Javadoc option 1.1 <https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#a1.1>. ++ ++ ++ outputDirectory ++ java.io.File ++ true ++ true ++ The shared output directory for the report where Javadoc saves the generated HTML files. Note that this parameter is only evaluated if the goal is run directly from the command line. If the goal is run indirectly as part of a site generation, the shared output directory configured in the Maven Site Plugin <https://maven.apache.org/plugins/maven-site-plugin/site-mojo.html#outputDirectory> is used instead. ++See also: org.apache.maven.reporting.AbstractMavenReport.outputDirectory, Doclet option d <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#additional-options-provided-by-the-standard-doclet> ++ ++ ++ outputTimestamp ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH <https://reproducible-builds.org/docs/source-date-epoch/>). ++ ++ ++ overview ++ java.io.File ++ false ++ true ++ 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). ++Note: could be in conflict with nooverview. ++See also: Javadoc option overview <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ packagesheader ++ java.lang.String ++ 2.1 ++ false ++ true ++ Specify the text for upper left frame. ++See also: Bug Report about missing documentation <https://bugs.openjdk.org/browse/JDK-4770521> ++ ++ ++ project ++ org.apache.maven.project.MavenProject ++ true ++ false ++ The Maven Project Object ++ ++ ++ quiet ++ boolean ++ false ++ true ++ Shuts off non-error and non-warning messages, leaving only the warnings and errors appear, making them easier to view. ++Note: was a standard doclet in Java 1.4.2 (refer to bug ID 4714350 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4714350>). ++Since Java 5.0. ++See also: Javadoc option quiet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ reactorProjects ++ java.util.List ++ true ++ false ++ The projects in the reactor for aggregation report. ++ ++ ++ release ++ java.lang.String ++ JDK 9 ++ false ++ true ++ Provide source compatibility with specified release ++See also: Javadoc option release <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-release>. ++ ++ ++ repoSession ++ org.eclipse.aether.RepositorySystemSession ++ true ++ false ++ ++ ++ ++ resourcesArtifacts ++ org.apache.maven.plugins.javadoc.options.ResourcesArtifact[] ++ 2.5 ++ false ++ true ++ A list of artifacts containing resources which should be copied into the Javadoc output directory (like stylesheets, icons, etc.). ++Example: <resourcesArtifacts> <resourcesArtifact> <groupId>external.group.id</groupId> <artifactId>external-resources</artifactId> <version>1.0</version> </resourcesArtifact> </resourcesArtifacts> ++See Javadoc. ++ ++ ++ ++ serialwarn ++ boolean ++ false ++ true ++ Generates compile-time warnings for missing serial tags. ++See also: Doclet option serialwarn <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ session ++ org.apache.maven.execution.MavenSession ++ true ++ false ++ The current build session instance. This is used for toolchain manager API calls. ++ ++ ++ settings ++ org.apache.maven.settings.Settings ++ 2.3 ++ true ++ false ++ The Maven Settings. ++ ++ ++ show ++ java.lang.String ++ false ++ true ++ Specifies the access level for classes and members to show in the Javadocs. Possible values are: ++* public (shows only public classes and members) ++* protected (shows only public and protected classes and members) ++* package (shows all classes and members not marked private) ++* private (shows all classes and members) ++See also: Javadoc options private, protected, public and package <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc> ++ ++ ++ skip ++ boolean ++ 2.5 ++ false ++ true ++ Specifies whether the Javadoc generation should be skipped. ++ ++ ++ skippedModules ++ java.lang.String ++ 3.2.0 ++ false ++ true ++ ++Comma separated list of modules (artifactId) to not add in aggregated javadoc ++ ++ ++ ++ source ++ java.lang.String ++ false ++ true ++ Provide source compatibility with specified release. Since JDK 9 rather use release. ++See also: Javadoc option source <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source>. ++ ++ ++ sourceDependencyCacheDir ++ java.io.File ++ 2.7 ++ false ++ true ++ Directory where unpacked project sources / test-sources should be cached. ++See also: includeDependencySources ++ ++ ++ sourceFileExcludes ++ java.util.List ++ 2.9 ++ false ++ true ++ exclude filters on the source files. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourceFileIncludes ++ java.util.List ++ 2.9 ++ false ++ true ++ Include filters on the source files. Default is **\/\*.java. These are ignored if you specify subpackages or subpackage excludes. ++ ++ ++ sourcepath ++ java.lang.String ++ false ++ true ++ Specifies the source paths where the subpackages are located. The sourcepath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Javadoc option sourcepath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javac.html#option-source-path>. ++ ++ ++ sourcetab ++ linksourcetab ++ int ++ 2.1 ++ false ++ true ++ Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used. ++See also: Doclet option sourcetab <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ splitindex ++ boolean ++ false ++ true ++ 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. ++Note: could be in conflict with noindex. ++See also: Doclet option splitindex <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ staleDataPath ++ java.io.File ++ 3.2.0 ++ false ++ true ++ ++Location of the file used to store the state of the previous javadoc run. This is used to skip the generation if nothing has changed. ++ ++ ++ ++ stylesheet ++ java.lang.String ++ This is no longer evaluated, instead use addStylesheets to customize the CSS. ++ false ++ true ++ Specifies whether the stylesheet to be used is the maven's javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. ++Possible values: maven or java. ++ ++ ++ stylesheetfile ++ java.lang.String ++ false ++ true ++ Specifies the path of an alternate HTML stylesheet file. ++The stylesheetfile could be an absolute File path. ++Since 2.6, it could be also be a path from a resource in the current project source directories (i.e. src/main/java, src/main/resources or src/main/javadoc) or from a resource in the Javadoc plugin dependencies, for instance: <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> Where path/to/your/resource/yourstylesheet.css could be in src/main/javadoc. <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <configuration> <stylesheetfile>path/to/your/resource/yourstylesheet.css</stylesheetfile> ... </configuration> <dependencies> <dependency> <groupId>groupId</groupId> <artifactId>artifactId</artifactId> <version>version</version> </dependency> </dependencies> </plugin> ... <plugins> </build> Where path/to/your/resource/yourstylesheet.css is defined in the groupId:artifactId:version javadoc plugin dependency. ++See also: Doclet option stylesheetfile <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ subpackages ++ java.lang.String ++ false ++ true ++ Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:). ++See also: Javadoc option subpackages <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ taglet ++ java.lang.String ++ false ++ true ++ Specifies the class file that starts the taglet used in generating the documentation for that tag. ++See also: Doclet option taglet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifact ++ org.apache.maven.plugins.javadoc.options.TagletArtifact ++ 2.1 ++ false ++ true ++ Specifies the Taglet artifact containing the taglet class files (.class). ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> </taglet> <taglet> <tagletClass>package.to.AnotherTagletClass</tagletClass> </taglet> ... </taglets> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ++See Javadoc. ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ tagletArtifacts ++ org.apache.maven.plugins.javadoc.options.TagletArtifact[] ++ 2.5 ++ false ++ true ++ 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. ++Example: <tagletArtifacts> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> ... </tagletArtifacts> ++See Javadoc. ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tagletpath ++ java.lang.String ++ false ++ true ++ Specifies the search paths for finding taglet class files (.class). The tagletpath can contain multiple paths by separating them with a colon (:) or a semicolon (;). ++See also: Doclet option tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ taglets ++ org.apache.maven.plugins.javadoc.options.Taglet[] ++ 2.1 ++ false ++ true ++ Enables the Javadoc tool to interpret multiple taglets. ++Example: <taglets> <taglet> <tagletClass>com.sun.tools.doclets.ToDoTaglet</tagletClass> <!--<tagletpath>/home/taglets</tagletpath>--> <tagletArtifact> <groupId>group-Taglet</groupId> <artifactId>artifact-Taglet</artifactId> <version>version-Taglet</version> </tagletArtifact> </taglet> </taglets> ++See Javadoc. ++ ++See also: Doclet options taglet and tagletpath <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> ++ ++ ++ tags ++ org.apache.maven.plugins.javadoc.options.Tag[] ++ false ++ true ++ Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments. ++Example: <tags> <tag> <name>todo</name> <placement>a</placement> <head>To Do:</head> </tag> </tags> Note: the placement should be a combinaison of Xaoptcmf letters: ++* X (disable tag) ++* a (all) ++* o (overview) ++* p (packages) ++* t (types, that is classes and interfaces) ++* c (constructors) ++* m (methods) ++* f (fields) See Javadoc. ++See also: Doclet option tag <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ testJavadocDirectory ++ javadocDirectory ++ java.io.File ++ false ++ true ++ Specifies the Test Javadoc resources directory to be included in the Javadoc (i.e. package.html, images...). ++ ++ ++ top ++ java.lang.String ++ 2.4 ++ false ++ true ++ Specifies the top text to be placed at the top of each output file. ++See also: Java Bug 6227616 <https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6227616>., Doclet option top <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ use ++ boolean ++ false ++ true ++ Includes one "Use" page for each documented class and package. ++See also: Doclet option use <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ useStandardDocletOptions ++ boolean ++ 2.5 ++ false ++ true ++ Specifies to use the options provided by the Standard Doclet <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options> for a custom doclet. ++Example: <docletArtifacts> <docletArtifact> <groupId>com.sun.tools.doclets</groupId> <artifactId>doccheck</artifactId> <version>1.2b2</version> </docletArtifact> </docletArtifacts> <useStandardDocletOptions>true</useStandardDocletOptions> ++ ++ ++ validateLinks ++ boolean ++ 2.8 ++ false ++ true ++ Flag controlling content validation of package-list/element-list resources. If set, the content of package-list/element-list resources will be validated. ++ ++ ++ verbose ++ boolean ++ false ++ true ++ Provides more detailed messages while javadoc is running. ++See also: Javadoc option verbose <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#options-for-javadoc>. ++ ++ ++ version ++ boolean ++ false ++ true ++ Includes the given version text in the generated docs. ++See also: Doclet option version <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ windowtitle ++ java.lang.String ++ false ++ true ++ Specifies the title to be placed in the HTML title tag. ++See also: Doclet option windowtitle <https://docs.oracle.com/en/java/javase/17/docs/specs/man/javadoc.html#standard-doclet-options>. ++ ++ ++ ++ ${additionalJOption} ++ ${maven.javadoc.applyJavadocSecurityFix} ++ ${author} ++ ${bootclasspath} ++ ${bootclasspathArtifacts} ++ ${bottom} ++ ${breakiterator} ++ ${charset} ++ ${debug} ++ ${detectJavaApiLink} ++ ${detectLinks} ++ ${detectOfflineLinks} ++ ${docencoding} ++ ${docfilessubdirs} ++ ${doclet} ++ ${docletArtifact} ++ ${docletArtifacts} ++ ${docletPath} ++ ${doclint} ++ ${doctitle} ++ ${encoding} ++ ${excludePackageNames} ++ ${excludedocfilessubdir} ++ ${extdirs} ++ ${maven.javadoc.failOnError} ++ ${maven.javadoc.failOnWarnings} ++ ++
${footer}
++ ${forceRootLocale} ++
${header}
++ ${helpfile} ++ ++ ++ ${javaApiLinks} ++ ++ ${javadocExecutable} ++ ++ ${javadocVersion} ++ ${keywords} ++ ${legacyMode} ++ ${links} ++ ${linksource} ++ ${locale} ++ ${maxmemory} ++ ${minmemory} ++ ++ ${nocomment} ++ ${nodeprecated} ++ ${nodeprecatedlist} ++ ${nohelp} ++ ${noindex} ++ ${nonavbar} ++ ${nooverview} ++ ${noqualifier} ++ ${nosince} ++ ${notimestamp} ++ ${notree} ++ ${maven.javadoc.offline} ++ ${offlineLinks} ++ ${old} ++ ++ ++ ${overview} ++ ${packagesheader} ++ ++ ${quiet} ++ ++ ++ ++ ${resourcesArtifacts} ++ ${serialwarn} ++ ++ ++ ${show} ++ ${maven.javadoc.skip} ++ ${maven.javadoc.skippedModules} ++ ${source} ++ ++ ${sourcepath} ++ ${sourcetab} ++ ${splitindex} ++ ${staleDataPath} ++ ${stylesheet} ++ ${stylesheetfile} ++ ${subpackages} ++ ${taglet} ++ ${tagletArtifact} ++ ${tagletArtifacts} ++ ${tagletpath} ++ ${taglets} ++ ${tags} ++ ++ ${top} ++ ${use} ++ ${useStandardDocletOptions} ++ ${validateLinks} ++ ${verbose} ++ ${version} ++ ${windowtitle} ++ ++ ++ ++ org.codehaus.plexus.archiver.manager.ArchiverManager ++ archiverManager ++ ++ ++ org.apache.maven.artifact.handler.manager.ArtifactHandlerManager ++ artifactHandlerManager ++ ++ ++ org.apache.maven.project.ProjectBuilder ++ mavenProjectBuilder ++ ++ ++ org.apache.maven.project.MavenProjectHelper ++ projectHelper ++ ++ ++ org.eclipse.aether.RepositorySystem ++ repoSystem ++ ++ ++ org.apache.maven.plugins.javadoc.resolver.ResourceResolver ++ resourceResolver ++ ++ ++ org.apache.maven.doxia.tools.SiteTool ++ siteTool ++ ++ ++ org.apache.maven.toolchain.ToolchainManager ++ toolchainManager ++ ++ ++ ++ ++ ++ ++ org.eclipse.sisu ++ org.eclipse.sisu.plexus ++ jar ++ 0.9.0.M3 ++ ++ ++ org.slf4j ++ slf4j-api ++ jar ++ 1.7.36 ++ ++ ++ org.codehaus.plexus ++ plexus-classworlds ++ jar ++ 2.8.0 ++ ++ ++ org.codehaus.plexus ++ plexus-component-annotations ++ jar ++ 2.1.0 ++ ++ ++ org.eclipse.sisu ++ org.eclipse.sisu.inject ++ jar ++ 0.9.0.M3 ++ ++ ++ org.codehaus.plexus ++ plexus-interpolation ++ jar ++ 1.27 ++ ++ ++ org.apache.maven.resolver ++ maven-resolver-util ++ jar ++ 1.4.1 ++ ++ ++ javax.inject ++ javax.inject ++ jar ++ 1 ++ ++ ++ org.apache.maven.reporting ++ maven-reporting-api ++ jar ++ 4.0.0 ++ ++ ++ org.apache.maven.doxia ++ doxia-core ++ jar ++ 2.0.0 ++ ++ ++ org.apache.maven.doxia ++ doxia-site-model ++ jar ++ 2.0.0 ++ ++ ++ org.apache.maven ++ maven-archiver ++ jar ++ 3.6.2 ++ ++ ++ org.apache.maven.shared ++ maven-invoker ++ jar ++ 3.3.0 ++ ++ ++ org.apache.maven.shared ++ maven-shared-utils ++ jar ++ 3.4.2 ++ ++ ++ org.apache.maven.shared ++ maven-common-artifact-filters ++ jar ++ 3.4.0 ++ ++ ++ org.apache.maven.doxia ++ doxia-sink-api ++ jar ++ 2.0.0 ++ ++ ++ org.apache.maven.doxia ++ doxia-site-renderer ++ jar ++ 2.0.0 ++ ++ ++ org.apache.maven.doxia ++ doxia-skin-model ++ jar ++ 2.0.0 ++ ++ ++ org.apache.velocity ++ velocity-engine-core ++ jar ++ 2.4 ++ ++ ++ org.codehaus.plexus ++ plexus-velocity ++ jar ++ 2.2.0 ++ ++ ++ org.apache.maven.doxia ++ doxia-module-xhtml5 ++ jar ++ 2.0.0 ++ ++ ++ org.apache.maven.doxia ++ doxia-integration-tools ++ jar ++ 2.0.0 ++ ++ ++ org.codehaus.plexus ++ plexus-i18n ++ jar ++ 1.0-beta-10 ++ ++ ++ org.apache.maven.wagon ++ wagon-provider-api ++ jar ++ 3.5.3 ++ ++ ++ org.apache.commons ++ commons-lang3 ++ jar ++ 3.17.0 ++ ++ ++ org.apache.commons ++ commons-text ++ jar ++ 1.12.0 ++ ++ ++ org.apache.httpcomponents ++ httpclient ++ jar ++ 4.5.14 ++ ++ ++ commons-logging ++ commons-logging ++ jar ++ 1.2 ++ ++ ++ commons-codec ++ commons-codec ++ jar ++ 1.11 ++ ++ ++ org.apache.httpcomponents ++ httpcore ++ jar ++ 4.4.16 ++ ++ ++ com.thoughtworks.qdox ++ qdox ++ jar ++ 2.1.0 ++ ++ ++ org.codehaus.plexus ++ plexus-java ++ jar ++ 1.3.0 ++ ++ ++ org.ow2.asm ++ asm ++ jar ++ 9.6 ++ ++ ++ org.codehaus.plexus ++ plexus-utils ++ jar ++ 4.0.2 ++ ++ ++ org.codehaus.plexus ++ plexus-xml ++ jar ++ 3.0.1 ++ ++ ++ org.codehaus.plexus ++ plexus-io ++ jar ++ 3.5.1 ++ ++ ++ org.codehaus.plexus ++ plexus-archiver ++ jar ++ 4.10.0 ++ ++ ++ org.tukaani ++ xz ++ jar ++ 1.9 ++ ++ ++ org.apache.commons ++ commons-compress ++ jar ++ 1.26.2 ++ ++ ++ commons-io ++ commons-io ++ jar ++ 2.17.0 ++ ++ ++ org.codehaus.plexus ++ plexus-interactivity-api ++ jar ++ 1.3 ++ ++ ++ +--- a/src/main/java/org/apache/maven/plugins/maven_javadoc_plugin/HelpMojo.java 1970-01-01 01:00:00.000000000 +0100 ++++ b/src/main/java/org/apache/maven/plugins/maven_javadoc_plugin/HelpMojo.java 2024-11-04 11:05:47.809358693 +0100 +@@ -0,0 +1,448 @@ ++package org.apache.maven.plugins.maven_javadoc_plugin; ++ ++import org.apache.maven.plugin.AbstractMojo; ++import org.apache.maven.plugin.MojoExecutionException; ++import org.apache.maven.plugins.annotations.Mojo; ++import org.apache.maven.plugins.annotations.Parameter; ++ ++import org.w3c.dom.Document; ++import org.w3c.dom.Element; ++import org.w3c.dom.Node; ++import org.w3c.dom.NodeList; ++import org.xml.sax.SAXException; ++ ++import javax.xml.parsers.DocumentBuilder; ++import javax.xml.parsers.DocumentBuilderFactory; ++import javax.xml.parsers.ParserConfigurationException; ++import java.io.IOException; ++import java.io.InputStream; ++import java.util.ArrayList; ++import java.util.List; ++ ++/** ++ * Display help information on maven-javadoc-plugin.
++ * Call mvn javadoc:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. ++ * @author maven-plugin-tools ++ */ ++@Mojo( name = "help", requiresProject = false, threadSafe = true ) ++public class HelpMojo ++ extends AbstractMojo ++{ ++ /** ++ * If true, display all settable properties for each goal. ++ * ++ */ ++ @Parameter( property = "detail", defaultValue = "false" ) ++ private boolean detail; ++ ++ /** ++ * The name of the goal for which to show help. If unspecified, all goals will be displayed. ++ * ++ */ ++ @Parameter( property = "goal" ) ++ private java.lang.String goal; ++ ++ /** ++ * The maximum length of a display line, should be positive. ++ * ++ */ ++ @Parameter( property = "lineLength", defaultValue = "80" ) ++ private int lineLength; ++ ++ /** ++ * The number of spaces per indentation level, should be positive. ++ * ++ */ ++ @Parameter( property = "indentSize", defaultValue = "2" ) ++ private int indentSize; ++ ++ // /META-INF/maven///plugin-help.xml ++ private static final String PLUGIN_HELP_PATH = ++ "/META-INF/maven/org.apache.maven.plugins/maven-javadoc-plugin/plugin-help.xml"; ++ ++ private static final int DEFAULT_LINE_LENGTH = 80; ++ ++ private Document build() ++ throws MojoExecutionException ++ { ++ getLog().debug( "load plugin-help.xml: " + PLUGIN_HELP_PATH ); ++ try ( InputStream is = getClass().getResourceAsStream( PLUGIN_HELP_PATH ) ) ++ { ++ if ( is == null ) ++ { ++ throw new MojoExecutionException( "Could not find plugin descriptor at " + PLUGIN_HELP_PATH ); ++ } ++ DocumentBuilderFactory dbFactory = DocumentBuilderFactory.newInstance(); ++ DocumentBuilder dBuilder = dbFactory.newDocumentBuilder(); ++ return dBuilder.parse( is ); ++ } ++ catch ( IOException e ) ++ { ++ throw new MojoExecutionException( e.getMessage(), e ); ++ } ++ catch ( ParserConfigurationException e ) ++ { ++ throw new MojoExecutionException( e.getMessage(), e ); ++ } ++ catch ( SAXException e ) ++ { ++ throw new MojoExecutionException( e.getMessage(), e ); ++ } ++ } ++ ++ /** ++ * {@inheritDoc} ++ */ ++ @Override ++ public void execute() ++ throws MojoExecutionException ++ { ++ if ( lineLength <= 0 ) ++ { ++ getLog().warn( "The parameter 'lineLength' should be positive, using '80' as default." ); ++ lineLength = DEFAULT_LINE_LENGTH; ++ } ++ if ( indentSize <= 0 ) ++ { ++ getLog().warn( "The parameter 'indentSize' should be positive, using '2' as default." ); ++ indentSize = 2; ++ } ++ ++ Document doc = build(); ++ ++ StringBuilder sb = new StringBuilder(); ++ Node plugin = getSingleChild( doc, "plugin" ); ++ ++ ++ String name = getValue( plugin, "name" ); ++ String version = getValue( plugin, "version" ); ++ String id = getValue( plugin, "groupId" ) + ":" + getValue( plugin, "artifactId" ) + ":" + version; ++ if ( isNotEmpty( name ) && !name.contains( id ) ) ++ { ++ append( sb, name + " " + version, 0 ); ++ } ++ else ++ { ++ if ( isNotEmpty( name ) ) ++ { ++ append( sb, name, 0 ); ++ } ++ else ++ { ++ append( sb, id, 0 ); ++ } ++ } ++ append( sb, getValue( plugin, "description" ), 1 ); ++ append( sb, "", 0 ); ++ ++ //plugin ++ String goalPrefix = getValue( plugin, "goalPrefix" ); ++ ++ Node mojos1 = getSingleChild( plugin, "mojos" ); ++ ++ List mojos = findNamedChild( mojos1, "mojo" ); ++ ++ if ( goal == null || goal.length() <= 0 ) ++ { ++ append( sb, "This plugin has " + mojos.size() + ( mojos.size() > 1 ? " goals:" : " goal:" ), 0 ); ++ append( sb, "", 0 ); ++ } ++ ++ for ( Node mojo : mojos ) ++ { ++ writeGoal( sb, goalPrefix, (Element) mojo ); ++ } ++ ++ if ( getLog().isInfoEnabled() ) ++ { ++ getLog().info( sb.toString() ); ++ } ++ } ++ ++ ++ private static boolean isNotEmpty( String string ) ++ { ++ return string != null && string.length() > 0; ++ } ++ ++ private static String getValue( Node node, String elementName ) ++ throws MojoExecutionException ++ { ++ return getSingleChild( node, elementName ).getTextContent(); ++ } ++ ++ private static Node getSingleChild( Node node, String elementName ) ++ throws MojoExecutionException ++ { ++ List namedChild = findNamedChild( node, elementName ); ++ if ( namedChild.isEmpty() ) ++ { ++ throw new MojoExecutionException( "Could not find " + elementName + " in plugin-help.xml" ); ++ } ++ if ( namedChild.size() > 1 ) ++ { ++ throw new MojoExecutionException( "Multiple " + elementName + " in plugin-help.xml" ); ++ } ++ return namedChild.get( 0 ); ++ } ++ ++ private static List findNamedChild( Node node, String elementName ) ++ { ++ List result = new ArrayList(); ++ NodeList childNodes = node.getChildNodes(); ++ for ( int i = 0; i < childNodes.getLength(); i++ ) ++ { ++ Node item = childNodes.item( i ); ++ if ( elementName.equals( item.getNodeName() ) ) ++ { ++ result.add( item ); ++ } ++ } ++ return result; ++ } ++ ++ private static Node findSingleChild( Node node, String elementName ) ++ throws MojoExecutionException ++ { ++ List elementsByTagName = findNamedChild( node, elementName ); ++ if ( elementsByTagName.isEmpty() ) ++ { ++ return null; ++ } ++ if ( elementsByTagName.size() > 1 ) ++ { ++ throw new MojoExecutionException( "Multiple " + elementName + "in plugin-help.xml" ); ++ } ++ return elementsByTagName.get( 0 ); ++ } ++ ++ private void writeGoal( StringBuilder sb, String goalPrefix, Element mojo ) ++ throws MojoExecutionException ++ { ++ String mojoGoal = getValue( mojo, "goal" ); ++ Node configurationElement = findSingleChild( mojo, "configuration" ); ++ Node description = findSingleChild( mojo, "description" ); ++ if ( goal == null || goal.length() <= 0 || mojoGoal.equals( goal ) ) ++ { ++ append( sb, goalPrefix + ":" + mojoGoal, 0 ); ++ Node deprecated = findSingleChild( mojo, "deprecated" ); ++ if ( ( deprecated != null ) && isNotEmpty( deprecated.getTextContent() ) ) ++ { ++ append( sb, "Deprecated. " + deprecated.getTextContent(), 1 ); ++ if ( detail && description != null ) ++ { ++ append( sb, "", 0 ); ++ append( sb, description.getTextContent(), 1 ); ++ } ++ } ++ else if ( description != null ) ++ { ++ append( sb, description.getTextContent(), 1 ); ++ } ++ append( sb, "", 0 ); ++ ++ if ( detail ) ++ { ++ Node parametersNode = getSingleChild( mojo, "parameters" ); ++ List parameters = findNamedChild( parametersNode, "parameter" ); ++ append( sb, "Available parameters:", 1 ); ++ append( sb, "", 0 ); ++ ++ for ( Node parameter : parameters ) ++ { ++ writeParameter( sb, parameter, configurationElement ); ++ } ++ } ++ } ++ } ++ ++ private void writeParameter( StringBuilder sb, Node parameter, Node configurationElement ) ++ throws MojoExecutionException ++ { ++ String parameterName = getValue( parameter, "name" ); ++ String parameterDescription = getValue( parameter, "description" ); ++ ++ Element fieldConfigurationElement = null; ++ if ( configurationElement != null ) ++ { ++ fieldConfigurationElement = (Element) findSingleChild( configurationElement, parameterName ); ++ } ++ ++ String parameterDefaultValue = ""; ++ if ( fieldConfigurationElement != null && fieldConfigurationElement.hasAttribute( "default-value" ) ) ++ { ++ parameterDefaultValue = " (Default: " + fieldConfigurationElement.getAttribute( "default-value" ) + ")"; ++ } ++ append( sb, parameterName + parameterDefaultValue, 2 ); ++ Node deprecated = findSingleChild( parameter, "deprecated" ); ++ if ( ( deprecated != null ) && isNotEmpty( deprecated.getTextContent() ) ) ++ { ++ append( sb, "Deprecated. " + deprecated.getTextContent(), 3 ); ++ append( sb, "", 0 ); ++ } ++ if ( isNotEmpty( parameterDescription ) ) { ++ append( sb, parameterDescription, 3 ); ++ } ++ if ( "true".equals( getValue( parameter, "required" ) ) ) ++ { ++ append( sb, "Required: Yes", 3 ); ++ } ++ if ( ( fieldConfigurationElement != null ) && isNotEmpty( fieldConfigurationElement.getTextContent() ) ) ++ { ++ String property = getPropertyFromExpression( fieldConfigurationElement.getTextContent() ); ++ append( sb, "User property: " + property, 3 ); ++ } ++ ++ append( sb, "", 0 ); ++ } ++ ++ /** ++ *

Repeat a String n times to form a new string.

++ * ++ * @param str String to repeat ++ * @param repeat number of times to repeat str ++ * @return String with repeated String ++ * @throws NegativeArraySizeException if repeat < 0 ++ * @throws NullPointerException if str is null ++ */ ++ private static String repeat( String str, int repeat ) ++ { ++ StringBuilder buffer = new StringBuilder( repeat * str.length() ); ++ ++ for ( int i = 0; i < repeat; i++ ) ++ { ++ buffer.append( str ); ++ } ++ ++ return buffer.toString(); ++ } ++ ++ /** ++ * Append a description to the buffer by respecting the indentSize and lineLength parameters. ++ * Note: The last character is always a new line. ++ * ++ * @param sb The buffer to append the description, not null. ++ * @param description The description, not null. ++ * @param indent The base indentation level of each line, must not be negative. ++ */ ++ private void append( StringBuilder sb, String description, int indent ) ++ { ++ for ( String line : toLines( description, indent, indentSize, lineLength ) ) ++ { ++ sb.append( line ).append( '\n' ); ++ } ++ } ++ ++ /** ++ * Splits the specified text into lines of convenient display length. ++ * ++ * @param text The text to split into lines, must not be null. ++ * @param indent The base indentation level of each line, must not be negative. ++ * @param indentSize The size of each indentation, must not be negative. ++ * @param lineLength The length of the line, must not be negative. ++ * @return The sequence of display lines, never null. ++ * @throws NegativeArraySizeException if indent < 0 ++ */ ++ private static List toLines( String text, int indent, int indentSize, int lineLength ) ++ { ++ List lines = new ArrayList(); ++ ++ String ind = repeat( "\t", indent ); ++ ++ String[] plainLines = text.split( "(\r\n)|(\r)|(\n)" ); ++ ++ for ( String plainLine : plainLines ) ++ { ++ toLines( lines, ind + plainLine, indentSize, lineLength ); ++ } ++ ++ return lines; ++ } ++ ++ /** ++ * Adds the specified line to the output sequence, performing line wrapping if necessary. ++ * ++ * @param lines The sequence of display lines, must not be null. ++ * @param line The line to add, must not be null. ++ * @param indentSize The size of each indentation, must not be negative. ++ * @param lineLength The length of the line, must not be negative. ++ */ ++ private static void toLines( List lines, String line, int indentSize, int lineLength ) ++ { ++ int lineIndent = getIndentLevel( line ); ++ StringBuilder buf = new StringBuilder( 256 ); ++ ++ String[] tokens = line.split( " +" ); ++ ++ for ( String token : tokens ) ++ { ++ if ( buf.length() > 0 ) ++ { ++ if ( buf.length() + token.length() >= lineLength ) ++ { ++ lines.add( buf.toString() ); ++ buf.setLength( 0 ); ++ buf.append( repeat( " ", lineIndent * indentSize ) ); ++ } ++ else ++ { ++ buf.append( ' ' ); ++ } ++ } ++ ++ for ( int j = 0; j < token.length(); j++ ) ++ { ++ char c = token.charAt( j ); ++ if ( c == '\t' ) ++ { ++ buf.append( repeat( " ", indentSize - buf.length() % indentSize ) ); ++ } ++ else if ( c == '\u00A0' ) ++ { ++ buf.append( ' ' ); ++ } ++ else ++ { ++ buf.append( c ); ++ } ++ } ++ } ++ lines.add( buf.toString() ); ++ } ++ ++ /** ++ * Gets the indentation level of the specified line. ++ * ++ * @param line The line whose indentation level should be retrieved, must not be null. ++ * @return The indentation level of the line. ++ */ ++ private static int getIndentLevel( String line ) ++ { ++ int level = 0; ++ for ( int i = 0; i < line.length() && line.charAt( i ) == '\t'; i++ ) ++ { ++ level++; ++ } ++ for ( int i = level + 1; i <= level + 4 && i < line.length(); i++ ) ++ { ++ if ( line.charAt( i ) == '\t' ) ++ { ++ level++; ++ break; ++ } ++ } ++ return level; ++ } ++ ++ private static String getPropertyFromExpression( String expression ) ++ { ++ if ( expression != null && expression.startsWith( "${" ) && expression.endsWith( "}" ) ++ && !expression.substring( 2 ).contains( "${" ) ) ++ { ++ // expression="${xxx}" -> property="xxx" ++ return expression.substring( 2, expression.length() - 1 ); ++ } ++ // no property can be extracted ++ return null; ++ } ++} diff --git a/maven-javadoc-plugin-build.xml b/maven-javadoc-plugin-build.xml new file mode 100644 index 0000000..22b5019 --- /dev/null +++ b/maven-javadoc-plugin-build.xml @@ -0,0 +1,329 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + =================================== WARNING =================================== + JUnit is not present in the test classpath or your $ANT_HOME/lib directory. Tests not executed. + =============================================================================== + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/maven-javadoc-plugin.changes b/maven-javadoc-plugin.changes new file mode 100644 index 0000000..c83f787 --- /dev/null +++ b/maven-javadoc-plugin.changes @@ -0,0 +1,323 @@ +------------------------------------------------------------------- +Sun Dec 8 19:49:03 UTC 2024 - Fridrich Strba + +- Upgrade to upstream version 3.11.2 + * New Feature + + MJAVADOC-814: Ability to split grouped packages over multiple + lines + * Improvement + + MJAVADOC-823: legacyMode keeps using module-info.java + (-sourcedirectory still use as well as java files input) + * Task + + MJAVADOC-822: parameter skippedModules should scale and easier + to use + +------------------------------------------------------------------- +Mon Nov 4 10:11:17 UTC 2024 - Fridrich Strba + +- Upgrade to upstream version 3.11.1 +- Version 3.11.1 + * Bug + + MJAVADOC-820: [REGRESSION] MJAVADOC-787 was merged + incompletely + * New Feature + + MJAVADOC-787: Automatic detection of release option for + JDK < 9 + * Task + + MJAVADOC-819: Align archive generation code with Maven Source + Plugin + + MJAVADOC-821: Align toolchain discovery code with Maven + Compiler Plugin + * Dependency upgrade + + MJAVADOC-816: Bump org.codehaus.plexus:plexus-java from + 1.2.0 to 1.3.0 + + MJAVADOC-817: Upgrade to Doxia 2.0.0 GA Stack +- Modified patches: + * maven-javadoc-plugin-bootstrap-resources.patch + + Regenerate from non-bootstrap build + +------------------------------------------------------------------- +Thu Oct 3 22:19:41 UTC 2024 - Fridrich Strba + +- Upgrade to upstream version 3.10.1 +- Version 3.10.1 + * Bug + + MJAVADOC-810: [REGRESSION] MJAVADOC-791 causes forked Maven + execution fail if any toolchains or settings file isn't + present + + MJAVADOC-811: javadoc.bat fails to execute on Windows when + project is not on drive C and AutoRun is configured + + MJAVADOC-812: [REGRESSION] maven-javadoc-plugin 3.10.0 creates + empty JARs +- Version 3.10.0 + * Bug + + MJAVADOC-560: Clarify outputDirectory, reportOutputDirectory + in javadoc:javadoc documentation + * Task + + MJAVADOC-776: Plugin depends on plexus-container-default, + which is EOL + + MJAVADOC-785: Align plugin implementation with + AbstractMavenReport (maven-reporting-impl) + + MJAVADOC-807: Simplify IT for MJAVADOC-498 + + MJAVADOC-809: Align Mojo class names +- Version 3.8.0 + * Bug + + MJAVADOC-603: javadoc:fix failure on JDK10: + java.lang.ClassNotFoundException: java.sql.Connection + + MJAVADOC-751: No warnings for localized output + + MJAVADOC-775: Option 'taglets/taglet/tagletpath' ignored when + pointing to a JAR + + MJAVADOC-783: Invalid path when using TagletArtifact and + TagletPath + + MJAVADOC-791: maven-javadoc-plugin not working correctly + together with maven-toolchains-plugin + * Improvement + + MJAVADOC-796: Do not follow links for Java 12+ + + MJAVADOC-798: Consider passing user settings when using + invoker + + MJAVADOC-802: Set default value of defaultAuthor parameter + in fix goals to ${user.name} + + MJAVADOC-803: Add default parameter to force root locale + * Test + + MJAVADOC-804: Temporary files are left after test execution + * Task + + MJAVADOC-799: Remove inconsistent + 'AbstractFixJavadocMojo#defaultVersion' default value +- Version 3.7.0 + * Bug + + MJAVADOC-793: java.lang.NullPointerException: Cannot invoke + "String.length()" because "text" is null +- Version 3.6.3 + * Bug + + MJAVADOC-682: Reactor builds fail when multiple modules with + same groupId:artifactId, but different versions + + MJAVADOC-780: Unit tests create null-null.jar in build root + directory + * Improvement + + MJAVADOC-779: Upgrade maven-plugin parent to 41 + * Task + + MJAVADOC-782: Align read-only parameters naming with other + plugins +- Version 3.6.2 + * Bug + + MJAVADOC-713: Skipping Javadoc reportset leaves empty Javadoc + link in site + + MJAVADOC-716: The stale file detection does not work + + MJAVADOC-726: Maven Java Doc Plugin downloads Log4j-1.2.12 + dependency transitively + + MJAVADOC-762: createTestRepo in JavaDocReportTest shares state + + MJAVADOC-774: 3.6.0 release is not reproducible + * Improvement + + MJAVADOC-730: Deprecate parameter "old" +- Removed patches: + * no-override.patch + + not needed with this version +- Modified patches: + * maven-javadoc-plugin-bootstrap-resources.patch + + Regenerate using maven-plugin-plugin 3.15 from non-bootstrap + build + * reproducible-from-environment.patch + * stale-data-encoding.patch + + adapt to changed context +- Fetch sources from Github using source service + +------------------------------------------------------------------- +Tue Sep 24 15:00:28 UTC 2024 - Fridrich Strba + +- Added patch: + * reproducible-from-environment.patch + + SOURCE_DATE_EPOCH environmental variable triggers reproducible + use of the maven-javadoc-plugin if it is not requested already + using the project.build.outputTimestamp option. + +------------------------------------------------------------------- +Mon Jun 10 16:33:19 UTC 2024 - Fridrich Strba + +- Remove dependency on plexus-metadata-generator, + plexus-component-metadata and on their dependencies, since there + is no plexus @Component annotation any more + +------------------------------------------------------------------- +Tue Apr 2 17:26:28 UTC 2024 - Fridrich Strba + +- Add dependency on plexus-xml where relevant + * this will be needed for smooth upgrade to plexus-utils 4.0.0 + +------------------------------------------------------------------- +Wed Feb 21 06:00:34 UTC 2024 - Fridrich Strba + +- Use %patch -P N instead of deprecated %patchN. + +------------------------------------------------------------------- +Fri Jan 26 08:10:17 UTC 2024 - Fridrich Strba + +- Require maven-parent >= 40. The maven build will fail with + anything lower + +------------------------------------------------------------------- +Wed Sep 20 07:04:26 UTC 2023 - Fridrich Strba + +- Upgrade to upstream version 3.6.0 + * Bug + + MJAVADOC-642: Setting maven.javadoc.isoffline seems to have no + effect + + MJAVADOC-701: javadoc site is broken for projects that contain + modules + + MJAVADOC-733: Alternative doclet page points to an SEO spammy + page + + MJAVADOC-742: [REGRESSION] Transitive dependencies of + docletArtifact missing + + MJAVADOC-757: Unresolvable link in javadoc tag with value + ResourcesBundleMojo#getAttachmentClassifier() found in + ResourcesBundleMojo + + MJAVADOC-758: IOException --> NullPointerException in + JavadocUtil.copyResource + + MJAVADOC-763: JavadocReportTest.testExceptions is broken + + MJAVADOC-767: javadoc creates invalid --patch-module + statements + + MJAVADOC-769: javadoc plugin can not deal with transitive + filename based modules + * Improvement + + MJAVADOC-755: Clean up deprecated and unpreferred methods in + JavadocUtil + + MJAVADOC-760: Cleanup dependency declarations as best possible + + MJAVADOC-770: Allow building javadoc "the old fashioned way" + after Java 8 + * Task + + MJAVADOC-743: Drop use of deprecated localRepository mojo + parameter + + MJAVADOC-765: Make build pass with Java 20 + + MJAVADOC-772: Refresh download page + * Dependency upgrade + + MJAVADOC-761: Update to commons-io 2.13.0 + + MJAVADOC-766: Update plexus-archiver from 4.7.1 to 4.8.0 + + MJAVADOC-771: Upgrade Parent to 40 +- Modified patches: + * maven-javadoc-plugin-bootstrap-resources.patch + + regenerate in cycle + * no-override.patch + * stale-data-encoding.patch + + rediff to changed line-endings + +------------------------------------------------------------------- +Wed Sep 20 06:25:32 UTC 2023 - Fridrich Strba + +- Upgrade to upstream version 3.5.0 + * Bug + + MJAVADOC-696: Invalid anchors in Javadoc and plugin mojo + + MJAVADOC-700: Plugin duplicates classes in Java 8 all-classes + lists + + MJAVADOC-702: javadoc site creation ignores configuration + parameters + * Improvement + + MJAVADOC-685: Deprecate parameter "stylesheet" + + MJAVADOC-721: Parse stderr output and suppress informational + lines + + MJAVADOC-729: Link to Javadoc references from JDK 17 + + MJAVADOC-731: Migrate components to JSR 330, get rid of + maven-artifact-transfer, update to parent 37 + * Task + + MJAVADOC-712: Remove remains of org.codehaus.doxia.sink.Sink + * Dependency upgrade + + MJAVADOC-711: Upgrade plugins in ITs + + MJAVADOC-714: Upgrade to Maven 3.2.5 + + MJAVADOC-719: Update Maven Archiver to 3.6.0 + + MJAVADOC-723: Upgrade Maven Reporting API to 3.1.1/Complete + with Maven Reporting Impl 3.2.0 + + MJAVADOC-738: Upgrade commons-text to 1.10.0 + + MJAVADOC-740: Upgrade Parent to 39 + + MJAVADOC-741: Upgrade plugins and components +- Modified patches: + * maven-javadoc-plugin-bootstrap-resources.patch + + regenerate in cycle + * stale-data-encoding.patch + + rediff to changed context +- Added patch: + * no-override.patch + + allow building with older version of maven-reporting-api +- Removed patch: + * maven-javadoc-plugin-ioexception.patch + + not necessary with this version + +------------------------------------------------------------------- +Tue Oct 25 14:16:58 UTC 2022 - Fridrich Strba + +- Added patch: + * maven-javadoc-plugin-ioexception.patch + + allow building with wider range of plexus-utils versions, + including the 3.5.0 that does not declare IOException as + thrown in functions where it is actually not thrown. + +------------------------------------------------------------------- +Fri May 13 09:41:52 UTC 2022 - Fridrich Strba + +- Fix build with modello 2.0.0 + +------------------------------------------------------------------- +Mon Mar 14 06:23:46 UTC 2022 - Fridrich Strba + +- Added patch: + * stale-data-encoding.patch + + use the same encoding when writing and getting the stale data + + fixes build with utf-8 sources on non utf-8 platforms + +------------------------------------------------------------------- +Fri Mar 11 07:05:23 UTC 2022 - Fridrich Strba + +- Upgrade to upstream version 3.3.2 + * fixing several NPE errors and using new + maven-reporting-{api,impl} +- Removed patches: + * 0001-Port-to-current-plexus-utils.patch + * reproducible-footer.patch + + not needed with the upstream code +- Modified patch: + * maven-javadoc-plugin-bootstrap-resources.patch + + regenerate the resources to correspond to the new version + +------------------------------------------------------------------- +Tue May 11 15:25:11 UTC 2021 - Fridrich Strba + +- Do not build against the legacy guava20 package any more + +------------------------------------------------------------------- +Wed Mar 11 11:44:44 UTC 2020 - Fridrich Strba + +- Fix build with doxia 1.9.x + +------------------------------------------------------------------- +Sun Nov 24 17:40:49 UTC 2019 - Fridrich Strba + +- Upgrade to version 3.1.1 +- Modified patch: + * maven-javadoc-plugin-bootstrap-resources.patch + + Regenerate patch from the non-bootstrap build + +------------------------------------------------------------------- +Thu Nov 21 16:33:35 UTC 2019 - Fridrich Strba + +- Fix build with maven-invoker-3.0.1 that has a new dependency + on maven-shared-utils + +------------------------------------------------------------------- +Mon Oct 7 13:50:06 UTC 2019 - Bernhard Wiedemann + +- Add reproducible-footer.patch to override build date (boo#1047218) + +------------------------------------------------------------------- +Sat Apr 6 22:38:49 UTC 2019 - Jan Engelhardt + +- Spruce up summary to not just repeat the name. + +------------------------------------------------------------------- +Wed Apr 3 09:24:05 UTC 2019 - Fridrich Strba + +- Initial packaging of maven-jar-plugin 3.0.1 +- Generate and customize ant build.xml file to use with the + bootstrap variang +- Create as a multibuild package to allow bootstrapping +- Added patch: + * maven-javadoc-plugin-bootstrap-resources.patch + + For the bootstrap version, add pre-generated resources that + need maven-plugin-plugin and maven to be generated at build + time diff --git a/maven-javadoc-plugin.spec b/maven-javadoc-plugin.spec new file mode 100644 index 0000000..62894f8 --- /dev/null +++ b/maven-javadoc-plugin.spec @@ -0,0 +1,181 @@ +# +# spec file for package maven-javadoc-plugin +# +# Copyright (c) 2024 SUSE LLC +# +# All modifications and additions to the file contributed by third parties +# remain the property of their copyright owners, unless otherwise agreed +# upon. The license for this file, and modifications and additions to the +# file, is the same license as for the pristine package itself (unless the +# license for the pristine package is not an Open Source License, in which +# case the license is the MIT License). An "Open Source License" is a +# license that conforms to the Open Source Definition (Version 1.9) +# published by the Open Source Initiative. + +# Please submit bugfixes or comments via https://bugs.opensuse.org/ +# + + +%global flavor @BUILD_FLAVOR@%{nil} +%if "%{flavor}" == "bootstrap" +%bcond_without bootstrap +%else +%bcond_with bootstrap +%endif +%global base_name maven-javadoc-plugin +Version: 3.11.2 +Release: 0 +Summary: Maven plugin for creating javadocs +License: Apache-2.0 +Group: Development/Libraries/Java +URL: https://maven.apache.org/plugins/maven-javadoc-plugin +Source0: %{base_name}-%{version}.tar.xz +Source1: %{base_name}-build.xml +Patch0: %{base_name}-bootstrap-resources.patch +Patch1: stale-data-encoding.patch +Patch2: reproducible-from-environment.patch +BuildRequires: apache-commons-io +BuildRequires: apache-commons-lang3 +BuildRequires: apache-commons-text +BuildRequires: atinject +BuildRequires: fdupes +BuildRequires: httpcomponents-client +BuildRequires: httpcomponents-core +BuildRequires: javapackages-local +BuildRequires: maven-archiver +BuildRequires: maven-common-artifact-filters +BuildRequires: maven-doxia-sink-api +BuildRequires: maven-doxia-sitetools +BuildRequires: maven-invoker +BuildRequires: maven-lib +BuildRequires: maven-plugin-annotations +BuildRequires: maven-reporting-api +BuildRequires: maven-reporting-impl +BuildRequires: maven-resolver-api +BuildRequires: maven-resolver-impl +BuildRequires: maven-resolver-util +BuildRequires: maven-shared-utils +BuildRequires: maven-wagon-provider-api +BuildRequires: plexus-archiver +BuildRequires: plexus-interactivity-api +BuildRequires: plexus-io +BuildRequires: plexus-languages +BuildRequires: plexus-utils +BuildRequires: plexus-xml +BuildRequires: qdox +BuildRequires: sisu-inject +BuildRequires: sisu-plexus +BuildRequires: unzip +BuildRequires: xmvn-install +BuildRequires: xmvn-resolve +BuildRequires: mvn(org.apache.maven.plugins:maven-plugins:pom:) >= 40 +BuildArch: noarch +%if %{with bootstrap} +Name: %{base_name}-bootstrap +BuildRequires: ant +BuildRequires: modello >= 2.0.0 +%else +Name: %{base_name} +BuildRequires: xmvn +BuildRequires: mvn(org.apache.maven.plugins:maven-compiler-plugin) +BuildRequires: mvn(org.apache.maven.plugins:maven-jar-plugin) +BuildRequires: mvn(org.apache.maven.plugins:maven-javadoc-plugin) +BuildRequires: mvn(org.apache.maven.plugins:maven-plugin-plugin) +BuildRequires: mvn(org.apache.maven.plugins:maven-resources-plugin) +BuildRequires: mvn(org.apache.maven.plugins:maven-surefire-plugin) +BuildRequires: mvn(org.codehaus.modello:modello-maven-plugin) +BuildRequires: mvn(org.eclipse.sisu:sisu-maven-plugin) +Obsoletes: %{base_name}-bootstrap +#!BuildRequires: maven-compiler-plugin-bootstrap +#!BuildRequires: maven-jar-plugin-bootstrap +#!BuildRequires: maven-javadoc-plugin-bootstrap +#!BuildRequires: maven-plugin-plugin-bootstrap +#!BuildRequires: maven-resources-plugin-bootstrap +#!BuildRequires: maven-surefire-plugin-bootstrap +%endif + +%description +The Maven Javadoc Plugin is a plugin that uses the javadoc tool for +generating javadocs for the specified project. + +%if %{without bootstrap} +%package javadoc +Summary: Javadoc for %{name} +Group: Documentation/HTML + +%description javadoc +API documentation for %{name}. +%endif + +%prep +%setup -q -n %{base_name}-%{version} +%if %{with bootstrap} +cp %{SOURCE1} build.xml +%patch -P 0 -p1 +%endif +%patch -P 1 -p1 +%patch -P 2 -p1 + +%pom_remove_dep :::test: + +%build +%if %{with bootstrap} +mkdir -p lib +build-jar-repository -s lib \ + apache-commons-lang3 \ + apache-commons-text \ + atinject \ + httpcomponents/httpclient \ + httpcomponents/httpcore \ + maven-archiver/maven-archiver \ + maven-common-artifact-filters/maven-common-artifact-filters \ + maven-doxia/doxia-core \ + maven-doxia/doxia-module-xhtml5 \ + maven-doxia/doxia-sink-api \ + maven-doxia-sitetools/doxia-integration-tools \ + maven-doxia-sitetools/doxia-site-renderer \ + maven-invoker/maven-invoker \ + maven/maven-artifact \ + maven/maven-core \ + maven/maven-model \ + maven/maven-model-builder \ + maven/maven-plugin-api \ + maven/maven-settings \ + maven-plugin-tools/maven-plugin-annotations \ + maven-resolver/maven-resolver-api \ + maven-resolver/maven-resolver-util \ + maven-reporting-api/maven-reporting-api \ + maven-shared-utils/maven-shared-utils \ + maven-wagon/provider-api \ + org.eclipse.sisu.inject \ + org.eclipse.sisu.plexus \ + plexus/archiver \ + plexus/interactivity-api \ + plexus/io \ + plexus-languages/plexus-java \ + plexus/utils \ + plexus/xml \ + qdox +ant -Dtest.skip=true jar +%else +xmvn --batch-mode --offline \ + -Dmaven.test.skip=true -DmavenVersion=3.5.0 \ +%if %{?pkg_vcmp:%pkg_vcmp java-devel >= 9}%{!?pkg_vcmp:0} + -Dmaven.compiler.release=8 \ +%endif + package org.apache.maven.plugins:maven-javadoc-plugin:aggregate +%endif + +%{mvn_artifact} pom.xml target/%{base_name}-%{version}.jar + +%install +%mvn_install +%fdupes -s %{buildroot}%{_javadocdir} + +%files -f .mfiles + +%if %{without bootstrap} +%files javadoc -f .mfiles-javadoc +%endif + +%changelog diff --git a/reproducible-from-environment.patch b/reproducible-from-environment.patch new file mode 100644 index 0000000..abb0d0e --- /dev/null +++ b/reproducible-from-environment.patch @@ -0,0 +1,17 @@ +--- a/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java ++++ b/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java +@@ -2692,6 +2692,14 @@ public abstract class AbstractJavadocMojo extends AbstractMojo { + private String getBottomText() { + final String inceptionYear = project.getInceptionYear(); + ++ if ( outputTimestamp == null || ++ outputTimestamp.length() < 1 || ++ ( ( outputTimestamp.length() == 1 ) ++ && !Character.isDigit( outputTimestamp.charAt(0) ) ) ) ++ { ++ outputTimestamp = System.getenv("SOURCE_DATE_EPOCH"); ++ } ++ + // get Reproducible Builds outputTimestamp date value or the current local date. + final LocalDate localDate = MavenArchiver.parseBuildOutputTimestamp(outputTimestamp) + .map(instant -> instant.atZone(ZoneOffset.UTC).toLocalDate()) diff --git a/stale-data-encoding.patch b/stale-data-encoding.patch new file mode 100644 index 0000000..4a6dd83 --- /dev/null +++ b/stale-data-encoding.patch @@ -0,0 +1,50 @@ +--- a/src/main/java/org/apache/maven/plugins/javadoc/StaleHelper.java ++++ b/src/main/java/org/apache/maven/plugins/javadoc/StaleHelper.java +@@ -40,6 +40,19 @@ import org.codehaus.plexus.util.cli.Commandline; + */ + public class StaleHelper { + ++ private static Charset getDataCharset() ++ { ++ if ( JavaVersion.JAVA_SPECIFICATION_VERSION.isAtLeast( "9" ) ++ && JavaVersion.JAVA_SPECIFICATION_VERSION.isBefore( "12" ) ) ++ { ++ return StandardCharsets.UTF_8; ++ } ++ else ++ { ++ return Charset.defaultCharset(); ++ } ++ } ++ + /** + * Compute the data used to detect a stale javadoc + * +@@ -55,13 +68,7 @@ public class StaleHelper { + String[] args = cmd.getArguments(); + Collections.addAll(options, args); + +- final Charset cs; +- if (JavaVersion.JAVA_SPECIFICATION_VERSION.isAtLeast("9") +- && JavaVersion.JAVA_SPECIFICATION_VERSION.isBefore("12")) { +- cs = StandardCharsets.UTF_8; +- } else { +- cs = Charset.defaultCharset(); +- } ++ final Charset cs = getDataCharset(); + + for (String arg : args) { + if (arg.startsWith("@")) { +@@ -115,9 +122,11 @@ public class StaleHelper { + */ + public static void writeStaleData(Commandline cmd, Path path) throws MavenReportException { + try { ++ final Charset cs = getDataCharset(); ++ + List curdata = getStaleData(cmd); + Files.createDirectories(path.getParent()); +- Files.write(path, curdata, StandardCharsets.UTF_8); ++ Files.write(path, curdata, cs); + } catch (IOException e) { + throw new MavenReportException("Error checking stale data", e); + }