Modified: websites/production/maven/content/plugins-archives/maven-compiler-plugin-LATEST/compile-mojo.html ============================================================================== --- websites/production/maven/content/plugins-archives/maven-compiler-plugin-LATEST/compile-mojo.html (original) +++ websites/production/maven/content/plugins-archives/maven-compiler-plugin-LATEST/compile-mojo.html Wed Oct 8 16:53:02 2014 @@ -1,11 +1,11 @@ <!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 Apr 3, 2013 + | Generated by Apache Maven Doxia at 2014-10-08 | Rendered using Apache Maven Stylus Skin 1.5 --> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <title>Maven Compiler plugin - + <title>Apache Maven Compiler Plugin - compiler:compile</title> <style type="text/css" media="all"> @import url("./css/maven-base.css"); @@ -13,7 +13,7 @@ @import url("./css/site.css"); </style> <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> - <meta name="Date-Revision-yyyymmdd" content="20130403" /> + <meta name="Date-Revision-yyyymmdd" content="20141008" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> @@ -42,14 +42,14 @@ > <a href="../index.html">Plugins</a> > - <a href="./">Maven Compiler plugin</a> + <a href="./">Apache Maven Compiler Plugin</a> > compiler:compile </div> <div class="xright"> - Last Published: 2013-04-03 - | Version: 3.1 + Last Published: 2014-10-08 + | Version: 3.2 </div> <div class="clear"> <hr/> @@ -72,6 +72,12 @@ <li class="none"> <a href="faq.html">FAQ</a> </li> + <li class="none"> + <a href="http://www.apache.org/licenses/" class="externalLink">License</a> + </li> + <li class="none"> + <a href="download.html">Download</a> + </li> </ul> <h5>Examples</h5> <ul> @@ -170,328 +176,554 @@ <div id="contentBox"> - <div class="section"><h2>compiler:compile<a name="compiler:compile"></a></h2> - <p><b>Full name</b>:</p> - <p>org.apache.maven.plugins:maven-compiler-plugin:3.1:compile</p> - <p><b>Description</b>:</p> - <div>Compiles application sources</div> - <p><b>Attributes</b>:</p> - <ul> - <li>Requires a Maven project to be executed.</li> - <li>Requires dependency resolution of artifacts in scope: <tt>compile</tt>.</li> - <li>The goal is thread-safe and supports parallel builds.</li> - <li>Since version: <tt>2.0</tt>.</li> - <li>Binds by default to the <a class="externalLink" href="http://maven.apache.org/ref/current/maven-core/lifecycles.html">lifecycle phase</a>: <tt>compile</tt>.</li> + <div class="section"> +<h2>compiler:compile<a name="compiler:compile"></a></h2> + +<p><b>Full name</b>:</p> + +<p>org.apache.maven.plugins:maven-compiler-plugin:3.2:compile</p> + +<p><b>Description</b>:</p> + +<div>Compiles application sources</div> + +<p><b>Attributes</b>:</p> + +<ul> + +<li>Requires a Maven project to be executed.</li> + +<li>Requires dependency resolution of artifacts in scope: <tt>compile</tt>.</li> + +<li>The goal is thread-safe and supports parallel builds.</li> + +<li>Since version: <tt>2.0</tt>.</li> + +<li>Binds by default to the <a class="externalLink" href="http://maven.apache.org/ref/current/maven-core/lifecycles.html">lifecycle phase</a>: <tt>compile</tt>.</li> </ul> - <div class="section"><h3>Optional Parameters<a name="Optional_Parameters"></a></h3> - <table class="bodyTable" border="0"> - <tr class="a"> - <th>Name</th> - <th>Type</th> - <th>Since</th> - <th>Description</th> - </tr> - <tr class="b"> - <td><b><a href="#annotationProcessors">annotationProcessors</a></b></td> - <td><tt>String[]</tt></td> - <td><tt>2.2</tt></td> - <td><p>Names of annotation processors to run. Only applies to JDK 1.6+ + +<div class="section"> +<h3>Optional Parameters<a name="Optional_Parameters"></a></h3> + +<table class="bodyTable" border="0"> + +<tr class="a"> + +<th>Name</th> + +<th>Type</th> + +<th>Since</th> + +<th>Description</th> + </tr> + +<tr class="b"> + +<td><b><a href="#annotationProcessors">annotationProcessors</a></b></td> + +<td><tt>String[]</tt></td> + +<td><tt>2.2</tt></td> + +<td> +<p>Names of annotation processors to run. Only applies to JDK 1.6+ If not set, the default annotation processors discovery process applies.</p><br /></td> </tr> - <tr class="a"> - <td><b><a href="#compilerArgs">compilerArgs</a></b></td> - <td><tt>List</tt></td> - <td><tt>3.1</tt></td> - <td><p>Sets the arguments to be passed to the compiler if + +<tr class="a"> + +<td><b><a href="#compilerArgs">compilerArgs</a></b></td> + +<td><tt>List</tt></td> + +<td><tt>3.1</tt></td> + +<td> +<p>Sets the arguments to be passed to the compiler if <tt>fork</tt> is set to <tt>true</tt>. Example:</p> -<div><pre> + +<div> +<pre> <compilerArgs> <arg>-Xmaxerrs=1000</arg> <arg>-Xlint</arg> + <arg>-J-Duser.language=en_us</arg> </compilerArgs> </pre></div><br /></td> </tr> - <tr class="b"> - <td><b><a href="#compilerArgument">compilerArgument</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.0</tt></td> - <td><p>Sets the unformatted single argument string to be passed to the + +<tr class="b"> + +<td><b><a href="#compilerArgument">compilerArgument</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.0</tt></td> + +<td> +<p>Sets the unformatted single argument string to be passed to the compiler if <tt>fork</tt> is set to <tt>true</tt>. To pass multiple arguments such as <tt>-Xmaxerrs 1000</tt> (which are actually two arguments) you have to use <tt>compilerArguments</tt>.</p> + <p>This is because the list of valid arguments passed to a Java compiler varies based on the compiler version.</p><br /></td> </tr> - <tr class="a"> - <td><b><a href="#compilerArguments">compilerArguments</a></b></td> - <td><tt>Map</tt></td> - <td><tt>2.0.1</tt></td> - <td><b>Deprecated.</b> use <tt>compilerArgs</tt> instead.<br /></td> - </tr> - <tr class="b"> - <td><b><a href="#compilerId">compilerId</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.0</tt></td> - <td>The compiler id of the compiler to use. See this <a href="non-javac-compilers.html">guide</a> for more information.<br /><b>Default value is</b>: <tt>javac</tt>.<br /><b>User property is</b>: <tt>maven.compiler.compilerId</tt>.</td> - </tr> - <tr class="a"> - <td><b><a href="#compilerReuseStrategy">compilerReuseStrategy</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.5</tt></td> - <td>Strategy to re use javacc class created: + +<tr class="a"> + +<td><b><a href="#compilerArguments">compilerArguments</a></b></td> + +<td><tt>Map</tt></td> + +<td><tt>2.0.1</tt></td> + +<td><b>Deprecated.</b> use <tt>compilerArgs</tt> instead.<br /></td> + </tr> + +<tr class="b"> + +<td><b><a href="#compilerId">compilerId</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.0</tt></td> + +<td>The compiler id of the compiler to use. See this <a href="non-javac-compilers.html">guide</a> for more information.<br /><b>Default value is</b>: <tt>javac</tt>.<br /><b>User property is</b>: <tt>maven.compiler.compilerId</tt>.</td> + </tr> + +<tr class="a"> + +<td><b><a href="#compilerReuseStrategy">compilerReuseStrategy</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.5</tt></td> + +<td>Strategy to re use javacc class created: + <ul> + <li><tt>reuseCreated</tt> (default): will reuse already created but in case of multi-threaded builds, each thread will have its own instance</li> + <li><tt>reuseSame</tt>: the same Javacc class will be used for each compilation even for multi-threaded build</li> + <li><tt>alwaysNew</tt>: a new Javacc class will be created for each compilation</li> </ul> Note this parameter value depends on the os/jdk you are using, but the default value should work on most of env.<br /><b>Default value is</b>: <tt>${reuseCreated}</tt>.<br /><b>User property is</b>: <tt>maven.compiler.compilerReuseStrategy</tt>.</td> </tr> - <tr class="b"> - <td><b><a href="#compilerVersion">compilerVersion</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.0</tt></td> - <td>Version of the compiler to use, ex. "1.3", "1.5", if + +<tr class="b"> + +<td><b><a href="#compilerVersion">compilerVersion</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.0</tt></td> + +<td>Version of the compiler to use, ex. "1.3", "1.5", if <tt>fork</tt> is set to <tt>true</tt>.<br /><b>User property is</b>: <tt>maven.compiler.compilerVersion</tt>.</td> </tr> - <tr class="a"> - <td><b><a href="#debug">debug</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>2.0</tt></td> - <td>Set to <tt>true</tt> to include debugging information in the + +<tr class="a"> + +<td><b><a href="#debug">debug</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>2.0</tt></td> + +<td>Set to <tt>true</tt> to include debugging information in the compiled class files.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>maven.compiler.debug</tt>.</td> </tr> - <tr class="b"> - <td><b><a href="#debuglevel">debuglevel</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.1</tt></td> - <td>Keyword list to be appended to the <tt>-g</tt> command-line + +<tr class="b"> + +<td><b><a href="#debuglevel">debuglevel</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.1</tt></td> + +<td>Keyword list to be appended to the <tt>-g</tt> command-line switch. Legal values are none or a comma-separated list of the following keywords: <tt>lines</tt>, <tt>vars</tt>, and <tt>source</tt>. If debug level is not specified, by default, nothing will be appended to <tt>-g</tt>. If debug is not turned on, this attribute will be ignored.<br /><b>User property is</b>: <tt>maven.compiler.debuglevel</tt>.</td> </tr> - <tr class="a"> - <td><b><a href="#encoding">encoding</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.1</tt></td> - <td>The -encoding argument for the Java compiler.<br /><b>Default value is</b>: <tt>${project.build.sourceEncoding}</tt>.<br /><b>User property is</b>: <tt>encoding</tt>.</td> - </tr> - <tr class="b"> - <td><b><a href="#excludes">excludes</a></b></td> - <td><tt>Set</tt></td> - <td><tt>2.0</tt></td> - <td>A list of exclusion filters for the compiler.<br /></td> - </tr> - <tr class="a"> - <td><b><a href="#executable">executable</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.0</tt></td> - <td>Sets the executable of the compiler to use when <tt>fork</tt> + +<tr class="a"> + +<td><b><a href="#encoding">encoding</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.1</tt></td> + +<td>The -encoding argument for the Java compiler.<br /><b>Default value is</b>: <tt>${project.build.sourceEncoding}</tt>.<br /><b>User property is</b>: <tt>encoding</tt>.</td> + </tr> + +<tr class="b"> + +<td><b><a href="#excludes">excludes</a></b></td> + +<td><tt>Set</tt></td> + +<td><tt>2.0</tt></td> + +<td>A list of exclusion filters for the compiler.<br /></td> + </tr> + +<tr class="a"> + +<td><b><a href="#executable">executable</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.0</tt></td> + +<td>Sets the executable of the compiler to use when <tt>fork</tt> is <tt>true</tt>.<br /><b>User property is</b>: <tt>maven.compiler.executable</tt>.</td> </tr> - <tr class="b"> - <td><b><a href="#failOnError">failOnError</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>2.0.2</tt></td> - <td>Indicates whether the build will continue even if there are + +<tr class="b"> + +<td><b><a href="#failOnError">failOnError</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>2.0.2</tt></td> + +<td>Indicates whether the build will continue even if there are compilation errors.<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>maven.compiler.failOnError</tt>.</td> </tr> - <tr class="a"> - <td><b><a href="#fileExtensions">fileExtensions</a></b></td> - <td><tt>List</tt></td> - <td><tt>3.1</tt></td> - <td>file extensions to check timestamp for incremental build <b>default + +<tr class="a"> + +<td><b><a href="#fileExtensions">fileExtensions</a></b></td> + +<td><tt>List</tt></td> + +<td><tt>3.1</tt></td> + +<td>file extensions to check timestamp for incremental build <b>default contains only <tt>.class</tt></b><br /></td> </tr> - <tr class="b"> - <td><b><a href="#forceJavacCompilerUse">forceJavacCompilerUse</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>3.0</tt></td> - <td>compiler can now use javax.tools if available in your current jdk, + +<tr class="b"> + +<td><b><a href="#forceJavacCompilerUse">forceJavacCompilerUse</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>3.0</tt></td> + +<td>compiler can now use javax.tools if available in your current jdk, you can disable this feature using -Dmaven.compiler.forceJavacCompilerUse=true or in the plugin configuration<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>maven.compiler.forceJavacCompilerUse</tt>.</td> </tr> - <tr class="a"> - <td><b><a href="#fork">fork</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>2.0</tt></td> - <td>Allows running the compiler in a separate process. If + +<tr class="a"> + +<td><b><a href="#fork">fork</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>2.0</tt></td> + +<td>Allows running the compiler in a separate process. If <tt>false</tt> it uses the built in compiler, while if <tt>true</tt> it will use an executable.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>maven.compiler.fork</tt>.</td> </tr> - <tr class="b"> - <td><b><a href="#generatedSourcesDirectory">generatedSourcesDirectory</a></b></td> - <td><tt>File</tt></td> - <td><tt>2.2</tt></td> - <td><p>Specify where to place generated source files created by + +<tr class="b"> + +<td><b><a href="#generatedSourcesDirectory">generatedSourcesDirectory</a></b></td> + +<td><tt>File</tt></td> + +<td><tt>2.2</tt></td> + +<td> +<p>Specify where to place generated source files created by annotation processing. Only applies to JDK 1.6+</p><br /><b>Default value is</b>: <tt>${project.build.directory}/generated-sources/annotations</tt>.<br /></td> </tr> - <tr class="a"> - <td><b><a href="#includes">includes</a></b></td> - <td><tt>Set</tt></td> - <td><tt>2.0</tt></td> - <td>A list of inclusion filters for the compiler.<br /></td> - </tr> - <tr class="b"> - <td><b><a href="#maxmem">maxmem</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.0.1</tt></td> - <td>Sets the maximum size, in megabytes, of the memory allocation pool, + +<tr class="a"> + +<td><b><a href="#includes">includes</a></b></td> + +<td><tt>Set</tt></td> + +<td><tt>2.0</tt></td> + +<td>A list of inclusion filters for the compiler.<br /></td> + </tr> + +<tr class="b"> + +<td><b><a href="#maxmem">maxmem</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.0.1</tt></td> + +<td>Sets the maximum size, in megabytes, of the memory allocation pool, ex. "128", "128m" if <tt>fork</tt> is set to <tt>true</tt>.<br /><b>User property is</b>: <tt>maven.compiler.maxmem</tt>.</td> </tr> - <tr class="a"> - <td><b><a href="#meminitial">meminitial</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.0.1</tt></td> - <td>Initial size, in megabytes, of the memory allocation pool, ex. + +<tr class="a"> + +<td><b><a href="#meminitial">meminitial</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.0.1</tt></td> + +<td>Initial size, in megabytes, of the memory allocation pool, ex. "64", "64m" if <tt>fork</tt> is set to <tt>true</tt>.<br /><b>User property is</b>: <tt>maven.compiler.meminitial</tt>.</td> </tr> - <tr class="b"> - <td><b><a href="#mojoExecution">mojoExecution</a></b></td> - <td><tt>MojoExecution</tt></td> - <td><tt>3.0 needed for storing the status for the incremental build support.</tt></td> - <td>(no description)<br /><b>User property is</b>: <tt>mojoExecution</tt>.</td> - </tr> - <tr class="a"> - <td><b><a href="#optimize">optimize</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>2.0</tt></td> - <td>Set to <tt>true</tt> to optimize the compiled code using the + +<tr class="b"> + +<td><b><a href="#optimize">optimize</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>2.0</tt></td> + +<td>Set to <tt>true</tt> to optimize the compiled code using the compiler's optimization methods.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>maven.compiler.optimize</tt>.</td> </tr> - <tr class="b"> - <td><b><a href="#outputFileName">outputFileName</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.0</tt></td> - <td>Sets the name of the output file when compiling a set of sources to + +<tr class="a"> + +<td><b><a href="#outputFileName">outputFileName</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.0</tt></td> + +<td>Sets the name of the output file when compiling a set of sources to a single file. expression="${project.build.finalName}"<br /></td> </tr> - <tr class="a"> - <td><b><a href="#proc">proc</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.2</tt></td> - <td><p>Sets whether annotation processing is performed or not. Only + +<tr class="b"> + +<td><b><a href="#proc">proc</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.2</tt></td> + +<td> +<p>Sets whether annotation processing is performed or not. Only applies to JDK 1.6+ If not set, both compilation and annotation processing are performed at the same time.</p> + <p>Allowed values are:</p> + <ul> + <li><tt>none</tt> - no annotation processing is performed.</li> + <li><tt>only</tt> - only annotation processing is done, no compilation.</li> </ul><br /></td> </tr> - <tr class="b"> - <td><b><a href="#showDeprecation">showDeprecation</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>2.0</tt></td> - <td>Sets whether to show source locations where deprecated APIs are + +<tr class="a"> + +<td><b><a href="#showDeprecation">showDeprecation</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>2.0</tt></td> + +<td>Sets whether to show source locations where deprecated APIs are used.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>maven.compiler.showDeprecation</tt>.</td> </tr> - <tr class="a"> - <td><b><a href="#showWarnings">showWarnings</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>2.0</tt></td> - <td>Set to <tt>true</tt> to show compilation warnings.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>maven.compiler.showWarnings</tt>.</td> - </tr> - <tr class="b"> - <td><b><a href="#skipMain">skipMain</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>2.0</tt></td> - <td>Set this to 'true' to bypass compilation of main sources. Its use + +<tr class="b"> + +<td><b><a href="#showWarnings">showWarnings</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>2.0</tt></td> + +<td>Set to <tt>true</tt> to show compilation warnings.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>maven.compiler.showWarnings</tt>.</td> + </tr> + +<tr class="a"> + +<td><b><a href="#skipMain">skipMain</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>2.0</tt></td> + +<td>Set this to 'true' to bypass compilation of main sources. Its use is NOT RECOMMENDED, but quite convenient on occasion.<br /><b>User property is</b>: <tt>maven.main.skip</tt>.</td> </tr> - <tr class="a"> - <td><b><a href="#skipMultiThreadWarning">skipMultiThreadWarning</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>2.5</tt></td> - <td>(no description)<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>maven.compiler.skipMultiThreadWarning</tt>.</td> - </tr> - <tr class="b"> - <td><b><a href="#source">source</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.0</tt></td> - <td>The -source argument for the Java compiler.<br /><b>Default value is</b>: <tt>1.5</tt>.<br /><b>User property is</b>: <tt>maven.compiler.source</tt>.</td> - </tr> - <tr class="a"> - <td><b><a href="#staleMillis">staleMillis</a></b></td> - <td><tt>int</tt></td> - <td><tt>2.0</tt></td> - <td>Sets the granularity in milliseconds of the last modification date + +<tr class="b"> + +<td><b><a href="#skipMultiThreadWarning">skipMultiThreadWarning</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>2.5</tt></td> + +<td>(no description)<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>maven.compiler.skipMultiThreadWarning</tt>.</td> + </tr> + +<tr class="a"> + +<td><b><a href="#source">source</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.0</tt></td> + +<td>The -source argument for the Java compiler.<br /><b>Default value is</b>: <tt>1.5</tt>.<br /><b>User property is</b>: <tt>maven.compiler.source</tt>.</td> + </tr> + +<tr class="b"> + +<td><b><a href="#staleMillis">staleMillis</a></b></td> + +<td><tt>int</tt></td> + +<td><tt>2.0</tt></td> + +<td>Sets the granularity in milliseconds of the last modification date for testing whether a source needs recompilation.<br /><b>Default value is</b>: <tt>0</tt>.<br /><b>User property is</b>: <tt>lastModGranularityMs</tt>.</td> </tr> - <tr class="b"> - <td><b><a href="#target">target</a></b></td> - <td><tt>String</tt></td> - <td><tt>2.0</tt></td> - <td>The -target argument for the Java compiler.<br /><b>Default value is</b>: <tt>1.5</tt>.<br /><b>User property is</b>: <tt>maven.compiler.target</tt>.</td> - </tr> - <tr class="a"> - <td><b><a href="#useIncrementalCompilation">useIncrementalCompilation</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>3.1</tt></td> - <td>to enable/disable incrementation compilation feature<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>maven.compiler.useIncrementalCompilation</tt>.</td> - </tr> - <tr class="b"> - <td><b><a href="#verbose">verbose</a></b></td> - <td><tt>boolean</tt></td> - <td><tt>2.0</tt></td> - <td>Set to <tt>true</tt> to show messages about what the compiler + +<tr class="a"> + +<td><b><a href="#target">target</a></b></td> + +<td><tt>String</tt></td> + +<td><tt>2.0</tt></td> + +<td>The -target argument for the Java compiler.<br /><b>Default value is</b>: <tt>1.5</tt>.<br /><b>User property is</b>: <tt>maven.compiler.target</tt>.</td> + </tr> + +<tr class="b"> + +<td><b><a href="#useIncrementalCompilation">useIncrementalCompilation</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>3.1</tt></td> + +<td>to enable/disable incrementation compilation feature<br /><b>Default value is</b>: <tt>true</tt>.<br /><b>User property is</b>: <tt>maven.compiler.useIncrementalCompilation</tt>.</td> + </tr> + +<tr class="a"> + +<td><b><a href="#verbose">verbose</a></b></td> + +<td><tt>boolean</tt></td> + +<td><tt>2.0</tt></td> + +<td>Set to <tt>true</tt> to show messages about what the compiler is doing.<br /><b>Default value is</b>: <tt>false</tt>.<br /><b>User property is</b>: <tt>maven.compiler.verbose</tt>.</td> </tr> </table> </div> - <div class="section"><h3>Parameter Details<a name="Parameter_Details"></a></h3> - <p><b><a name="annotationProcessors">annotationProcessors</a>:</b></p> - <div><p>Names of annotation processors to run. Only applies to JDK 1.6+ + +<div class="section"> +<h3>Parameter Details<a name="Parameter_Details"></a></h3> + +<p><b><a name="annotationProcessors">annotationProcessors</a>:</b></p> + +<div> +<p>Names of annotation processors to run. Only applies to JDK 1.6+ If not set, the default annotation processors discovery process applies.</p></div> - <ul> - <li><b>Type</b>: <tt>java.lang.String[]</tt></li> - <li><b>Since</b>: <tt>2.2</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - </ul><hr /><p><b><a name="compilerArgs">compilerArgs</a>:</b></p> - <div><p>Sets the arguments to be passed to the compiler if + +<ul> + +<li><b>Type</b>: <tt>java.lang.String[]</tt></li> + +<li><b>Since</b>: <tt>2.2</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + </ul><hr /> +<p><b><a name="compilerArgs">compilerArgs</a>:</b></p> + +<div> +<p>Sets the arguments to be passed to the compiler if <tt>fork</tt> is set to <tt>true</tt>. Example:</p> -<div><pre> + +<div> +<pre> <compilerArgs> <arg>-Xmaxerrs=1000</arg> <arg>-Xlint</arg> + <arg>-J-Duser.language=en_us</arg> </compilerArgs> </pre></div></div> - <ul> - <li><b>Type</b>: <tt>java.util.List</tt></li> - <li><b>Since</b>: <tt>3.1</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - </ul><hr /><p><b><a name="compilerArgument">compilerArgument</a>:</b></p> - <div><p>Sets the unformatted single argument string to be passed to the + +<ul> + +<li><b>Type</b>: <tt>java.util.List</tt></li> + +<li><b>Since</b>: <tt>3.1</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + </ul><hr /> +<p><b><a name="compilerArgument">compilerArgument</a>:</b></p> + +<div> +<p>Sets the unformatted single argument string to be passed to the compiler if <tt>fork</tt> is set to <tt>true</tt>. To pass multiple arguments such as <tt>-Xmaxerrs 1000</tt> (which are actually two arguments) you have to use <tt>compilerArguments</tt>.</p> + <p>This is because the list of valid arguments passed to a Java compiler varies based on the compiler version.</p></div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - </ul><hr /><p><b><a name="compilerArguments">compilerArguments</a>:</b></p> - <div><b>Deprecated.</b> use <tt>compilerArgs</tt> instead.</div> - <div><p>Sets the arguments to be passed to the compiler (prepending a + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + </ul><hr /> +<p><b><a name="compilerArguments">compilerArguments</a>:</b></p> + +<div><b>Deprecated.</b> use <tt>compilerArgs</tt> instead.</div> + +<div> +<p>Sets the arguments to be passed to the compiler (prepending a dash) if <tt>fork</tt> is set to <tt>true</tt>.</p> + <p>This is because the list of valid arguments passed to a Java compiler varies based on the compiler version.</p> + <p>To pass <tt>-Xmaxerrs 1000 -Xlint -Xlint:-path -Averbose=true</tt> you should include the following:</p> -<div><pre> + +<div> +<pre> <compilerArguments> <Xmaxerrs>1000</Xmaxerrs> <Xlint/> @@ -499,267 +731,481 @@ compiler varies based on the compiler ve <Averbose>true</Averbose> </compilerArguments> </pre></div></div> - <ul> - <li><b>Type</b>: <tt>java.util.Map</tt></li> - <li><b>Since</b>: <tt>2.0.1</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - </ul><hr /><p><b><a name="compilerId">compilerId</a>:</b></p> - <div>The compiler id of the compiler to use. See this <a href="non-javac-compilers.html">guide</a> for more information.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.compilerId</tt></li> - <li><b>Default</b>: <tt>javac</tt></li> - </ul><hr /><p><b><a name="compilerReuseStrategy">compilerReuseStrategy</a>:</b></p> - <div>Strategy to re use javacc class created: + <ul> + +<li><b>Type</b>: <tt>java.util.Map</tt></li> + +<li><b>Since</b>: <tt>2.0.1</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + </ul><hr /> +<p><b><a name="compilerId">compilerId</a>:</b></p> + +<div>The compiler id of the compiler to use. See this <a href="non-javac-compilers.html">guide</a> for more information.</div> + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.compilerId</tt></li> + +<li><b>Default</b>: <tt>javac</tt></li> + </ul><hr /> +<p><b><a name="compilerReuseStrategy">compilerReuseStrategy</a>:</b></p> + +<div>Strategy to re use javacc class created: + +<ul> + <li><tt>reuseCreated</tt> (default): will reuse already created but in case of multi-threaded builds, each thread will have its own instance</li> + <li><tt>reuseSame</tt>: the same Javacc class will be used for each compilation even for multi-threaded build</li> + <li><tt>alwaysNew</tt>: a new Javacc class will be created for each compilation</li> </ul> Note this parameter value depends on the os/jdk you are using, but the default value should work on most of env.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.5</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.compilerReuseStrategy</tt></li> - <li><b>Default</b>: <tt>${reuseCreated}</tt></li> - </ul><hr /><p><b><a name="compilerVersion">compilerVersion</a>:</b></p> - <div>Version of the compiler to use, ex. "1.3", "1.5", if + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.5</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.compilerReuseStrategy</tt></li> + +<li><b>Default</b>: <tt>${reuseCreated}</tt></li> + </ul><hr /> +<p><b><a name="compilerVersion">compilerVersion</a>:</b></p> + +<div>Version of the compiler to use, ex. "1.3", "1.5", if <tt>fork</tt> is set to <tt>true</tt>.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.compilerVersion</tt></li> - </ul><hr /><p><b><a name="debug">debug</a>:</b></p> - <div>Set to <tt>true</tt> to include debugging information in the + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.compilerVersion</tt></li> + </ul><hr /> +<p><b><a name="debug">debug</a>:</b></p> + +<div>Set to <tt>true</tt> to include debugging information in the compiled class files.</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.debug</tt></li> - <li><b>Default</b>: <tt>true</tt></li> - </ul><hr /><p><b><a name="debuglevel">debuglevel</a>:</b></p> - <div>Keyword list to be appended to the <tt>-g</tt> command-line + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.debug</tt></li> + +<li><b>Default</b>: <tt>true</tt></li> + </ul><hr /> +<p><b><a name="debuglevel">debuglevel</a>:</b></p> + +<div>Keyword list to be appended to the <tt>-g</tt> command-line switch. Legal values are none or a comma-separated list of the following keywords: <tt>lines</tt>, <tt>vars</tt>, and <tt>source</tt>. If debug level is not specified, by default, nothing will be appended to <tt>-g</tt>. If debug is not turned on, this attribute will be ignored.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.1</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.debuglevel</tt></li> - </ul><hr /><p><b><a name="encoding">encoding</a>:</b></p> - <div>The -encoding argument for the Java compiler.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.1</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>encoding</tt></li> - <li><b>Default</b>: <tt>${project.build.sourceEncoding}</tt></li> - </ul><hr /><p><b><a name="excludes">excludes</a>:</b></p> - <div>A list of exclusion filters for the compiler.</div> - <ul> - <li><b>Type</b>: <tt>java.util.Set</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - </ul><hr /><p><b><a name="executable">executable</a>:</b></p> - <div>Sets the executable of the compiler to use when <tt>fork</tt> + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.1</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.debuglevel</tt></li> + </ul><hr /> +<p><b><a name="encoding">encoding</a>:</b></p> + +<div>The -encoding argument for the Java compiler.</div> + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.1</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>encoding</tt></li> + +<li><b>Default</b>: <tt>${project.build.sourceEncoding}</tt></li> + </ul><hr /> +<p><b><a name="excludes">excludes</a>:</b></p> + +<div>A list of exclusion filters for the compiler.</div> + +<ul> + +<li><b>Type</b>: <tt>java.util.Set</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + </ul><hr /> +<p><b><a name="executable">executable</a>:</b></p> + +<div>Sets the executable of the compiler to use when <tt>fork</tt> is <tt>true</tt>.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.executable</tt></li> - </ul><hr /><p><b><a name="failOnError">failOnError</a>:</b></p> - <div>Indicates whether the build will continue even if there are + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.executable</tt></li> + </ul><hr /> +<p><b><a name="failOnError">failOnError</a>:</b></p> + +<div>Indicates whether the build will continue even if there are compilation errors.</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>2.0.2</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.failOnError</tt></li> - <li><b>Default</b>: <tt>true</tt></li> - </ul><hr /><p><b><a name="fileExtensions">fileExtensions</a>:</b></p> - <div>file extensions to check timestamp for incremental build <b>default + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>2.0.2</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.failOnError</tt></li> + +<li><b>Default</b>: <tt>true</tt></li> + </ul><hr /> +<p><b><a name="fileExtensions">fileExtensions</a>:</b></p> + +<div>file extensions to check timestamp for incremental build <b>default contains only <tt>.class</tt></b></div> - <ul> - <li><b>Type</b>: <tt>java.util.List</tt></li> - <li><b>Since</b>: <tt>3.1</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - </ul><hr /><p><b><a name="forceJavacCompilerUse">forceJavacCompilerUse</a>:</b></p> - <div>compiler can now use javax.tools if available in your current jdk, + +<ul> + +<li><b>Type</b>: <tt>java.util.List</tt></li> + +<li><b>Since</b>: <tt>3.1</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + </ul><hr /> +<p><b><a name="forceJavacCompilerUse">forceJavacCompilerUse</a>:</b></p> + +<div>compiler can now use javax.tools if available in your current jdk, you can disable this feature using -Dmaven.compiler.forceJavacCompilerUse=true or in the plugin configuration</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>3.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.forceJavacCompilerUse</tt></li> - <li><b>Default</b>: <tt>false</tt></li> - </ul><hr /><p><b><a name="fork">fork</a>:</b></p> - <div>Allows running the compiler in a separate process. If + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>3.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.forceJavacCompilerUse</tt></li> + +<li><b>Default</b>: <tt>false</tt></li> + </ul><hr /> +<p><b><a name="fork">fork</a>:</b></p> + +<div>Allows running the compiler in a separate process. If <tt>false</tt> it uses the built in compiler, while if <tt>true</tt> it will use an executable.</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.fork</tt></li> - <li><b>Default</b>: <tt>false</tt></li> - </ul><hr /><p><b><a name="generatedSourcesDirectory">generatedSourcesDirectory</a>:</b></p> - <div><p>Specify where to place generated source files created by + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.fork</tt></li> + +<li><b>Default</b>: <tt>false</tt></li> + </ul><hr /> +<p><b><a name="generatedSourcesDirectory">generatedSourcesDirectory</a>:</b></p> + +<div> +<p>Specify where to place generated source files created by annotation processing. Only applies to JDK 1.6+</p></div> - <ul> - <li><b>Type</b>: <tt>java.io.File</tt></li> - <li><b>Since</b>: <tt>2.2</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>Default</b>: <tt>${project.build.directory}/generated-sources/annotations</tt></li> - </ul><hr /><p><b><a name="includes">includes</a>:</b></p> - <div>A list of inclusion filters for the compiler.</div> - <ul> - <li><b>Type</b>: <tt>java.util.Set</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - </ul><hr /><p><b><a name="maxmem">maxmem</a>:</b></p> - <div>Sets the maximum size, in megabytes, of the memory allocation pool, + +<ul> + +<li><b>Type</b>: <tt>java.io.File</tt></li> + +<li><b>Since</b>: <tt>2.2</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>Default</b>: <tt>${project.build.directory}/generated-sources/annotations</tt></li> + </ul><hr /> +<p><b><a name="includes">includes</a>:</b></p> + +<div>A list of inclusion filters for the compiler.</div> + +<ul> + +<li><b>Type</b>: <tt>java.util.Set</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + </ul><hr /> +<p><b><a name="maxmem">maxmem</a>:</b></p> + +<div>Sets the maximum size, in megabytes, of the memory allocation pool, ex. "128", "128m" if <tt>fork</tt> is set to <tt>true</tt>.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.0.1</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.maxmem</tt></li> - </ul><hr /><p><b><a name="meminitial">meminitial</a>:</b></p> - <div>Initial size, in megabytes, of the memory allocation pool, ex. + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.0.1</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.maxmem</tt></li> + </ul><hr /> +<p><b><a name="meminitial">meminitial</a>:</b></p> + +<div>Initial size, in megabytes, of the memory allocation pool, ex. "64", "64m" if <tt>fork</tt> is set to <tt>true</tt>.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.0.1</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.meminitial</tt></li> - </ul><hr /><p><b><a name="mojoExecution">mojoExecution</a>:</b></p> - <div>(no description)</div> - <ul> - <li><b>Type</b>: <tt>org.apache.maven.plugin.MojoExecution</tt></li> - <li><b>Since</b>: <tt>3.0 needed for storing the status for the incremental build support.</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>mojoExecution</tt></li> - </ul><hr /><p><b><a name="optimize">optimize</a>:</b></p> - <div>Set to <tt>true</tt> to optimize the compiled code using the + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.0.1</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.meminitial</tt></li> + </ul><hr /> +<p><b><a name="optimize">optimize</a>:</b></p> + +<div>Set to <tt>true</tt> to optimize the compiled code using the compiler's optimization methods.</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.optimize</tt></li> - <li><b>Default</b>: <tt>false</tt></li> - </ul><hr /><p><b><a name="outputFileName">outputFileName</a>:</b></p> - <div>Sets the name of the output file when compiling a set of sources to + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.optimize</tt></li> + +<li><b>Default</b>: <tt>false</tt></li> + </ul><hr /> +<p><b><a name="outputFileName">outputFileName</a>:</b></p> + +<div>Sets the name of the output file when compiling a set of sources to a single file. expression="${project.build.finalName}"</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - </ul><hr /><p><b><a name="proc">proc</a>:</b></p> - <div><p>Sets whether annotation processing is performed or not. Only + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + </ul><hr /> +<p><b><a name="proc">proc</a>:</b></p> + +<div> +<p>Sets whether annotation processing is performed or not. Only applies to JDK 1.6+ If not set, both compilation and annotation processing are performed at the same time.</p> + <p>Allowed values are:</p> + <ul> + <li><tt>none</tt> - no annotation processing is performed.</li> + <li><tt>only</tt> - only annotation processing is done, no compilation.</li> </ul></div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.2</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - </ul><hr /><p><b><a name="showDeprecation">showDeprecation</a>:</b></p> - <div>Sets whether to show source locations where deprecated APIs are + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.2</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + </ul><hr /> +<p><b><a name="showDeprecation">showDeprecation</a>:</b></p> + +<div>Sets whether to show source locations where deprecated APIs are used.</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.showDeprecation</tt></li> - <li><b>Default</b>: <tt>false</tt></li> - </ul><hr /><p><b><a name="showWarnings">showWarnings</a>:</b></p> - <div>Set to <tt>true</tt> to show compilation warnings.</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.showWarnings</tt></li> - <li><b>Default</b>: <tt>false</tt></li> - </ul><hr /><p><b><a name="skipMain">skipMain</a>:</b></p> - <div>Set this to 'true' to bypass compilation of main sources. Its use + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.showDeprecation</tt></li> + +<li><b>Default</b>: <tt>false</tt></li> + </ul><hr /> +<p><b><a name="showWarnings">showWarnings</a>:</b></p> + +<div>Set to <tt>true</tt> to show compilation warnings.</div> + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.showWarnings</tt></li> + +<li><b>Default</b>: <tt>false</tt></li> + </ul><hr /> +<p><b><a name="skipMain">skipMain</a>:</b></p> + +<div>Set this to 'true' to bypass compilation of main sources. Its use is NOT RECOMMENDED, but quite convenient on occasion.</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.main.skip</tt></li> - </ul><hr /><p><b><a name="skipMultiThreadWarning">skipMultiThreadWarning</a>:</b></p> - <div>(no description)</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>2.5</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.skipMultiThreadWarning</tt></li> - <li><b>Default</b>: <tt>false</tt></li> - </ul><hr /><p><b><a name="source">source</a>:</b></p> - <div>The -source argument for the Java compiler.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.source</tt></li> - <li><b>Default</b>: <tt>1.5</tt></li> - </ul><hr /><p><b><a name="staleMillis">staleMillis</a>:</b></p> - <div>Sets the granularity in milliseconds of the last modification date + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.main.skip</tt></li> + </ul><hr /> +<p><b><a name="skipMultiThreadWarning">skipMultiThreadWarning</a>:</b></p> + +<div>(no description)</div> + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>2.5</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.skipMultiThreadWarning</tt></li> + +<li><b>Default</b>: <tt>false</tt></li> + </ul><hr /> +<p><b><a name="source">source</a>:</b></p> + +<div>The -source argument for the Java compiler.</div> + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.source</tt></li> + +<li><b>Default</b>: <tt>1.5</tt></li> + </ul><hr /> +<p><b><a name="staleMillis">staleMillis</a>:</b></p> + +<div>Sets the granularity in milliseconds of the last modification date for testing whether a source needs recompilation.</div> - <ul> - <li><b>Type</b>: <tt>int</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>lastModGranularityMs</tt></li> - <li><b>Default</b>: <tt>0</tt></li> - </ul><hr /><p><b><a name="target">target</a>:</b></p> - <div>The -target argument for the Java compiler.</div> - <ul> - <li><b>Type</b>: <tt>java.lang.String</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.target</tt></li> - <li><b>Default</b>: <tt>1.5</tt></li> - </ul><hr /><p><b><a name="useIncrementalCompilation">useIncrementalCompilation</a>:</b></p> - <div>to enable/disable incrementation compilation feature</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>3.1</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.useIncrementalCompilation</tt></li> - <li><b>Default</b>: <tt>true</tt></li> - </ul><hr /><p><b><a name="verbose">verbose</a>:</b></p> - <div>Set to <tt>true</tt> to show messages about what the compiler + +<ul> + +<li><b>Type</b>: <tt>int</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>lastModGranularityMs</tt></li> + +<li><b>Default</b>: <tt>0</tt></li> + </ul><hr /> +<p><b><a name="target">target</a>:</b></p> + +<div>The -target argument for the Java compiler.</div> + +<ul> + +<li><b>Type</b>: <tt>java.lang.String</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.target</tt></li> + +<li><b>Default</b>: <tt>1.5</tt></li> + </ul><hr /> +<p><b><a name="useIncrementalCompilation">useIncrementalCompilation</a>:</b></p> + +<div>to enable/disable incrementation compilation feature</div> + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>3.1</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.useIncrementalCompilation</tt></li> + +<li><b>Default</b>: <tt>true</tt></li> + </ul><hr /> +<p><b><a name="verbose">verbose</a>:</b></p> + +<div>Set to <tt>true</tt> to show messages about what the compiler is doing.</div> - <ul> - <li><b>Type</b>: <tt>boolean</tt></li> - <li><b>Since</b>: <tt>2.0</tt></li> - <li><b>Required</b>: <tt>No</tt></li> - <li><b>User Property</b>: <tt>maven.compiler.verbose</tt></li> - <li><b>Default</b>: <tt>false</tt></li> + +<ul> + +<li><b>Type</b>: <tt>boolean</tt></li> + +<li><b>Since</b>: <tt>2.0</tt></li> + +<li><b>Required</b>: <tt>No</tt></li> + +<li><b>User Property</b>: <tt>maven.compiler.verbose</tt></li> + +<li><b>Default</b>: <tt>false</tt></li> </ul> </div> </div> @@ -772,7 +1218,7 @@ is doing.</div> </div> <div id="footer"> <div class="xright"> - © 2001-2013 + © 2001-2014 The Apache Software Foundation - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.