maven-plugins/aspectj/xdocs/properties.xml
2005-04-25 13:21:16 +00:00

185 lines
5.7 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
/*
* Copyright 2001-2005 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
-->
<document>
<properties>
<title>Maven AspectJ plugin Properties</title>
<author email="dion@multitask.com.au">dIon Gillard</author>
<author email="vmassol@pivolis.com">Vincent Massol</author>
<author email="carlos@apache.org">Carlos Sanchez</author>
</properties>
<body>
<section name="Maven AspectJ Plugin Settings">
<table>
<tr>
<th>Property name</th>
<th>Optional?</th>
<th>Description</th>
</tr>
<tr>
<td>maven.aspectj.argfiles</td>
<td>Yes</td>
<td>
List of argument files separated by commas.
An argument file contains a list of arguments read by the
compiler. Each line is read into one element of the argument
array and may include another argfile by reference.
If specified, <code>maven.aspectj.weaveAspectSources</code>
is set to a default <code>false</code> value.
</td>
</tr>
<tr>
<td>maven.aspectj.weaveAspectSources</td>
<td>Yes</td>
<td>
If true weave aspect sources in
<code>pom.build.aspectSourceDirectory</code>.
Default <code>true</code>, <code>false</code> if
<code>maven.aspectj.argfiles</code> is specified.
</td>
</tr>
<tr>
<td>maven.aspectj.sourceRootCopyFilter</td>
<td>Yes</td>
<td>
List of resource files to exclude when copying resources
from the input jar to the weaved output jar.<br/>
Default <code>**/CVS/*,**/*.java,**/*.aj</code>
</td>
</tr>
<tr>
<td>maven.aspectj.emacssym</td>
<td>Yes</td>
<td>
If true, emit .ajesym symbol files for Emacs support.<br/>
Default <code>no</code>
</td>
</tr>
<tr>
<td>maven.aspectj.debug</td>
<td>Yes</td>
<td>
If true, run in debug mode.<br/>
Default <code>false</code>
</td>
</tr>
<tr>
<td>maven.aspectj.verbose</td>
<td>Yes</td>
<td>
If true, emit compiler status messages during the compile.<br/>
Default <code>false</code>
</td>
</tr>
<tr>
<td>maven.aspectj.incremental</td>
<td>Yes</td>
<td>
Incremental mode: Build once, then recompile only required source
files when user provides input.<br/>
Default <code>false</code>
</td>
</tr>
<tr>
<td>maven.aspectj.fork</td>
<td>Yes</td>
<td>
Run process in another VM. This gets the forking classpath either explicitly
from a forkclasspath entry or by searching the task or system/Ant classpath
for the first readable file with a name of the form aspectj{-}tools{.*}.jar.
When forking you can specify the amount of memory used with maxmem. Fork cannot
be used in incremental mode, unless using a tag file.<br/>
Default <code>false</code>
</td>
</tr>
<tr>
<td>maven.aspectj.maxmem</td>
<td>Yes</td>
<td>
The maximum memory to use for the new VM when fork is true. Values should have
the same form as accepted by the VM, e.g., "128m".
Default <code>128m</code>
</td>
</tr>
<tr>
<td>maven.aspectj.source</td>
<td>Yes</td>
<td>
The J2SE source compliance level. Valid values are [1.3 1.4].
Defaults to <code>1.3</code>.
</td>
</tr>
<tr>
<td>maven.aspectj.time</td>
<td>Yes</td>
<td>
If true, display speed information during weaving.
Defaults to <code>false</code>.
</td>
</tr>
<tr>
<td>maven.aspectj.noweave</td>
<td>Yes</td>
<td>
If true, produce binaries that can only be used as input for the <code>-injars</code> or <code>-inpath</code> option.
Defaults to <code>false</code>.
</td>
</tr>
<tr>
<td>maven.aspectj.lint</td>
<td>Yes</td>
<td>
Level of language usage messages. Possible values are <code>error</code>, <code>warning</code> and <code>ignore</code>.
Defaults to <code>warning</code>.
</td>
</tr>
<tr>
<td>maven.aspectj.messageHolder</td>
<td>Yes</td>
<td>
Specify a class to use as the message holder for the compile process. The entry must be
a fully-qualified name of a class complying with the <code>org.aspectj.bridge.IMessageHolder</code>
interface and having a public no-argument constructor.
</td>
</tr>
</table>
</section>
</body>
</document>