<commit_before><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
  <title>checkstyle Command Line</title>
  <link rel="stylesheet" type="text/css" href="mystyle.css">
</head>

<body>
<h1><a name="checkstyle">checkstyle Command Line</a></h1>
<h2>Description</h2>

<p>This document describes how to run checkstyle using the command line tool. The latest version of checkstyle can be found at 
<a href="http://checkstyle.sourceforge.net">http://checkstyle.sourceforge.net</a>.
This command line tool is included in the checkstyle distribution.</p>


<h2>Installation</h2>
<p>The easiest way is to include <span class="default">checkstyle-all-2.1.jar</span> in the classpath. This contains all the classes required to run checkstyle. Alternatively, you must include the following in the classpath:</p>
<ol>
  <li><span class="default">checkstyle-2.1.jar</span></li>
  <li>ANTLR 2.7.1 classes. <span class="default">antlr.jar</span> is included in the distribution.</li>
  <li>Jakarta Regexp 1.2 classes. <span class="default">jakarta-regexp-1.2.jar</span> is included in the distribution.</li>
</ol>


<h2>Usage</h2>
<p>The command line usage is:</p>
<pre>
  java -D&lt;property&gt;=&lt;value&gt;  \
       com.puppycrawl.tools.checkstyle.Main \
       [-f &lt;format&gt;] [-o &lt;toFile&gt;] file...
</pre>

<p>Checkstyle will process the specified files and by default report errors to standard out in plain format. The options are:</p>

<ul>
  <li><span class="default">-f format</span> - specify the output format. Options are <span class="default">"plain"</span> for the <a href="api/com/puppycrawl/tools/checkstyle/DefaultLogger.html">DefaultLogger</a> and <span class="default">"xml"</span> for the <a href="api/com/puppycrawl/tools/checkstyle/XMLLogger.html">XMLLogger</a>. Defaults to <span class="default">"plain"</span>.</li>
  <li><span class="default">-o file</span> - specify the file to output to.</li>
</ul>

<p>The default behaviour of checkstyle can be changed by setting system properties using the <code>-D&lt;property&gt;=&lt;value&gt;</code> arguments to java. The following table describes what properties can be set:</p>

<table border="1" cellpadding="2" cellspacing="0" summary="properties">
  <tr class="header">
    <td valign="top"><b>Property</b></td>
    <td valign="top"><b>Description</b></td>
  </tr>
  <tr>
    <td valign="top">checkstyle.lcurly.type</td> 
    <td valign="top">Specifies the policy of where to put the left brace <span class=code>'{'</span> for type declarations. The legal values are defined <a href="engine.html#lcurlyopt">here</a>. Defaults to <span class="default">&quot;eol&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.lcurly.method</td> 
    <td valign="top">Specifies the policy of where to put the left brace <span class=code>'{'</span> for method declarations. The legal values are defined <a href="engine.html#lcurlyopt">here</a>. Defaults to <span class="default">&quot;eol&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.lcurly.other</td> 
    <td valign="top">Specifies the policy of where to put the left brace <span class=code>'{'</span> for other declarations. The keywords covered is defined <a href="engine.html#lcurlyother">here</a>. The legal values are defined <a href="engine.html#lcurlyopt">here</a>. Defaults to <span class="default">&quot;eol&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.rcurly</td> 
    <td valign="top">Specifies the policy of where to put the right brace <span class=code>'}'</span>. The keywords covered is defined <a href="engine.html#rcurly">here</a>. The legal values are defined <a href="engine.html#rcurlyopt">here</a>. Defaults to <span class="default">&quot;same&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.allow.protected</td> 
    <td valign="top">Indicates whether to allow protected data. Defaults to <span class="default">&quot;no&quot;</span>.</td>
 </tr>
  <tr>
    <td valign="top">checkstyle.allow.package</td>
    <td valign="top">Indicates whether to allow package visible data. Defaults to <span class="default">&quot;no&quot;</span>.</td>
 </tr>
  <tr>
     <td valign="top">checkstyle.allow.noauthor</td> 
    <td valign="top">Indicates whether to allow no <span class="default">@author</span> tag to be defined for class and interface Javadoc comments. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.maxlinelen</td> 
    <td valign="top">Specifies the maximum line length. Default value is defined <a href="engine.html#length">here</a>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.ignore.importlength</td> 
    <td valign="top">Specifies whether to ignore the maximum line length for <span class="code">import</span> statements. Defaults to <span class="default">&quot;false&quot;</span>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.maxmethodlen</td> 
    <td valign="top">Specifies the maximum method length. Default value is defined <a href="engine.html#methodLength">here</a>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.maxconstructorlen</td> 
    <td valign="top">Specifies the maximum constructor length. Default value is defined <a href="engine.html#constructorLength">here</a>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.maxfilelen</td> 
    <td valign="top">Specifies the maximum file length. Default value is defined <a href="engine.html#fileLength">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.member</td> 
    <td valign="top">Specifies the regular expression to match against member variables. Default value is defined <a href="engine.html#varformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.publicmember</td> 
    <td valign="top">Specifies the regular expression to match against public member variables. Default value is defined <a href="engine.html#fieldformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.parameter</td> 
    <td valign="top">Specifies the regular expression to match against parameters. Default value is defined <a href="engine.html#paramformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.const</td> 
    <td valign="top">Specifies the regular expression to match against static/final variables. Default value is defined <a href="engine.html#varformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.static</td> 
    <td valign="top">Specifies the regular expression to match against static variables. Default value is defined <a href="engine.html#varformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.type</td> 
    <td valign="top">Specifies the regular expression to match against type names. Default value is defined <a href="engine.html#typeformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.method</td>
    <td valign="top">Specifies the regular expression to match against method names. Default value is defined <a href="engine.html#methodformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.localvar</td>
    <td valign="top">Specifies the regular expression to match against local variable names. Default value is defined <a href="engine.html#localvarformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.header.file</td> 
    <td valign="top">Specifies the file containing the header lines. Default is to not check.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.header.regexp</td> 
    <td valign="top">Specifies whether to interpret each line in the checkstyle.header.file as a regular expression. Default is <span class="default">&quot;false&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.header.ignoreline</td> 
    <td valign="top">Specifies a comma separated list of the lines in the header to ignore when comparing. Default is to not ignore any line.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.javadoc.scope</td> 
    <td valign="top">Specifies the visibility scope where javadoc comments are checked. Valid values are <span class="default">&quot;nothing&quot;</span>, <span class="default">&quot;public&quot;</span>, <span class="default">&quot;protected&quot;</span>, <span class="default">&quot;package&quot;</span>, <span class="default">&quot;private&quot;</span> and <span class="default">&quot;anoninner&quot;</span>. Defaults to <span class="default">&quot;private&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.require.packagehtml</td>
    <td valign="top">Specifies whether to require that package documentation is available. Defaults to <span class="default">&quot;false&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.ignore.imports</td> 
    <td valign="top">Specifies whether to ignore checking import statements. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.ignore.whitespace</td> 
    <td valign="top">Specifies whether to ignore checking whitespace. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.ignore.whitespace.cast</td> 
    <td valign="top">Specifies whether to ignore checking for whitespace after a cast. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.ignore.braces</td> 
    <td valign="top">Specifies whether to ignore checking braces. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.cache.file</td> 
    <td valign="top">Specifies the name of a file that can be used to cache details of files that pass checkstyle. This can signicantly increase the speed of checkstyle on successive runs.</td>
  </tr>
</table>

<p>
Older versions of the checkstyle task supported the boolean parameters checkstyle.javadoc.relax and checkstyle.javadoc.ignore. These parameters have been removed because they were conflicting with each other and the semantics of relaxJavadoc was not specified. The two parameters have been replaced by the checkstyle.javadoc.scope parameter. Instead of checkstyle.javadoc.ignore=true you can now use checkstyle.javadoc.scope=nothing. The behaviour of checkstyle.javadoc.relax=true is roughly the same as checkstyle.javadoc.scope=protected.
</p>

<h2>Examples</h2>
<p><b>Run checkstyle on a file</b></p>
<pre>
  java  com.puppycrawl.tools.checkstyle.Main  Check.java
</pre>

<p><b>Run checkstyle on a file and allow tabs</b></p>
<pre>
  java  -Dcheckstyle.allow.tabs=yes \
        com.puppycrawl.tools.checkstyle.Main Check.java
</pre>

<p><b>Run checkstyle on a file and output to a file in XML format</b></p>
<pre>
  java  -Dcheckstyle.allow.tabs=yes  \
        com.puppycrawl.tools.checkstyle.Main \
        -f xml -o build/checkstyle_errors.xml Check.java
</pre>

<p><b>Run checkstyle on a file and disable pattern matching</b></p>
<pre>
  java  -Dcheckstyle.pattern.parameter=. \
        -Dcheckstyle.pattern.static=. \
        -Dcheckstyle.pattern.const=. \
        -Dcheckstyle.pattern.member=. \
        com.puppycrawl.tools.checkstyle.Main Check.java
</pre>

<hr>
<p align="center">Copyright &copy; 2001 <NAME>. All rights Reserved.</p>
</body>
</html>
<commit_msg>Added doc for allowing tabs.<commit_after><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
  <title>checkstyle Command Line</title>
  <link rel="stylesheet" type="text/css" href="mystyle.css">
</head>

<body>
<h1><a name="checkstyle">checkstyle Command Line</a></h1>
<h2>Description</h2>

<p>This document describes how to run checkstyle using the command line tool. The latest version of checkstyle can be found at 
<a href="http://checkstyle.sourceforge.net">http://checkstyle.sourceforge.net</a>.
This command line tool is included in the checkstyle distribution.</p>


<h2>Installation</h2>
<p>The easiest way is to include <span class="default">checkstyle-all-2.1.jar</span> in the classpath. This contains all the classes required to run checkstyle. Alternatively, you must include the following in the classpath:</p>
<ol>
  <li><span class="default">checkstyle-2.1.jar</span></li>
  <li>ANTLR 2.7.1 classes. <span class="default">antlr.jar</span> is included in the distribution.</li>
  <li>Jakarta Regexp 1.2 classes. <span class="default">jakarta-regexp-1.2.jar</span> is included in the distribution.</li>
</ol>


<h2>Usage</h2>
<p>The command line usage is:</p>
<pre>
  java -D&lt;property&gt;=&lt;value&gt;  \
       com.puppycrawl.tools.checkstyle.Main \
       [-f &lt;format&gt;] [-o &lt;toFile&gt;] file...
</pre>

<p>Checkstyle will process the specified files and by default report errors to standard out in plain format. The options are:</p>

<ul>
  <li><span class="default">-f format</span> - specify the output format. Options are <span class="default">"plain"</span> for the <a href="api/com/puppycrawl/tools/checkstyle/DefaultLogger.html">DefaultLogger</a> and <span class="default">"xml"</span> for the <a href="api/com/puppycrawl/tools/checkstyle/XMLLogger.html">XMLLogger</a>. Defaults to <span class="default">"plain"</span>.</li>
  <li><span class="default">-o file</span> - specify the file to output to.</li>
</ul>

<p>The default behaviour of checkstyle can be changed by setting system properties using the <code>-D&lt;property&gt;=&lt;value&gt;</code> arguments to java. The following table describes what properties can be set:</p>

<table border="1" cellpadding="2" cellspacing="0" summary="properties">
  <tr class="header">
    <td valign="top"><b>Property</b></td>
    <td valign="top"><b>Description</b></td>
  </tr>
  <tr>
    <td valign="top">checkstyle.lcurly.type</td> 
    <td valign="top">Specifies the policy of where to put the left brace <span class=code>'{'</span> for type declarations. The legal values are defined <a href="engine.html#lcurlyopt">here</a>. Defaults to <span class="default">&quot;eol&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.lcurly.method</td> 
    <td valign="top">Specifies the policy of where to put the left brace <span class=code>'{'</span> for method declarations. The legal values are defined <a href="engine.html#lcurlyopt">here</a>. Defaults to <span class="default">&quot;eol&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.lcurly.other</td> 
    <td valign="top">Specifies the policy of where to put the left brace <span class=code>'{'</span> for other declarations. The keywords covered is defined <a href="engine.html#lcurlyother">here</a>. The legal values are defined <a href="engine.html#lcurlyopt">here</a>. Defaults to <span class="default">&quot;eol&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.rcurly</td> 
    <td valign="top">Specifies the policy of where to put the right brace <span class=code>'}'</span>. The keywords covered is defined <a href="engine.html#rcurly">here</a>. The legal values are defined <a href="engine.html#rcurlyopt">here</a>. Defaults to <span class="default">&quot;same&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.allow.protected</td> 
    <td valign="top">Indicates whether to allow protected data. Defaults to <span class="default">&quot;no&quot;</span>.</td>
 </tr>
  <tr>
    <td valign="top">checkstyle.allow.tabs</td> 
    <td valign="top">Indicates whether to allow tabs. Defaults to <span class="default">&quot;no&quot;</span>.</td>
 </tr>
  <tr>
    <td valign="top">checkstyle.allow.package</td>
    <td valign="top">Indicates whether to allow package visible data. Defaults to <span class="default">&quot;no&quot;</span>.</td>
 </tr>
  <tr>
     <td valign="top">checkstyle.allow.noauthor</td> 
    <td valign="top">Indicates whether to allow no <span class="default">@author</span> tag to be defined for class and interface Javadoc comments. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.maxlinelen</td> 
    <td valign="top">Specifies the maximum line length. Default value is defined <a href="engine.html#length">here</a>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.ignore.importlength</td> 
    <td valign="top">Specifies whether to ignore the maximum line length for <span class="code">import</span> statements. Defaults to <span class="default">&quot;false&quot;</span>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.maxmethodlen</td> 
    <td valign="top">Specifies the maximum method length. Default value is defined <a href="engine.html#methodLength">here</a>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.maxconstructorlen</td> 
    <td valign="top">Specifies the maximum constructor length. Default value is defined <a href="engine.html#constructorLength">here</a>.</td>
  </tr>
 <tr>
    <td valign="top">checkstyle.maxfilelen</td> 
    <td valign="top">Specifies the maximum file length. Default value is defined <a href="engine.html#fileLength">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.member</td> 
    <td valign="top">Specifies the regular expression to match against member variables. Default value is defined <a href="engine.html#varformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.publicmember</td> 
    <td valign="top">Specifies the regular expression to match against public member variables. Default value is defined <a href="engine.html#fieldformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.parameter</td> 
    <td valign="top">Specifies the regular expression to match against parameters. Default value is defined <a href="engine.html#paramformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.const</td> 
    <td valign="top">Specifies the regular expression to match against static/final variables. Default value is defined <a href="engine.html#varformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.static</td> 
    <td valign="top">Specifies the regular expression to match against static variables. Default value is defined <a href="engine.html#varformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.type</td> 
    <td valign="top">Specifies the regular expression to match against type names. Default value is defined <a href="engine.html#typeformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.method</td>
    <td valign="top">Specifies the regular expression to match against method names. Default value is defined <a href="engine.html#methodformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.pattern.localvar</td>
    <td valign="top">Specifies the regular expression to match against local variable names. Default value is defined <a href="engine.html#localvarformat">here</a>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.header.file</td> 
    <td valign="top">Specifies the file containing the header lines. Default is to not check.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.header.regexp</td> 
    <td valign="top">Specifies whether to interpret each line in the checkstyle.header.file as a regular expression. Default is <span class="default">&quot;false&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.header.ignoreline</td> 
    <td valign="top">Specifies a comma separated list of the lines in the header to ignore when comparing. Default is to not ignore any line.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.javadoc.scope</td> 
    <td valign="top">Specifies the visibility scope where javadoc comments are checked. Valid values are <span class="default">&quot;nothing&quot;</span>, <span class="default">&quot;public&quot;</span>, <span class="default">&quot;protected&quot;</span>, <span class="default">&quot;package&quot;</span>, <span class="default">&quot;private&quot;</span> and <span class="default">&quot;anoninner&quot;</span>. Defaults to <span class="default">&quot;private&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.require.packagehtml</td>
    <td valign="top">Specifies whether to require that package documentation is available. Defaults to <span class="default">&quot;false&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.ignore.imports</td> 
    <td valign="top">Specifies whether to ignore checking import statements. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.ignore.whitespace</td> 
    <td valign="top">Specifies whether to ignore checking whitespace. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.ignore.whitespace.cast</td> 
    <td valign="top">Specifies whether to ignore checking for whitespace after a cast. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.ignore.braces</td> 
    <td valign="top">Specifies whether to ignore checking braces. Defaults to <span class="default">&quot;no&quot;</span>.</td>
  </tr>
  <tr>
    <td valign="top">checkstyle.cache.file</td> 
    <td valign="top">Specifies the name of a file that can be used to cache details of files that pass checkstyle. This can signicantly increase the speed of checkstyle on successive runs.</td>
  </tr>
</table>

<p>
Older versions of the checkstyle task supported the boolean parameters checkstyle.javadoc.relax and checkstyle.javadoc.ignore. These parameters have been removed because they were conflicting with each other and the semantics of relaxJavadoc was not specified. The two parameters have been replaced by the checkstyle.javadoc.scope parameter. Instead of checkstyle.javadoc.ignore=true you can now use checkstyle.javadoc.scope=nothing. The behaviour of checkstyle.javadoc.relax=true is roughly the same as checkstyle.javadoc.scope=protected.
</p>

<h2>Examples</h2>
<p><b>Run checkstyle on a file</b></p>
<pre>
  java  com.puppycrawl.tools.checkstyle.Main  Check.java
</pre>

<p><b>Run checkstyle on a file and allow tabs</b></p>
<pre>
  java  -Dcheckstyle.allow.tabs=yes \
        com.puppycrawl.tools.checkstyle.Main Check.java
</pre>

<p><b>Run checkstyle on a file and output to a file in XML format</b></p>
<pre>
  java  -Dcheckstyle.allow.tabs=yes  \
        com.puppycrawl.tools.checkstyle.Main \
        -f xml -o build/checkstyle_errors.xml Check.java
</pre>

<p><b>Run checkstyle on a file and disable pattern matching</b></p>
<pre>
  java  -Dcheckstyle.pattern.parameter=. \
        -Dcheckstyle.pattern.static=. \
        -Dcheckstyle.pattern.const=. \
        -Dcheckstyle.pattern.member=. \
        com.puppycrawl.tools.checkstyle.Main Check.java
</pre>

<hr>
<p align="center">Copyright &copy; 2001 <NAME>. All rights Reserved.</p>
</body>
</html>

{'fraction_non_alphanumeric': 0.16068615438473657, 'fraction_numerical': 0.0027131104498512165, 'mean_word_length': 4.582071323888617, 'pattern_counts': {'":': 0, '<': 783, '<?xml version=': 0, '>': 783, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 6}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2081800', 'n_tokens_mistral': 7453, 'n_tokens_neox': 7149, 'n_words': 2056}