You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by de...@apache.org on 2015/05/02 12:15:10 UTC
svn commit: r949876 [2/17] - in
/websites/production/maven/components/plugins-archives/maven-checkstyle-plugin-LATEST:
./ apidocs/ config/ css/ examples/ images/ testapidocs/ xref-test/ xref/
Modified: websites/production/maven/components/plugins-archives/maven-checkstyle-plugin-LATEST/check-mojo.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-checkstyle-plugin-LATEST/check-mojo.html (original)
+++ websites/production/maven/components/plugins-archives/maven-checkstyle-plugin-LATEST/check-mojo.html Sat May 2 10:15:09 2015
@@ -1,1317 +1,1321 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!--
- | Generated by Apache Maven Doxia at 2015-04-11
- | Rendered using Apache Maven Stylus Skin 1.5
--->
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <title>Apache Maven Checkstyle Plugin – checkstyle:check</title>
- <style type="text/css" media="all">
- @import url("./css/maven-base.css");
- @import url("./css/maven-theme.css");
- @import url("./css/site.css");
- </style>
- <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20150411" />
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-
-<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
-
-<script type="text/javascript">_uacct = "UA-140879-1";
- urchinTracker();</script>
- </head>
- <body class="composite">
- <div id="banner">
- <a href="../../" id="bannerLeft">
- <img src="../../images/apache-maven-project-2.png" alt="" />
- </a>
- <span id="bannerRight">
- <img src="../../images/maven-logo-2.gif" alt="" />
- </span>
- <div class="clear">
- <hr/>
- </div>
- </div>
- <div id="breadcrumbs">
-
- <div class="xleft">
- <a href="http://www.apache.org/" class="externalLink">Apache</a>
- >
- <a href="../../index.html">Maven</a>
- >
- <a href="../index.html">Plugins</a>
- >
- <a href="./">Apache Maven Checkstyle Plugin</a>
- >
- checkstyle:check
- </div>
- <div class="xright">
- Last Published: 2015-04-11
- | Version: 2.16-SNAPSHOT
- </div>
- <div class="clear">
- <hr/>
- </div>
- </div>
- <div id="leftColumn">
- <div id="navcolumn">
-
- <h5>Overview</h5>
- <ul>
- <li class="none">
- <a href="index.html">Introduction</a>
- </li>
- <li class="none">
- <a href="plugin-info.html">Goals</a>
- </li>
- <li class="none">
- <a href="usage.html">Usage</a>
- </li>
- <li class="none">
- <a href="faq.html">FAQ</a>
- </li>
- <li class="none">
- <a href="http://www.apache.org/licenses/" class="externalLink">License</a>
- </li>
- <li class="none">
- <a href="download.html">Download</a>
- </li>
- <li class="none">
- <a href="history.html">Releases History</a>
- </li>
- </ul>
- <h5>Examples</h5>
- <ul>
- <li class="none">
- <a href="examples/upgrading-checkstyle.html">Upgrading Checkstyle at Runtime</a>
- </li>
- <li class="none">
- <a href="examples/inline-checker-config.html">Using an Inline Checkstyle Checker Configuration</a>
- </li>
- <li class="none">
- <a href="examples/custom-checker-config.html">Using a Custom Checkstyle Checker Configuration</a>
- </li>
- <li class="none">
- <a href="examples/custom-property-expansion.html">Using Custom Checkstyle Property Expansion Definitions</a>
- </li>
- <li class="none">
- <a href="examples/suppressions-filter.html">Using a Suppressions Filter</a>
- </li>
- <li class="none">
- <a href="examples/custom-developed-checkstyle.html">Using Custom Developed Checkstyle Checks</a>
- </li>
- <li class="none">
- <a href="examples/multi-module-config.html">Multimodule Configuration</a>
- </li>
- </ul>
- <h5>Project Documentation</h5>
- <ul>
- <li class="collapsed">
- <a href="project-info.html">Project Information</a>
- </li>
- <li class="collapsed">
- <a href="project-reports.html">Project Reports</a>
- </li>
- </ul>
- <h5>Maven Projects</h5>
- <ul>
- <li class="none">
- <a href="../../ant-tasks/index.html">Ant Tasks</a>
- </li>
- <li class="none">
- <a href="../../archetype/index.html">Archetype</a>
- </li>
- <li class="none">
- <a href="../../doxia/index.html">Doxia</a>
- </li>
- <li class="none">
- <a href="../../jxr/index.html">JXR</a>
- </li>
- <li class="none">
- <a href="../../ref/current">Maven</a>
- </li>
- <li class="none">
- <a href="../../pom/index.html">Parent POMs</a>
- </li>
- <li class="none">
- <a href="../index.html">Plugins</a>
- </li>
- <li class="none">
- <a href="../../plugin-testing/index.html">Plugin Testing</a>
- </li>
- <li class="none">
- <a href="../../plugin-tools/index.html">Plugin Tools</a>
- </li>
- <li class="none">
- <a href="../../apache-resource-bundles/index.html">Resource Bundles</a>
- </li>
- <li class="none">
- <a href="../../scm/index.html">SCM</a>
- </li>
- <li class="none">
- <a href="../../shared/index.html">Shared Components</a>
- </li>
- <li class="none">
- <a href="../../skins/index.html">Skins</a>
- </li>
- <li class="none">
- <a href="../../surefire/index.html">Surefire</a>
- </li>
- <li class="none">
- <a href="../../wagon/index.html">Wagon</a>
- </li>
- </ul>
- <h5>ASF</h5>
- <ul>
- <li class="none">
- <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
- </li>
- <li class="none">
- <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
- </li>
- <li class="none">
- <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
- </li>
- <li class="none">
- <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
- </li>
- </ul>
- <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
- <img alt="Built by Maven" src="./images/logos/maven-feather.png"/>
- </a>
-
- </div>
- </div>
- <div id="bodyColumn">
- <div id="contentBox">
-
-
- <div class="section">
-<h2><a name="checkstyle:check"></a>checkstyle:check</h2>
-
-<p><b>Full name</b>:</p>
-
-<p>org.apache.maven.plugins:maven-checkstyle-plugin:2.16-SNAPSHOT: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>
-
-<ul>
-
-<li>Requires a Maven project to be executed.</li>
-
-<li>Requires dependency resolution of artifacts in scope: <tt>test</tt>.</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>: <tt>verify</tt>.</li>
- </ul>
-
-<div class="section">
-<h3><a name="Required_Parameters"></a>Required Parameters</h3>
-
-<table class="bodyTable" border="0">
-
-<tr class="a">
-
-<th>Name</th>
-
-<th>Type</th>
-
-<th>Since</th>
-
-<th>Description</th>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#includeResources">includeResources</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>2.11</tt></td>
-
-<td>Whether to apply Checkstyle to resource directories.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.includeResources</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#includeTestResources">includeTestResources</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>2.11</tt></td>
-
-<td>Whether to apply Checkstyle to test resource directories.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.includeTestResources</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#includes">includes</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies the names filter of the source files to be used for
-Checkstyle.<br /><b>Default value is</b>: <tt>**\/*.java</tt>.<br /><b>User property is</b>: <tt>checkstyle.includes</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#resourceIncludes">resourceIncludes</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.11</tt></td>
-
-<td>Specifies the names filter of the files to be used for Checkstyle
-when checking resources.<br /><b>Default value is</b>: <tt>**/*.properties</tt>.<br /><b>User property is</b>: <tt>checkstyle.resourceIncludes</tt>.</td>
- </tr>
- </table>
- </div>
-
-<div class="section">
-<h3><a name="Optional_Parameters"></a>Optional Parameters</h3>
-
-<table class="bodyTable" border="0">
-
-<tr class="a">
-
-<th>Name</th>
-
-<th>Type</th>
-
-<th>Since</th>
-
-<th>Description</th>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#cacheFile">cacheFile</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies the cache file used to speed up Checkstyle on successive
-runs.<br /><b>Default value is</b>: <tt>${project.build.directory}/checkstyle-cachefile</tt>.<br /></td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#checkstyleRules">checkstyleRules</a></b></td>
-
-<td><tt>PlexusConfiguration</tt></td>
-
-<td><tt>2.12</tt></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>
- <module name="TreeWalker">
- <module name="EmptyBlock"/>
- </module>
- </module>
- </checkstyleRules>
- </configuration>
- ...
-</pre></div><br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#configLocation">configLocation</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.5</tt></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="http://checkstyle.sourceforge.net/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
-<tt>${project.build.directory}/checkstyle-configuration.xml</tt>
-file before being passed to Checkstyle as a configuration.</p>
-
-<p>There are 2 predefined rulesets.</p>
-
-<ul>
-
-<li><tt>config/sun_checks.xml</tt>: Sun Checks.</li>
-
-<li><tt>config/maven_checks.xml</tt>: Maven Source Checks.</li>
-</ul><br /><b>Default value is</b>: <tt>config/sun_checks.xml</tt>.<br /><b>User property is</b>: <tt>checkstyle.config.location</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#consoleOutput">consoleOutput</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Output errors to console.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>checkstyle.consoleOutput</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#encoding">encoding</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.2</tt></td>
-
-<td>The file encoding to use when reading the source files. If the
-property <tt>project.build.sourceEncoding</tt> is not set, the
-platform default encoding is used. <b>Note:</b> This
-parameter always overrides the property <tt>charset</tt> from
-Checkstyle's <tt>TreeWalker</tt> module.<br /><b>Default value is</b>: <tt>${project.build.sourceEncoding}</tt>.<br /><b>User property is</b>: <tt>encoding</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#excludes">excludes</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies the names filter of the source files to be excluded for
-Checkstyle.<br /><b>User property is</b>: <tt>checkstyle.excludes</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#failOnViolation">failOnViolation</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Fail the build on a violation. The goal checks for the violations
-after logging them (if <tt>logViolationsToConsole</tt> is
-'true'). Compare this to <tt>failsOnError</tt> which fails the
-build immediately before examining the output log.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.failOnViolation</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#failsOnError">failsOnError</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>-</tt></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 <tt>logViolationsToConsole</tt>. If you
-want to use <tt>logViolationsToConsole</tt>, use
-<tt>failOnViolation</tt> instead of this.<br /><b>Default value is</b>: <tt>false</tt>.<br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#headerLocation">headerLocation</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.0-beta-2</tt></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>
-
-<p>You need to use ${checkstyle.header.file} in your Checkstyle xml
-configuration to reference the name of this header file.</p>
-
-<p>For instance:</p>
-
-<p><tt><module name="RegexpHeader"> <property
-name="headerFile" value="${checkstyle.header.file}"/>
-</module></tt></p><br /><b>Default value is</b>: <tt>LICENSE.txt</tt>.<br /><b>User property is</b>: <tt>checkstyle.header.file</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#includeTestSourceDirectory">includeTestSourceDirectory</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>2.2</tt></td>
-
-<td>Include or not the test source directory to be used for Checkstyle.<br /><b>Default value is</b>: <tt>false</tt>.<br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#logViolationsToConsole">logViolationsToConsole</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>2.3</tt></td>
-
-<td>Output the detected violations to the console.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.console</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#maxAllowedViolations">maxAllowedViolations</a></b></td>
-
-<td><tt>int</tt></td>
-
-<td><tt>2.3</tt></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>: <tt>0</tt>.<br /><b>User property is</b>: <tt>checkstyle.maxAllowedViolations</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#outputFile">outputFile</a></b></td>
-
-<td><tt>File</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies the path and filename to save the Checkstyle output. The
-format of the output file is determined by the
-<tt>outputFileFormat</tt> parameter.<br /><b>Default value is</b>: <tt>${project.build.directory}/checkstyle-result.xml</tt>.<br /><b>User property is</b>: <tt>checkstyle.output.file</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#outputFileFormat">outputFileFormat</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies the format of the output to be used when writing to the
-output file. Valid values are "<tt>plain</tt>" and
-"<tt>xml</tt>".<br /><b>Default value is</b>: <tt>xml</tt>.<br /><b>User property is</b>: <tt>checkstyle.output.format</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#propertiesLocation">propertiesLocation</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.5</tt></td>
-
-<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
-<tt>${project.build.directory}/checkstyle-checker.properties</tt>
-file before being passed to Checkstyle for loading.</p>
-
-<p>The contents of the <tt>propertiesLocation</tt> will be made
-available to Checkstyle for specifying values for parameters within
-the xml configuration (specified in the <tt>configLocation</tt>
-parameter).</p><br /><b>User property is</b>: <tt>checkstyle.properties.location</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#propertyExpansion">propertyExpansion</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Allows for specifying raw property expansion information.<br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#resourceExcludes">resourceExcludes</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.11</tt></td>
-
-<td>Specifies the names filter of the files to be excluded for
-Checkstyle when checking resources.<br /><b>User property is</b>: <tt>checkstyle.resourceExcludes</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#rulesFiles">rulesFiles</a></b></td>
-
-<td><tt>File</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>dump file for inlined Checkstyle rules<br /><b>Default value is</b>: <tt>${project.build.directory}/checkstyle-rules.xml</tt>.<br /><b>User property is</b>: <tt>checkstyle.output.rules.file</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#skip">skip</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>2.2</tt></td>
-
-<td>Skip entire check.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>checkstyle.skip</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#skipExec">skipExec</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>2.5</tt></td>
-
-<td>Skip Checkstyle execution will only scan the outputFile.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>checkstyle.skipExec</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#sourceDirectories">sourceDirectories</a></b></td>
-
-<td><tt>List</tt></td>
-
-<td><tt>2.13</tt></td>
-
-<td>Specifies the location of the source directories to be used for
-Checkstyle.<br /><b>Default value is</b>: <tt>${project.compileSourceRoots}</tt>.<br /></td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#sourceDirectory">sourceDirectory</a></b></td>
-
-<td><tt>File</tt></td>
-
-<td><tt>-</tt></td>
-
-<td><b>Deprecated.</b> instead use <tt>sourceDirectories</tt><br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#suppressionsFileExpression">suppressionsFileExpression</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.1</tt></td>
-
-<td>The key to be used in the properties for the suppressions file.<br /><b>Default value is</b>: <tt>checkstyle.suppressions.file</tt>.<br /><b>User property is</b>: <tt>checkstyle.suppression.expression</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#suppressionsLocation">suppressionsLocation</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.0-beta-2</tt></td>
-
-<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
-<tt>${project.build.directory}/checkstyle-suppressions.xml</tt>
-file before being passed to Checkstyle for loading.</p>
-
-<p>See <tt>suppressionsFileExpression</tt> for the property
-that will be made available to your Checkstyle configuration.</p><br /><b>User property is</b>: <tt>checkstyle.suppressions.location</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#testSourceDirectories">testSourceDirectories</a></b></td>
-
-<td><tt>List</tt></td>
-
-<td><tt>2.13</tt></td>
-
-<td>Specifies the location of the test source directories to be used
-for Checkstyle.<br /><b>Default value is</b>: <tt>${project.testCompileSourceRoots}</tt>.<br /></td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#testSourceDirectory">testSourceDirectory</a></b></td>
-
-<td><tt>File</tt></td>
-
-<td><tt>2.2</tt></td>
-
-<td><b>Deprecated.</b> instead use <tt>testSourceDirectories</tt><br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#useFile">useFile</a></b></td>
-
-<td><tt>File</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>If <tt>null</tt>, the Checkstyle plugin will display violations
-on stdout. Otherwise, a text file will be created with the
-violations.<br /></td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#violationIgnore">violationIgnore</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.13</tt></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>: <tt>checkstyle.violation.ignore</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#violationSeverity">violationSeverity</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.2</tt></td>
-
-<td>The lowest severity level that is considered a violation. Valid
-values are "<tt>error</tt>", "<tt>warning</tt>" and
-"<tt>info</tt>".<br /><b>Default value is</b>: <tt>error</tt>.<br /><b>User property is</b>: <tt>checkstyle.violationSeverity</tt>.</td>
- </tr>
- </table>
- </div>
-
-<div class="section">
-<h3><a name="Parameter_Details"></a>Parameter Details</h3>
-
-<p><b><a name="cacheFile">cacheFile</a>:</b></p>
-
-<div>Specifies the cache file used to speed up Checkstyle on successive
-runs.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>Default</b>: <tt>${project.build.directory}/checkstyle-cachefile</tt></li>
- </ul><hr />
-<p><b><a name="checkstyleRules">checkstyleRules</a>:</b></p>
-
-<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>
- <module name="TreeWalker">
- <module name="EmptyBlock"/>
- </module>
- </module>
- </checkstyleRules>
- </configuration>
- ...
-</pre></div></div>
-
-<ul>
-
-<li><b>Type</b>: <tt>org.codehaus.plexus.configuration.PlexusConfiguration</tt></li>
-
-<li><b>Since</b>: <tt>2.12</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
- </ul><hr />
-<p><b><a name="configLocation">configLocation</a>:</b></p>
-
-<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="http://checkstyle.sourceforge.net/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
-<tt>${project.build.directory}/checkstyle-configuration.xml</tt>
-file before being passed to Checkstyle as a configuration.</p>
-
-<p>There are 2 predefined rulesets.</p>
-
-<ul>
-
-<li><tt>config/sun_checks.xml</tt>: Sun Checks.</li>
-
-<li><tt>config/maven_checks.xml</tt>: Maven Source Checks.</li>
-</ul></div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.5</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.config.location</tt></li>
-
-<li><b>Default</b>: <tt>config/sun_checks.xml</tt></li>
- </ul><hr />
-<p><b><a name="consoleOutput">consoleOutput</a>:</b></p>
-
-<div>Output errors to console.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.consoleOutput</tt></li>
-
-<li><b>Default</b>: <tt>false</tt></li>
- </ul><hr />
-<p><b><a name="encoding">encoding</a>:</b></p>
-
-<div>The file encoding to use when reading the source files. If the
-property <tt>project.build.sourceEncoding</tt> is not set, the
-platform default encoding is used. <b>Note:</b> This
-parameter always overrides the property <tt>charset</tt> from
-Checkstyle's <tt>TreeWalker</tt> module.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.2</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>encoding</tt></li>
-
-<li><b>Default</b>: <tt>${project.build.sourceEncoding}</tt></li>
- </ul><hr />
-<p><b><a name="excludes">excludes</a>:</b></p>
-
-<div>Specifies the names filter of the source files to be excluded for
-Checkstyle.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.excludes</tt></li>
- </ul><hr />
-<p><b><a name="failOnViolation">failOnViolation</a>:</b></p>
-
-<div>Fail the build on a violation. The goal checks for the violations
-after logging them (if <tt>logViolationsToConsole</tt> is
-'true'). Compare this to <tt>failsOnError</tt> which fails the
-build immediately before examining the output log.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.failOnViolation</tt></li>
-
-<li><b>Default</b>: <tt>true</tt></li>
- </ul><hr />
-<p><b><a name="failsOnError">failsOnError</a>:</b></p>
-
-<div>If this is true, and Checkstyle reported any violations or errors,
-the build fails immediately after running Checkstyle, before
-checking the log for <tt>logViolationsToConsole</tt>. If you
-want to use <tt>logViolationsToConsole</tt>, use
-<tt>failOnViolation</tt> instead of this.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>Default</b>: <tt>false</tt></li>
- </ul><hr />
-<p><b><a name="headerLocation">headerLocation</a>:</b></p>
-
-<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 ${checkstyle.header.file} in your Checkstyle xml
-configuration to reference the name of this header file.</p>
-
-<p>For instance:</p>
-
-<p><tt><module name="RegexpHeader"> <property
-name="headerFile" value="${checkstyle.header.file}"/>
-</module></tt></p></div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.0-beta-2</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.header.file</tt></li>
-
-<li><b>Default</b>: <tt>LICENSE.txt</tt></li>
- </ul><hr />
-<p><b><a name="includeResources">includeResources</a>:</b></p>
-
-<div>Whether to apply Checkstyle to resource directories.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</tt></li>
-
-<li><b>Since</b>: <tt>2.11</tt></li>
-
-<li><b>Required</b>: <tt>Yes</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.includeResources</tt></li>
-
-<li><b>Default</b>: <tt>true</tt></li>
- </ul><hr />
-<p><b><a name="includeTestResources">includeTestResources</a>:</b></p>
-
-<div>Whether to apply Checkstyle to test resource directories.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</tt></li>
-
-<li><b>Since</b>: <tt>2.11</tt></li>
-
-<li><b>Required</b>: <tt>Yes</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.includeTestResources</tt></li>
-
-<li><b>Default</b>: <tt>true</tt></li>
- </ul><hr />
-<p><b><a name="includeTestSourceDirectory">includeTestSourceDirectory</a>:</b></p>
-
-<div>Include or not the test source directory to be used for Checkstyle.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</tt></li>
-
-<li><b>Since</b>: <tt>2.2</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>Default</b>: <tt>false</tt></li>
- </ul><hr />
-<p><b><a name="includes">includes</a>:</b></p>
-
-<div>Specifies the names filter of the source files to be used for
-Checkstyle.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Required</b>: <tt>Yes</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.includes</tt></li>
-
-<li><b>Default</b>: <tt>**\/*.java</tt></li>
- </ul><hr />
-<p><b><a name="logViolationsToConsole">logViolationsToConsole</a>:</b></p>
-
-<div>Output the detected violations to the console.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</tt></li>
-
-<li><b>Since</b>: <tt>2.3</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.console</tt></li>
-
-<li><b>Default</b>: <tt>true</tt></li>
- </ul><hr />
-<p><b><a name="maxAllowedViolations">maxAllowedViolations</a>:</b></p>
-
-<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>: <tt>int</tt></li>
-
-<li><b>Since</b>: <tt>2.3</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.maxAllowedViolations</tt></li>
-
-<li><b>Default</b>: <tt>0</tt></li>
- </ul><hr />
-<p><b><a name="outputFile">outputFile</a>:</b></p>
-
-<div>Specifies the path and filename to save the Checkstyle output. The
-format of the output file is determined by the
-<tt>outputFileFormat</tt> parameter.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.io.File</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.output.file</tt></li>
-
-<li><b>Default</b>: <tt>${project.build.directory}/checkstyle-result.xml</tt></li>
- </ul><hr />
-<p><b><a name="outputFileFormat">outputFileFormat</a>:</b></p>
-
-<div>Specifies the format of the output to be used when writing to the
-output file. Valid values are "<tt>plain</tt>" and
-"<tt>xml</tt>".</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.output.format</tt></li>
-
-<li><b>Default</b>: <tt>xml</tt></li>
- </ul><hr />
-<p><b><a name="propertiesLocation">propertiesLocation</a>:</b></p>
-
-<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
-<tt>${project.build.directory}/checkstyle-checker.properties</tt>
-file before being passed to Checkstyle for loading.</p>
-
-<p>The contents of the <tt>propertiesLocation</tt> will be made
-available to Checkstyle for specifying values for parameters within
-the xml configuration (specified in the <tt>configLocation</tt>
-parameter).</p></div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.5</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.properties.location</tt></li>
- </ul><hr />
-<p><b><a name="propertyExpansion">propertyExpansion</a>:</b></p>
-
-<div>Allows for specifying raw property expansion information.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
- </ul><hr />
-<p><b><a name="resourceExcludes">resourceExcludes</a>:</b></p>
-
-<div>Specifies the names filter of the files to be excluded for
-Checkstyle when checking resources.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.11</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.resourceExcludes</tt></li>
- </ul><hr />
-<p><b><a name="resourceIncludes">resourceIncludes</a>:</b></p>
-
-<div>Specifies the names filter of the files to be used for Checkstyle
-when checking resources.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.11</tt></li>
-
-<li><b>Required</b>: <tt>Yes</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.resourceIncludes</tt></li>
-
-<li><b>Default</b>: <tt>**/*.properties</tt></li>
- </ul><hr />
-<p><b><a name="rulesFiles">rulesFiles</a>:</b></p>
-
-<div>dump file for inlined Checkstyle rules</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.io.File</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.output.rules.file</tt></li>
-
-<li><b>Default</b>: <tt>${project.build.directory}/checkstyle-rules.xml</tt></li>
- </ul><hr />
-<p><b><a name="skip">skip</a>:</b></p>
-
-<div>Skip entire check.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</tt></li>
-
-<li><b>Since</b>: <tt>2.2</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.skip</tt></li>
-
-<li><b>Default</b>: <tt>false</tt></li>
- </ul><hr />
-<p><b><a name="skipExec">skipExec</a>:</b></p>
-
-<div>Skip Checkstyle execution will only scan the outputFile.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</tt></li>
-
-<li><b>Since</b>: <tt>2.5</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.skipExec</tt></li>
-
-<li><b>Default</b>: <tt>false</tt></li>
- </ul><hr />
-<p><b><a name="sourceDirectories">sourceDirectories</a>:</b></p>
-
-<div>Specifies the location of the source directories to be used for
-Checkstyle.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.util.List</tt></li>
-
-<li><b>Since</b>: <tt>2.13</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>Default</b>: <tt>${project.compileSourceRoots}</tt></li>
- </ul><hr />
-<p><b><a name="sourceDirectory">sourceDirectory</a>:</b></p>
-
-<div><b>Deprecated.</b> instead use <tt>sourceDirectories</tt></div>
-
-<div>Specifies the location of the source directory to be used for
-Checkstyle.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.io.File</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
- </ul><hr />
-<p><b><a name="suppressionsFileExpression">suppressionsFileExpression</a>:</b></p>
-
-<div>The key to be used in the properties for the suppressions file.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.1</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.suppression.expression</tt></li>
-
-<li><b>Default</b>: <tt>checkstyle.suppressions.file</tt></li>
- </ul><hr />
-<p><b><a name="suppressionsLocation">suppressionsLocation</a>:</b></p>
-
-<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
-<tt>${project.build.directory}/checkstyle-suppressions.xml</tt>
-file before being passed to Checkstyle for loading.</p>
-
-<p>See <tt>suppressionsFileExpression</tt> for the property
-that will be made available to your Checkstyle configuration.</p></div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.0-beta-2</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.suppressions.location</tt></li>
- </ul><hr />
-<p><b><a name="testSourceDirectories">testSourceDirectories</a>:</b></p>
-
-<div>Specifies the location of the test source directories to be used
-for Checkstyle.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.util.List</tt></li>
-
-<li><b>Since</b>: <tt>2.13</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>Default</b>: <tt>${project.testCompileSourceRoots}</tt></li>
- </ul><hr />
-<p><b><a name="testSourceDirectory">testSourceDirectory</a>:</b></p>
-
-<div><b>Deprecated.</b> instead use <tt>testSourceDirectories</tt></div>
-
-<div>Specifies the location of the test source directory to be used for
-Checkstyle.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.io.File</tt></li>
-
-<li><b>Since</b>: <tt>2.2</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
- </ul><hr />
-<p><b><a name="useFile">useFile</a>:</b></p>
-
-<div>If <tt>null</tt>, the Checkstyle plugin will display violations
-on stdout. Otherwise, a text file will be created with the
-violations.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.io.File</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
- </ul><hr />
-<p><b><a name="violationIgnore">violationIgnore</a>:</b></p>
-
-<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>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.13</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.violation.ignore</tt></li>
- </ul><hr />
-<p><b><a name="violationSeverity">violationSeverity</a>:</b></p>
-
-<div>The lowest severity level that is considered a violation. Valid
-values are "<tt>error</tt>", "<tt>warning</tt>" and
-"<tt>info</tt>".</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.lang.String</tt></li>
-
-<li><b>Since</b>: <tt>2.2</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>User Property</b>: <tt>checkstyle.violationSeverity</tt></li>
-
-<li><b>Default</b>: <tt>error</tt></li>
- </ul>
- </div>
- </div>
-
-
- </div>
- </div>
- <div class="clear">
- <hr/>
- </div>
- <div id="footer">
- <div class="xright">
- © 2005-2015
- The Apache Software Foundation
-
- - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
- Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
- </div>
- <div class="clear">
- <hr/>
- </div>
- </div>
- </body>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at 2015-05-02
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Apache Maven Checkstyle Plugin – checkstyle:check</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20150502" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../" id="bannerLeft">
+ <img src="../../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../../index.html">Maven</a>
+ >
+ <a href="../index.html">Plugins</a>
+ >
+ <a href="./">Apache Maven Checkstyle Plugin</a>
+ >
+ checkstyle:check
+ </div>
+ <div class="xright">
+ Last Published: 2015-05-02
+ | Version: 2.16-SNAPSHOT
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="plugin-info.html">Goals</a>
+ </li>
+ <li class="none">
+ <a href="usage.html">Usage</a>
+ </li>
+ <li class="none">
+ <a href="faq.html">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink">License</a>
+ </li>
+ <li class="none">
+ <a href="download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="history.html">Releases History</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="examples/upgrading-checkstyle.html">Upgrading Checkstyle at Runtime</a>
+ </li>
+ <li class="none">
+ <a href="examples/inline-checker-config.html">Using an Inline Checkstyle Checker Configuration</a>
+ </li>
+ <li class="none">
+ <a href="examples/custom-checker-config.html">Using a Custom Checkstyle Checker Configuration</a>
+ </li>
+ <li class="none">
+ <a href="examples/custom-property-expansion.html">Using Custom Checkstyle Property Expansion Definitions</a>
+ </li>
+ <li class="none">
+ <a href="examples/suppressions-filter.html">Using a Suppressions Filter</a>
+ </li>
+ <li class="none">
+ <a href="examples/custom-developed-checkstyle.html">Using Custom Developed Checkstyle Checks</a>
+ </li>
+ <li class="none">
+ <a href="examples/multi-module-config.html">Multimodule Configuration</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="project-info.html">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="project-reports.html">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../ref/current">Maven</a>
+ </li>
+ <li class="none">
+ <a href="../../pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="../index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../plugin-testing/index.html">Plugin Testing</a>
+ </li>
+ <li class="none">
+ <a href="../../plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="../../apache-resource-bundles/index.html">Resource Bundles</a>
+ </li>
+ <li class="none">
+ <a href="../../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+
+
+ <div class="section">
+<h2><a name="checkstyle:check"></a>checkstyle:check</h2>
+
+<p><b>Full name</b>:</p>
+
+<p>org.apache.maven.plugins:maven-checkstyle-plugin:2.16-SNAPSHOT: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>
+
+<ul>
+
+<li>Requires a Maven project to be executed.</li>
+
+<li>Requires dependency resolution of artifacts in scope: <tt>test</tt>.</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>: <tt>verify</tt>.</li>
+ </ul>
+
+<div class="section">
+<h3><a name="Required_Parameters"></a>Required Parameters</h3>
+
+<table class="bodyTable" border="0">
+
+<tr class="a">
+
+<th>Name</th>
+
+<th>Type</th>
+
+<th>Since</th>
+
+<th>Description</th>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#includeResources">includeResources</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>2.11</tt></td>
+
+<td>Whether to apply Checkstyle to resource directories.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.includeResources</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#includeTestResources">includeTestResources</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>2.11</tt></td>
+
+<td>Whether to apply Checkstyle to test resource directories.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.includeTestResources</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#includes">includes</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies the names filter of the source files to be used for
+Checkstyle.<br /><b>Default value is</b>: <tt>**\/*.java</tt>.<br /><b>User property is</b>: <tt>checkstyle.includes</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#resourceIncludes">resourceIncludes</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.11</tt></td>
+
+<td>Specifies the names filter of the files to be used for Checkstyle
+when checking resources.<br /><b>Default value is</b>: <tt>**/*.properties</tt>.<br /><b>User property is</b>: <tt>checkstyle.resourceIncludes</tt>.</td>
+ </tr>
+ </table>
+ </div>
+
+<div class="section">
+<h3><a name="Optional_Parameters"></a>Optional Parameters</h3>
+
+<table class="bodyTable" border="0">
+
+<tr class="a">
+
+<th>Name</th>
+
+<th>Type</th>
+
+<th>Since</th>
+
+<th>Description</th>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#cacheFile">cacheFile</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies the cache file used to speed up Checkstyle on successive
+runs.<br /><b>Default value is</b>: <tt>${project.build.directory}/checkstyle-cachefile</tt>.<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#checkstyleRules">checkstyleRules</a></b></td>
+
+<td><tt>PlexusConfiguration</tt></td>
+
+<td><tt>2.12</tt></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>
+ <module name="TreeWalker">
+ <module name="EmptyBlock"/>
+ </module>
+ </module>
+ </checkstyleRules>
+ </configuration>
+ ...
+</pre></div><br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#configLocation">configLocation</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.5</tt></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="http://checkstyle.sourceforge.net/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
+<tt>${project.build.directory}/checkstyle-configuration.xml</tt>
+file before being passed to Checkstyle as a configuration.</p>
+
+<p>There are 3 predefined rulesets.</p>
+
+<ul>
+
+<li><tt>sun_checks.xml</tt>: Sun Checks.</li>
+
+<li><tt>google_checks.xml</tt>: Google Checks.</li>
+
+<li><tt>config/maven_checks.xml</tt>: Maven Source Checks.</li>
+</ul><br /><b>Default value is</b>: <tt>sun_checks.xml</tt>.<br /><b>User property is</b>: <tt>checkstyle.config.location</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#consoleOutput">consoleOutput</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Output errors to console.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>checkstyle.consoleOutput</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#encoding">encoding</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.2</tt></td>
+
+<td>The file encoding to use when reading the source files. If the
+property <tt>project.build.sourceEncoding</tt> is not set, the
+platform default encoding is used. <b>Note:</b> This
+parameter always overrides the property <tt>charset</tt> from
+Checkstyle's <tt>TreeWalker</tt> module.<br /><b>Default value is</b>: <tt>${project.build.sourceEncoding}</tt>.<br /><b>User property is</b>: <tt>encoding</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#excludes">excludes</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies the names filter of the source files to be excluded for
+Checkstyle.<br /><b>User property is</b>: <tt>checkstyle.excludes</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#failOnViolation">failOnViolation</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Fail the build on a violation. The goal checks for the violations
+after logging them (if <tt>logViolationsToConsole</tt> is
+'true'). Compare this to <tt>failsOnError</tt> which fails the
+build immediately before examining the output log.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.failOnViolation</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#failsOnError">failsOnError</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></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 <tt>logViolationsToConsole</tt>. If you
+want to use <tt>logViolationsToConsole</tt>, use
+<tt>failOnViolation</tt> instead of this.<br /><b>Default value is</b>: <tt>false</tt>.<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#headerLocation">headerLocation</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.0-beta-2</tt></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>
+
+<p>You need to use ${checkstyle.header.file} in your Checkstyle xml
+configuration to reference the name of this header file.</p>
+
+<p>For instance:</p>
+
+<p><tt><module name="RegexpHeader"> <property
+name="headerFile" value="${checkstyle.header.file}"/>
+</module></tt></p><br /><b>Default value is</b>: <tt>LICENSE.txt</tt>.<br /><b>User property is</b>: <tt>checkstyle.header.file</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#includeTestSourceDirectory">includeTestSourceDirectory</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>2.2</tt></td>
+
+<td>Include or not the test source directory to be used for Checkstyle.<br /><b>Default value is</b>: <tt>false</tt>.<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#logViolationsToConsole">logViolationsToConsole</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>2.3</tt></td>
+
+<td>Output the detected violations to the console.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.console</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#maxAllowedViolations">maxAllowedViolations</a></b></td>
+
+<td><tt>int</tt></td>
+
+<td><tt>2.3</tt></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>: <tt>0</tt>.<br /><b>User property is</b>: <tt>checkstyle.maxAllowedViolations</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#outputFile">outputFile</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies the path and filename to save the Checkstyle output. The
+format of the output file is determined by the
+<tt>outputFileFormat</tt> parameter.<br /><b>Default value is</b>: <tt>${project.build.directory}/checkstyle-result.xml</tt>.<br /><b>User property is</b>: <tt>checkstyle.output.file</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#outputFileFormat">outputFileFormat</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies the format of the output to be used when writing to the
+output file. Valid values are "<tt>plain</tt>" and
+"<tt>xml</tt>".<br /><b>Default value is</b>: <tt>xml</tt>.<br /><b>User property is</b>: <tt>checkstyle.output.format</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#propertiesLocation">propertiesLocation</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.5</tt></td>
+
+<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
+<tt>${project.build.directory}/checkstyle-checker.properties</tt>
+file before being passed to Checkstyle for loading.</p>
+
+<p>The contents of the <tt>propertiesLocation</tt> will be made
+available to Checkstyle for specifying values for parameters within
+the xml configuration (specified in the <tt>configLocation</tt>
+parameter).</p><br /><b>User property is</b>: <tt>checkstyle.properties.location</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#propertyExpansion">propertyExpansion</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Allows for specifying raw property expansion information.<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#resourceExcludes">resourceExcludes</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.11</tt></td>
+
+<td>Specifies the names filter of the files to be excluded for
+Checkstyle when checking resources.<br /><b>User property is</b>: <tt>checkstyle.resourceExcludes</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#rulesFiles">rulesFiles</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>dump file for inlined Checkstyle rules<br /><b>Default value is</b>: <tt>${project.build.directory}/checkstyle-rules.xml</tt>.<br /><b>User property is</b>: <tt>checkstyle.output.rules.file</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#skip">skip</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>2.2</tt></td>
+
+<td>Skip entire check.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>checkstyle.skip</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#skipExec">skipExec</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>2.5</tt></td>
+
+<td>Skip Checkstyle execution will only scan the outputFile.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>checkstyle.skipExec</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#sourceDirectories">sourceDirectories</a></b></td>
+
+<td><tt>List</tt></td>
+
+<td><tt>2.13</tt></td>
+
+<td>Specifies the location of the source directories to be used for
+Checkstyle.<br /><b>Default value is</b>: <tt>${project.compileSourceRoots}</tt>.<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#sourceDirectory">sourceDirectory</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td><b>Deprecated.</b> instead use <tt>sourceDirectories</tt><br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#suppressionsFileExpression">suppressionsFileExpression</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.1</tt></td>
+
+<td>The key to be used in the properties for the suppressions file.<br /><b>Default value is</b>: <tt>checkstyle.suppressions.file</tt>.<br /><b>User property is</b>: <tt>checkstyle.suppression.expression</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#suppressionsLocation">suppressionsLocation</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.0-beta-2</tt></td>
+
+<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
+<tt>${project.build.directory}/checkstyle-suppressions.xml</tt>
+file before being passed to Checkstyle for loading.</p>
+
+<p>See <tt>suppressionsFileExpression</tt> for the property
+that will be made available to your Checkstyle configuration.</p><br /><b>User property is</b>: <tt>checkstyle.suppressions.location</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#testSourceDirectories">testSourceDirectories</a></b></td>
+
+<td><tt>List</tt></td>
+
+<td><tt>2.13</tt></td>
+
+<td>Specifies the location of the test source directories to be used
+for Checkstyle.<br /><b>Default value is</b>: <tt>${project.testCompileSourceRoots}</tt>.<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#testSourceDirectory">testSourceDirectory</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>2.2</tt></td>
+
+<td><b>Deprecated.</b> instead use <tt>testSourceDirectories</tt><br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#useFile">useFile</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>If <tt>null</tt>, the Checkstyle plugin will display violations
+on stdout. Otherwise, a text file will be created with the
+violations.<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#violationIgnore">violationIgnore</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.13</tt></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>: <tt>checkstyle.violation.ignore</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#violationSeverity">violationSeverity</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.2</tt></td>
+
+<td>The lowest severity level that is considered a violation. Valid
+values are "<tt>error</tt>", "<tt>warning</tt>" and
+"<tt>info</tt>".<br /><b>Default value is</b>: <tt>error</tt>.<br /><b>User property is</b>: <tt>checkstyle.violationSeverity</tt>.</td>
+ </tr>
+ </table>
+ </div>
+
+<div class="section">
+<h3><a name="Parameter_Details"></a>Parameter Details</h3>
+
+<p><b><a name="cacheFile">cacheFile</a>:</b></p>
+
+<div>Specifies the cache file used to speed up Checkstyle on successive
+runs.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>Default</b>: <tt>${project.build.directory}/checkstyle-cachefile</tt></li>
+ </ul><hr />
+<p><b><a name="checkstyleRules">checkstyleRules</a>:</b></p>
+
+<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>
+ <module name="TreeWalker">
+ <module name="EmptyBlock"/>
+ </module>
+ </module>
+ </checkstyleRules>
+ </configuration>
+ ...
+</pre></div></div>
+
+<ul>
+
+<li><b>Type</b>: <tt>org.codehaus.plexus.configuration.PlexusConfiguration</tt></li>
+
+<li><b>Since</b>: <tt>2.12</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="configLocation">configLocation</a>:</b></p>
+
+<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="http://checkstyle.sourceforge.net/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
+<tt>${project.build.directory}/checkstyle-configuration.xml</tt>
+file before being passed to Checkstyle as a configuration.</p>
+
+<p>There are 3 predefined rulesets.</p>
+
+<ul>
+
+<li><tt>sun_checks.xml</tt>: Sun Checks.</li>
+
+<li><tt>google_checks.xml</tt>: Google Checks.</li>
+
+<li><tt>config/maven_checks.xml</tt>: Maven Source Checks.</li>
+</ul></div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Since</b>: <tt>2.5</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.config.location</tt></li>
+
+<li><b>Default</b>: <tt>sun_checks.xml</tt></li>
+ </ul><hr />
+<p><b><a name="consoleOutput">consoleOutput</a>:</b></p>
+
+<div>Output errors to console.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.consoleOutput</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="encoding">encoding</a>:</b></p>
+
+<div>The file encoding to use when reading the source files. If the
+property <tt>project.build.sourceEncoding</tt> is not set, the
+platform default encoding is used. <b>Note:</b> This
+parameter always overrides the property <tt>charset</tt> from
+Checkstyle's <tt>TreeWalker</tt> module.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Since</b>: <tt>2.2</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>encoding</tt></li>
+
+<li><b>Default</b>: <tt>${project.build.sourceEncoding}</tt></li>
+ </ul><hr />
+<p><b><a name="excludes">excludes</a>:</b></p>
+
+<div>Specifies the names filter of the source files to be excluded for
+Checkstyle.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.excludes</tt></li>
+ </ul><hr />
+<p><b><a name="failOnViolation">failOnViolation</a>:</b></p>
+
+<div>Fail the build on a violation. The goal checks for the violations
+after logging them (if <tt>logViolationsToConsole</tt> is
+'true'). Compare this to <tt>failsOnError</tt> which fails the
+build immediately before examining the output log.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.failOnViolation</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="failsOnError">failsOnError</a>:</b></p>
+
+<div>If this is true, and Checkstyle reported any violations or errors,
+the build fails immediately after running Checkstyle, before
+checking the log for <tt>logViolationsToConsole</tt>. If you
+want to use <tt>logViolationsToConsole</tt>, use
+<tt>failOnViolation</tt> instead of this.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="headerLocation">headerLocation</a>:</b></p>
+
+<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 ${checkstyle.header.file} in your Checkstyle xml
+configuration to reference the name of this header file.</p>
+
+<p>For instance:</p>
+
+<p><tt><module name="RegexpHeader"> <property
+name="headerFile" value="${checkstyle.header.file}"/>
+</module></tt></p></div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Since</b>: <tt>2.0-beta-2</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.header.file</tt></li>
+
+<li><b>Default</b>: <tt>LICENSE.txt</tt></li>
+ </ul><hr />
+<p><b><a name="includeResources">includeResources</a>:</b></p>
+
+<div>Whether to apply Checkstyle to resource directories.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Since</b>: <tt>2.11</tt></li>
+
+<li><b>Required</b>: <tt>Yes</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.includeResources</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="includeTestResources">includeTestResources</a>:</b></p>
+
+<div>Whether to apply Checkstyle to test resource directories.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Since</b>: <tt>2.11</tt></li>
+
+<li><b>Required</b>: <tt>Yes</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.includeTestResources</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="includeTestSourceDirectory">includeTestSourceDirectory</a>:</b></p>
+
+<div>Include or not the test source directory to be used for Checkstyle.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Since</b>: <tt>2.2</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="includes">includes</a>:</b></p>
+
+<div>Specifies the names filter of the source files to be used for
+Checkstyle.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>Yes</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.includes</tt></li>
+
+<li><b>Default</b>: <tt>**\/*.java</tt></li>
+ </ul><hr />
+<p><b><a name="logViolationsToConsole">logViolationsToConsole</a>:</b></p>
+
+<div>Output the detected violations to the console.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Since</b>: <tt>2.3</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.console</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="maxAllowedViolations">maxAllowedViolations</a>:</b></p>
+
+<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>: <tt>int</tt></li>
+
+<li><b>Since</b>: <tt>2.3</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.maxAllowedViolations</tt></li>
+
+<li><b>Default</b>: <tt>0</tt></li>
+ </ul><hr />
+<p><b><a name="outputFile">outputFile</a>:</b></p>
+
+<div>Specifies the path and filename to save the Checkstyle output. The
+format of the output file is determined by the
+<tt>outputFileFormat</tt> parameter.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.output.file</tt></li>
+
+<li><b>Default</b>: <tt>${project.build.directory}/checkstyle-result.xml</tt></li>
+ </ul><hr />
+<p><b><a name="outputFileFormat">outputFileFormat</a>:</b></p>
+
+<div>Specifies the format of the output to be used when writing to the
+output file. Valid values are "<tt>plain</tt>" and
+"<tt>xml</tt>".</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.output.format</tt></li>
+
+<li><b>Default</b>: <tt>xml</tt></li>
+ </ul><hr />
+<p><b><a name="propertiesLocation">propertiesLocation</a>:</b></p>
+
+<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
+<tt>${project.build.directory}/checkstyle-checker.properties</tt>
+file before being passed to Checkstyle for loading.</p>
+
+<p>The contents of the <tt>propertiesLocation</tt> will be made
+available to Checkstyle for specifying values for parameters within
+the xml configuration (specified in the <tt>configLocation</tt>
+parameter).</p></div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Since</b>: <tt>2.5</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.properties.location</tt></li>
+ </ul><hr />
+<p><b><a name="propertyExpansion">propertyExpansion</a>:</b></p>
+
+<div>Allows for specifying raw property expansion information.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="resourceExcludes">resourceExcludes</a>:</b></p>
+
+<div>Specifies the names filter of the files to be excluded for
+Checkstyle when checking resources.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Since</b>: <tt>2.11</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.resourceExcludes</tt></li>
+ </ul><hr />
+<p><b><a name="resourceIncludes">resourceIncludes</a>:</b></p>
+
+<div>Specifies the names filter of the files to be used for Checkstyle
+when checking resources.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Since</b>: <tt>2.11</tt></li>
+
+<li><b>Required</b>: <tt>Yes</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.resourceIncludes</tt></li>
+
+<li><b>Default</b>: <tt>**/*.properties</tt></li>
+ </ul><hr />
+<p><b><a name="rulesFiles">rulesFiles</a>:</b></p>
+
+<div>dump file for inlined Checkstyle rules</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.output.rules.file</tt></li>
+
+<li><b>Default</b>: <tt>${project.build.directory}/checkstyle-rules.xml</tt></li>
+ </ul><hr />
+<p><b><a name="skip">skip</a>:</b></p>
+
+<div>Skip entire check.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Since</b>: <tt>2.2</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.skip</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="skipExec">skipExec</a>:</b></p>
+
+<div>Skip Checkstyle execution will only scan the outputFile.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</tt></li>
+
+<li><b>Since</b>: <tt>2.5</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.skipExec</tt></li>
+
+<li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr />
+<p><b><a name="sourceDirectories">sourceDirectories</a>:</b></p>
+
+<div>Specifies the location of the source directories to be used for
+Checkstyle.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.util.List</tt></li>
+
+<li><b>Since</b>: <tt>2.13</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>Default</b>: <tt>${project.compileSourceRoots}</tt></li>
+ </ul><hr />
+<p><b><a name="sourceDirectory">sourceDirectory</a>:</b></p>
+
+<div><b>Deprecated.</b> instead use <tt>sourceDirectories</tt></div>
+
+<div>Specifies the location of the source directory to be used for
+Checkstyle.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="suppressionsFileExpression">suppressionsFileExpression</a>:</b></p>
+
+<div>The key to be used in the properties for the suppressions file.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Since</b>: <tt>2.1</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.suppression.expression</tt></li>
+
+<li><b>Default</b>: <tt>checkstyle.suppressions.file</tt></li>
+ </ul><hr />
+<p><b><a name="suppressionsLocation">suppressionsLocation</a>:</b></p>
+
+<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
+<tt>${project.build.directory}/checkstyle-suppressions.xml</tt>
+file before being passed to Checkstyle for loading.</p>
+
+<p>See <tt>suppressionsFileExpression</tt> for the property
+that will be made available to your Checkstyle configuration.</p></div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.lang.String</tt></li>
+
+<li><b>Since</b>: <tt>2.0-beta-2</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>User Property</b>: <tt>checkstyle.suppressions.location</tt></li>
+ </ul><hr />
+<p><b><a name="testSourceDirectories">testSourceDirectories</a>:</b></p>
+
+<div>Specifies the location of the test source directories to be used
+for Checkstyle.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.util.List</tt></li>
+
+<li><b>Since</b>: <tt>2.13</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>Default</b>: <tt>${project.testCompileSourceRoots}</tt></li>
+ </ul><hr />
+<p><b><a name="testSourceDirectory">testSourceDirectory</a>:</b></p>
+
+<div><b>Deprecated.</b> instead use <tt>testSourceDirectories</tt></div>
+
+<div>Specifies the location of the test source directory to be used for
+Checkstyle.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Since</b>: <tt>2.2</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="useFile">useFile</a>:</b></p>
+
+<div>If <tt>null</tt>, the Checkstyle plugin will display violations
+on stdout. Otherwise, a text file will be created with the
+violations.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr />
+<p><b><a name="violationIgnore">violationIgnore</a>:</b></p>
+
+<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>
+
[... 51 lines stripped ...]