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 [4/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/checkstyle-mojo.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-checkstyle-plugin-LATEST/checkstyle-mojo.html (original)
+++ websites/production/maven/components/plugins-archives/maven-checkstyle-plugin-LATEST/checkstyle-mojo.html Sat May 2 10:15:09 2015
@@ -1,1419 +1,1423 @@
-<!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:checkstyle</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:checkstyle
- </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:checkstyle"></a>checkstyle:checkstyle</h2>
-
-<p><b>Note</b>:This goal should be used as a Maven report.</p>
-
-<p><b>Full name</b>:</p>
-
-<p>org.apache.maven.plugins:maven-checkstyle-plugin:2.16-SNAPSHOT:checkstyle</p>
-
-<p><b>Description</b>:</p>
-
-<div>A reporting task that performs Checkstyle analysis and generates an
-HTML report on any violations that Checkstyle finds.</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>compile</tt>.</li>
-
-<li>The goal is thread-safe and supports parallel builds.</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>Specifies whether to include the resource directories in the check.<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>Specifies whether to include the test resource directories in the
-check.<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 resource files to be used for
-Checkstyle.<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="#configLocation">configLocation</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>-</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 included in Maven Checkstyle
-Plugin:</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="b">
-
-<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="a">
-
-<td><b><a href="#enableFilesSummary">enableFilesSummary</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies if the Files summary should be enabled or not.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.enable.files.summary</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#enableRSS">enableRSS</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies if the RSS should be enabled or not.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.enable.rss</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#enableRulesSummary">enableRulesSummary</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies if the Rules summary should be enabled or not.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.enable.rules.summary</tt>.</td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#enableSeveritySummary">enableSeveritySummary</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies if the Severity summary should be enabled or not.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.enable.severity.summary</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<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="b">
-
-<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="a">
-
-<td><b><a href="#failsOnError">failsOnError</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Specifies if the build should fail upon a violation.<br /><b>Default value is</b>: <tt>false</tt>.<br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#format">format</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>-</tt></td>
-
-<td><b>Deprecated.</b> Use configLocation instead.<br /><b>Default value is</b>: <tt>sun</tt>.<br /></td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#headerFile">headerFile</a></b></td>
-
-<td><tt>File</tt></td>
-
-<td><tt>-</tt></td>
-
-<td><b>Deprecated.</b> Use headerLocation instead.<br /><b>Default value is</b>: <tt>${basedir}/LICENSE.txt</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/directories to be used for
-Checkstyle.<br /><b>Default value is</b>: <tt>false</tt>.<br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#linkXRef">linkXRef</a></b></td>
-
-<td><tt>boolean</tt></td>
-
-<td><tt>2.1</tt></td>
-
-<td>Link the violation line numbers to the source xref. Will link
-automatically if Maven JXR plugin is being used.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>linkXRef</tt>.</td>
- </tr>
-
-<tr class="a">
-
-<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="b">
-
-<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="a">
-
-<td><b><a href="#packageNamesFile">packageNamesFile</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>-</tt></td>
-
-<td><b>Deprecated.</b> Use packageNamesLocation instead.<br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#packageNamesLocation">packageNamesLocation</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.0-beta-2</tt></td>
-
-<td>
-<p>Specifies the location of the package names XML to be used to
-configure the Checkstyle <a class="externalLink" href="http://checkstyle.sourceforge.net/config.html#Packages">Packages</a>.</p>
-
-<p>This parameter is resolved as resource, URL, then file. If
-resolved to a resource, or a URL, the contents of the package names
-XML is copied into the
-<tt>${project.build.directory}/checkstyle-packagenames.xml</tt>
-file before being passed to Checkstyle for loading.</p><br /></td>
- </tr>
-
-<tr class="a">
-
-<td><b><a href="#propertiesFile">propertiesFile</a></b></td>
-
-<td><tt>File</tt></td>
-
-<td><tt>-</tt></td>
-
-<td><b>Deprecated.</b> Use propertiesLocation instead.<br /></td>
- </tr>
-
-<tr class="b">
-
-<td><b><a href="#propertiesLocation">propertiesLocation</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>2.0-beta-2</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="#propertiesURL">propertiesURL</a></b></td>
-
-<td><tt>URL</tt></td>
-
-<td><tt>-</tt></td>
-
-<td><b>Deprecated.</b> Use propertiesLocation instead.<br /></td>
- </tr>
-
-<tr class="b">
-
-<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="a">
-
-<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 resource files to be excluded for
-Checkstyle.<br /><b>User property is</b>: <tt>checkstyle.resourceExcludes</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="#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="b">
-
-<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="a">
-
-<td><b><a href="#suppressionsFile">suppressionsFile</a></b></td>
-
-<td><tt>String</tt></td>
-
-<td><tt>-</tt></td>
-
-<td><b>Deprecated.</b> Use suppressionsLocation instead.<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-supressions.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="#treeWalkerNames">treeWalkerNames</a></b></td>
-
-<td><tt>List</tt></td>
-
-<td><tt>2.11</tt></td>
-
-<td>When using custom treeWalkers, specify their names here so the
-checks inside the treeWalker end up the the rule-summary.<br /></td>
- </tr>
-
-<tr class="a">
-
-<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="b">
-
-<td><b><a href="#xrefLocation">xrefLocation</a></b></td>
-
-<td><tt>File</tt></td>
-
-<td><tt>-</tt></td>
-
-<td>Location of the Xrefs to link to.<br /><b>Default value is</b>: <tt>${project.reporting.outputDirectory}/xref</tt>.<br /></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="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 included in Maven Checkstyle
-Plugin:</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>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="enableFilesSummary">enableFilesSummary</a>:</b></p>
-
-<div>Specifies if the Files summary should be enabled or not.</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.enable.files.summary</tt></li>
-
-<li><b>Default</b>: <tt>true</tt></li>
- </ul><hr />
-<p><b><a name="enableRSS">enableRSS</a>:</b></p>
-
-<div>Specifies if the RSS should be enabled or not.</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.enable.rss</tt></li>
-
-<li><b>Default</b>: <tt>true</tt></li>
- </ul><hr />
-<p><b><a name="enableRulesSummary">enableRulesSummary</a>:</b></p>
-
-<div>Specifies if the Rules summary should be enabled or not.</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.enable.rules.summary</tt></li>
-
-<li><b>Default</b>: <tt>true</tt></li>
- </ul><hr />
-<p><b><a name="enableSeveritySummary">enableSeveritySummary</a>:</b></p>
-
-<div>Specifies if the Severity summary should be enabled or not.</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.enable.severity.summary</tt></li>
-
-<li><b>Default</b>: <tt>true</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="failsOnError">failsOnError</a>:</b></p>
-
-<div>Specifies if the build should fail upon a violation.</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="format">format</a>:</b></p>
-
-<div><b>Deprecated.</b> Use configLocation instead.</div>
-
-<div>Specifies what predefined check set to use. Available sets are
-"sun" (for the Sun coding conventions), and "maven".</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>sun</tt></li>
- </ul><hr />
-<p><b><a name="headerFile">headerFile</a>:</b></p>
-
-<div><b>Deprecated.</b> Use headerLocation instead.</div>
-
-<div>Specifies the location of the License file (a.k.a. the header file)
-that is used by Checkstyle to verify that source code has the
-correct license header.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.io.File</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>Default</b>: <tt>${basedir}/LICENSE.txt</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>Specifies whether to include the resource directories in the check.</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>Specifies whether to include the test resource directories in the
-check.</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/directories 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="linkXRef">linkXRef</a>:</b></p>
-
-<div>Link the violation line numbers to the source xref. Will link
-automatically if Maven JXR plugin is being used.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>boolean</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>linkXRef</tt></li>
-
-<li><b>Default</b>: <tt>true</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="packageNamesFile">packageNamesFile</a>:</b></p>
-
-<div><b>Deprecated.</b> Use packageNamesLocation instead.</div>
-
-<div>Specifies the location of the package names XML to be used to
-configure Checkstyle.</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="packageNamesLocation">packageNamesLocation</a>:</b></p>
-
-<div>
-<p>Specifies the location of the package names XML to be used to
-configure the Checkstyle <a class="externalLink" href="http://checkstyle.sourceforge.net/config.html#Packages">Packages</a>.</p>
-
-<p>This parameter is resolved as resource, URL, then file. If
-resolved to a resource, or a URL, the contents of the package names
-XML is copied into the
-<tt>${project.build.directory}/checkstyle-packagenames.xml</tt>
-file before being passed to Checkstyle for loading.</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>
- </ul><hr />
-<p><b><a name="propertiesFile">propertiesFile</a>:</b></p>
-
-<div><b>Deprecated.</b> Use propertiesLocation instead.</div>
-
-<div>Specifies the location of the Checkstyle properties file that will
-be used to check the source.</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="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.0-beta-2</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="propertiesURL">propertiesURL</a>:</b></p>
-
-<div><b>Deprecated.</b> Use propertiesLocation instead.</div>
-
-<div>Specifies the URL of the Checkstyle properties that will be used to
-check the source.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.net.URL</tt></li>
-
-<li><b>Required</b>: <tt>No</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 resource files to be excluded for
-Checkstyle.</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 resource files to be used for
-Checkstyle.</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="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="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="suppressionsFile">suppressionsFile</a>:</b></p>
-
-<div><b>Deprecated.</b> Use suppressionsLocation instead.</div>
-
-<div>Specifies the location of the suppressions XML file to use. The
-plugin defines a Checkstyle property named
-<tt>checkstyle.suppressions.file</tt> with the value of this
-property. This allows using the Checkstyle property in your own
-custom Checkstyle configuration file when specifying a suppressions
-file.</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="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-supressions.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="treeWalkerNames">treeWalkerNames</a>:</b></p>
-
-<div>When using custom treeWalkers, specify their names here so the
-checks inside the treeWalker end up the the rule-summary.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.util.List</tt></li>
-
-<li><b>Since</b>: <tt>2.11</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="xrefLocation">xrefLocation</a>:</b></p>
-
-<div>Location of the Xrefs to link to.</div>
-
-<ul>
-
-<li><b>Type</b>: <tt>java.io.File</tt></li>
-
-<li><b>Required</b>: <tt>No</tt></li>
-
-<li><b>Default</b>: <tt>${project.reporting.outputDirectory}/xref</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:checkstyle</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:checkstyle
+ </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:checkstyle"></a>checkstyle:checkstyle</h2>
+
+<p><b>Note</b>:This goal should be used as a Maven report.</p>
+
+<p><b>Full name</b>:</p>
+
+<p>org.apache.maven.plugins:maven-checkstyle-plugin:2.16-SNAPSHOT:checkstyle</p>
+
+<p><b>Description</b>:</p>
+
+<div>A reporting task that performs Checkstyle analysis and generates an
+HTML report on any violations that Checkstyle finds.</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>compile</tt>.</li>
+
+<li>The goal is thread-safe and supports parallel builds.</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>Specifies whether to include the resource directories in the check.<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>Specifies whether to include the test resource directories in the
+check.<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 resource files to be used for
+Checkstyle.<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="#configLocation">configLocation</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</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 included in Maven Checkstyle
+Plugin:</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="b">
+
+<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="a">
+
+<td><b><a href="#enableFilesSummary">enableFilesSummary</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies if the Files summary should be enabled or not.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.enable.files.summary</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#enableRSS">enableRSS</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies if the RSS should be enabled or not.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.enable.rss</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#enableRulesSummary">enableRulesSummary</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies if the Rules summary should be enabled or not.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.enable.rules.summary</tt>.</td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#enableSeveritySummary">enableSeveritySummary</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies if the Severity summary should be enabled or not.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>checkstyle.enable.severity.summary</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<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="b">
+
+<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="a">
+
+<td><b><a href="#failsOnError">failsOnError</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Specifies if the build should fail upon a violation.<br /><b>Default value is</b>: <tt>false</tt>.<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#format">format</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td><b>Deprecated.</b> Use configLocation instead.<br /><b>Default value is</b>: <tt>sun</tt>.<br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#headerFile">headerFile</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td><b>Deprecated.</b> Use headerLocation instead.<br /><b>Default value is</b>: <tt>${basedir}/LICENSE.txt</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/directories to be used for
+Checkstyle.<br /><b>Default value is</b>: <tt>false</tt>.<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#linkXRef">linkXRef</a></b></td>
+
+<td><tt>boolean</tt></td>
+
+<td><tt>2.1</tt></td>
+
+<td>Link the violation line numbers to the source xref. Will link
+automatically if Maven JXR plugin is being used.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>linkXRef</tt>.</td>
+ </tr>
+
+<tr class="a">
+
+<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="b">
+
+<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="a">
+
+<td><b><a href="#packageNamesFile">packageNamesFile</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td><b>Deprecated.</b> Use packageNamesLocation instead.<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#packageNamesLocation">packageNamesLocation</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.0-beta-2</tt></td>
+
+<td>
+<p>Specifies the location of the package names XML to be used to
+configure the Checkstyle <a class="externalLink" href="http://checkstyle.sourceforge.net/config.html#Packages">Packages</a>.</p>
+
+<p>This parameter is resolved as resource, URL, then file. If
+resolved to a resource, or a URL, the contents of the package names
+XML is copied into the
+<tt>${project.build.directory}/checkstyle-packagenames.xml</tt>
+file before being passed to Checkstyle for loading.</p><br /></td>
+ </tr>
+
+<tr class="a">
+
+<td><b><a href="#propertiesFile">propertiesFile</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td><b>Deprecated.</b> Use propertiesLocation instead.<br /></td>
+ </tr>
+
+<tr class="b">
+
+<td><b><a href="#propertiesLocation">propertiesLocation</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>2.0-beta-2</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="#propertiesURL">propertiesURL</a></b></td>
+
+<td><tt>URL</tt></td>
+
+<td><tt>-</tt></td>
+
+<td><b>Deprecated.</b> Use propertiesLocation instead.<br /></td>
+ </tr>
+
+<tr class="b">
+
+<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="a">
+
+<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 resource files to be excluded for
+Checkstyle.<br /><b>User property is</b>: <tt>checkstyle.resourceExcludes</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="#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="b">
+
+<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="a">
+
+<td><b><a href="#suppressionsFile">suppressionsFile</a></b></td>
+
+<td><tt>String</tt></td>
+
+<td><tt>-</tt></td>
+
+<td><b>Deprecated.</b> Use suppressionsLocation instead.<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-supressions.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="#treeWalkerNames">treeWalkerNames</a></b></td>
+
+<td><tt>List</tt></td>
+
+<td><tt>2.11</tt></td>
+
+<td>When using custom treeWalkers, specify their names here so the
+checks inside the treeWalker end up the the rule-summary.<br /></td>
+ </tr>
+
+<tr class="a">
+
+<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="b">
+
+<td><b><a href="#xrefLocation">xrefLocation</a></b></td>
+
+<td><tt>File</tt></td>
+
+<td><tt>-</tt></td>
+
+<td>Location of the Xrefs to link to.<br /><b>Default value is</b>: <tt>${project.reporting.outputDirectory}/xref</tt>.<br /></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="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 included in Maven Checkstyle
+Plugin:</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>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="enableFilesSummary">enableFilesSummary</a>:</b></p>
+
+<div>Specifies if the Files summary should be enabled or not.</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.enable.files.summary</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="enableRSS">enableRSS</a>:</b></p>
+
+<div>Specifies if the RSS should be enabled or not.</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.enable.rss</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="enableRulesSummary">enableRulesSummary</a>:</b></p>
+
+<div>Specifies if the Rules summary should be enabled or not.</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.enable.rules.summary</tt></li>
+
+<li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr />
+<p><b><a name="enableSeveritySummary">enableSeveritySummary</a>:</b></p>
+
+<div>Specifies if the Severity summary should be enabled or not.</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.enable.severity.summary</tt></li>
+
+<li><b>Default</b>: <tt>true</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="failsOnError">failsOnError</a>:</b></p>
+
+<div>Specifies if the build should fail upon a violation.</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="format">format</a>:</b></p>
+
+<div><b>Deprecated.</b> Use configLocation instead.</div>
+
+<div>Specifies what predefined check set to use. Available sets are
+"sun" (for the Sun coding conventions), and "maven".</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>sun</tt></li>
+ </ul><hr />
+<p><b><a name="headerFile">headerFile</a>:</b></p>
+
+<div><b>Deprecated.</b> Use headerLocation instead.</div>
+
+<div>Specifies the location of the License file (a.k.a. the header file)
+that is used by Checkstyle to verify that source code has the
+correct license header.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.io.File</tt></li>
+
+<li><b>Required</b>: <tt>No</tt></li>
+
+<li><b>Default</b>: <tt>${basedir}/LICENSE.txt</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>Specifies whether to include the resource directories in the check.</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>Specifies whether to include the test resource directories in the
+check.</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/directories 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="linkXRef">linkXRef</a>:</b></p>
+
+<div>Link the violation line numbers to the source xref. Will link
+automatically if Maven JXR plugin is being used.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>boolean</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>linkXRef</tt></li>
+
+<li><b>Default</b>: <tt>true</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="packageNamesFile">packageNamesFile</a>:</b></p>
+
+<div><b>Deprecated.</b> Use packageNamesLocation instead.</div>
+
+<div>Specifies the location of the package names XML to be used to
+configure Checkstyle.</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="packageNamesLocation">packageNamesLocation</a>:</b></p>
+
+<div>
+<p>Specifies the location of the package names XML to be used to
+configure the Checkstyle <a class="externalLink" href="http://checkstyle.sourceforge.net/config.html#Packages">Packages</a>.</p>
+
+<p>This parameter is resolved as resource, URL, then file. If
+resolved to a resource, or a URL, the contents of the package names
+XML is copied into the
+<tt>${project.build.directory}/checkstyle-packagenames.xml</tt>
+file before being passed to Checkstyle for loading.</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>
+ </ul><hr />
+<p><b><a name="propertiesFile">propertiesFile</a>:</b></p>
+
+<div><b>Deprecated.</b> Use propertiesLocation instead.</div>
+
+<div>Specifies the location of the Checkstyle properties file that will
+be used to check the source.</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="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.0-beta-2</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="propertiesURL">propertiesURL</a>:</b></p>
+
+<div><b>Deprecated.</b> Use propertiesLocation instead.</div>
+
+<div>Specifies the URL of the Checkstyle properties that will be used to
+check the source.</div>
+
+<ul>
+
+<li><b>Type</b>: <tt>java.net.URL</tt></li>
+
+<li><b>Required</b>: <tt>No</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 resource files to be excluded for
+Checkstyle.</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>
+
[... 212 lines stripped ...]