javadoc:javadoc

Note:This goal should be used as a Maven report.

Full name:

org.apache.maven.plugins:maven-javadoc-plugin:2.5:javadoc

Description:

Generates documentation for the Java code in the project using the standard Javadoc Tool .

Attributes:

  • Requires a Maven 2.0 project to be executed.
  • Requires dependency resolution of artifacts in scope: compile.
  • Since version: 2.0.
  • Invokes the execution of the lifecycle phase generate-sources prior to executing itself.

Required Parameters

Name Type Since Description
outputDirectory File 2.0 Specifies the destination directory where javadoc saves the generated HTML files.
See d .

Default value is: ${project.build.directory}/apidocs.
reportOutputDirectory File 2.0 Specifies the destination directory where javadoc saves the generated HTML files.

Optional Parameters

Name Type Since Description
additionalJOption String 2.3 Set an additional Javadoc option(s) (i.e. JVM options) on the command line. Example:
<additionalJOption>-J-Xss128m</additionalJOption>
See Jflag .
See vmoptions .
additionalparam String 2.0 Set an additional parameter(s) on the command line. This value should include quotes as necessary for parameters that include spaces. Useful for a custom doclet.
aggregate boolean 2.0 Deprecated. {0}. As of version 2.5, use the goals javadoc:aggregate and javadoc:test-aggregate instead.
Default value is: false.
author boolean 2.0 Specifies whether or not the author text is included in the generated Javadocs.
See author .

Default value is: true.
bootclasspath String 2.5 Specifies the paths where the boot classes reside.
See bootclasspath .

bootclasspathArtifacts BootclasspathArtifact[] 2.5 Specifies the artifacts where the boot classes reside.
See bootclasspath .
Example:
<bootclasspathArtifacts>
  <bootclasspathArtifact>
    <groupId>my-groupId</groupId>
    <artifactId>my-artifactId</artifactId>
    <version>my-version</version>
  </bootclasspathArtifact>
</bootclasspathArtifacts>

See Javadoc .

bottom String 2.0 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,
eg. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]>
See bottom .

Default value is: Copyright � {inceptionYear}-{currentYear} {organizationName}. All Rights Reserved..
breakiterator boolean 2.0 Uses the sentence break iterator to determine the end of the first sentence.
See breakiterator .
Since Java 1.4 .

Default value is: false.
charset String 2.0 Specifies the HTML character set for this document. If not specificed, the charset value will be the value of the docencoding parameter.
See charset .

debug boolean 2.1 Set this to 'true' to debug Javadoc plugin. With this, 'options' and 'files' files are provided.

Default value is: false.
description String 2.1 The description of the Javadoc report.
destDir String 2.1 The name of the destination directory.

Default value is: apidocs.
docencoding String 2.0 Specifies the encoding of the generated HTML files. If not specificed, the docencoding value will be UTF-8.
See docencoding .
Default value is: ${project.reporting.outputEncoding}.
docfilessubdirs boolean 2.0 Enables deep copying of "doc-files" directories.
See docfilessubdirs .
Since Java 1.4 .
See javadocDirectory .

Default value is: false.
doclet String 2.0 Specifies the class file that starts the doclet used in generating the documentation.
See doclet .
docletArtifact DocletArtifact 2.0 Specifies the artifact containing the doclet starting class file (specified with the -doclet option).
See docletpath .
Example:
<docletArtifact>
  <groupId>com.sun.tools.doclets</groupId>
  <artifactId>doccheck</artifactId>
  <version>1.2b2</version>
</docletArtifact>

See Javadoc .

docletArtifacts DocletArtifact[] 2.1 Specifies multiple artifacts containing the path for the doclet starting class file (specified with the -doclet option).
See docletpath .
Example:
<docletArtifacts>
  <docletArtifact>
    <groupId>com.sun.tools.doclets</groupId>
    <artifactId>doccheck</artifactId>
    <version>1.2b2</version>
  </docletArtifact>
</docletArtifacts>

See Javadoc .

docletPath String 2.0 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 (:) on Solaris and a semi-colon (;) on Windows.
See docletpath .
doctitle String 2.0 Specifies the title to be placed near the top of the overview summary file.
See doctitle .

Default value is: ${project.name} ${project.version} API.
encoding String 2.0 Specifies the encoding name of the source files. If not specificed, the encoding value will be the value of the file.encoding system property.
See encoding .
Note : In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5.

Default value is: ${project.build.sourceEncoding}.
excludePackageNames String 2.0 Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by colons (:).
See exclude .
Since Java 1.4 .
excludedocfilessubdir String 2.0 Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:).
See excludedocfilessubdir .
Since Java 1.4 .
extdirs String 2.0 Specifies the directories where extension classes reside. Separate directories in dirlist with a colon (:) on Solaris and a semi-colon (;) on Windows.
See extdirs .
failOnError boolean 2.5 Specifies whether the build will continue even if there are errors.
Default value is: true.
footer String 2.0 Specifies the footer text to be placed at the bottom of each output file.
See footer .
groups Group[] 2.0 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 (:).
See group .
Example:
<groups>
  <group>
    <title>Core Packages</title>
    <packages>org.apache.core</packages>
  </group>
</groups>

See Javadoc .

header String 2.0 Specifies the header text to be placed at the top of each output file.
See header .
helpfile String 2.0 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/>.
See helpfile .
javadocDirectory File 2.1 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 .
javadocExecutable String 2.3 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 String 2.3 Version of the Javadoc Tool executable to use, ex. "1.3", "1.5".
keywords boolean 2.1 Adds HTML meta keyword tags to the generated file for each class.
See keywords .
Since Java 1.4.2 .
Since Java 5.0 .

Default value is: false.
links ArrayList 2.0 Creates links to existing javadoc-generated documentation of external referenced classes.
See link .
linksource boolean 2.0 Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation.
See linksource .
Since Java 1.4 .

Default value is: false.
localRepository ArtifactRepository 2.0 The local repository where the artifacts are located.
locale String 2.0 Specifies the locale that javadoc uses when generating documentation.
See locale .
maxmemory String 2.0 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 String 2.0 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 String 2.1 The name of the Javadoc report.
nocomment boolean 2.0 Suppress the entire comment body, including the main description and all tags, generating only declarations.
See nocomment .
Since Java 1.4 .

Default value is: false.
nodeprecated boolean 2.0 Prevents the generation of any deprecated API at all in the documentation.
See nodeprecated .

Default value is: false.
nodeprecatedlist boolean 2.0 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 nodeprecatedlist .

Default value is: false.
nohelp boolean 2.0 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 nohelp .

Default value is: false.
noindex boolean 2.0 Omits the index from the generated docs.
Note : could be in conflict with <splitindex/>.
See noindex .

Default value is: false.
nonavbar boolean 2.0 Omits the navigation bar from the generated docs.
See nonavbar .

Default value is: false.
nooverview boolean 2.4 Omits the entire overview page from the generated docs.
Note : could be in conflict with <overview/>.
Standard Doclet undocumented option.

Default value is: false.
noqualifier String 2.0 Omits qualifying package name from ahead of class names in output.
See noqualifier .
Since Java 1.4 .
nosince boolean 2.0 Omits from the generated docs the "Since" sections associated with the since tags.
See nosince .

Default value is: false.
notimestamp boolean 2.1 Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page.
See notimestamp .
Since Java 5.0 .

Default value is: false.
notree boolean 2.0 Omits the class/interface hierarchy pages from the generated docs.
See notree .

Default value is: false.
offlineLinks OfflineLink[] 2.0 This option is a variation of -link; they both create links to javadoc-generated documentation for external referenced classes.
See linkoffline .
Example:
<offlineLinks>
  <offlineLink>
    <url>http://java.sun.com/j2se/1.5.0/docs/api/</url>
    <location>../javadoc/jdk-5.0/</location>
  </offlineLink>
</offlineLinks>

See Javadoc .

old boolean 2.0 This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1.
See 1.1 .

Default value is: false.
overview File 2.0 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 overview .

Default value is: ${basedir}/src/main/javadoc/overview.html.
packagesheader String 2.1 Specify the text for upper left frame.
Since Java 1.4.2 .
proxyHost String 2.0 Deprecated. {0}. since 2.4. Instead of, configure an active proxy host in settings.xml.
Default value is: ${settings.activeProxy.host}.
proxyPort int 2.0 Deprecated. {0}. since 2.4. Instead of, configure an active proxy port in settings.xml.
Default value is: ${settings.activeProxy.port}.
quiet boolean 2.0 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 ).
See quiet .
Since Java 5.0.

Default value is: false.
remoteRepositories List 2.0 The remote repositories where artifacts are located.
resourcesArtifacts ResourcesArtifact[] 2.5 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 2.0 Generates compile-time warnings for missing serial tags.
See serialwarn

Default value is: false.
show String 2.0 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)


Default value is: protected.
skip boolean 2.5 Specifies whether the Javadoc generation should be skipped.
Default value is: false.
source String 2.0 Necessary to enable javadoc to handle assertions present in J2SE v 1.4 source code.
See source .
Since Java 1.4 .
sourcepath String 2.0 Specifies the source paths where the subpackages are located. The paths are separated with a colon (:) on Solaris and a semi-colon (;) on Windows.
See sourcepath .
sourcetab int 2.1 Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used.
Note: was linksourcetab in Java 1.4.2 (refer to bug ID 4788919 ).
Since 1.4.2 .
Since Java 5.0.
splitindex boolean 2.0 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 splitindex .

Default value is: false.
stylesheet String 2.0 Specifies whether the stylesheet to be used is the maven javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. Possible values: "maven" or "java".

Default value is: java.
stylesheetfile String 2.0 Specifies the path of an alternate HTML stylesheet file.
See stylesheetfile .
subpackages String 2.0 Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:).
See subpackages .
Since Java 1.4 .
taglet String 2.0 Specifies the class file that starts the taglet used in generating the documentation for that tag.
See taglet .
Since Java 1.4 .
tagletArtifact TagletArtifact 2.1 Specifies the Taglet artifact containing the taglet class files (.class).
See tagletpath .
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 .

tagletArtifacts TagletArtifact[] 2.5 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.
See taglet .
See tagletpath .
Example:
<tagletArtifacts>
  <tagletArtifact>
    <groupId>group-Taglet</groupId>
    <artifactId>artifact-Taglet</artifactId>
    <version>version-Taglet</version>
  </tagletArtifact>
  ...
</tagletArtifacts>

See Javadoc .

tagletpath String 2.0 Specifies the search paths for finding taglet class files (.class). The tagletPath can contain multiple paths by separating them with a colon (:) on Solaris and a semi-colon (;) on Windows.
See tagletpath .
Since Java 1.4 .
taglets Taglet[] 2.1 Enables the Javadoc tool to interpret multiple taglets.
See taglet .
See tagletpath .
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 .

tags Tag[] 2.0 Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments.
See tag .
Since Java 1.4 .
Example:
<tags>
  <tag>
    <name>todo</name>
    <placement>a</placement>
    <head>To Do:</head>
  </tag>
</tags>

See Javadoc .

top String 2.4 Specifies the top text to be placed at the top of each output file.
See 6227616 .
Since Java 6.0
use boolean 2.0 Includes one "Use" page for each documented class and package.
See use .

Default value is: true.
useStandardDocletOptions boolean 2.5 Specifies to use the options provided by the Standard Doclet 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>

Default value is: true.
verbose boolean 2.0 Provides more detailed messages while javadoc is running.
See verbose .

Default value is: false.
version boolean 2.0 Includes the version text in the generated docs.
See version .

Default value is: true.
windowtitle String 2.0 Specifies the title to be placed in the HTML title tag.
See windowtitle .

Default value is: ${project.name} ${project.version} API.

Parameter Details

additionalJOption :

Set an additional Javadoc option(s) (i.e. JVM options) on the command line. Example:
<additionalJOption>-J-Xss128m</additionalJOption>
See Jflag .
See vmoptions .
  • Type: java.lang.String
  • Since: 2.3
  • Required: No
  • Expression: ${additionalJOption}

additionalparam :

Set an additional parameter(s) on the command line. This value should include quotes as necessary for parameters that include spaces. Useful for a custom doclet.
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${additionalparam}

aggregate :

Deprecated. As of version 2.5, use the goals javadoc:aggregate and javadoc:test-aggregate instead.
Whether to build an aggregated report at the root, or build individual reports.
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${aggregate}
  • Default: false

author :

Specifies whether or not the author text is included in the generated Javadocs.
See author .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${author}
  • Default: true

bootclasspath :

Specifies the paths where the boot classes reside.
See bootclasspath .
  • Type: java.lang.String
  • Since: 2.5
  • Required: No
  • Expression: ${bootclasspath}

bootclasspathArtifacts :

Specifies the artifacts where the boot classes reside.
See bootclasspath .
Example:
<bootclasspathArtifacts>
  <bootclasspathArtifact>
    <groupId>my-groupId</groupId>
    <artifactId>my-artifactId</artifactId>
    <version>my-version</version>
  </bootclasspathArtifact>
</bootclasspathArtifacts>

See Javadoc .
  • Type: org.apache.maven.plugin.javadoc.options.BootclasspathArtifact[]
  • Since: 2.5
  • Required: No
  • Expression: ${bootclasspathArtifacts}

bottom :

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,
eg. <![CDATA[Copyright 2005, <a href="http://www.mycompany.com">MyCompany, Inc.<a>]]>
See bottom .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${bottom}
  • Default: Copyright � {inceptionYear}-{currentYear} {organizationName}. All Rights Reserved.

breakiterator :

Uses the sentence break iterator to determine the end of the first sentence.
See breakiterator .
Since Java 1.4 .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${breakiterator}
  • Default: false

charset :

Specifies the HTML character set for this document. If not specificed, the charset value will be the value of the docencoding parameter.
See charset .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${charset}

debug :

Set this to 'true' to debug Javadoc plugin. With this, 'options' and 'files' files are provided.
  • Type: boolean
  • Since: 2.1
  • Required: No
  • Expression: ${debug}
  • Default: false

description :

The description of the Javadoc report.
  • Type: java.lang.String
  • Since: 2.1
  • Required: No
  • Expression: ${description}

destDir :

The name of the destination directory.
  • Type: java.lang.String
  • Since: 2.1
  • Required: No
  • Expression: ${destDir}
  • Default: apidocs

docencoding :

Specifies the encoding of the generated HTML files. If not specificed, the docencoding value will be UTF-8.
See docencoding .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${docencoding}
  • Default: ${project.reporting.outputEncoding}

docfilessubdirs :

Enables deep copying of "doc-files" directories.
See docfilessubdirs .
Since Java 1.4 .
See javadocDirectory .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${docfilessubdirs}
  • Default: false

doclet :

Specifies the class file that starts the doclet used in generating the documentation.
See doclet .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${doclet}

docletArtifact :

Specifies the artifact containing the doclet starting class file (specified with the -doclet option).
See docletpath .
Example:
<docletArtifact>
  <groupId>com.sun.tools.doclets</groupId>
  <artifactId>doccheck</artifactId>
  <version>1.2b2</version>
</docletArtifact>

See Javadoc .
  • Type: org.apache.maven.plugin.javadoc.options.DocletArtifact
  • Since: 2.0
  • Required: No
  • Expression: ${docletArtifact}

docletArtifacts :

Specifies multiple artifacts containing the path for the doclet starting class file (specified with the -doclet option).
See docletpath .
Example:
<docletArtifacts>
  <docletArtifact>
    <groupId>com.sun.tools.doclets</groupId>
    <artifactId>doccheck</artifactId>
    <version>1.2b2</version>
  </docletArtifact>
</docletArtifacts>

See Javadoc .
  • Type: org.apache.maven.plugin.javadoc.options.DocletArtifact[]
  • Since: 2.1
  • Required: No
  • Expression: ${docletArtifacts}

docletPath :

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 (:) on Solaris and a semi-colon (;) on Windows.
See docletpath .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${docletPath}

doctitle :

Specifies the title to be placed near the top of the overview summary file.
See doctitle .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${doctitle}
  • Default: ${project.name} ${project.version} API

encoding :

Specifies the encoding name of the source files. If not specificed, the encoding value will be the value of the file.encoding system property.
See encoding .
Note : In 2.4, the default value was locked to ISO-8859-1 to ensure reproducing build, but this was reverted in 2.5.
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${encoding}
  • Default: ${project.build.sourceEncoding}

excludePackageNames :

Unconditionally excludes the specified packages and their subpackages from the list formed by -subpackages. Multiple packages can be separated by colons (:).
See exclude .
Since Java 1.4 .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${excludePackageNames}

excludedocfilessubdir :

Excludes any "doc-files" subdirectories with the given names. Multiple patterns can be excluded by separating them with colons (:).
See excludedocfilessubdir .
Since Java 1.4 .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${excludedocfilessubdir}

extdirs :

Specifies the directories where extension classes reside. Separate directories in dirlist with a colon (:) on Solaris and a semi-colon (;) on Windows.
See extdirs .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${extdirs}

failOnError :

Specifies whether the build will continue even if there are errors.
  • Type: boolean
  • Since: 2.5
  • Required: No
  • Expression: ${maven.javadoc.failOnError}
  • Default: true

footer :

Specifies the footer text to be placed at the bottom of each output file.
See footer .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${footer}

groups :

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 (:).
See group .
Example:
<groups>
  <group>
    <title>Core Packages</title>
    <packages>org.apache.core</packages>
  </group>
</groups>

See Javadoc .
  • Type: org.apache.maven.plugin.javadoc.options.Group[]
  • Since: 2.0
  • Required: No
  • Expression: ${groups}

header :

Specifies the header text to be placed at the top of each output file.
See header .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${header}

helpfile :

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/>.
See helpfile .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${helpfile}

javadocDirectory :

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 .
  • Type: java.io.File
  • Since: 2.1
  • Required: No
  • Expression: ${basedir}/src/main/javadoc

javadocExecutable :

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.
  • Type: java.lang.String
  • Since: 2.3
  • Required: No
  • Expression: ${javadocExecutable}

javadocVersion :

Version of the Javadoc Tool executable to use, ex. "1.3", "1.5".
  • Type: java.lang.String
  • Since: 2.3
  • Required: No
  • Expression: ${javadocVersion}

keywords :

Adds HTML meta keyword tags to the generated file for each class.
See keywords .
Since Java 1.4.2 .
Since Java 5.0 .
  • Type: boolean
  • Since: 2.1
  • Required: No
  • Expression: ${keywords}
  • Default: false

links :

Creates links to existing javadoc-generated documentation of external referenced classes.
See link .
  • Type: java.util.ArrayList
  • Since: 2.0
  • Required: No
  • Expression: ${links}

linksource :

Creates an HTML version of each source file (with line numbers) and adds links to them from the standard HTML documentation.
See linksource .
Since Java 1.4 .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${linksource}
  • Default: false

localRepository :

The local repository where the artifacts are located.
  • Type: org.apache.maven.artifact.repository.ArtifactRepository
  • Since: 2.0
  • Required: No
  • Expression: ${localRepository}

locale :

Specifies the locale that javadoc uses when generating documentation.
See locale .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${locale}

maxmemory :

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.
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${maxmemory}

minmemory :

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.
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${minmemory}

name :

The name of the Javadoc report.
  • Type: java.lang.String
  • Since: 2.1
  • Required: No
  • Expression: ${name}

nocomment :

Suppress the entire comment body, including the main description and all tags, generating only declarations.
See nocomment .
Since Java 1.4 .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${nocomment}
  • Default: false

nodeprecated :

Prevents the generation of any deprecated API at all in the documentation.
See nodeprecated .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${nodeprecated}
  • Default: false

nodeprecatedlist :

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 nodeprecatedlist .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${nodeprecatedlist}
  • Default: false

nohelp :

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 nohelp .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${nohelp}
  • Default: false

noindex :

Omits the index from the generated docs.
Note : could be in conflict with <splitindex/>.
See noindex .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${noindex}
  • Default: false

nonavbar :

Omits the navigation bar from the generated docs.
See nonavbar .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${nonavbar}
  • Default: false

nooverview :

Omits the entire overview page from the generated docs.
Note : could be in conflict with <overview/>.
Standard Doclet undocumented option.
  • Type: boolean
  • Since: 2.4
  • Required: No
  • Expression: ${nooverview}
  • Default: false

noqualifier :

Omits qualifying package name from ahead of class names in output.
See noqualifier .
Since Java 1.4 .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${noqualifier}

nosince :

Omits from the generated docs the "Since" sections associated with the since tags.
See nosince .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${nosince}
  • Default: false

notimestamp :

Suppresses the timestamp, which is hidden in an HTML comment in the generated HTML near the top of each page.
See notimestamp .
Since Java 5.0 .
  • Type: boolean
  • Since: 2.1
  • Required: No
  • Expression: ${notimestamp}
  • Default: false

notree :

Omits the class/interface hierarchy pages from the generated docs.
See notree .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${notree}
  • Default: false

offlineLinks :

This option is a variation of -link; they both create links to javadoc-generated documentation for external referenced classes.
See linkoffline .
Example:
<offlineLinks>
  <offlineLink>
    <url>http://java.sun.com/j2se/1.5.0/docs/api/</url>
    <location>../javadoc/jdk-5.0/</location>
  </offlineLink>
</offlineLinks>

See Javadoc .
  • Type: org.apache.maven.plugin.javadoc.options.OfflineLink[]
  • Since: 2.0
  • Required: No
  • Expression: ${offlineLinks}

old :

This option creates documentation with the appearance and functionality of documentation generated by Javadoc 1.1.
See 1.1 .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${old}
  • Default: false

outputDirectory :

Specifies the destination directory where javadoc saves the generated HTML files.
See d .
  • Type: java.io.File
  • Since: 2.0
  • Required: Yes
  • Expression: ${destDir}
  • Default: ${project.build.directory}/apidocs

overview :

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 overview .
  • Type: java.io.File
  • Since: 2.0
  • Required: No
  • Expression: ${overview}
  • Default: ${basedir}/src/main/javadoc/overview.html

packagesheader :

Specify the text for upper left frame.
Since Java 1.4.2 .
  • Type: java.lang.String
  • Since: 2.1
  • Required: No
  • Expression: ${packagesheader}

proxyHost :

Deprecated. since 2.4. Instead of, configure an active proxy host in settings.xml.
Specifies the proxy host where the javadoc web access in -link would pass through. It defaults to the proxy host of the active proxy set in the settings.xml, otherwise it gets the proxy configuration set in the pom.
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${proxyHost}
  • Default: ${settings.activeProxy.host}

proxyPort :

Deprecated. since 2.4. Instead of, configure an active proxy port in settings.xml.
Specifies the proxy port where the javadoc web access in -link would pass through. It defaults to the proxy port of the active proxy set in the settings.xml, otherwise it gets the proxy configuration set in the pom.
  • Type: int
  • Since: 2.0
  • Required: No
  • Expression: ${proxyPort}
  • Default: ${settings.activeProxy.port}

quiet :

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 ).
See quiet .
Since Java 5.0.
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${quiet}
  • Default: false

remoteRepositories :

The remote repositories where artifacts are located.
  • Type: java.util.List
  • Since: 2.0
  • Required: No
  • Expression: ${project.remoteArtifactRepositories}

reportOutputDirectory :

Specifies the destination directory where javadoc saves the generated HTML files.
  • Type: java.io.File
  • Since: 2.0
  • Required: Yes
  • Expression: ${project.reporting.outputDirectory}/apidocs

resourcesArtifacts :

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 .
  • Type: org.apache.maven.plugin.javadoc.options.ResourcesArtifact[]
  • Since: 2.5
  • Required: No
  • Expression: ${resourcesArtifacts}

serialwarn :

Generates compile-time warnings for missing serial tags.
See serialwarn
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${serialwarn}
  • Default: false

show :

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)

  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${show}
  • Default: protected

skip :

Specifies whether the Javadoc generation should be skipped.
  • Type: boolean
  • Since: 2.5
  • Required: No
  • Expression: ${maven.javadoc.skip}
  • Default: false

source :

Necessary to enable javadoc to handle assertions present in J2SE v 1.4 source code.
See source .
Since Java 1.4 .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${source}

sourcepath :

Specifies the source paths where the subpackages are located. The paths are separated with a colon (:) on Solaris and a semi-colon (;) on Windows.
See sourcepath .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${sourcepath}

sourcetab :

Specify the number of spaces each tab takes up in the source. If no tab is used in source, the default space is used.
Note: was linksourcetab in Java 1.4.2 (refer to bug ID 4788919 ).
Since 1.4.2 .
Since Java 5.0.
  • Type: int
  • Since: 2.1
  • Required: No
  • Expression: ${sourcetab}

splitindex :

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 splitindex .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${splitindex}
  • Default: false

stylesheet :

Specifies whether the stylesheet to be used is the maven javadoc stylesheet or java's default stylesheet when a stylesheetfile parameter is not specified. Possible values: "maven" or "java".
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${stylesheet}
  • Default: java

stylesheetfile :

Specifies the path of an alternate HTML stylesheet file.
See stylesheetfile .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${stylesheetfile}

subpackages :

Specifies the package directory where javadoc will be executed. Multiple packages can be separated by colons (:).
See subpackages .
Since Java 1.4 .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${subpackages}

taglet :

Specifies the class file that starts the taglet used in generating the documentation for that tag.
See taglet .
Since Java 1.4 .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${taglet}

tagletArtifact :

Specifies the Taglet artifact containing the taglet class files (.class).
See tagletpath .
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 .
  • Type: org.apache.maven.plugin.javadoc.options.TagletArtifact
  • Since: 2.1
  • Required: No
  • Expression: ${tagletArtifact}

tagletArtifacts :

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.
See taglet .
See tagletpath .
Example:
<tagletArtifacts>
  <tagletArtifact>
    <groupId>group-Taglet</groupId>
    <artifactId>artifact-Taglet</artifactId>
    <version>version-Taglet</version>
  </tagletArtifact>
  ...
</tagletArtifacts>

See Javadoc .
  • Type: org.apache.maven.plugin.javadoc.options.TagletArtifact[]
  • Since: 2.5
  • Required: No
  • Expression: ${tagletArtifacts}

tagletpath :

Specifies the search paths for finding taglet class files (.class). The tagletPath can contain multiple paths by separating them with a colon (:) on Solaris and a semi-colon (;) on Windows.
See tagletpath .
Since Java 1.4 .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${tagletpath}

taglets :

Enables the Javadoc tool to interpret multiple taglets.
See taglet .
See tagletpath .
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 .
  • Type: org.apache.maven.plugin.javadoc.options.Taglet[]
  • Since: 2.1
  • Required: No
  • Expression: ${taglets}

tags :

Enables the Javadoc tool to interpret a simple, one-argument custom block tag tagname in doc comments.
See tag .
Since Java 1.4 .
Example:
<tags>
  <tag>
    <name>todo</name>
    <placement>a</placement>
    <head>To Do:</head>
  </tag>
</tags>

See Javadoc .
  • Type: org.apache.maven.plugin.javadoc.options.Tag[]
  • Since: 2.0
  • Required: No
  • Expression: ${tags}

top :

Specifies the top text to be placed at the top of each output file.
See 6227616 .
Since Java 6.0
  • Type: java.lang.String
  • Since: 2.4
  • Required: No
  • Expression: ${top}

use :

Includes one "Use" page for each documented class and package.
See use .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${use}
  • Default: true

useStandardDocletOptions :

Specifies to use the options provided by the Standard Doclet 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>
  • Type: boolean
  • Since: 2.5
  • Required: No
  • Expression: ${useStandardDocletOptions}
  • Default: true

verbose :

Provides more detailed messages while javadoc is running.
See verbose .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${verbose}
  • Default: false

version :

Includes the version text in the generated docs.
See version .
  • Type: boolean
  • Since: 2.0
  • Required: No
  • Expression: ${version}
  • Default: true

windowtitle :

Specifies the title to be placed in the HTML title tag.
See windowtitle .
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${windowtitle}
  • Default: ${project.name} ${project.version} API