RubyGems - git_sniffer - Versions diffs - 0.0.1 - Mend

git_sniffer 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1018) hide show

data/third_party_tools/checkstyle-5.6/site/config_coding.html ADDED Viewed

@@ -0,0 +1,2724 @@
+<!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 Sep 18, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>checkstyle -
+    Coding</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="author" content="Checkstyle Development Team" />
+    <meta name="Date-Revision-yyyymmdd" content="20120918" />
+    <meta http-equiv="Content-Language" content="en" />
+  </head>
+  <body class="composite">
+    <div id="banner">
+                    <div id="bannerLeft">
+                Checkstyle 5.6
+                </div>
+                        <a href="" id="bannerRight" title="Checkstyle">
+                                                <img src="images/logo.png" alt="Checkstyle" />
+                </a>
+            <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+                <div class="xleft">
+        <span id="publishDate">Last Published: 2012-09-18</span>
+                  &nbsp;| <span id="projectVersion">Version: 5.6</span>
+                      </div>
+            <div class="xright">
+      </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+                                <h5>About</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="index.html" title="Checkstyle">Checkstyle</a>
+            </li>
+                  <li class="none">
+                          <a href="releasenotes.html" title="Release Notes">Release Notes</a>
+            </li>
+          </ul>
+                       <h5>Documentation</h5>
+                  <ul>
+                                                              <li class="expanded">
+                          <a href="config.html" title="Configuration">Configuration</a>
+                    <ul>
+                      <li class="none">
+                          <a href="property_types.html" title="Property Types">Property Types</a>
+            </li>
+              </ul>
+        </li>
+                                                                                <li class="expanded">
+                          <a href="running.html" title="Running">Running</a>
+                    <ul>
+                      <li class="none">
+                          <a href="anttask.html" title="Ant Task">Ant Task</a>
+            </li>
+                      <li class="none">
+                          <a href="cmdline.html" title="Command Line">Command Line</a>
+            </li>
+              </ul>
+        </li>
+                  <li class="none">
+                          <a href="availablechecks.html" title="Available Checks">Available Checks</a>
+            </li>
+                                                                                                                                                                                                                                                                                                                                    <li class="expanded">
+                          <a href="checks.html" title="Standard Checks">Standard Checks</a>
+                    <ul>
+                      <li class="none">
+                          <a href="config_annotation.html" title="Annotations">Annotations</a>
+            </li>
+                      <li class="none">
+                          <a href="config_blocks.html" title="Block Checks">Block Checks</a>
+            </li>
+                      <li class="none">
+                          <a href="config_design.html" title="Class Design">Class Design</a>
+            </li>
+                      <li class="none">
+            <strong>Coding</strong>
+          </li>
+                      <li class="none">
+                          <a href="config_duplicates.html" title="Duplicate Code">Duplicate Code</a>
+            </li>
+                      <li class="none">
+                          <a href="config_header.html" title="Headers">Headers</a>
+            </li>
+                      <li class="none">
+                          <a href="config_imports.html" title="Imports">Imports</a>
+            </li>
+                      <li class="none">
+                          <a href="config_javadoc.html" title="Javadoc Comments">Javadoc Comments</a>
+            </li>
+                      <li class="none">
+                          <a href="config_metrics.html" title="Metrics">Metrics</a>
+            </li>
+                      <li class="none">
+                          <a href="config_misc.html" title="Miscellaneous">Miscellaneous</a>
+            </li>
+                      <li class="none">
+                          <a href="config_modifier.html" title="Modifiers">Modifiers</a>
+            </li>
+                      <li class="none">
+                          <a href="config_naming.html" title="Naming Conventions">Naming Conventions</a>
+            </li>
+                      <li class="none">
+                          <a href="config_regexp.html" title="Regexp">Regexp</a>
+            </li>
+                      <li class="none">
+                          <a href="config_sizes.html" title="Size Violations">Size Violations</a>
+            </li>
+                      <li class="none">
+                          <a href="config_whitespace.html" title="Whitespace">Whitespace</a>
+            </li>
+              </ul>
+        </li>
+                                                                                                  <li class="expanded">
+                          <a href="extending.html" title="Extending Checkstyle">Extending Checkstyle</a>
+                    <ul>
+                      <li class="none">
+                          <a href="writingchecks.html" title="Writing checks">Writing checks</a>
+            </li>
+                      <li class="none">
+                          <a href="writingfilters.html" title="Writing filters">Writing filters</a>
+            </li>
+                      <li class="none">
+                          <a href="writinglisteners.html" title="Writing listeners">Writing listeners</a>
+            </li>
+              </ul>
+        </li>
+          </ul>
+                       <h5>Developers</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="apidocs/index.html" title="Javadoc">Javadoc</a>
+            </li>
+                  <li class="none">
+                          <a href="http://sourceforge.net/projects/checkstyle" class="externalLink" title="Project Page">Project Page</a>
+            </li>
+                  <li class="none">
+                          <a href="contributing.html" title="Contributing">Contributing</a>
+            </li>
+          </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                                                                                                                                                                                                          <li class="collapsed">
+                          <a href="project-info.html" title="Project Information">Project Information</a>
+                  </li>
+                                                                    <li class="collapsed">
+                          <a href="project-reports.html" title="Project Reports">Project Reports</a>
+                  </li>
+          </ul>
+                                                                                                                   <a href="http://sourceforge.net/projects/checkstyle" title="SourceForge" class="poweredBy">
+        <img class="poweredBy"  alt="SourceForge" src="http://sflogo.sourceforge.net/sflogo.php?group_id=29721&type=11"    />
+      </a>
+            </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+    <div class="section"><h2>ArrayTrailingComma<a name="ArrayTrailingComma"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that array initialization contains a trailing comma.
+        </p>
+        <div class="source"><pre>
+int[] a = new int[]
+{
+    1,
+    2,
+    3,
+};
+        </pre></div>
+        <p>
+          The check allows to not add a comma if both left and right curlys
+          are on the same line.
+        </p>
+        <div class="source"><pre>
+return new int[] { 0 };
+        </pre></div>
+        <p>
+          Rationale: Putting this comma in makes it easier to change the order
+          of the elements or add new elements on the end.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;ArrayTrailingComma&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>AvoidInlineConditionals<a name="AvoidInlineConditionals"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Detects inline conditionals. An example inline conditional is this:
+        </p>
+        <div class="source"><pre>
+String a = getParameter(&quot;a&quot;);
+String b = (a==null || a.length&lt;1) ? null : a.substring(1);
+        </pre></div>
+        <p>
+          Rationale: Some developers find inline conditionals hard to read, so
+          their company's coding standards forbids them.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;AvoidInlineConditionals&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>CovariantEquals<a name="CovariantEquals"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that classes that define a covariant <tt>equals()</tt> method also override method <tt>equals(java.lang.Object)</tt>.  Inspired by <a class="externalLink" href="http://www.cs.umd.edu/~pugh/java/bugs/docs/findbugsPaper.pdf">findbugs</a>.
+        </p>
+        <p>
+          Rationale: Mistakenly defining a covariant <tt>equals()</tt> method without overriding method <tt>equals(java.lang.Object)</tt> can produce unexpected
+          runtime behaviour.
+        </p>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;CovariantEquals&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>EmptyStatement<a name="EmptyStatement"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Detects empty statements (standalone ;).
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;EmptyStatement&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>EqualsAvoidNull<a name="EqualsAvoidNull"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that any combination of String literals with optional
+          assignment is on the left side of an <tt>equals()</tt> comparison.
+          The check also processes <tt>String.equalsIgnoreCase()</tt>
+          invocations (which can be suppressed).
+        </p>
+        <p>
+          Rationale: Calling the <tt>equals()</tt>
+          method on String literals will avoid a potential
+          NullPointerException.  Also, it is pretty common to see null
+          check right before equals comparisons which is not necessary
+          in the below example.
+        </p>
+        <p>
+          For example:
+        </p>
+        <div class="source"><pre>
+String nullString = null;
+nullString.equals(&quot;My_Sweet_String&quot;);
+        </pre></div>
+        <p>should be refactored to:</p>
+        <div class="source"><pre>
+String nullString = null;
+&quot;My_Sweet_String&quot;.equals(nullString);
+        </pre></div>
+        <p>
+          Limitations: If the equals method is overridden or a covariant
+          equals method is defined and the implementation is incorrect
+          (where <tt>s.equals(t)</tt> does not return
+          the same result as <tt>t.equals(s)</tt>) then
+          rearranging the called on object and parameter may have
+          unexpected results
+        </p>
+        <p>
+          Java's Autoboxing feature has an affect on how this check is
+          implemented. Pre Java 5 all IDENT + IDENT object
+          concatenations would not cause a NullPointerException even if
+          null.  Those situations could have been included in this
+          check.  They would simply act as if they surrounded by <tt>String.valueof()</tt> which would concatenate
+          the String null.
+        </p>
+        <p>
+          The following example will cause a NullPointerException as a
+          result of what autoboxing does.
+        </p>
+        <div class="source"><pre>
+Integer i = null, j = null;
+String number = &quot;5&quot;
+number.equals(i + j);
+        </pre></div>
+        <p>
+          Since, it is difficult to determine what kind of Object is
+          being concatenated all ident concatenation is considered
+          unsafe.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>ignoreEqualsIgnoreCase</td>
+            <td>whether to ignore <tt>String.equalsIgnoreCase()</tt> invocations</td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td>false</td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;EqualsAvoidNull&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>EqualsHashCode<a name="EqualsHashCode"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that classes that override <tt>equals()</tt>
+          also override <tt>hashCode()</tt>.
+        </p>
+        <p>
+          Rationale: The contract of <tt>equals()</tt> and
+          <tt>hashCode()</tt> requires that equal objects
+          have the same hashCode. Hence, whenever you override <tt>equals()</tt> you must override <tt>
+          hashCode()</tt> to ensure that your class can be used in
+          collections that are hash based.
+        </p>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;EqualsHashCode&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>FinalLocalVariable<a name="FinalLocalVariable"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that local variables that never have their values changed are
+          declared final. The check can be configured to also check that
+          unchanged parameters are declared final.
+        </p>
+      </div>
+      <div class="section"><h3>Notes<a name="Notes"></a></h3>
+        <p>
+          When configured to check parameters, the check ignores parameters of
+          interface methods and abstract methods.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="header">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>tokens</td>
+            <td>tokens to check</td>
+            <td>
+              subset of tokens <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#PARAMETER_DEF">PARAMETER_DEF</a>,
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#VARIABLE_DEF">VARIABLE_DEF</a>
+            </td>
+            <td>
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#VARIABLE_DEF">VARIABLE_DEF</a>
+            </td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;FinalLocalVariable&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it checks local variables and
+          parameters:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;FinalLocalVariable&quot;&gt;
+    &lt;property name=&quot;tokens&quot; value=&quot;VARIABLE_DEF,PARAMETER_DEF&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>HiddenField<a name="HiddenField"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that a local variable or a parameter does not shadow a field
+          that is defined in the same class.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>tokens</td>
+            <td>tokens to check</td>
+            <td>
+              subset of tokens <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#PARAMETER_DEF">PARAMETER_DEF</a>,
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#VARIABLE_DEF">VARIABLE_DEF</a>
+            </td>
+            <td>
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#PARAMETER_DEF">PARAMETER_DEF</a>,
+               <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#VARIABLE_DEF">VARIABLE_DEF</a>
+            </td>
+          </tr>
+          <tr class="a">
+            <td>ignoreFormat</td>
+            <td>pattern for names to ignore</td>
+            <td><a href="property_types.html#regexp">regular expression</a></td>
+            <td>(not applied)</td>
+          </tr>
+          <tr class="b">
+            <td>ignoreConstructorParameter</td>
+            <td>Controls whether to ignore constructor parameters.</td>
+            <td><a href="property_types.html#boolean">Boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+          <tr class="a">
+            <td>ignoreSetter</td>
+            <td>
+              Controls whether to ignore the parameter of a property setter
+              method, where the property setter method for field
+              &quot;xyz&quot; has name &quot;setXyz&quot;, one parameter named
+              &quot;xyz&quot;, and return type <tt>void</tt>.
+            </td>
+            <td><a href="property_types.html#boolean">Boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+          <tr class="b">
+            <td>ignoreAbstractMethods</td>
+            <td>Controls whether to ignore parameters of abstract methods.</td>
+            <td><a href="property_types.html#boolean">Boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;HiddenField&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it checks local variables but not
+          parameters:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;HiddenField&quot;&gt;
+    &lt;property name=&quot;tokens&quot; value=&quot;VARIABLE_DEF&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it ignores the name
+          &quot;rcsid&quot;:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;HiddenField&quot;&gt;
+    &lt;property name=&quot;ignoreFormat&quot; value=&quot;^rcsid$&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it ignores constructor parameters:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;HiddenField&quot;&gt;
+    &lt;property name=&quot;ignoreConstructorParameter&quot; value=&quot;true&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it ignores the parameter of setter
+          methods:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;HiddenField&quot;&gt;
+    &lt;property name=&quot;ignoreSetter&quot; value=&quot;true&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>IllegalInstantiation<a name="IllegalInstantiation"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for illegal instantiations where a factory method is
+          preferred.
+        </p>
+        <p>
+          Rationale: Depending on the project, for some classes it might be
+          preferable to create instances through factory methods rather than
+          calling the constructor.
+        </p>
+        <p>
+          A simple example is the <tt>java.lang.Boolean</tt>
+          class. In order to save memory and CPU cycles, it is preferable to
+          use the predefined constants <tt> TRUE</tt> and
+          <tt>FALSE</tt>. Constructor invocations should be
+          replaced by calls to <tt>Boolean.valueOf()</tt>.
+        </p>
+        <p>
+          Some extremely performance sensitive projects may require the use of
+          factory methods for other classes as well, to enforce the usage of
+          number caches or object pools.
+        </p>
+      </div>
+      <div class="section"><h3>Notes<a name="Notes"></a></h3>
+        <p>
+          There is a limitation that it is currently not possible to specify
+          array classes.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>classes</td>
+            <td>classes that should not be instantiated</td>
+            <td><a href="property_types.html#stringSet">String Set</a></td>
+            <td>{}</td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check to find instantiations of java.lang.Boolean:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;IllegalInstantiation&quot;&gt;
+    &lt;property name=&quot;classes&quot; value=&quot;java.lang.Boolean&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>IllegalToken<a name="IllegalToken"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for illegal tokens.
+        </p>
+        <p>
+          Rational: Certain language features often lead to hard to maintain
+          code or are non-obvious to novice developers. Other features may be
+          discouraged in certain frameworks, such as not having native methods
+          in EJB components.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>tokens</td>
+            <td>tokens to check</td>
+            <td>
+              subset of <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html">TokenTypes</a>,
+            </td>
+            <td>
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#LITERAL_SWITCH">LITERAL_SWITCH</a>,
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#POST_INC">POST_INC</a>,
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#POST_DEC">POST_DEC</a>
+            </td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check to find token LITERAL_NATIVE:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;IllegalToken&quot;&gt;
+    &lt;property name=&quot;tokens&quot; value=&quot;LITERAL_NATIVE&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>IllegalTokenText<a name="IllegalTokenText"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for illegal token text.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>tokens</td>
+            <td>tokens to check</td>
+            <td>subset of <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html">TokenTypes</a>
+            </td>
+            <td>empty</td>
+          </tr>
+          <tr class="a">
+            <td>format</td>
+            <td>illegal pattern</td>
+            <td><a href="property_types.html#regexp">regular expression</a></td>
+            <td><tt>^$</tt> (empty)</td>
+          </tr>
+          <tr class="b">
+            <td>ignoreCase</td>
+            <td>Controls whether to ignore case when matching.</td>
+            <td><a href="property_types.html#boolean">Boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+          <tr class="a">
+            <td>message</td>
+            <td>Message which is used to notify about violations;
+            if empty then the default message is used.</td>
+            <td><a href="property_types.html#string">String</a></td>
+            <td><tt>&quot;&quot;</tt>(empty)</td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check to forbid String literals containing <tt>&quot;a href&quot;</tt>:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;IllegalTokenText&quot;&gt;
+    &lt;property name=&quot;tokens&quot; value=&quot;STRING_LITERAL&quot;/&gt;
+    &lt;property name=&quot;format&quot; value=&quot;a href&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+        <p>
+          To configure the check to forbid leading zeros in an integer
+          literal, other than zero and a hex literal:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;IllegalTokenText&quot;&gt;
+    &lt;property name=&quot;tokens&quot; value=&quot;NUM_INT,NUM_LONG&quot;/&gt;
+    &lt;property name=&quot;format&quot; value=&quot;^0[^lx]&quot;/&gt;
+    &lt;property name=&quot;ignoreCase&quot; value=&quot;true&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>InnerAssignment<a name="InnerAssignment"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for assignments in subexpressions, such as in <tt>String s = Integer.toString(i = 2);</tt>.
+        </p>
+        <p>
+          Rationale: With the exception of <tt>for</tt>
+          iterators, all assignments should occur in their own toplevel
+          statement to increase readability.  With inner assignments like the
+          above it is difficult to see all places where a variable is set.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>tokens</td>
+            <td>assignments to check</td>
+            <td>subset of tokens <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#ASSIGN">ASSIGN</a>,
+            <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#BAND_ASSIGN">BAND_ASSIGN</a>,
+             <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#BOR_ASSIGN">BOR_ASSIGN</a>,
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#BSR_ASSIGN">BSR_ASSIGN</a>,
+               <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#BXOR_ASSIGN">BXOR_ASSIGN</a>,
+                <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#DIV_ASSIGN">DIV_ASSIGN</a>,
+                 <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#MINUS_ASSIGN">MINUS_ASSIGN</a>,
+                  <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#MOD_ASSIGN">MOD_ASSIGN</a>,
+                   <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#PLUS_ASSIGN">PLUS_ASSIGN</a>,
+                    <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#SL_ASSIGN">SL_ASSIGN</a>,
+                     <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#SR_ASSIGN">SR_ASSIGN</a>,
+                      <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#STAR_ASSIGN">STAR_ASSIGN</a></td>
+            <td>all tokens</td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;InnerAssignment&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure the check for only <tt>=</tt>, <tt> +=</tt>, and <tt>-=</tt> operators:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;InnerAssignment&quot;&gt;
+    &lt;property name=&quot;tokens&quot; value=&quot;ASSIGN,PLUS_ASSIGN,MINUS_ASSIGN&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>MagicNumber<a name="MagicNumber"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that there are no &quot;magic numbers&quot;, where a magic
+          number is a numeric literal that is not defined as a constant. By
+          default, -1, 0, 1, and 2 are not considered to be magic numbers.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>tokens</td>
+            <td>tokens to check</td>
+            <td>subset of tokens NUM_DOUBLE, NUM_FLOAT, NUM_INT, NUM_LONG</td>
+            <td>all tokens</td>
+          </tr>
+          <tr class="a">
+            <td>ignoreNumbers</td>
+            <td>non-magic numbers</td>
+            <td>list of numbers</td>
+            <td>-1, 0, 1, 2</td>
+          </tr>
+          <tr class="b">
+            <td>ignoreHashCodeMethod</td>
+            <td>ignore magic numbers in hashCode methods</td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td><span class="default">false</span></td>
+          </tr>
+          <tr class="a">
+            <td>ignoreAnnotation</td>
+            <td>ignore magic numbers in annotation declarations.</td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td><span class="default">false</span></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;MagicNumber&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it checks floating-point numbers
+          that are neither 0, 0.5, nor 1:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;MagicNumber&quot;&gt;
+    &lt;property name=&quot;tokens&quot; value=&quot;NUM_DOUBLE, NUM_FLOAT&quot;/&gt;
+    &lt;property name=&quot;ignoreNumbers&quot; value=&quot;0, 0.5, 1&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>MissingSwitchDefault<a name="MissingSwitchDefault"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that switch statement has &quot;default&quot; clause.
+        </p>
+        <p>
+          Rationale: It's usually a good idea to introduce a default case in
+          every switch statement. Even if the developer is sure that all
+          currently possible cases are covered, this should be expressed in
+          the default branch, e.g. by using an assertion. This way the code is
+          protected aginst later changes, e.g. introduction of new types in an
+          enumeration type.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;MissingSwitchDefault&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>ModifiedControlVariable<a name="ModifiedControlVariable"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Check for ensuring that for loop control variables are not
+          modified inside the for block. An example is:
+        </p>
+        <div class="source"><pre>
+for (int i = 0; i &lt; 1; i++) {
+    i++;
+}
+        </pre></div>
+        <p>
+          Rationale: If the control variable is modified inside the loop
+          body, the program flow becomes more difficult to follow. An option
+          is to replace the for loop with a while loop.
+        </p>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;ModifiedControlVariable&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>RedundantThrows<a name="RedundantThrows"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for redundant exceptions declared in throws clause such as
+          duplicates, unchecked exceptions or subclasses of another declared
+          exception.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>allowUnchecked</td>
+            <td>whether unchecked exceptions in throws are allowed or not</td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+          <tr class="a">
+            <td>allowSubclasses</td>
+            <td> whether subclass of another declared exception
+            is allowed in throws clause </td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+          <tr class="b">
+            <td>logLoadErrors</td>
+            <td>This check may need to load exception classes mentioned in
+            the @throws tag to check whether they are RuntimeExceptions.
+            If loading the class fails, this property allows to control
+            checkstyle's error handling. If set to <tt>false</tt> a
+            classpath configuration problem is assumed and the TreeWalker
+            stops operating on the class completely.
+            If set to <tt>true</tt> (the default), checkstyle assumes a
+            typo or refactoring problem in the
+            javadoc and logs the problem in the normal checkstyle report
+            (potentially masking a configuration error).</td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td><tt>true</tt></td>
+          </tr>
+          <tr class="a">
+            <td>suppressLoadErrors</td>
+            <td>When logLoadErrors is set to true, the TreeWalker completely
+            processes a class and displays any problems with loading exceptions
+            as checkstyle violations.
+            When this property is set to true, the violations generated when
+            logLoadErrors is set true are suppressed from being reported as
+            violations in the checkstyle report.
+            </td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the default check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;RedundantThrows&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure the check to allow unchecked exception in throws clause
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;RedundantThrows&quot;&gt;
+    &lt;property name=&quot;allowUnchecked&quot; value=&quot;true&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Note<a name="Note"></a></h3>
+        <p>
+          The classpath should be configured to locate the class
+          information. The classpath configuration is dependent on the
+          mechanism used to invoke Checkstyle.
+        </p>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>SimplifyBooleanExpression<a name="SimplifyBooleanExpression"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for overly complicated boolean expressions. Currently finds
+          code like <tt> if (b == true)</tt>, <tt>b || true</tt>, <tt>!false</tt>,
+          etc.
+        </p>
+        <p>
+          Rationale: Complex boolean logic makes code hard to understand and
+          maintain.
+        </p>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;SimplifyBooleanExpression&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>SimplifyBooleanReturn<a name="SimplifyBooleanReturn"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for overly complicated boolean return statements. For example
+          the following code
+        </p>
+        <div class="source"><pre>
+if (valid())
+    return false;
+else
+    return true;
+        </pre></div>
+        <p>
+          could be written as
+        </p>
+        <div class="source"><pre>
+return !valid();
+        </pre></div>
+        <p>
+          The Idea for this Check has been shamelessly stolen from the
+          equivalent <a class="externalLink" href="http://pmd.sourceforge.net">PMD</a> rule.
+        </p>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;SimplifyBooleanReturn&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>StringLiteralEquality<a name="StringLiteralEquality"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that string literals are not used with <tt>==</tt> or
+          <tt>!=</tt>.
+        </p>
+        <p>
+          Rationale: Novice Java programmers often use code like:
+        </p>
+        <div class="source"><pre>
+if (x == &quot;something&quot;)
+        </pre></div>
+        <p>when they mean</p>
+        <div class="source"><pre>
+if (&quot;something&quot;.equals(x))
+        </pre></div>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;StringLiteralEquality&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>NestedForDepth<a name="NestedForDepth"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Restricts nested <tt>for</tt> blocks to a specified depth
+          (default = 1).
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>max</td>
+            <td>allowed nesting depth</td>
+            <td><a href="property_types.html#integer">Integer</a></td>
+            <td><span class="default">1</span></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;NestedForDepth&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure the check to allow nesting depth 3:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;NestedForDepth&quot;&gt;
+    &lt;property name=&quot;max&quot; value=&quot;3&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>NestedIfDepth<a name="NestedIfDepth"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Restricts nested if-else blocks to a specified depth (default = 1).
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>max</td>
+            <td>allowed nesting depth</td>
+            <td><a href="property_types.html#integer">Integer</a></td>
+            <td><tt>1</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;NestedIfDepth&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure the check to allow nesting depth 3:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;NestedIfDepth&quot;&gt;
+    &lt;property name=&quot;max&quot; value=&quot;3&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>NestedTryDepth<a name="NestedTryDepth"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Restricts nested try blocks to a specified depth (default = 1).
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>max</td>
+            <td>allowed nesting depth</td>
+            <td><a href="property_types.html#integer">Integer</a></td>
+            <td><tt>1</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;NestedTryDepth&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure the check to allow nesting depth 3:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;NestedTryDepth&quot;&gt;
+    &lt;property name=&quot;max&quot; value=&quot;3&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>NoClone<a name="NoClone"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+       <p>
+       Checks that the clone method is not overridden from the
+       Object class.
+       </p>
+       <p>
+       Rationale: The clone method relies on strange/hard to follow rules that
+       do not work it all situations.  Consequently, it is difficult to
+       override correctly.  Below are some of the rules/reasons why the clone
+       method should be avoided.
+       </p>
+       <ul>
+       <li>
+       Classes supporting the clone method should implement the Cloneable
+       interface but the Cloneable interface does not include the clone method.
+       As a result, it doesn't enforce the method override.
+       </li>
+       <li>
+       The Cloneable interface forces the Object's clone method to work
+       correctly. Without implementing it, the Object's clone method will
+       throw a CloneNotSupportedException.
+       </li>
+       <li>
+       Non-final classes must return the object returned from a call to
+       super.clone().
+       </li>
+       <li>
+       Final classes can use a constructor to create a clone which is different
+       from non-final classes.
+       </li>
+       <li>
+       If a super class implements the clone method incorrectly all subclasses
+       calling super.clone() are doomed to failure.
+       </li>
+       <li>
+       If a class has references to mutable objects then those object
+       references must be replaced with copies in the clone method
+       after calling super.clone().
+       </li>
+       <li>
+       The clone method does not work correctly with final mutable object
+       references because final references cannot be reassigned.
+       </li>
+       <li>
+       If a super class overrides the clone method then all subclasses must
+       provide a correct clone implementation.
+       </li>
+       </ul>
+       <p>
+       Two alternatives to the clone method, in some cases, is a copy constructor
+       or a static factory method to return copies of an object. Both of these
+       approaches are simpler and do not conflict with final fields. The do not
+       force the calling client to handle a CloneNotSuportException.  They also
+       are typed therefore no casting is necessary. Finally, they are more
+       flexible since they can take interface types rather than concrete classes.
+       </p>
+       <p>
+       Sometimes a copy constructor or static factory is not an acceptable
+       alternative to the clone method.  The example below highlights the
+       limitation of a copy constructor (or static factory). Assume
+       Square is a subclass for Shape.
+       </p>
+       <div class="source"><pre>
+       Shape s1 = new Square();
+       System.out.println(s1 instanceof Square); //true
+       </pre></div>
+       <p>
+       ...assume at this point the code knows nothing of s1 being a Square
+          that's the beauty of polymorphism but the code wants to copy
+          the Square which is declared as a Shape, its super type...
+       </p>
+       <div class="source"><pre>
+       Shape s2 = new Shape(s1); //using the copy constructor
+       System.out.println(s2 instanceof Square); //false
+       </pre></div>
+       <p>
+       The working solution (without knowing about all subclasses and doing many
+       casts) is to do the following (assuming correct clone implementation).
+       </p>
+       <div class="source"><pre>
+       Shape s2 = s1.clone();
+       System.out.println(s2 instanceof Square); //true
+       </pre></div>
+       <p>
+       Just keep in mind if this type of polymorphic cloning is required
+       then a properly implemented clone method may be the best choice.
+       </p>
+       <p>
+       Much of this information was taken from Effective Java:
+       Programming Language Guide First Edition by Joshua Bloch
+       pages 45-52.  Give Bloch credit for writing an excellent book.
+       </p>
+       <p>
+       This check is almost exactly the same as the {@link NoFinalizerCheck}
+       </p>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;NoClone&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>NoFinalizer<a name="NoFinalizer"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Verifies there are no <tt>finalize()</tt> methods
+          defined in a class.
+        </p>
+      </div>
+      <div class="section"><h3>Example<a name="Example"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;NoFinalizer&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>SuperClone<a name="SuperClone"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that an overriding <tt>clone()</tt> method
+          invokes <tt>super.clone()</tt>.
+        </p>
+        <p>
+          Reference: <a class="externalLink" href="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html#clone()">Object.clone()</a>.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;SuperClone&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>SuperFinalize<a name="SuperFinalize"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that an overriding <tt>finalize()</tt>
+          method invokes <tt>super.finalize()</tt>.
+        </p>
+        <p>
+          Reference: <a class="externalLink" href="http://java.sun.com/docs/books/tutorial/java/data/garbagecollection.html">Cleaning
+          Up Unused Objects</a>.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;SuperFinalize&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>IllegalCatch<a name="IllegalCatch"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Catching java.lang.Exception, java.lang.Error or
+          java.lang.RuntimeException is almost never acceptable.
+        </p>
+        <p>
+          Rationale: Junior developers often simply catch Exception in an
+          attempt to handle multiple exception classes. This unfortunately
+          leads to code that inadvertantly catchs NPE, OutOfMemoryErrors, etc.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>illegalClassNames</td>
+            <td>exception class names to reject</td>
+            <td><a href="property_types.html#stringSet">list of strings</a></td>
+            <td><tt>&quot;java.lang.Exception,
+            java.lang.Throwable, java.lang.RuntimeException&quot;</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;IllegalCatch&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>IllegalThrows<a name="IllegalThrows"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          This check can be used to ensure that types are not declared
+          to be thrown. Declaring to throw java.lang.Error or
+          java.lang.RuntimeException is almost never acceptable.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>illegalClassNames</td>
+            <td>throw class names to reject</td>
+            <td><a href="property_types.html#stringSet">list of strings</a></td>
+            <td>
+              <tt>&quot;java.lang.Throwable,
+              java.lang.Error, java.lang.RuntimeException&quot;</tt>
+            </td>
+          </tr>
+          <tr class="a">
+            <td>ignoredMethodNames</td>
+            <td>names of methods to ignore</td>
+            <td><a href="property_types.html#stringSet">list of strings</a></td>
+            <td><tt>finalize</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;IllegalThrows&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>PackageDeclaration<a name="PackageDeclaration"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Ensure a class is has a package declaration, and (optionally) whether
+          the package name matches the directory name for the source file.
+        </p>
+        <p>
+          Rationale: Classes that live in the null package cannot be
+          imported. Many novice developers are not aware of this.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>ignoreDirectoryName</td>
+            <td>
+              whether to ignore checking that the package declaration matches
+              the source directory name
+            </td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;PackageDeclaration&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>JUnitTestCase<a name="JUnitTestCase"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Ensures that the setUp(), tearDown()methods are named correctly,
+          have no arguments, return void and are either public or
+          protected.
+        </p>
+        <p>
+          Also ensures that suite() is named correctly, have no arguments,
+          return junit.framewotk.Test, public and static.
+        </p>
+        <p>
+          Rationale: often times developers will misname one or more of these
+          methods and not realise that the method is not being called.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;JUnitTestCase&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>ReturnCount<a name="ReturnCount"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Restricts the number of return statements. Default = 2.  Ignores
+          specified methods (<tt>equals()</tt> by default).
+        </p>
+        <p>
+          Rationale: Too many return points can be indication that code is
+          attempting to do too much or may be difficult to understand.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>max</td>
+            <td>maximum allowed number of return statments</td>
+            <td><a href="property_types.html#integer">Integer</a></td>
+            <td><tt>2</tt></td>
+          </tr>
+          <tr class="a">
+            <td>format</td>
+            <td>method names to ingone</td>
+            <td><a href="property_types.html#regexp">regular expression</a></td>
+            <td><tt>^equals$</tt> (empty)</td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check so that it doesn't allow more than three
+          return statements per method (<tt>equals()</tt>
+          method ignored):
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;ReturnCount&quot;&gt;
+    &lt;property name=&quot;max&quot; value=&quot;3&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it doesn't allow more than three
+          return statements per method for all methods:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;ReturnCount&quot;&gt;
+    &lt;property name=&quot;max&quot; value=&quot;3&quot;/&gt;
+    &lt;property name=&quot;format&quot; value=&quot;^$&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>IllegalType<a name="IllegalType"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that particular class are never used as types in variable
+          declarations, return values or parameters. Includes a pattern check
+          that by default disallows abstract classes.
+        </p>
+        <p>
+          Rationale: Helps reduce coupling on concrete classes. In addition
+          abstract classes should be thought of a convenience base class
+          implementations of interfaces and as such are not types themselves.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>tokens</td>
+            <td>tokens to check</td>
+            <td>
+              subset of tokens <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#PARAMETER_DEF">PARAMETER_DEF</a>,
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#VARIABLE_DEF">VARIABLE_DEF</a>
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#METHOD_DEF">METHOD_DEF</a>
+            </td>
+            <td>
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#PARAMETER_DEF">PARAMETER_DEF</a>,
+               <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#VARIABLE_DEF">VARIABLE_DEF</a>
+               <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html#METHOD_DEF">METHOD_DEF</a>
+            </td>
+          </tr>
+          <tr class="a">
+            <td>illegalClassNames</td>
+            <td>classes that should not be used as types in variable
+            declarations, return values or parameters. </td>
+            <td><a href="property_types.html#stringSet">String Set</a></td>
+            <td>&quot;java.util.GregorianCalendar, java.util.Hashtable,
+            java.util.HashSet, java.util.HashMap, java.util.ArrayList,
+            java.util.LinkedList, java.util.LinkedHashMap,
+            java.util.LinkedHashSet, java.util.TreeSet,
+            java.util.TreeMap, java.util.Vector&quot;</td>
+          </tr>
+          <tr class="b">
+          <td>legalAbstractClassNames</td>
+          <td>abstract classes that may be used as types. </td>
+          <td><a href="property_types.html#stringSet">String Set</a></td>
+          <td></td>
+        </tr>
+        <tr class="a">
+            <td>ignoredMethodNames</td>
+            <td>methods that should not be checked</td>
+            <td><a href="property_types.html#stringSet">String Set</a></td>
+            <td>&quot;getInitialContext, getEnvironment&quot; </td>
+          </tr>
+          <tr class="b">
+            <td>format</td>
+            <td>pattern for illegal class name</td>
+            <td><a href="property_types.html#regexp">regular expression</a></td>
+            <td><tt>^(.*[\\.])?Abstract.*$</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check so that it ignore getInstance() method:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;IllegalType&quot;&gt;
+    &lt;property name=&quot;ignoredMethodNames&quot; value=&quot;getInstance&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>DeclarationOrder<a name="DeclarationOrder"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          According to <a class="externalLink" href="http://java.sun.com/docs/codeconv/html/CodeConventions.doc2.html#1852">
+          Code Conventions for the Java Programming Language</a> , the parts
+          of a class or interface declaration should appear in the following
+          order:
+        </p>
+        <ol style="list-style-type: decimal">
+          <li>
+            Class (static) variables. First the public class variables, then
+            the protected, then package level (no access modifier), and then
+            the private.
+          </li>
+          <li>
+            Instance variables. First the public class variables, then the
+            protected, then package level (no access modifier), and then the
+            private.
+          </li>
+          <li> Constructors </li>
+          <li> Methods </li>
+        </ol>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>ignoreConstructors</td>
+            <td>whether to ignore constructors</td>
+            <td><a href="property_types.html#boolean">Boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+          <tr class="a">
+            <td>ignoreMethods</td>
+            <td>whether to ignore methods</td>
+            <td><a href="property_types.html#boolean">Boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+          <tr class="b">
+            <td>ignoreModifiers</td>
+            <td>whether to ignore modifiers</td>
+            <td><a href="property_types.html#boolean">Boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;DeclarationOrder&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>ParameterAssignment<a name="ParameterAssignment"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p> Disallow assignment of parameters.</p>
+        <p>
+          Rationale: Parameter assignment is often considered poor programming
+          practice. Forcing developers to declare parameters as final is often
+          onerous. Having a check ensure that parameters are never assigned
+          would give the best of both worlds.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;ParameterAssignment&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>ExplicitInitialization<a name="ExplicitInitialization"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks if any class or object member explicitly initialized to
+          default for its type value (<tt>null</tt> for
+          object references, zero for numeric types and <tt>char</tt> and <tt>false</tt> for
+          <tt>boolean</tt>.
+        </p>
+        <p>
+          Rationale: each instance variable gets initialized twice, to the
+          same value.  Java initializes each instance variable to its default
+          value (0 or null) before performing any initialization specified in
+          the code.  So in this case, x gets initialized to 0 twice, and bar
+          gets initialized to null twice.  So there is a minor inefficiency.
+          This style of coding is a hold-over from C/C++ style coding, and it
+          shows that the developer isn't really confident that Java really
+          initializes instance variables to default values.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;ExplicitInitialization&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>DefaultComesLast<a name="DefaultComesLast"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Check that the <tt>default</tt> is after all the
+          <tt>case</tt>s in a <tt>switch</tt> statement.
+        </p>
+        <p>
+          Rationale: Java allows <tt>default</tt> anywhere
+          within the <tt>switch</tt> statement. But it is
+          more readable if it comes after the last <tt>case</tt>.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;DefaultComesLast&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>MissingCtor<a name="MissingCtor"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that classes (except abtract one) define a ctor and don't
+          rely on the default one.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;MissingCtor&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>FallThrough<a name="FallThrough"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for fall through in <tt>switch</tt>
+          statements Finds locations where a <tt>case</tt>
+          contains Java code - but lacks a <tt>break</tt>, <tt>return</tt>, <tt>throw</tt> or <tt>continue</tt>
+          statement.
+        </p>
+        <p>
+          The check honores special comments to supress the warning. By
+          default the text &quot;fallthru&quot;, &quot;fall through&quot;, &quot;fallthrough&quot;,
+          &quot;falls through&quot; and &quot;fallsthrough&quot; are recognized (case
+          sensitive). The comment containing this words must be a
+          one-liner and must be on the last none-empty line before the
+          <tt>case</tt> triggering the warning or on
+          the same line before the <tt>case</tt>
+          (urgly, but possible).
+        </p>
+        <div class="source"><pre>
+switch (i){
+case 0:
+    i++; // fall through
+case 1:
+    i++;
+    // falls through
+case 2: {
+    i++;
+}
+// fallthrough
+case 3:
+    i++;
+/* fallthru */case 4:
+    i++
+    break;
+}
+        </pre></div>
+        <p>
+          Note: the check works in assumption that there is no unreachable
+          code in the <tt>case</tt>.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>checkLastCaseGroup</td>
+            <td>
+              Whether we need to check last case group or not.
+            </td>
+            <td><a href="property_types.html#boolean">Boolean</a></td>
+            <td><tt>false</tt></td>
+          </tr>
+          <tr class="a">
+            <td>reliefPattern</td>
+            <td>
+              Regulare expression to match the relief comment that supresses
+              the warning about a fall through.
+            </td>
+            <td><a href="property_types.html#regexp">regular expression</a></td>
+            <td><tt>fallthru|falls? ?through</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;FallThrough&quot;/&gt;
+        </pre></div>
+        <p>
+          or
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;FallThrough&quot;&gt;
+    &lt;property name=&quot;reliefPattern&quot; value=&quot;continue in next case&quot;/&gt;
+&lt;module name=&quot;FallThrough&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>MultipleStringLiterals<a name="MultipleStringLiterals"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for multiple occurrences of the same string literal within a
+          single file.
+        </p>
+        <p>
+          Rationale: Code duplication makes maintenance more difficult, so it
+          can be better to replace the multiple occurrences with a constant.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>allowedDuplicates</td>
+            <td>
+              The maximum number of occurences to allow without generating a
+              warning
+            </td>
+            <td><a href="property_types.html#integer">Integer</a></td>
+            <td>1</td>
+          </tr>
+          <tr class="a">
+            <td>ignoreStringsRegexp</td>
+            <td>
+              regexp pattern for ignored strings (with quotation marks)
+            </td>
+            <td><a href="property_types.html#regexp">regular expression</a></td>
+            <td><tt>^&quot;&quot;$</tt> (ignore empty strings)</td>
+          </tr>
+          <tr class="b">
+            <td>ignoreOccurrenceContext</td>
+            <td>
+              Token type names where duplicate strings are ignored even if they don't match
+              ignoredStringsRegexp. This allows you to exclude syntactical contexts like
+              Annotations or static initializers from the check.
+            </td>
+            <td>
+              <a href="property_types.html#stringSet">list</a> of
+              <a href="apidocs/com/puppycrawl/tools/checkstyle/api/TokenTypes.html">token type</a>
+              names
+            </td>
+            <td>
+              <tt>ANNOTATION</tt>
+              (ignore strings inside the context of an annotation)
+            </td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;MultipleStringLiterals&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it allows two occurrences of each
+          string:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;MultipleStringLiterals&quot;&gt;
+    &lt;property name=&quot;allowedDuplicates&quot; value=&quot;2&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it ignores &quot;, &quot; and empty strings:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;MultipleStringLiterals&quot;&gt;
+    &lt;property name=&quot;ignoreStringsRegexp&quot; value='^((&quot;&quot;)|(&quot;, &quot;))$'/&gt;
+&lt;/module&gt;
+        </pre></div>
+        <p>
+          To configure the check so that it flags duplicate strings in all
+          syntactical contexts, even in annotations like
+          <tt>@SuppressWarnings(&quot;unchecked&quot;)</tt>:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;MultipleStringLiterals&quot;&gt;
+    &lt;property name=&quot;ignoreOccurrenceContext&quot; value=&quot;&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>MultipleVariableDeclarations<a name="MultipleVariableDeclarations"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that each variable declaration is in its own statement and on
+          its own line.
+        </p>
+        <p>
+          Rationale: <a class="externalLink" href="http://java.sun.com/docs/codeconv/html/CodeConventions.doc5.html#2991">
+          the SUN Code conventions chapter 6.1</a> recommends that
+          declarations should be one per line/statement.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;MultipleVariableDeclarations&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>RequireThis<a name="RequireThis"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks that code doesn't rely on the &quot;this.&quot; default,
+          i.e. references to instance variables and methods of the present
+          object are explicitly of the form &quot;this.varName&quot; or
+          &quot;this.methodName(args)&quot;.
+        </p>
+      </div>
+      <div class="section"><h3>Properties<a name="Properties"></a></h3>
+        <table border="0" class="bodyTable">
+          <tr class="a">
+            <th>name</th>
+            <th>description</th>
+            <th>type</th>
+            <th>default value</th>
+          </tr>
+          <tr class="b">
+            <td>checkFields</td>
+            <td>whether we should check fields usage or not</td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td><tt>true</tt></td>
+          </tr>
+          <tr class="a">
+            <td>checkMethods</td>
+            <td>whether we should check methods usage or not</td>
+            <td><a href="property_types.html#boolean">boolean</a></td>
+            <td><tt>true</tt></td>
+          </tr>
+        </table>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the default check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;RequireThis&quot;/&gt;
+        </pre></div>
+        <p>
+          To configure to check <tt>this</tt> qualifier for fields only:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;RequireThis&quot;&gt;
+    &lt;property name=&quot;checkMethods&quot; value=&quot;false&quot;/&gt;
+&lt;/module&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>UnnecessaryParentheses<a name="UnnecessaryParentheses"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks for the use of unnecessary parentheses.
+        </p>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;UnnecessaryParentheses&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+    <div class="section"><h2>OneStatementPerLine<a name="OneStatementPerLine"></a></h2>
+      <div class="section"><h3>Description<a name="Description"></a></h3>
+        <p>
+          Checks there is only one statement per line. The following line
+          will be flagged as an error:
+        </p>
+        <div class="source"><pre>    x = 1; y = 2; // Two statments on a single line.</pre></div>
+      </div>
+      <div class="section"><h3>Examples<a name="Examples"></a></h3>
+        <p>
+          To configure the check:
+        </p>
+        <div class="source"><pre>
+&lt;module name=&quot;OneStatementPerLine&quot;/&gt;
+        </pre></div>
+      </div>
+      <div class="section"><h3>Package<a name="Package"></a></h3>
+        <p>
+          com.puppycrawl.tools.checkstyle.checks.coding
+        </p>
+      </div>
+      <div class="section"><h3>Parent Module<a name="Parent_Module"></a></h3>
+        <p>
+          <a href="config.html#TreeWalker">TreeWalker</a>
+        </p>
+      </div>
+    </div>
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">Copyright &#169;                   2001-2012.
+          All Rights Reserved.
+      </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>