Apache Maven Javadoc Plugin

javadoc:fix

Full name:

org.apache.maven.plugins:maven-javadoc-plugin:3.1.1:fix

Description:

Fix Javadoc documentation and tags for the Java code for the project. See Where Tags Can Be Used.

Attributes:

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

Optional Parameters

Name	Type	Since	Description
`<comparisonVersion>`	`String`	`2.6`	Version to compare the current code against using the Clirr Maven Plugin. See defaultSince. Default value is: `(,${project.version})`. User property is: `comparisonVersion`.
`<defaultAuthor>`	`String`	`2.6`	Default value for the Javadoc tag `@author`. If not specified, the `user.name` defined in the System properties will be used. User property is: `defaultAuthor`.
`<defaultSince>`	`String`	`2.6`	Default value for the Javadoc tag `@since`. Default value is: `${project.version}`. User property is: `defaultSince`.
`<defaultVersion>`	`String`	`2.6`	Default value for the Javadoc tag `@version`. By default, it is $Id:$ , corresponding to a SVN keyword. Refer to your SCM to use an other SCM keyword. Default value is: `$Id: $Id`. User property is: `defaultVersion`.
`<encoding>`	`String`	`2.6`	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. Default value is: `${project.build.sourceEncoding}`. User property is: `encoding`.
`<excludes>`	`String`	`2.6`	Comma separated excludes Java files, i.e. `*/Test.java`. User property is: `excludes`.
`<fixClassComment>`	`boolean`	`2.6`	Flag to fix the classes or interfaces Javadoc comments according the `level`. Default value is: `true`. User property is: `fixClassComment`.
`<fixFieldComment>`	`boolean`	`2.6`	Flag to fix the fields Javadoc comments according the `level`. Default value is: `true`. User property is: `fixFieldComment`.
`<fixMethodComment>`	`boolean`	`2.6`	Flag to fix the methods Javadoc comments according the `level`. Default value is: `true`. User property is: `fixMethodComment`.
`<fixTags>`	`String`	`2.6`	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) Default value is: `all`. User property is: `fixTags`.
`<force>`	`boolean`	`2.6`	Forcing the goal execution i.e. skip warranty messages (not recommended). User property is: `force`.
`<ignoreClirr>`	`boolean`	`2.6`	Flag to ignore or not Clirr. Default value is: `false`. User property is: `ignoreClirr`.
`<includes>`	`String`	`2.6`	Comma separated includes Java files, i.e. `*/Test.java`. Note: default value is `*\/.java`. Default value is: `*\/.java`. User property is: `includes`.
`<level>`	`String`	`2.6`	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`. User property is: `level`.
`<localRepository>`	`ArtifactRepository`	`2.6`	The local repository where the artifacts are located, used by the tests. User property is: `localRepository`.
`<outputDirectory>`	`File`	`2.6`	Output directory where Java classes will be rewritten. Default value is: `${project.build.sourceDirectory}`. User property is: `outputDirectory`.
`<removeUnknownThrows>`	`boolean`	`2.6`	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. Default value is: `true`. User property is: `removeUnknownThrows`.

Parameter Details

<comparisonVersion>

Version to compare the current code against using the Clirr Maven Plugin.
See defaultSince.

Type: java.lang.String
Since: 2.6
Required: No
User Property: comparisonVersion
Default: (,${project.version})

<defaultAuthor>

Default value for the Javadoc tag @author.
If not specified, the user.name defined in the System properties will be used.

Type: java.lang.String
Since: 2.6
Required: No
User Property: defaultAuthor

<defaultSince>

Default value for the Javadoc tag @since.

Type: java.lang.String
Since: 2.6
Required: No
User Property: defaultSince
Default: ${project.version}

<defaultVersion>

Default value for the Javadoc tag @version.
By default, it is $Id:$ , corresponding to a SVN keyword. Refer to your SCM to use an other SCM keyword.

Type: java.lang.String
Since: 2.6
Required: No
User Property: defaultVersion
Default: $Id: $Id

<encoding>

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.

Type: java.lang.String
Since: 2.6
Required: No
User Property: encoding
Default: ${project.build.sourceEncoding}