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 &#x2013; 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>
-        &gt;
-                  <a href="../../index.html">Maven</a>
-        &gt;
-                  <a href="../index.html">Plugins</a>
-        &gt;
-                      <a href="./">Apache Maven Checkstyle Plugin</a>
-        &gt;
-        checkstyle:check
-        </div>
-            <div class="xright">        
-                                    Last Published: 2015-04-11
-              &nbsp;| 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>
-&lt;plugin&gt;
-  ...
-  &lt;configuration&gt;
-    &lt;checkstyleRules&gt;
-      &lt;module name=&quot;Checker&quot;&gt;
-        &lt;module name=&quot;FileTabCharacter&quot;&gt;
-          &lt;property name=&quot;eachLine&quot; value=&quot;true&quot; /&gt;
-        &lt;/module&gt;
-        &lt;module name=&quot;TreeWalker&quot;&gt;
-          &lt;module name=&quot;EmptyBlock&quot;/&gt;
-        &lt;/module&gt;
-      &lt;/module&gt;
-    &lt;/checkstyleRules&gt;
-  &lt;/configuration&gt;
-  ...
-</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>&lt;module name=&quot;RegexpHeader&quot;&gt; &lt;property
-name=&quot;headerFile&quot; value=&quot;${checkstyle.header.file}&quot;/&gt;
-&lt;/module&gt;</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 &quot;<tt>plain</tt>&quot; and
-&quot;<tt>xml</tt>&quot;.<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 &quot;<tt>error</tt>&quot;, &quot;<tt>warning</tt>&quot; and
-&quot;<tt>info</tt>&quot;.<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>
-&lt;plugin&gt;
-  ...
-  &lt;configuration&gt;
-    &lt;checkstyleRules&gt;
-      &lt;module name=&quot;Checker&quot;&gt;
-        &lt;module name=&quot;FileTabCharacter&quot;&gt;
-          &lt;property name=&quot;eachLine&quot; value=&quot;true&quot; /&gt;
-        &lt;/module&gt;
-        &lt;module name=&quot;TreeWalker&quot;&gt;
-          &lt;module name=&quot;EmptyBlock&quot;/&gt;
-        &lt;/module&gt;
-      &lt;/module&gt;
-    &lt;/checkstyleRules&gt;
-  &lt;/configuration&gt;
-  ...
-</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>&lt;module name=&quot;RegexpHeader&quot;&gt; &lt;property
-name=&quot;headerFile&quot; value=&quot;${checkstyle.header.file}&quot;/&gt;
-&lt;/module&gt;</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 &quot;<tt>plain</tt>&quot; and
-&quot;<tt>xml</tt>&quot;.</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 &quot;<tt>error</tt>&quot;, &quot;<tt>warning</tt>&quot; and
-&quot;<tt>info</tt>&quot;.</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">
-        &#169;            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 &#x2013; 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>
+        &gt;
+                  <a href="../../index.html">Maven</a>
+        &gt;
+                  <a href="../index.html">Plugins</a>
+        &gt;
+                      <a href="./">Apache Maven Checkstyle Plugin</a>
+        &gt;
+        checkstyle:check
+        </div>
+            <div class="xright">        
+                                    Last Published: 2015-05-02
+              &nbsp;| 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>
+&lt;plugin&gt;
+  ...
+  &lt;configuration&gt;
+    &lt;checkstyleRules&gt;
+      &lt;module name=&quot;Checker&quot;&gt;
+        &lt;module name=&quot;FileTabCharacter&quot;&gt;
+          &lt;property name=&quot;eachLine&quot; value=&quot;true&quot; /&gt;
+        &lt;/module&gt;
+        &lt;module name=&quot;TreeWalker&quot;&gt;
+          &lt;module name=&quot;EmptyBlock&quot;/&gt;
+        &lt;/module&gt;
+      &lt;/module&gt;
+    &lt;/checkstyleRules&gt;
+  &lt;/configuration&gt;
+  ...
+</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>&lt;module name=&quot;RegexpHeader&quot;&gt; &lt;property
+name=&quot;headerFile&quot; value=&quot;${checkstyle.header.file}&quot;/&gt;
+&lt;/module&gt;</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 &quot;<tt>plain</tt>&quot; and
+&quot;<tt>xml</tt>&quot;.<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 &quot;<tt>error</tt>&quot;, &quot;<tt>warning</tt>&quot; and
+&quot;<tt>info</tt>&quot;.<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>
+&lt;plugin&gt;
+  ...
+  &lt;configuration&gt;
+    &lt;checkstyleRules&gt;
+      &lt;module name=&quot;Checker&quot;&gt;
+        &lt;module name=&quot;FileTabCharacter&quot;&gt;
+          &lt;property name=&quot;eachLine&quot; value=&quot;true&quot; /&gt;
+        &lt;/module&gt;
+        &lt;module name=&quot;TreeWalker&quot;&gt;
+          &lt;module name=&quot;EmptyBlock&quot;/&gt;
+        &lt;/module&gt;
+      &lt;/module&gt;
+    &lt;/checkstyleRules&gt;
+  &lt;/configuration&gt;
+  ...
+</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>&lt;module name=&quot;RegexpHeader&quot;&gt; &lt;property
+name=&quot;headerFile&quot; value=&quot;${checkstyle.header.file}&quot;/&gt;
+&lt;/module&gt;</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 &quot;<tt>plain</tt>&quot; and
+&quot;<tt>xml</tt>&quot;.</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 ...]