Modified: maven/website/components/plugins-archives/maven-checkstyle-plugin-LATEST/check-mojo.html ============================================================================== --- maven/website/components/plugins-archives/maven-checkstyle-plugin-LATEST/check-mojo.html (original) +++ maven/website/components/plugins-archives/maven-checkstyle-plugin-LATEST/check-mojo.html Sun Jun 2 14:48:29 2024 @@ -2,7 +2,7 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 1.11.1 from target\generated-site\xdoc/check-mojo.xml at 2023-10-21 + | Generated by Apache Maven Doxia Site Renderer 1.11.1 from org.apache.maven.plugins:maven-plugin-report-plugin:3.12.0:report at 2024-06-02 | Rendered using Apache Maven Fluido Skin 1.11.2 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> @@ -49,8 +49,8 @@ <li><a href="../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> <li><a href="index.html" title="Apache Maven Checkstyle Plugin">Apache Maven Checkstyle Plugin</a><span class="divider">/</span></li> <li class="active ">checkstyle:check</li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-10-21</li> - <li id="projectVersion" class="pull-right">Version: 3.3.1</li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-06-02</li> + <li id="projectVersion" class="pull-right">Version: 3.4.0</li> </ul> </div> </header> @@ -117,1115 +117,556 @@ </div> </header> <main id="bodyColumn" class="span10" > - - - <section> -<h2><a name="checkstyle:check"></a>checkstyle:check</h2> - -<p><b>Full name</b>:</p> - -<p>org.apache.maven.plugins:maven-checkstyle-plugin:3.3.1:check</p> - -<p><b>Description</b>:</p> - -<div>Performs Checkstyle analysis and outputs violations or a count of violations to the console, potentially failing the build. It can also be configured to re-use an earlier analysis.</div> - -<p><b>Attributes</b>:</p> - +<section> +<h2><a name="checkstyle:check"></a>checkstyle:check</h2><a name="checkstyle:check"></a> +<p><strong>Full name</strong>:</p> +<p>org.apache.maven.plugins:maven-checkstyle-plugin:3.4.0:check</p> +<p><strong>Description</strong>:</p> +<p>Performs Checkstyle analysis and outputs violations or a count of violations to the console, potentially failing the build. It can also be configured to re-use an earlier analysis.</p> +<p><strong>Attributes</strong>:</p> <ul> - <li>Requires a Maven project to be executed.</li> - <li>The goal is thread-safe and supports parallel builds.</li> - -<li>Binds by default to the <a class="externalLink" href="http://maven.apache.org/ref/current/maven-core/lifecycles.html">lifecycle phase</a>: <code>verify</code>.</li> - </ul> - <section> -<h3><a name="Required_Parameters"></a>Required Parameters</h3> - +<li>Binds by default to the <a class="externalLink" href="https://maven.apache.org/ref/current/maven-core/lifecycles.html">lifecycle phase</a>: <code>verify</code>.</li></ul><section> +<h3><a name="Required_Parameters"></a>Required Parameters</h3><a name="Required_Parameters"></a> <table border="0" class="table table-striped"> - <tr class="a"> - <th>Name</th> - <th>Type</th> - <th>Since</th> - -<th>Description</th> - </tr> - +<th>Description</th></tr> <tr class="b"> - -<td align="left"><code><a href="#includeResources"><includeResources></a></code></td> - +<td align="left"><a href="#includeResources"><code><includeResources></code></a></td> <td><code>boolean</code></td> - <td><code>2.11</code></td> - -<td>Whether to apply Checkstyle to resource directories.<br /><b>Default value is</b>: <code>true</code>.<br /><b>User property is</b>: <code>checkstyle.includeResources</code>.<br /></td> - </tr> - +<td>Whether to apply Checkstyle to resource directories.<br /><strong>Default</strong>: <code>true</code><br /><strong>User Property</strong>: <code>checkstyle.includeResources</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#includes"><includes></a></code></td> - -<td><code>String</code></td> - -<td><code>-</code></td> - -<td>Specifies the names filter of the source files to be used for Checkstyle.<br /><b>Default value is</b>: <code>**\/*.java</code>.<br /><b>User property is</b>: <code>checkstyle.includes</code>.<br /></td> - </tr> - -<tr class="b"> - -<td align="left"><code><a href="#includeTestResources"><includeTestResources></a></code></td> - +<td align="left"><a href="#includeTestResources"><code><includeTestResources></code></a></td> <td><code>boolean</code></td> - <td><code>2.11</code></td> - -<td>Whether to apply Checkstyle to test resource directories.<br /><b>Default value is</b>: <code>true</code>.<br /><b>User property is</b>: <code>checkstyle.includeTestResources</code>.<br /></td> - </tr> - +<td>Whether to apply Checkstyle to test resource directories.<br /><strong>Default</strong>: <code>true</code><br /><strong>User Property</strong>: <code>checkstyle.includeTestResources</code></td></tr> +<tr class="b"> +<td align="left"><a href="#includes"><code><includes></code></a></td> +<td><code>String</code></td> +<td><code>-</code></td> +<td>Specifies the names filter of the source files to be used for Checkstyle.<br /><strong>Default</strong>: <code>**\/*.java</code><br /><strong>User Property</strong>: <code>checkstyle.includes</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#resourceIncludes"><resourceIncludes></a></code></td> - +<td align="left"><a href="#resourceIncludes"><code><resourceIncludes></code></a></td> <td><code>String</code></td> - <td><code>2.11</code></td> - -<td>Specifies the names filter of the files to be used for Checkstyle when checking resources.<br /><b>Default value is</b>: <code>**/*.properties</code>.<br /><b>User property is</b>: <code>checkstyle.resourceIncludes</code>.<br /></td> - </tr> - </table> - </section> - <section> -<h3><a name="Optional_Parameters"></a>Optional Parameters</h3> - +<td>Specifies the names filter of the files to be used for Checkstyle when checking resources.<br /><strong>Default</strong>: <code>**/*.properties</code><br /><strong>User Property</strong>: <code>checkstyle.resourceIncludes</code></td></tr></table></section><section> +<h3><a name="Optional_Parameters"></a>Optional Parameters</h3><a name="Optional_Parameters"></a> <table border="0" class="table table-striped"> - <tr class="a"> - <th>Name</th> - <th>Type</th> - <th>Since</th> - -<th>Description</th> - </tr> - +<th>Description</th></tr> <tr class="b"> - -<td align="left"><code><a href="#cacheFile"><cacheFile></a></code></td> - +<td align="left"><a href="#cacheFile"><code><cacheFile></code></a></td> <td><code>String</code></td> - <td><code>-</code></td> - -<td>Specifies the cache file used to speed up Checkstyle on successive runs.<br /><b>Default value is</b>: <code>${project.build.directory}/checkstyle-cachefile</code>.<br /></td> - </tr> - +<td>Specifies the cache file used to speed up Checkstyle on successive runs.<br /><strong>Default</strong>: <code>${project.build.directory}/checkstyle-cachefile</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#checkstyleRules"><checkstyleRules></a></code></td> - +<td align="left"><a href="#checkstyleRules"><code><checkstyleRules></code></a></td> <td><code>PlexusConfiguration</code></td> - <td><code>2.12</code></td> - <td>By using this property, you can specify the whole Checkstyle rules inline directly inside this pom. - -<div> <pre> <plugin> ... <configuration> <checkstyleRules> - <module name="Checker"> - <module name="FileTabCharacter"> - <property name="eachLine" value="true" /> + <module name="Checker"> + <module name="FileTabCharacter"> + <property name="eachLine" value="true" /> </module> - <module name="TreeWalker"> - <module name="EmptyBlock"/> + <module name="TreeWalker"> + <module name="EmptyBlock"/> </module> </module> </checkstyleRules> </configuration> ... -</pre></div><br /></td> - </tr> - +</pre></td></tr> <tr class="b"> - -<td align="left"><code><a href="#checkstyleRulesHeader"><checkstyleRulesHeader></a></code></td> - +<td align="left"><a href="#checkstyleRulesHeader"><code><checkstyleRulesHeader></code></a></td> <td><code>String</code></td> - <td><code>-</code></td> - -<td>The header to use for the inline configuration. Only used when you specify <code>checkstyleRules</code>.<br /><b>Default value is</b>: <code><?xml version="1.0"?> +<td>The header to use for the inline configuration. Only used when you specify <code>checkstyleRules</code>.<br /><strong>Default</strong>: <code><?xml version="1.0"?> <!DOCTYPE module PUBLIC "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN" "https://checkstyle.org/dtds/configuration_1_3.dtd"> -</code>.<br /></td> - </tr> - +</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#configLocation"><configLocation></a></code></td> - +<td align="left"><a href="#configLocation"><code><configLocation></code></a></td> <td><code>String</code></td> - <td><code>2.5</code></td> - -<td> -<p>Specifies the location of the XML configuration to use.</p> - -<p>Potential values are a filesystem path, a URL, or a classpath resource. This parameter expects that the contents of the location conform to the xml format (Checkstyle <a class="externalLink" href="https://checkstyle.org/config.html#Modules">Checker module</a>) configuration of rulesets.</p> - +<td><p>Specifies the location of the XML configuration to use.</p> +<p>Potential values are a filesystem path, a URL, or a classpath resource. This parameter expects that the contents of the location conform to the xml format (Checkstyle <a href="https://checkstyle.org/config.html#Modules">Checker module</a>) configuration of rulesets.</p> <p>This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the <code>${project.build.directory}/checkstyle-configuration.xml</code> file before being passed to Checkstyle as a configuration.</p> - <p>There are 2 predefined rulesets.</p> - <ul> - -<li><code>sun_checks.xml</code>: Sun Checks.</li> - -<li><code>google_checks.xml</code>: Google Checks.</li> -</ul><br /><b>Default value is</b>: <code>sun_checks.xml</code>.<br /><b>User property is</b>: <code>checkstyle.config.location</code>.<br /></td> - </tr> - + <li><code>sun_checks.xml</code>: Sun Checks.</li> + <li><code>google_checks.xml</code>: Google Checks.</li> +</ul><br /><strong>Default</strong>: <code>sun_checks.xml</code><br /><strong>User Property</strong>: <code>checkstyle.config.location</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#consoleOutput"><consoleOutput></a></code></td> - +<td align="left"><a href="#consoleOutput"><code><consoleOutput></code></a></td> <td><code>boolean</code></td> - <td><code>-</code></td> - -<td>Output errors to console.<br /><b>Default value is</b>: <code>false</code>.<br /><b>User property is</b>: <code>checkstyle.consoleOutput</code>.<br /></td> - </tr> - +<td>Output errors to console.<br /><strong>Default</strong>: <code>false</code><br /><strong>User Property</strong>: <code>checkstyle.consoleOutput</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#excludeGeneratedSources"><excludeGeneratedSources></a></code></td> - +<td align="left"><a href="#excludeGeneratedSources"><code><excludeGeneratedSources></code></a></td> <td><code>boolean</code></td> - <td><code>3.3.1</code></td> - -<td>Specifies whether generated source files should be excluded from Checkstyle.<br /><b>Default value is</b>: <code>false</code>.<br /><b>User property is</b>: <code>checkstyle.excludeGeneratedSources</code>.<br /></td> - </tr> - +<td>Specifies whether generated source files should be excluded from Checkstyle.<br /><strong>Default</strong>: <code>false</code><br /><strong>User Property</strong>: <code>checkstyle.excludeGeneratedSources</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#excludes"><excludes></a></code></td> - +<td align="left"><a href="#excludes"><code><excludes></code></a></td> <td><code>String</code></td> - <td><code>-</code></td> - -<td>Specifies the names filter of the source files to be excluded for Checkstyle.<br /><b>User property is</b>: <code>checkstyle.excludes</code>.<br /></td> - </tr> - +<td>Specifies the names filter of the source files to be excluded for Checkstyle.<br /><strong>User Property</strong>: <code>checkstyle.excludes</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#failOnViolation"><failOnViolation></a></code></td> - +<td align="left"><a href="#failOnViolation"><code><failOnViolation></code></a></td> <td><code>boolean</code></td> - <td><code>-</code></td> - -<td>Fail the build on a violation. The goal checks for the violations after logging them (if <a href="#logViolationsToConsole"><code>logViolationsToConsole</code></a> is <code>true</code>). Compare this to <a href="#failsOnError"><code>failsOnError</code></a> which fails the build immediately before examining the output log.<br /><b>Default value is</b>: <code>true</code>.<br /><b>User property is</b>: <code>checkstyle.failOnViolation</code>.<br /></td> - </tr> - +<td>Fail the build on a violation. The goal checks for the violations after logging them (if <a href="#logViolationsToConsole"><code>logViolationsToConsole</code></a> is <code>true</code>). Compare this to <a href="#failsOnError"><code>failsOnError</code></a> which fails the build immediately before examining the output log.<br /><strong>Default</strong>: <code>true</code><br /><strong>User Property</strong>: <code>checkstyle.failOnViolation</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#failsOnError"><failsOnError></a></code></td> - +<td align="left"><a href="#failsOnError"><code><failsOnError></code></a></td> <td><code>boolean</code></td> - <td><code>-</code></td> - -<td>If this is true, and Checkstyle reported any violations or errors, the build fails immediately after running Checkstyle, before checking the log for <a href="#logViolationsToConsole"><code>logViolationsToConsole</code></a>. If you want to use <a href="#logViolationsToConsole"><code>logViolationsToConsole</code></a>, use <a href="#failOnViolation"><code>failOnViolation</code></a> instead of this.<br /><b>Default value is</b>: <code>false</code>.<br /></td> - </tr> - +<td>If this is true, and Checkstyle reported any violations or errors, the build fails immediately after running Checkstyle, before checking the log for <a href="#logViolationsToConsole"><code>logViolationsToConsole</code></a>. If you want to use <a href="#logViolationsToConsole"><code>logViolationsToConsole</code></a>, use <a href="#failOnViolation"><code>failOnViolation</code></a> instead of this.<br /><strong>Default</strong>: <code>false</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#headerLocation"><headerLocation></a></code></td> - +<td align="left"><a href="#headerLocation"><code><headerLocation></code></a></td> <td><code>String</code></td> - <td><code>2.0-beta-2</code></td> - -<td> -<p>Specifies the location of the License file (a.k.a. the header file) that can be used by Checkstyle to verify that source code has the correct license header.</p> - +<td><p>Specifies the location of the License file (a.k.a. the header file) that can be used by Checkstyle to verify that source code has the correct license header.</p> <p>You need to use <code>${checkstyle.header.file}</code> in your Checkstyle xml configuration to reference the name of this header file.</p> - <p>For instance:</p> - -<div> <pre> -<module name="RegexpHeader"> - <property name="headerFile" value="${checkstyle.header.file}"/> +<module name="RegexpHeader"> + <property name="headerFile" value="${checkstyle.header.file}"/> </module> -</pre></div><br /><b>Default value is</b>: <code>LICENSE.txt</code>.<br /><b>User property is</b>: <code>checkstyle.header.file</code>.<br /></td> - </tr> - +</pre><br /><strong>Default</strong>: <code>LICENSE.txt</code><br /><strong>User Property</strong>: <code>checkstyle.header.file</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#includeTestSourceDirectory"><includeTestSourceDirectory></a></code></td> - +<td align="left"><a href="#includeTestSourceDirectory"><code><includeTestSourceDirectory></code></a></td> <td><code>boolean</code></td> - <td><code>2.2</code></td> - -<td>Include or not the test source directory to be used for Checkstyle.<br /><b>Default value is</b>: <code>false</code>.<br /></td> - </tr> - +<td>Include or not the test source directory to be used for Checkstyle.<br /><strong>Default</strong>: <code>false</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#inputEncoding"><inputEncoding></a></code></td> - +<td align="left"><a href="#inputEncoding"><code><inputEncoding></code></a></td> <td><code>String</code></td> - <td><code>2.2</code></td> - -<td>The file encoding to use when reading the source files. If the property <code>project.build.sourceEncoding</code> is not set, the platform default encoding is used. <b>Note:</b> This parameter always overrides the property <code>charset</code> from Checkstyle's <code>TreeWalker</code> module.<br /><b>Default value is</b>: <code>${project.build.sourceEncoding}</code>.<br /><b>User property is</b>: <code>encoding</code>.<br /></td> - </tr> - +<td>The file encoding to use when reading the source files. If the property <code>project.build.sourceEncoding</code> is not set, the platform default encoding is used. <strong>Note:</strong> This parameter always overrides the property <code>charset</code> from Checkstyle's <code>TreeWalker</code> module.<br /><strong>Default</strong>: <code>${project.build.sourceEncoding}</code><br /><strong>User Property</strong>: <code>encoding</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#logViolationCountToConsole"><logViolationCountToConsole></a></code></td> - +<td align="left"><a href="#logViolationCountToConsole"><code><logViolationCountToConsole></code></a></td> <td><code>boolean</code></td> - <td><code>3.0.1</code></td> - -<td>Output the detected violation count to the console.<br /><b>Default value is</b>: <code>true</code>.<br /><b>User property is</b>: <code>checkstyle.logViolationCount</code>.<br /></td> - </tr> - +<td>Output the detected violation count to the console.<br /><strong>Default</strong>: <code>true</code><br /><strong>User Property</strong>: <code>checkstyle.logViolationCount</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#logViolationsToConsole"><logViolationsToConsole></a></code></td> - +<td align="left"><a href="#logViolationsToConsole"><code><logViolationsToConsole></code></a></td> <td><code>boolean</code></td> - <td><code>2.3</code></td> - -<td>Output the detected violations to the console.<br /><b>Default value is</b>: <code>true</code>.<br /><b>User property is</b>: <code>checkstyle.console</code>.<br /></td> - </tr> - +<td>Output the detected violations to the console.<br /><strong>Default</strong>: <code>true</code><br /><strong>User Property</strong>: <code>checkstyle.console</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#maxAllowedViolations"><maxAllowedViolations></a></code></td> - +<td align="left"><a href="#maxAllowedViolations"><code><maxAllowedViolations></code></a></td> <td><code>int</code></td> - <td><code>2.3</code></td> - -<td>The maximum number of allowed violations. The execution fails only if the number of violations is above this limit.<br /><b>Default value is</b>: <code>0</code>.<br /><b>User property is</b>: <code>checkstyle.maxAllowedViolations</code>.<br /></td> - </tr> - +<td>The maximum number of allowed violations. The execution fails only if the number of violations is above this limit.<br /><strong>Default</strong>: <code>0</code><br /><strong>User Property</strong>: <code>checkstyle.maxAllowedViolations</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#omitIgnoredModules"><omitIgnoredModules></a></code></td> - +<td align="left"><a href="#omitIgnoredModules"><code><omitIgnoredModules></code></a></td> <td><code>boolean</code></td> - <td><code>3.0.0</code></td> - -<td>Specifies whether modules with a configured severity of <code>ignore</code> should be omitted during Checkstyle invocation.<br /><b>Default value is</b>: <code>false</code>.<br /></td> - </tr> - +<td>Specifies whether modules with a configured severity of <code>ignore</code> should be omitted during Checkstyle invocation.<br /><strong>Default</strong>: <code>false</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#outputFile"><outputFile></a></code></td> - +<td align="left"><a href="#outputFile"><code><outputFile></code></a></td> <td><code>File</code></td> - <td><code>-</code></td> - -<td>Specifies the path and filename to save the Checkstyle output. The format of the output file is determined by the <code>outputFileFormat</code> parameter.<br /><b>Default value is</b>: <code>${project.build.directory}/checkstyle-result.xml</code>.<br /><b>User property is</b>: <code>checkstyle.output.file</code>.<br /></td> - </tr> - +<td>Specifies the path and filename to save the Checkstyle output. The format of the output file is determined by the <code>outputFileFormat</code> parameter.<br /><strong>Default</strong>: <code>${project.build.directory}/checkstyle-result.xml</code><br /><strong>User Property</strong>: <code>checkstyle.output.file</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#outputFileFormat"><outputFileFormat></a></code></td> - +<td align="left"><a href="#outputFileFormat"><code><outputFileFormat></code></a></td> <td><code>String</code></td> - <td><code>-</code></td> - -<td>Specifies the format of the output to be used when writing to the output file. Valid values are "<code>plain</code>" and "<code>xml</code>".<br /><b>Default value is</b>: <code>xml</code>.<br /><b>User property is</b>: <code>checkstyle.output.format</code>.<br /></td> - </tr> - +<td>Specifies the format of the output to be used when writing to the output file. Valid values are "<code>plain</code>", "<code>sarif</code>" and "<code>xml</code>".<br /><strong>Default</strong>: <code>xml</code><br /><strong>User Property</strong>: <code>checkstyle.output.format</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#propertiesLocation"><propertiesLocation></a></code></td> - +<td align="left"><a href="#propertiesLocation"><code><propertiesLocation></code></a></td> <td><code>String</code></td> - <td><code>2.5</code></td> - -<td> -<p>Specifies the location of the properties file.</p> - +<td><p>Specifies the location of the properties file.</p> <p>This parameter is resolved as URL, File then resource. If successfully resolved, the contents of the properties location is copied into the <code>${project.build.directory}/checkstyle-checker.properties</code> file before being passed to Checkstyle for loading.</p> - -<p>The contents of the <code>propertiesLocation</code> will be made available to Checkstyle for specifying values for parameters within the xml configuration (specified in the <code>configLocation</code> parameter).</p><br /><b>User property is</b>: <code>checkstyle.properties.location</code>.<br /></td> - </tr> - +<p>The contents of the <code>propertiesLocation</code> will be made available to Checkstyle for specifying values for parameters within the xml configuration (specified in the <code>configLocation</code> parameter).</p><br /><strong>User Property</strong>: <code>checkstyle.properties.location</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#propertyExpansion"><propertyExpansion></a></code></td> - +<td align="left"><a href="#propertyExpansion"><code><propertyExpansion></code></a></td> <td><code>String</code></td> - <td><code>-</code></td> - -<td>Allows for specifying raw property expansion information.<br /></td> - </tr> - +<td>Allows for specifying raw property expansion information.</td></tr> <tr class="b"> - -<td align="left"><code><a href="#resourceExcludes"><resourceExcludes></a></code></td> - +<td align="left"><a href="#resourceExcludes"><code><resourceExcludes></code></a></td> <td><code>String</code></td> - <td><code>2.11</code></td> - -<td>Specifies the names filter of the files to be excluded for Checkstyle when checking resources.<br /><b>User property is</b>: <code>checkstyle.resourceExcludes</code>.<br /></td> - </tr> - +<td>Specifies the names filter of the files to be excluded for Checkstyle when checking resources.<br /><strong>User Property</strong>: <code>checkstyle.resourceExcludes</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#rulesFiles"><rulesFiles></a></code></td> - +<td align="left"><a href="#rulesFiles"><code><rulesFiles></code></a></td> <td><code>File</code></td> - <td><code>-</code></td> - -<td>Dump file for inlined Checkstyle rules.<br /><b>Default value is</b>: <code>${project.build.directory}/checkstyle-rules.xml</code>.<br /><b>User property is</b>: <code>checkstyle.output.rules.file</code>.<br /></td> - </tr> - +<td>Dump file for inlined Checkstyle rules.<br /><strong>Default</strong>: <code>${project.build.directory}/checkstyle-rules.xml</code><br /><strong>User Property</strong>: <code>checkstyle.output.rules.file</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#skip"><skip></a></code></td> - +<td align="left"><a href="#skip"><code><skip></code></a></td> <td><code>boolean</code></td> - <td><code>2.2</code></td> - -<td>Skip entire check.<br /><b>Default value is</b>: <code>false</code>.<br /><b>User property is</b>: <code>checkstyle.skip</code>.<br /></td> - </tr> - +<td>Skip entire check.<br /><strong>Default</strong>: <code>false</code><br /><strong>User Property</strong>: <code>checkstyle.skip</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#skipExec"><skipExec></a></code></td> - +<td align="left"><a href="#skipExec"><code><skipExec></code></a></td> <td><code>boolean</code></td> - <td><code>2.5</code></td> - -<td>Skip Checkstyle execution will only scan the outputFile.<br /><b>Default value is</b>: <code>false</code>.<br /><b>User property is</b>: <code>checkstyle.skipExec</code>.<br /></td> - </tr> - +<td>Skip Checkstyle execution will only scan the outputFile.<br /><strong>Default</strong>: <code>false</code><br /><strong>User Property</strong>: <code>checkstyle.skipExec</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#sourceDirectories"><sourceDirectories></a></code></td> - +<td align="left"><a href="#sourceDirectories"><code><sourceDirectories></code></a></td> <td><code>List<String></code></td> - <td><code>2.13</code></td> - -<td>Specifies the location of the source directories to be used for Checkstyle. Default value is <code>${project.compileSourceRoots}</code>.<br /></td> - </tr> - +<td>Specifies the location of the source directories to be used for Checkstyle. Default value is <code>${project.compileSourceRoots}</code>.</td></tr> <tr class="a"> - -<td align="left"><code><a href="#sourceDirectory"><sourceDirectory></a></code></td> - +<td align="left"><a href="#sourceDirectory"><code><sourceDirectory></code></a></td> <td><code>File</code></td> - <td><code>-</code></td> - -<td><b>Deprecated.</b> Specifies the location of the source directory to be used for Checkstyle.<br /></td> - </tr> - +<td> +<div><strong>Deprecated.</strong><br />instead use <a href="#sourceDirectories"><code>sourceDirectories</code></a>. For version 3.0.0, this parameter is only defined to break the build if you use it!</div><br />Specifies the location of the source directory to be used for Checkstyle.</td></tr> <tr class="b"> - -<td align="left"><code><a href="#suppressionsFileExpression"><suppressionsFileExpression></a></code></td> - +<td align="left"><a href="#suppressionsFileExpression"><code><suppressionsFileExpression></code></a></td> <td><code>String</code></td> - <td><code>2.1</code></td> - -<td>The key to be used in the properties for the suppressions file.<br /><b>Default value is</b>: <code>checkstyle.suppressions.file</code>.<br /><b>User property is</b>: <code>checkstyle.suppression.expression</code>.<br /></td> - </tr> - +<td>The key to be used in the properties for the suppressions file.<br /><strong>Default</strong>: <code>checkstyle.suppressions.file</code><br /><strong>User Property</strong>: <code>checkstyle.suppression.expression</code></td></tr> <tr class="a"> - -<td align="left"><code><a href="#suppressionsLocation"><suppressionsLocation></a></code></td> - +<td align="left"><a href="#suppressionsLocation"><code><suppressionsLocation></code></a></td> <td><code>String</code></td> - <td><code>2.0-beta-2</code></td> - -<td> -<p>Specifies the location of the suppressions XML file to use.</p> - +<td><p>Specifies the location of the suppressions XML file to use.</p> <p>This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the suppressions XML is copied into the <code>${project.build.directory}/checkstyle-suppressions.xml</code> file before being passed to Checkstyle for loading.</p> - -<p>See <code>suppressionsFileExpression</code> for the property that will be made available to your Checkstyle configuration.</p><br /><b>User property is</b>: <code>checkstyle.suppressions.location</code>.<br /></td> - </tr> - +<p>See <code>suppressionsFileExpression</code> for the property that will be made available to your Checkstyle configuration.</p><br /><strong>User Property</strong>: <code>checkstyle.suppressions.location</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#testSourceDirectories"><testSourceDirectories></a></code></td> - +<td align="left"><a href="#testSourceDirectories"><code><testSourceDirectories></code></a></td> <td><code>List<String></code></td> - <td><code>2.13</code></td> - -<td>Specifies the location of the test source directories to be used for Checkstyle. Default value is <code>${project.testCompileSourceRoots}</code>.<br /></td> - </tr> - +<td>Specifies the location of the test source directories to be used for Checkstyle. Default value is <code>${project.testCompileSourceRoots}</code>.</td></tr> <tr class="a"> - -<td align="left"><code><a href="#testSourceDirectory"><testSourceDirectory></a></code></td> - +<td align="left"><a href="#testSourceDirectory"><code><testSourceDirectory></code></a></td> <td><code>File</code></td> - <td><code>2.2</code></td> - -<td><b>Deprecated.</b> Specifies the location of the test source directory to be used for Checkstyle.<br /></td> - </tr> - +<td> +<div><strong>Deprecated.</strong><br />instead use <a href="#testSourceDirectories"><code>testSourceDirectories</code></a>. For version 3.0.0, this parameter is only defined to break the build if you use it!</div><br />Specifies the location of the test source directory to be used for Checkstyle.</td></tr> <tr class="b"> - -<td align="left"><code><a href="#useFile"><useFile></a></code></td> - +<td align="left"><a href="#useFile"><code><useFile></code></a></td> <td><code>File</code></td> - <td><code>-</code></td> - -<td>If <code>null</code>, the Checkstyle plugin will display violations on stdout. Otherwise, a text file will be created with the violations.<br /></td> - </tr> - +<td>If <code>null</code>, the Checkstyle plugin will display violations on stdout. Otherwise, a text file will be created with the violations.</td></tr> <tr class="a"> - -<td align="left"><code><a href="#violationIgnore"><violationIgnore></a></code></td> - +<td align="left"><a href="#violationIgnore"><code><violationIgnore></code></a></td> <td><code>String</code></td> - <td><code>2.13</code></td> - -<td>Violations to ignore. This is a comma-separated list, each value being either a rule name, a rule category or a java package name of rule class.<br /><b>User property is</b>: <code>checkstyle.violation.ignore</code>.<br /></td> - </tr> - +<td>Violations to ignore. This is a comma-separated list, each value being either a rule name, a rule category or a java package name of rule class.<br /><strong>User Property</strong>: <code>checkstyle.violation.ignore</code></td></tr> <tr class="b"> - -<td align="left"><code><a href="#violationSeverity"><violationSeverity></a></code></td> - +<td align="left"><a href="#violationSeverity"><code><violationSeverity></code></a></td> <td><code>String</code></td> - <td><code>2.2</code></td> - -<td>The lowest severity level that is considered a violation. Valid values are "<code>error</code>", "<code>warning</code>" and "<code>info</code>".<br /><b>Default value is</b>: <code>error</code>.<br /><b>User property is</b>: <code>checkstyle.violationSeverity</code>.<br /></td> - </tr> - </table> - </section> - <section> -<h3><a name="Parameter_Details"></a>Parameter Details</h3> - <section> -<h4><a name="a.3CcacheFile.3E"></a><b><a name="cacheFile"><cacheFile></a></b></h4> - +<td>The lowest severity level that is considered a violation. Valid values are "<code>error</code>", "<code>warning</code>" and "<code>info</code>".<br /><strong>Default</strong>: <code>error</code><br /><strong>User Property</strong>: <code>checkstyle.violationSeverity</code></td></tr></table></section><section> +<h3><a name="Parameter_Details"></a>Parameter Details</h3><a name="Parameter_Details"></a><a name="cacheFile"><section> +<h4><a name="a.3CcacheFile.3E"></a><cacheFile></h4><a name="a.3CcacheFile.3E"></a></a> <div>Specifies the cache file used to speed up Checkstyle on successive runs.</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>Default</b>: <code>${project.build.directory}/checkstyle-cachefile</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CcheckstyleRules.3E"></a><b><a name="checkstyleRules"><checkstyleRules></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>Default</strong>: <code>${project.build.directory}/checkstyle-cachefile</code></li></ul><hr /></section><a name="checkstyleRules"><section> +<h4><a name="a.3CcheckstyleRules.3E"></a><checkstyleRules></h4><a name="a.3CcheckstyleRules.3E"></a></a> <div>By using this property, you can specify the whole Checkstyle rules inline directly inside this pom. - -<div> <pre> <plugin> ... <configuration> <checkstyleRules> - <module name="Checker"> - <module name="FileTabCharacter"> - <property name="eachLine" value="true" /> + <module name="Checker"> + <module name="FileTabCharacter"> + <property name="eachLine" value="true" /> </module> - <module name="TreeWalker"> - <module name="EmptyBlock"/> + <module name="TreeWalker"> + <module name="EmptyBlock"/> </module> </module> </checkstyleRules> </configuration> ... -</pre></div></div> - +</pre></div> <ul> - -<li><b>Type</b>: <code>org.codehaus.plexus.configuration.PlexusConfiguration</code></li> - -<li><b>Since</b>: <code>2.12</code></li> - -<li><b>Required</b>: <code>No</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CcheckstyleRulesHeader.3E"></a><b><a name="checkstyleRulesHeader"><checkstyleRulesHeader></a></b></h4> - +<li><strong>Type</strong>: <code>org.codehaus.plexus.configuration.PlexusConfiguration</code></li> +<li><strong>Since</strong>: <code>2.12</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="checkstyleRulesHeader"><section> +<h4><a name="a.3CcheckstyleRulesHeader.3E"></a><checkstyleRulesHeader></h4><a name="a.3CcheckstyleRulesHeader.3E"></a></a> <div>The header to use for the inline configuration. Only used when you specify <code>checkstyleRules</code>.</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>Default</b>: <code><?xml version="1.0"?> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>Default</strong>: <code><?xml version="1.0"?> <!DOCTYPE module PUBLIC "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN" "https://checkstyle.org/dtds/configuration_1_3.dtd"> -</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CconfigLocation.3E"></a><b><a name="configLocation"><configLocation></a></b></h4> - -<div> -<p>Specifies the location of the XML configuration to use.</p> - -<p>Potential values are a filesystem path, a URL, or a classpath resource. This parameter expects that the contents of the location conform to the xml format (Checkstyle <a class="externalLink" href="https://checkstyle.org/config.html#Modules">Checker module</a>) configuration of rulesets.</p> - +</code></li></ul><hr /></section><a name="configLocation"><section> +<h4><a name="a.3CconfigLocation.3E"></a><configLocation></h4><a name="a.3CconfigLocation.3E"></a></a> +<div><p>Specifies the location of the XML configuration to use.</p> +<p>Potential values are a filesystem path, a URL, or a classpath resource. This parameter expects that the contents of the location conform to the xml format (Checkstyle <a href="https://checkstyle.org/config.html#Modules">Checker module</a>) configuration of rulesets.</p> <p>This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the configuration is copied into the <code>${project.build.directory}/checkstyle-configuration.xml</code> file before being passed to Checkstyle as a configuration.</p> - <p>There are 2 predefined rulesets.</p> - <ul> - -<li><code>sun_checks.xml</code>: Sun Checks.</li> - -<li><code>google_checks.xml</code>: Google Checks.</li> + <li><code>sun_checks.xml</code>: Sun Checks.</li> + <li><code>google_checks.xml</code>: Google Checks.</li> </ul></div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.5</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.config.location</code></li> - -<li><b>Default</b>: <code>sun_checks.xml</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CconsoleOutput.3E"></a><b><a name="consoleOutput"><consoleOutput></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.5</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.config.location</code></li> +<li><strong>Default</strong>: <code>sun_checks.xml</code></li></ul><hr /></section><a name="consoleOutput"><section> +<h4><a name="a.3CconsoleOutput.3E"></a><consoleOutput></h4><a name="a.3CconsoleOutput.3E"></a></a> <div>Output errors to console.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.consoleOutput</code></li> - -<li><b>Default</b>: <code>false</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CexcludeGeneratedSources.3E"></a><b><a name="excludeGeneratedSources"><excludeGeneratedSources></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.consoleOutput</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="excludeGeneratedSources"><section> +<h4><a name="a.3CexcludeGeneratedSources.3E"></a><excludeGeneratedSources></h4><a name="a.3CexcludeGeneratedSources.3E"></a></a> <div>Specifies whether generated source files should be excluded from Checkstyle.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Since</b>: <code>3.3.1</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.excludeGeneratedSources</code></li> - -<li><b>Default</b>: <code>false</code></li> - </ul><hr /></section><section> -<h4><a name="a.3Cexcludes.3E"></a><b><a name="excludes"><excludes></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>3.3.1</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.excludeGeneratedSources</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="excludes"><section> +<h4><a name="a.3Cexcludes.3E"></a><excludes></h4><a name="a.3Cexcludes.3E"></a></a> <div>Specifies the names filter of the source files to be excluded for Checkstyle.</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.excludes</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CfailOnViolation.3E"></a><b><a name="failOnViolation"><failOnViolation></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.excludes</code></li></ul><hr /></section><a name="failOnViolation"><section> +<h4><a name="a.3CfailOnViolation.3E"></a><failOnViolation></h4><a name="a.3CfailOnViolation.3E"></a></a> <div>Fail the build on a violation. The goal checks for the violations after logging them (if <a href="#logViolationsToConsole"><code>logViolationsToConsole</code></a> is <code>true</code>). Compare this to <a href="#failsOnError"><code>failsOnError</code></a> which fails the build immediately before examining the output log.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.failOnViolation</code></li> - -<li><b>Default</b>: <code>true</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CfailsOnError.3E"></a><b><a name="failsOnError"><failsOnError></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.failOnViolation</code></li> +<li><strong>Default</strong>: <code>true</code></li></ul><hr /></section><a name="failsOnError"><section> +<h4><a name="a.3CfailsOnError.3E"></a><failsOnError></h4><a name="a.3CfailsOnError.3E"></a></a> <div>If this is true, and Checkstyle reported any violations or errors, the build fails immediately after running Checkstyle, before checking the log for <a href="#logViolationsToConsole"><code>logViolationsToConsole</code></a>. If you want to use <a href="#logViolationsToConsole"><code>logViolationsToConsole</code></a>, use <a href="#failOnViolation"><code>failOnViolation</code></a> instead of this.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>Default</b>: <code>false</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CheaderLocation.3E"></a><b><a name="headerLocation"><headerLocation></a></b></h4> - -<div> -<p>Specifies the location of the License file (a.k.a. the header file) that can be used by Checkstyle to verify that source code has the correct license header.</p> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="headerLocation"><section> +<h4><a name="a.3CheaderLocation.3E"></a><headerLocation></h4><a name="a.3CheaderLocation.3E"></a></a> +<div><p>Specifies the location of the License file (a.k.a. the header file) that can be used by Checkstyle to verify that source code has the correct license header.</p> <p>You need to use <code>${checkstyle.header.file}</code> in your Checkstyle xml configuration to reference the name of this header file.</p> - <p>For instance:</p> - -<div> <pre> -<module name="RegexpHeader"> - <property name="headerFile" value="${checkstyle.header.file}"/> +<module name="RegexpHeader"> + <property name="headerFile" value="${checkstyle.header.file}"/> </module> -</pre></div></div> - +</pre></div> <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.0-beta-2</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.header.file</code></li> - -<li><b>Default</b>: <code>LICENSE.txt</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CincludeResources.3E"></a><b><a name="includeResources"><includeResources></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.0-beta-2</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.header.file</code></li> +<li><strong>Default</strong>: <code>LICENSE.txt</code></li></ul><hr /></section><a name="includeResources"><section> +<h4><a name="a.3CincludeResources.3E"></a><includeResources></h4><a name="a.3CincludeResources.3E"></a></a> <div>Whether to apply Checkstyle to resource directories.</div> - -<ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Since</b>: <code>2.11</code></li> - -<li><b>Required</b>: <code>Yes</code></li> - -<li><b>User Property</b>: <code>checkstyle.includeResources</code></li> - -<li><b>Default</b>: <code>true</code></li> - </ul><hr /></section><section> -<h4><a name="a.3Cincludes.3E"></a><b><a name="includes"><includes></a></b></h4> - -<div>Specifies the names filter of the source files to be used for Checkstyle.</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Required</b>: <code>Yes</code></li> - -<li><b>User Property</b>: <code>checkstyle.includes</code></li> - -<li><b>Default</b>: <code>**\/*.java</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CincludeTestResources.3E"></a><b><a name="includeTestResources"><includeTestResources></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>2.11</code></li> +<li><strong>Required</strong>: <code>Yes</code></li> +<li><strong>User Property</strong>: <code>checkstyle.includeResources</code></li> +<li><strong>Default</strong>: <code>true</code></li></ul><hr /></section><a name="includeTestResources"><section> +<h4><a name="a.3CincludeTestResources.3E"></a><includeTestResources></h4><a name="a.3CincludeTestResources.3E"></a></a> <div>Whether to apply Checkstyle to test resource directories.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Since</b>: <code>2.11</code></li> - -<li><b>Required</b>: <code>Yes</code></li> - -<li><b>User Property</b>: <code>checkstyle.includeTestResources</code></li> - -<li><b>Default</b>: <code>true</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CincludeTestSourceDirectory.3E"></a><b><a name="includeTestSourceDirectory"><includeTestSourceDirectory></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>2.11</code></li> +<li><strong>Required</strong>: <code>Yes</code></li> +<li><strong>User Property</strong>: <code>checkstyle.includeTestResources</code></li> +<li><strong>Default</strong>: <code>true</code></li></ul><hr /></section><a name="includeTestSourceDirectory"><section> +<h4><a name="a.3CincludeTestSourceDirectory.3E"></a><includeTestSourceDirectory></h4><a name="a.3CincludeTestSourceDirectory.3E"></a></a> <div>Include or not the test source directory to be used for Checkstyle.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Since</b>: <code>2.2</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>Default</b>: <code>false</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CinputEncoding.3E"></a><b><a name="inputEncoding"><inputEncoding></a></b></h4> - -<div>The file encoding to use when reading the source files. If the property <code>project.build.sourceEncoding</code> is not set, the platform default encoding is used. <b>Note:</b> This parameter always overrides the property <code>charset</code> from Checkstyle's <code>TreeWalker</code> module.</div> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>2.2</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="includes"><section> +<h4><a name="a.3Cincludes.3E"></a><includes></h4><a name="a.3Cincludes.3E"></a></a> +<div>Specifies the names filter of the source files to be used for Checkstyle.</div> <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.2</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>encoding</code></li> - -<li><b>Default</b>: <code>${project.build.sourceEncoding}</code></li> - </ul><hr /></section><section> -<h4><a name="a.3ClogViolationCountToConsole.3E"></a><b><a name="logViolationCountToConsole"><logViolationCountToConsole></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>Yes</code></li> +<li><strong>User Property</strong>: <code>checkstyle.includes</code></li> +<li><strong>Default</strong>: <code>**\/*.java</code></li></ul><hr /></section><a name="inputEncoding"><section> +<h4><a name="a.3CinputEncoding.3E"></a><inputEncoding></h4><a name="a.3CinputEncoding.3E"></a></a> +<div>The file encoding to use when reading the source files. If the property <code>project.build.sourceEncoding</code> is not set, the platform default encoding is used. <strong>Note:</strong> This parameter always overrides the property <code>charset</code> from Checkstyle's <code>TreeWalker</code> module.</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.2</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>encoding</code></li> +<li><strong>Default</strong>: <code>${project.build.sourceEncoding}</code></li></ul><hr /></section><a name="logViolationCountToConsole"><section> +<h4><a name="a.3ClogViolationCountToConsole.3E"></a><logViolationCountToConsole></h4><a name="a.3ClogViolationCountToConsole.3E"></a></a> <div>Output the detected violation count to the console.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Since</b>: <code>3.0.1</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.logViolationCount</code></li> - -<li><b>Default</b>: <code>true</code></li> - </ul><hr /></section><section> -<h4><a name="a.3ClogViolationsToConsole.3E"></a><b><a name="logViolationsToConsole"><logViolationsToConsole></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>3.0.1</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.logViolationCount</code></li> +<li><strong>Default</strong>: <code>true</code></li></ul><hr /></section><a name="logViolationsToConsole"><section> +<h4><a name="a.3ClogViolationsToConsole.3E"></a><logViolationsToConsole></h4><a name="a.3ClogViolationsToConsole.3E"></a></a> <div>Output the detected violations to the console.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Since</b>: <code>2.3</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.console</code></li> - -<li><b>Default</b>: <code>true</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CmaxAllowedViolations.3E"></a><b><a name="maxAllowedViolations"><maxAllowedViolations></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>2.3</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.console</code></li> +<li><strong>Default</strong>: <code>true</code></li></ul><hr /></section><a name="maxAllowedViolations"><section> +<h4><a name="a.3CmaxAllowedViolations.3E"></a><maxAllowedViolations></h4><a name="a.3CmaxAllowedViolations.3E"></a></a> <div>The maximum number of allowed violations. The execution fails only if the number of violations is above this limit.</div> - <ul> - -<li><b>Type</b>: <code>int</code></li> - -<li><b>Since</b>: <code>2.3</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.maxAllowedViolations</code></li> - -<li><b>Default</b>: <code>0</code></li> - </ul><hr /></section><section> -<h4><a name="a.3ComitIgnoredModules.3E"></a><b><a name="omitIgnoredModules"><omitIgnoredModules></a></b></h4> - +<li><strong>Type</strong>: <code>int</code></li> +<li><strong>Since</strong>: <code>2.3</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.maxAllowedViolations</code></li> +<li><strong>Default</strong>: <code>0</code></li></ul><hr /></section><a name="omitIgnoredModules"><section> +<h4><a name="a.3ComitIgnoredModules.3E"></a><omitIgnoredModules></h4><a name="a.3ComitIgnoredModules.3E"></a></a> <div>Specifies whether modules with a configured severity of <code>ignore</code> should be omitted during Checkstyle invocation.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Since</b>: <code>3.0.0</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>Default</b>: <code>false</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CoutputFile.3E"></a><b><a name="outputFile"><outputFile></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>3.0.0</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="outputFile"><section> +<h4><a name="a.3CoutputFile.3E"></a><outputFile></h4><a name="a.3CoutputFile.3E"></a></a> <div>Specifies the path and filename to save the Checkstyle output. The format of the output file is determined by the <code>outputFileFormat</code> parameter.</div> - -<ul> - -<li><b>Type</b>: <code>java.io.File</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.output.file</code></li> - -<li><b>Default</b>: <code>${project.build.directory}/checkstyle-result.xml</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CoutputFileFormat.3E"></a><b><a name="outputFileFormat"><outputFileFormat></a></b></h4> - -<div>Specifies the format of the output to be used when writing to the output file. Valid values are "<code>plain</code>" and "<code>xml</code>".</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.output.format</code></li> - -<li><b>Default</b>: <code>xml</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CpropertiesLocation.3E"></a><b><a name="propertiesLocation"><propertiesLocation></a></b></h4> - -<div> -<p>Specifies the location of the properties file.</p> - +<li><strong>Type</strong>: <code>java.io.File</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.output.file</code></li> +<li><strong>Default</strong>: <code>${project.build.directory}/checkstyle-result.xml</code></li></ul><hr /></section><a name="outputFileFormat"><section> +<h4><a name="a.3CoutputFileFormat.3E"></a><outputFileFormat></h4><a name="a.3CoutputFileFormat.3E"></a></a> +<div>Specifies the format of the output to be used when writing to the output file. Valid values are "<code>plain</code>", "<code>sarif</code>" and "<code>xml</code>".</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.output.format</code></li> +<li><strong>Default</strong>: <code>xml</code></li></ul><hr /></section><a name="propertiesLocation"><section> +<h4><a name="a.3CpropertiesLocation.3E"></a><propertiesLocation></h4><a name="a.3CpropertiesLocation.3E"></a></a> +<div><p>Specifies the location of the properties file.</p> <p>This parameter is resolved as URL, File then resource. If successfully resolved, the contents of the properties location is copied into the <code>${project.build.directory}/checkstyle-checker.properties</code> file before being passed to Checkstyle for loading.</p> - <p>The contents of the <code>propertiesLocation</code> will be made available to Checkstyle for specifying values for parameters within the xml configuration (specified in the <code>configLocation</code> parameter).</p></div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.5</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.properties.location</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CpropertyExpansion.3E"></a><b><a name="propertyExpansion"><propertyExpansion></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.5</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.properties.location</code></li></ul><hr /></section><a name="propertyExpansion"><section> +<h4><a name="a.3CpropertyExpansion.3E"></a><propertyExpansion></h4><a name="a.3CpropertyExpansion.3E"></a></a> <div>Allows for specifying raw property expansion information.</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Required</b>: <code>No</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CresourceExcludes.3E"></a><b><a name="resourceExcludes"><resourceExcludes></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="resourceExcludes"><section> +<h4><a name="a.3CresourceExcludes.3E"></a><resourceExcludes></h4><a name="a.3CresourceExcludes.3E"></a></a> <div>Specifies the names filter of the files to be excluded for Checkstyle when checking resources.</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.11</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.resourceExcludes</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CresourceIncludes.3E"></a><b><a name="resourceIncludes"><resourceIncludes></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.11</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.resourceExcludes</code></li></ul><hr /></section><a name="resourceIncludes"><section> +<h4><a name="a.3CresourceIncludes.3E"></a><resourceIncludes></h4><a name="a.3CresourceIncludes.3E"></a></a> <div>Specifies the names filter of the files to be used for Checkstyle when checking resources.</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.11</code></li> - -<li><b>Required</b>: <code>Yes</code></li> - -<li><b>User Property</b>: <code>checkstyle.resourceIncludes</code></li> - -<li><b>Default</b>: <code>**/*.properties</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CrulesFiles.3E"></a><b><a name="rulesFiles"><rulesFiles></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.11</code></li> +<li><strong>Required</strong>: <code>Yes</code></li> +<li><strong>User Property</strong>: <code>checkstyle.resourceIncludes</code></li> +<li><strong>Default</strong>: <code>**/*.properties</code></li></ul><hr /></section><a name="rulesFiles"><section> +<h4><a name="a.3CrulesFiles.3E"></a><rulesFiles></h4><a name="a.3CrulesFiles.3E"></a></a> <div>Dump file for inlined Checkstyle rules.</div> - <ul> - -<li><b>Type</b>: <code>java.io.File</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.output.rules.file</code></li> - -<li><b>Default</b>: <code>${project.build.directory}/checkstyle-rules.xml</code></li> - </ul><hr /></section><section> -<h4><a name="a.3Cskip.3E"></a><b><a name="skip"><skip></a></b></h4> - +<li><strong>Type</strong>: <code>java.io.File</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.output.rules.file</code></li> +<li><strong>Default</strong>: <code>${project.build.directory}/checkstyle-rules.xml</code></li></ul><hr /></section><a name="skip"><section> +<h4><a name="a.3Cskip.3E"></a><skip></h4><a name="a.3Cskip.3E"></a></a> <div>Skip entire check.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Since</b>: <code>2.2</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.skip</code></li> - -<li><b>Default</b>: <code>false</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CskipExec.3E"></a><b><a name="skipExec"><skipExec></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>2.2</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.skip</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="skipExec"><section> +<h4><a name="a.3CskipExec.3E"></a><skipExec></h4><a name="a.3CskipExec.3E"></a></a> <div>Skip Checkstyle execution will only scan the outputFile.</div> - <ul> - -<li><b>Type</b>: <code>boolean</code></li> - -<li><b>Since</b>: <code>2.5</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.skipExec</code></li> - -<li><b>Default</b>: <code>false</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CsourceDirectories.3E"></a><b><a name="sourceDirectories"><sourceDirectories></a></b></h4> - +<li><strong>Type</strong>: <code>boolean</code></li> +<li><strong>Since</strong>: <code>2.5</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.skipExec</code></li> +<li><strong>Default</strong>: <code>false</code></li></ul><hr /></section><a name="sourceDirectories"><section> +<h4><a name="a.3CsourceDirectories.3E"></a><sourceDirectories></h4><a name="a.3CsourceDirectories.3E"></a></a> <div>Specifies the location of the source directories to be used for Checkstyle. Default value is <code>${project.compileSourceRoots}</code>.</div> - <ul> - -<li><b>Type</b>: <code>java.util.List<java.lang.String></code></li> - -<li><b>Since</b>: <code>2.13</code></li> - -<li><b>Required</b>: <code>No</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CsourceDirectory.3E"></a><b><a name="sourceDirectory"><sourceDirectory></a></b></h4> - -<div><b>Deprecated.</b> instead use <a href="#sourceDirectories"><code>sourceDirectories</code></a>. For version 3.0.0, this parameter is only defined to break the build if you use it!</div> - +<li><strong>Type</strong>: <code>java.util.List<java.lang.String></code></li> +<li><strong>Since</strong>: <code>2.13</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="sourceDirectory"><section> +<h4><a name="a.3CsourceDirectory.3E"></a><sourceDirectory></h4><a name="a.3CsourceDirectory.3E"></a></a> +<div><strong>Deprecated.</strong><br />instead use <a href="#sourceDirectories"><code>sourceDirectories</code></a>. For version 3.0.0, this parameter is only defined to break the build if you use it!</div><br /> <div>Specifies the location of the source directory to be used for Checkstyle.</div> - <ul> - -<li><b>Type</b>: <code>java.io.File</code></li> - -<li><b>Required</b>: <code>No</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CsuppressionsFileExpression.3E"></a><b><a name="suppressionsFileExpression"><suppressionsFileExpression></a></b></h4> - +<li><strong>Type</strong>: <code>java.io.File</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="suppressionsFileExpression"><section> +<h4><a name="a.3CsuppressionsFileExpression.3E"></a><suppressionsFileExpression></h4><a name="a.3CsuppressionsFileExpression.3E"></a></a> <div>The key to be used in the properties for the suppressions file.</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.1</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.suppression.expression</code></li> - -<li><b>Default</b>: <code>checkstyle.suppressions.file</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CsuppressionsLocation.3E"></a><b><a name="suppressionsLocation"><suppressionsLocation></a></b></h4> - -<div> -<p>Specifies the location of the suppressions XML file to use.</p> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.1</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.suppression.expression</code></li> +<li><strong>Default</strong>: <code>checkstyle.suppressions.file</code></li></ul><hr /></section><a name="suppressionsLocation"><section> +<h4><a name="a.3CsuppressionsLocation.3E"></a><suppressionsLocation></h4><a name="a.3CsuppressionsLocation.3E"></a></a> +<div><p>Specifies the location of the suppressions XML file to use.</p> <p>This parameter is resolved as resource, URL, then file. If successfully resolved, the contents of the suppressions XML is copied into the <code>${project.build.directory}/checkstyle-suppressions.xml</code> file before being passed to Checkstyle for loading.</p> - <p>See <code>suppressionsFileExpression</code> for the property that will be made available to your Checkstyle configuration.</p></div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.0-beta-2</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.suppressions.location</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CtestSourceDirectories.3E"></a><b><a name="testSourceDirectories"><testSourceDirectories></a></b></h4> - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.0-beta-2</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.suppressions.location</code></li></ul><hr /></section><a name="testSourceDirectories"><section> +<h4><a name="a.3CtestSourceDirectories.3E"></a><testSourceDirectories></h4><a name="a.3CtestSourceDirectories.3E"></a></a> <div>Specifies the location of the test source directories to be used for Checkstyle. Default value is <code>${project.testCompileSourceRoots}</code>.</div> - <ul> - -<li><b>Type</b>: <code>java.util.List<java.lang.String></code></li> - -<li><b>Since</b>: <code>2.13</code></li> - -<li><b>Required</b>: <code>No</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CtestSourceDirectory.3E"></a><b><a name="testSourceDirectory"><testSourceDirectory></a></b></h4> - -<div><b>Deprecated.</b> instead use <a href="#testSourceDirectories"><code>testSourceDirectories</code></a>. For version 3.0.0, this parameter is only defined to break the build if you use it!</div> - +<li><strong>Type</strong>: <code>java.util.List<java.lang.String></code></li> +<li><strong>Since</strong>: <code>2.13</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="testSourceDirectory"><section> +<h4><a name="a.3CtestSourceDirectory.3E"></a><testSourceDirectory></h4><a name="a.3CtestSourceDirectory.3E"></a></a> +<div><strong>Deprecated.</strong><br />instead use <a href="#testSourceDirectories"><code>testSourceDirectories</code></a>. For version 3.0.0, this parameter is only defined to break the build if you use it!</div><br /> <div>Specifies the location of the test source directory to be used for Checkstyle.</div> - <ul> - -<li><b>Type</b>: <code>java.io.File</code></li> - -<li><b>Since</b>: <code>2.2</code></li> - -<li><b>Required</b>: <code>No</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CuseFile.3E"></a><b><a name="useFile"><useFile></a></b></h4> - +<li><strong>Type</strong>: <code>java.io.File</code></li> +<li><strong>Since</strong>: <code>2.2</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="useFile"><section> +<h4><a name="a.3CuseFile.3E"></a><useFile></h4><a name="a.3CuseFile.3E"></a></a> <div>If <code>null</code>, the Checkstyle plugin will display violations on stdout. Otherwise, a text file will be created with the violations.</div> - <ul> - -<li><b>Type</b>: <code>java.io.File</code></li> - -<li><b>Required</b>: <code>No</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CviolationIgnore.3E"></a><b><a name="violationIgnore"><violationIgnore></a></b></h4> - +<li><strong>Type</strong>: <code>java.io.File</code></li> +<li><strong>Required</strong>: <code>No</code></li></ul><hr /></section><a name="violationIgnore"><section> +<h4><a name="a.3CviolationIgnore.3E"></a><violationIgnore></h4><a name="a.3CviolationIgnore.3E"></a></a> <div>Violations to ignore. This is a comma-separated list, each value being either a rule name, a rule category or a java package name of rule class.</div> - <ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.13</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.violation.ignore</code></li> - </ul><hr /></section><section> -<h4><a name="a.3CviolationSeverity.3E"></a><b><a name="violationSeverity"><violationSeverity></a></b></h4> - -<div>The lowest severity level that is considered a violation. Valid values are "<code>error</code>", "<code>warning</code>" and "<code>info</code>".</div> - -<ul> - -<li><b>Type</b>: <code>java.lang.String</code></li> - -<li><b>Since</b>: <code>2.2</code></li> - -<li><b>Required</b>: <code>No</code></li> - -<li><b>User Property</b>: <code>checkstyle.violationSeverity</code></li> - -<li><b>Default</b>: <code>error</code></li> - </ul> - </section></section> - </section> - - +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.13</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.violation.ignore</code></li></ul><hr /></section><a name="violationSeverity"><section> +<h4><a name="a.3CviolationSeverity.3E"></a><violationSeverity></h4><a name="a.3CviolationSeverity.3E"></a></a> +<div>The lowest severity level that is considered a violation. Valid values are "<code>error</code>", "<code>warning</code>" and "<code>info</code>".</div> +<ul> +<li><strong>Type</strong>: <code>java.lang.String</code></li> +<li><strong>Since</strong>: <code>2.2</code></li> +<li><strong>Required</strong>: <code>No</code></li> +<li><strong>User Property</strong>: <code>checkstyle.violationSeverity</code></li> +<li><strong>Default</strong>: <code>error</code></li></ul></section></section></section> </main> </div> </div> @@ -1233,7 +674,7 @@ <footer> <div class="container-fluid"> <div class="row-fluid"> - <p>© 2005–2023 + <p>© 2005–2024 <a href="https://www.apache.org/">The Apache Software Foundation</a> </p> </div>