@@ -124,7 +124,7 @@ outside of targets in the new project—but not those defined inside of targ | |||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>property</h4> | <h4>property</h4> | ||||
<p>See the description of the <a href="property.html">property</a> task.<br> These properties | |||||
<p>See the description of the <a href="property.html">property</a> task.<br/> These properties | |||||
become equivalent to properties you define on the command line. These are special properties and | become equivalent to properties you define on the command line. These are special properties and | ||||
they will always get passed down, even through additional <code><*ant*></code> tasks | they will always get passed down, even through additional <code><*ant*></code> tasks | ||||
with <var>inheritAll</var> set to <q>false</q> (see above).<br/> Note that the <var>refid</var> | with <var>inheritAll</var> set to <q>false</q> (see above).<br/> Note that the <var>refid</var> | ||||
@@ -100,7 +100,7 @@ the <var>id</var> attribute).</p> | |||||
<h3>Parameters specified as nested elements</h3> | <h3>Parameters specified as nested elements</h3> | ||||
<h4>param</h4> | <h4>param</h4> | ||||
<p>Specifies the properties to set before running the specified | <p>Specifies the properties to set before running the specified | ||||
target. See <a href="property.html">property</a> for usage guidelines.<br> These properties become | |||||
target. See <a href="property.html">property</a> for usage guidelines.<br/> These properties become | |||||
equivalent to properties you define on the command line. These are special properties and they will | equivalent to properties you define on the command line. These are special properties and they will | ||||
always get passed down, even through additional <code><*ant*></code> tasks | always get passed down, even through additional <code><*ant*></code> tasks | ||||
with <var>inheritAll</var> set to <q>false</q> (see above).</p> | with <var>inheritAll</var> set to <q>false</q> (see above).</p> | ||||
@@ -72,13 +72,14 @@ the <code>antlr-all.jar</code> target of the Makefile provided with the download | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>html</td> | <td>html</td> | ||||
<td>Emit an HTML version of the grammar with hyperlinked actions.</td> | |||||
<td>No</td> | |||||
<td>Emit an HTML version of the grammar with hyperlinked actions if set to <q>yes</q>.</td> | |||||
<td>No; default is <q>no</q></td> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>diagnostic</td> | <td>diagnostic</td> | ||||
<td>Generate a text file with debugging information based on the target grammar.</td> | |||||
<td>No</td> | |||||
<td>Generate a text file with debugging information based on the target grammar if set | |||||
to <q>yes</q>.</td> | |||||
<td>No; default is <q>no</q></td> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>trace</td> | <td>trace</td> | ||||
@@ -72,7 +72,7 @@ standard input.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>spawn</td> | <td>spawn</td> | ||||
<td>whether or not you want the commands to be spawned.<br> If you spawn a command, its output | |||||
<td>whether or not you want the commands to be spawned.<br/> If you spawn a command, its output | |||||
will not be logged by Ant.<br/> The input, output, error, and result property settings are not | will not be logged by Ant.<br/> The input, output, error, and result property settings are not | ||||
active when spawning a process.<br/> <em>since Ant 1.6</em></td> | active when spawning a process.<br/> <em>since Ant 1.6</em></td> | ||||
<td>No; default is <q>false</q></td> | <td>No; default is <q>false</q></td> | ||||
@@ -175,8 +175,8 @@ standard input.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failonerror</td> | <td>failonerror</td> | ||||
<td>Stop the build process if the command exits with a return code other than 0.</td> | |||||
<td>No</td> | |||||
<td>Stop the build process if the command exits with a return code other than <q>0</q>.</td> | |||||
<td>No; defaults to <q>false</q></td> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failifexecutionfails</td> | <td>failifexecutionfails</td> | ||||
@@ -200,7 +200,7 @@ standard input.</p> | |||||
<td>type</td> | <td>type</td> | ||||
<td>One of <q>file</q>, <q>dir</q> or <q>both</q>. If set to <q>file</q>, only the names of | <td>One of <q>file</q>, <q>dir</q> or <q>both</q>. If set to <q>file</q>, only the names of | ||||
plain files will be sent to the command. If set to <q>dir</q>, only the names of directories | plain files will be sent to the command. If set to <q>dir</q>, only the names of directories | ||||
are considered.<br> | |||||
are considered.<br/> | |||||
<strong>Note</strong>: The <var>type</var> attribute does not apply to | <strong>Note</strong>: The <var>type</var> attribute does not apply to | ||||
nested <code>dirset</code>s—<code>dirset</code>s always implicitly assume type to | nested <code>dirset</code>s—<code>dirset</code>s always implicitly assume type to | ||||
be <q>dir</q>.</td> | be <q>dir</q>.</td> | ||||
@@ -74,8 +74,7 @@ operation may fail when using such an incompatible client.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failonerror</td> | <td>failonerror</td> | ||||
<td>Stop the build process if the command exits with a return code other | |||||
than <code>0</code></td> | |||||
<td>Stop the build process if the command exits with a return code other than <q>0</q></td> | |||||
<td>No; defaults to <q>false</q></td> | <td>No; defaults to <q>false</q></td> | ||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
@@ -92,7 +92,7 @@ Architecture Standard Algorithm Name Documentation</a></p> | |||||
the <var>verifyproperty</var> attribute, property specifies the name of the property to be set | the <var>verifyproperty</var> attribute, property specifies the name of the property to be set | ||||
with the generated checksum value.<br/><strong>If you set</strong> | with the generated checksum value.<br/><strong>If you set</strong> | ||||
the <var>verifyproperty</var> attribute, property specifies the checksum you expect to be | the <var>verifyproperty</var> attribute, property specifies the checksum you expect to be | ||||
generated (the checksum itself, not a name of a property containing the checksum).<br> This | |||||
generated (the checksum itself, not a name of a property containing the checksum).<br/> This | |||||
cannot be specified when <var>fileext</var> is being used or when the number of files for | cannot be specified when <var>fileext</var> is being used or when the number of files for | ||||
which checksums are to be generated is greater than 1. | which checksums are to be generated is greater than 1. | ||||
</td> | </td> | ||||
@@ -24,10 +24,10 @@ | |||||
<body> | <body> | ||||
<h1>Apache Ant ClearCase Tasks</h1> | <h1>Apache Ant ClearCase Tasks</h1> | ||||
<p>by:<br> | |||||
Curtis White (cwhite at aracnet dot com),<br> | |||||
Sean P. Kane (spkane at genomatica dot com),<br> | |||||
Rob Anderson (Anderson.Rob at vectorscm dot com), and<br> | |||||
<p>by:<br/> | |||||
Curtis White (cwhite at aracnet dot com),<br/> | |||||
Sean P. Kane (spkane at genomatica dot com),<br/> | |||||
Rob Anderson (Anderson.Rob at vectorscm dot com), and<br/> | |||||
Sean Egan (sean at cm-logic dot com)</p> | Sean Egan (sean at cm-logic dot com)</p> | ||||
<p>Version 1.6—02/25/2003</p> | <p>Version 1.6—02/25/2003</p> | ||||
@@ -189,12 +189,11 @@ original.</p> | |||||
<td>notco</td> | <td>notco</td> | ||||
<td>Fail if it's already checked out to the current view. Set to <q>false</q> to ignore | <td>Fail if it's already checked out to the current view. Set to <q>false</q> to ignore | ||||
it.<br/><em>Since Ant 1.6.1</em></td> | it.<br/><em>Since Ant 1.6.1</em></td> | ||||
<td>No</td> | |||||
<td>No; default is <q>true</q></td> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failonerr</td> | <td>failonerr</td> | ||||
<td>Throw an exception if the command fails.<br> | |||||
<em>Since Ant 1.6.1</em></td> | |||||
<td>Throw an exception if the command fails.<br/><em>Since Ant 1.6.1</em></td> | |||||
<td>No; default is <q>true</q></td> | <td>No; default is <q>true</q></td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
@@ -375,8 +374,7 @@ set to the current time.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failonerr</td> | <td>failonerr</td> | ||||
<td>Throw an exception if the command fails.<br> | |||||
<em>Since Ant 1.6.1</em></td> | |||||
<td>Throw an exception if the command fails.<br/><em>Since Ant 1.6.1</em></td> | |||||
<td>No; default is <q>true</q></td> | <td>No; default is <q>true</q></td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
@@ -845,8 +843,8 @@ automatically check it out.</p> | |||||
<h2 id="ccmkelem">CCMkelem</h2> | <h2 id="ccmkelem">CCMkelem</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
Task to perform a <code>cleartool mkelem</code> command to ClearCase.<br> | |||||
<em>Since Ant 1.6.1</em> | |||||
<p>Task to perform a <code>cleartool mkelem</code> command to ClearCase.<br/><em>Since Ant | |||||
1.6.1</em></p> | |||||
<h3>Parameters</h3> | <h3>Parameters</h3> | ||||
<table class="attr"> | <table class="attr"> | ||||
<tr> | <tr> | ||||
@@ -107,8 +107,8 @@ for recommended workarounds.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>reallyquiet</td> | <td>reallyquiet</td> | ||||
<td>suppress all messages. This is the same as | |||||
<code>-Q</code> on the command line. <em>since Ant 1.6</em>.</td> | |||||
<td>suppress all messages. This is the same as <code>-Q</code> on the command line. <em>since | |||||
Ant 1.6</em>.</td> | |||||
<td>No; defaults to <q>false</q></td> | <td>No; defaults to <q>false</q></td> | ||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
@@ -143,8 +143,7 @@ for recommended workarounds.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failonerror</td> | <td>failonerror</td> | ||||
<td>Stop the build process if the command exits with a return code other | |||||
than <code>0</code>.</td> | |||||
<td>Stop the build process if the command exits with a return code other than <q>0</q>.</td> | |||||
<td>No; defaults to <q>false</q></td> | <td>No; defaults to <q>false</q></td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
@@ -121,7 +121,7 @@ example—and some operation may fail when using such an incompatible client | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failonerror</td> | <td>failonerror</td> | ||||
<td>Stop the build process if the command exits with a return code other than 0.</td> | |||||
<td>Stop the build process if the command exits with a return code other than <q>0</q>.</td> | |||||
<td>No; defaults to <q>false</q></td> | <td>No; defaults to <q>false</q></td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
@@ -196,7 +196,7 @@ output. The following example illustrates how to generate a HTML report from the | |||||
<h4>Output</h4> | <h4>Output</h4> | ||||
<p>The <var>cvsroot</var> and <var>package</var> attributes of the <code>tagdiff</code> element are | <p>The <var>cvsroot</var> and <var>package</var> attributes of the <code>tagdiff</code> element are | ||||
new in Ant 1.6.<br> Notes on <code>entry</code> attributes:</p> | |||||
new in Ant 1.6.<br/> Notes on <code>entry</code> attributes:</p> | |||||
<table> | <table> | ||||
<tr> | <tr> | ||||
<th>Attribute</th> | <th>Attribute</th> | ||||
@@ -774,7 +774,7 @@ vendor's EJB container. The parameters for each supported deployment element are | |||||
them to the final EJB jar file. JBoss has two deployment descriptors:</p> | them to the final EJB jar file. JBoss has two deployment descriptors:</p> | ||||
<ul> | <ul> | ||||
<li><samp>jboss.xml</samp></li> | <li><samp>jboss.xml</samp></li> | ||||
<li>for container manager persistence:<br> | |||||
<li>for container manager persistence: | |||||
<table> | <table> | ||||
<tr><th>CMP version</th><th>File name</th></tr> | <tr><th>CMP version</th><th>File name</th></tr> | ||||
<tr><td>CMP 1.0</td><td><samp>jaws.xml</samp></td></tr> | <tr><td>CMP 1.0</td><td><samp>jaws.xml</samp></td></tr> | ||||
@@ -1193,7 +1193,7 @@ the <code>websphere.home</code> property (look at the examples below).</p> | |||||
<td>No; defaults to <q>_ejbdeploy_temp</q></td> | <td>No; defaults to <q>_ejbdeploy_temp</q></td> | ||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>dbName<br>dbSchema</td> | |||||
<td>dbName<br/>dbSchema</td> | |||||
<td>These options are passed to <code>ejbdeploy</code>.</td> | <td>These options are passed to <code>ejbdeploy</code>.</td> | ||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
@@ -68,7 +68,7 @@ the element.</p> | |||||
<p>As an alternative to the <var>if</var>/<var>unless</var> attributes, conditional failure can be | <p>As an alternative to the <var>if</var>/<var>unless</var> attributes, conditional failure can be | ||||
achieved using a single nested <code><condition></code> element, which should contain exactly | achieved using a single nested <code><condition></code> element, which should contain exactly | ||||
one core or custom condition. For information about conditions, | one core or custom condition. For information about conditions, | ||||
see <a href="conditions.html">here</a>.<br><em>Since Ant 1.6.2</em> | |||||
see <a href="conditions.html">here</a>.<br/><em>Since Ant 1.6.2</em> | |||||
</p> | </p> | ||||
<h3>Examples</h3> | <h3>Examples</h3> | ||||
@@ -325,7 +325,7 @@ connection.</p> | |||||
Icelandic FTP server might conceivably be specified | Icelandic FTP server might conceivably be specified | ||||
as <q>jan|feb|mar|apr|maí|jún|júl|ágú|sep|okt|nóv|des</q>. | as <q>jan|feb|mar|apr|maí|jún|júl|ágú|sep|okt|nóv|des</q>. | ||||
This attribute exists primarily to support languages not supported by | This attribute exists primarily to support languages not supported by | ||||
the <var>serverLanguageCode</var> attribute.<br><em>Since Ant 1.7</em></td> | |||||
the <var>serverLanguageCode</var> attribute.<br/><em>Since Ant 1.7</em></td> | |||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
@@ -358,8 +358,7 @@ connection.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td><q>list</q></td> | <td><q>list</q></td> | ||||
<td>base directory from which files are listed<br> | |||||
</td> | |||||
<td>base directory from which files are listed</td> | |||||
<td>the remote files located under the <var>remotedir</var> matching the include/exclude | <td>the remote files located under the <var>remotedir</var> matching the include/exclude | ||||
patterns of the <var>fileset</var></td> | patterns of the <var>fileset</var></td> | ||||
</tr> | </tr> | ||||
@@ -523,7 +523,7 @@ JDK 6 scripting interface:</p> | |||||
<p>Here we want to create a <em>Multi-Release JAR File</em> according the | <p>Here we want to create a <em>Multi-Release JAR File</em> according the | ||||
specification <a target="_blank" href="http://openjdk.java.net/jeps/238">JEP 238</a>. It defines on | specification <a target="_blank" href="http://openjdk.java.net/jeps/238">JEP 238</a>. It defines on | ||||
top of a JAR the possibility to place additional or overwriting classes in a jar, which are | top of a JAR the possibility to place additional or overwriting classes in a jar, which are | ||||
available according to the Java version you run.<br> Basically it says, that you have to set the | |||||
available according to the Java version you run.<br/> Basically it says, that you have to set the | |||||
manifest entry <code>Multi-Release: true</code> and place all additional or overwriting classes | manifest entry <code>Multi-Release: true</code> and place all additional or overwriting classes | ||||
in <samp>META-INF/versions/<i>number</i>/package-structure</samp>, | in <samp>META-INF/versions/<i>number</i>/package-structure</samp>, | ||||
e.g. <samp>META-INF/versions/9/org/apache/ant/MyClass.class</samp></p> | e.g. <samp>META-INF/versions/9/org/apache/ant/MyClass.class</samp></p> | ||||
@@ -129,7 +129,7 @@ because it tries to read from the standard input.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failonerror</td> | <td>failonerror</td> | ||||
<td>Stop the build process if the command exits with a return code other than 0.</td> | |||||
<td>Stop the build process if the command exits with a return code other than <q>0</q>.</td> | |||||
<td>No; default is <q>false</q> (see <a href="#failonerror">note</a>)</td> | <td>No; default is <q>false</q> (see <a href="#failonerror">note</a>)</td> | ||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
@@ -294,7 +294,7 @@ file will not get compiled even if a native header file generated for it would b | |||||
command-line switch. Valid feature versions are <q>1.3</q>, <q>1.4</q>, <q>1.5</q> | command-line switch. Valid feature versions are <q>1.3</q>, <q>1.4</q>, <q>1.5</q> | ||||
or <q>5</q>, etc. The attribute will be ignored by all implementations prior | or <q>5</q>, etc. The attribute will be ignored by all implementations prior | ||||
to <q>javac1.4</q> (or <q>modern</q> when Ant is not running in a JVM 1.3), <q>gcj</q> | to <q>javac1.4</q> (or <q>modern</q> when Ant is not running in a JVM 1.3), <q>gcj</q> | ||||
and <q>jikes</q>.<br> If you use this attribute together with <q>gcj</q> or <q>jikes</q>, you | |||||
and <q>jikes</q>.<br/> If you use this attribute together with <q>gcj</q> or <q>jikes</q>, you | |||||
must make sure that your version supports the <code>-source</code> (or <code>-fsource</code> | must make sure that your version supports the <code>-source</code> (or <code>-fsource</code> | ||||
for <code>gcj</code>) switch.</td> | for <code>gcj</code>) switch.</td> | ||||
<td>No; by default, no <code>-source</code> argument will be used at all unless the magic | <td>No; by default, no <code>-source</code> argument will be used at all unless the magic | ||||
@@ -694,8 +694,8 @@ are <q>false</q>.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td><code>build.compiler.fulldepend</code></td> | <td><code>build.compiler.fulldepend</code></td> | ||||
<td>Enable full dependency checking; see<br> the <code>+F</code> switch in the Jikes | |||||
manual.</td> | |||||
<td>Enable full dependency checking; see<br/> the <code>+F</code> switch in the Jikes | |||||
manual.</td> | |||||
<td><q>false</q></td> | <td><q>false</q></td> | ||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
@@ -398,7 +398,7 @@ with the <var>exclude</var> patterns of the <code>packageset</code> (and vice ve | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failonerror</td> | <td>failonerror</td> | ||||
<td>Stop the build process if the command exits with a return code other than 0.</td> | |||||
<td>Stop the build process if the command exits with a return code other than <q>0</q>.</td> | |||||
<td>all</td> | <td>all</td> | ||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
@@ -490,7 +490,7 @@ with the <var>exclude</var> patterns of the <code>packageset</code> (and vice ve | |||||
<tr> | <tr> | ||||
<td>postProcessGeneratedJavadocs</td> | <td>postProcessGeneratedJavadocs</td> | ||||
<td>Whether to post-process the generated javadocs in order to mitigate | <td>Whether to post-process the generated javadocs in order to mitigate | ||||
CVE-2013-1571. <em>Since Ant 1.9.2</em><br> There is a frame injection attack possible in | |||||
CVE-2013-1571. <em>Since Ant 1.9.2</em><br/> There is a frame injection attack possible in | |||||
javadocs generated by Oracle JDKs prior to Java 7 update 25 | javadocs generated by Oracle JDKs prior to Java 7 update 25 | ||||
(<a href="https://www.oracle.com/technetwork/java/javase/7u25-relnotes-1955741.html#jpi-upt" | (<a href="https://www.oracle.com/technetwork/java/javase/7u25-relnotes-1955741.html#jpi-upt" | ||||
target="_blank">details</a>). When this flag is set to <q>true</q>, Ant will check whether | target="_blank">details</a>). When this flag is set to <q>true</q>, Ant will check whether | ||||
@@ -148,7 +148,7 @@ more information.</p> | |||||
<tr> | <tr> | ||||
<td>charset</td> | <td>charset</td> | ||||
<td>Character set of the email.<br/>You can also set the <var>charset</var> in | <td>Character set of the email.<br/>You can also set the <var>charset</var> in | ||||
the <code>message</code> nested element.<br> These options are mutually exclusive.</td> | |||||
the <code>message</code> nested element.<br/> These options are mutually exclusive.</td> | |||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
@@ -230,7 +230,7 @@ can contain email addresses of the form:</p> | |||||
<tr> | <tr> | ||||
<td>charset</td> | <td>charset</td> | ||||
<td>Character set of the message<br/>You can also set the <var>charset</var> as attribute of the | <td>Character set of the message<br/>You can also set the <var>charset</var> as attribute of the | ||||
enclosing <code>mail</code> task.<br> These options are mutually exclusive.</td> | |||||
enclosing <code>mail</code> task.<br/> These options are mutually exclusive.</td> | |||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
@@ -50,7 +50,7 @@ nested <code><include></code>, <code><exclude></code> | |||||
and <code><patternset></code> elements.</p> | and <code><patternset></code> elements.</p> | ||||
<p>All attributes except <var>classpath</var>, <var>srcdir</var> and <var>destDir</var> are also | <p>All attributes except <var>classpath</var>, <var>srcdir</var> and <var>destDir</var> are also | ||||
available as properties in the form <code>ant.netrexxc.<i>attributename</i></code>, | available as properties in the form <code>ant.netrexxc.<i>attributename</i></code>, | ||||
eg.<br/><code><property name="ant.netrexxc.verbose" value="noverbose"/></code><br> or from the | |||||
eg.<br/><code><property name="ant.netrexxc.verbose" value="noverbose"/></code><br/> or from the | |||||
command line as<br/><code>ant -Dant.netrexxc.verbose=noverbose ...</code></p> | command line as<br/><code>ant -Dant.netrexxc.verbose=noverbose ...</code></p> | ||||
<p><strong>Note</strong>: This task depends on external libraries not included in the Apache Ant | <p><strong>Note</strong>: This task depends on external libraries not included in the Apache Ant | ||||
distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> for more | distribution. See <a href="../install.html#librarydependencies">Library Dependencies</a> for more | ||||
@@ -61,14 +61,14 @@ the <a href="../Types/regexp.html#implementation">Regexp Type</a>.</p> | |||||
<tr> | <tr> | ||||
<td>flags</td> | <td>flags</td> | ||||
<td>The flags to use when matching the regular expression. For more information, consult the | <td>The flags to use when matching the regular expression. For more information, consult the | ||||
Perl 5 syntax<br> | |||||
<q>g</q> : Global replacement. Replace all occurrences found<br> | |||||
<q>i</q> : Case Insensitive. Do not consider case in the match<br> | |||||
Perl 5 syntax<br/> | |||||
<q>g</q> : Global replacement. Replace all occurrences found<br/> | |||||
<q>i</q> : Case Insensitive. Do not consider case in the match<br/> | |||||
<q>m</q> : Multiline. Treat the string as multiple lines of input, using <q>^</q> | <q>m</q> : Multiline. Treat the string as multiple lines of input, using <q>^</q> | ||||
and <q>$</q> as the start or end of any line, respectively, rather than start or end of | and <q>$</q> as the start or end of any line, respectively, rather than start or end of | ||||
string.<br> | |||||
string.<br/> | |||||
<q>s</q> : Singleline. Treat the string as a single line of input, using <q>.</q> to match | <q>s</q> : Singleline. Treat the string as a single line of input, using <q>.</q> to match | ||||
any character, including a newline, which normally, it would not match.<br> | |||||
any character, including a newline, which normally, it would not match. | |||||
</td> | </td> | ||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
@@ -118,7 +118,7 @@ pattern. You can use this element to refer to a previously defined substitution | |||||
instance.</p> | instance.</p> | ||||
<pre> | <pre> | ||||
<substitution id="id" expression="beta\1alpha"/><br> | |||||
<substitution id="id" expression="beta\1alpha"/><br/> | |||||
<substitution refid="id"/></pre> | <substitution refid="id"/></pre> | ||||
<h3>Examples</h3> | <h3>Examples</h3> | ||||
@@ -151,7 +151,7 @@ input</p> | |||||
<html> <body> | <html> <body> | ||||
<h1> T E S T </h1> </body></html></pre> | <h1> T E S T </h1> </body></html></pre> | ||||
<br><!-- small distance from code of the previous example --> | |||||
<br/><!-- small distance from code of the previous example --> | |||||
<pre> | <pre> | ||||
<replaceregexp match="\\n" replace="${line.separator}" flags="g" byline="true"> | <replaceregexp match="\\n" replace="${line.separator}" flags="g" byline="true"> | ||||
@@ -107,7 +107,7 @@ documentation to learn how to use it.</p> | |||||
<td>stubversion</td> | <td>stubversion</td> | ||||
<td>Specify the JDK version for the generated stub code. Specify <q>1.1</q> to pass | <td>Specify the JDK version for the generated stub code. Specify <q>1.1</q> to pass | ||||
the <code>-v1.1</code> option to <code>rmic</code>, <q>1.2</q> | the <code>-v1.1</code> option to <code>rmic</code>, <q>1.2</q> | ||||
for <code>-v12</code>, <q>compat</q> for <code>-vcompat</code>.<br>/<em>Since Ant 1.7</em>, if | |||||
for <code>-v12</code>, <q>compat</q> for <code>-vcompat</code>.<br/><em>Since Ant 1.7</em>, if | |||||
you do not specify a version, and do not ask for <samp>.iiop</samp> or <samp>.idl</samp> | you do not specify a version, and do not ask for <samp>.iiop</samp> or <samp>.idl</samp> | ||||
files, <q>compat</q> is selected.</td> | files, <q>compat</q> is selected.</td> | ||||
<td>No; default is <q>compat</q></td> | <td>No; default is <q>compat</q></td> | ||||
@@ -48,7 +48,7 @@ with <code>rpm</code> support.</p> | |||||
<td>This is the directory which will have the expected | <td>This is the directory which will have the expected | ||||
subdirectories, <samp>SPECS</samp>, <samp>SOURCES</samp>, <samp>BUILD</samp>, <samp>SRPMS</samp>. | subdirectories, <samp>SPECS</samp>, <samp>SOURCES</samp>, <samp>BUILD</samp>, <samp>SRPMS</samp>. | ||||
If this isn't specified, the default RPM directory of the system (or user, | If this isn't specified, the default RPM directory of the system (or user, | ||||
if <samp>~/.rpmmacros</samp> defines it) is used (often <samp>/usr/src/rpm</samp>.<br> | |||||
if <samp>~/.rpmmacros</samp> defines it) is used (often <samp>/usr/src/rpm</samp>.<br/> | |||||
Defining a <var>topdir</var> will set <code>%_topdir</code> to the specified | Defining a <var>topdir</var> will set <code>%_topdir</code> to the specified | ||||
directory—there is no need to edit your <samp>.rpmmacros</samp> file.</td> | directory—there is no need to edit your <samp>.rpmmacros</samp> file.</td> | ||||
<td>No, but your build file is very brittle if it is not set.</td> | <td>No, but your build file is very brittle if it is not set.</td> | ||||
@@ -71,7 +71,7 @@ their URL equivalents.</p> | |||||
<tr> | <tr> | ||||
<td>classpathref</td> | <td>classpathref</td> | ||||
<td>where to find the parser class. Optionally can use an | <td>where to find the parser class. Optionally can use an | ||||
embedded <code><classpath></code> element.</td> | |||||
embedded <code><classpath></code> element.</td> | |||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
@@ -82,8 +82,8 @@ their URL equivalents.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>failonerror</td> | <td>failonerror</td> | ||||
<td>fails on a error if set to <q>true</q> (defaults to <q>true</q>).</td> | |||||
<td>No</td> | |||||
<td>fails on a error if set to <q>true</q>.</td> | |||||
<td>No; defaults to <q>true</q></td> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>file</td> | <td>file</td> | ||||
@@ -167,9 +167,9 @@ their URL equivalents.</p> | |||||
<p>The <a href="../Types/xmlcatalog.html"><code><xmlcatalog></code></a> element is used to | <p>The <a href="../Types/xmlcatalog.html"><code><xmlcatalog></code></a> element is used to | ||||
perform entity resolution.</p> | perform entity resolution.</p> | ||||
<h4>attribute</h4> | <h4>attribute</h4> | ||||
<p>The <code><attribute></code> element is used to set parser features.<br>Features usable | |||||
<p>The <code><attribute></code> element is used to set parser features.<br/>Features usable | |||||
with the xerces parser are defined | with the xerces parser are defined | ||||
here: <a href="https://xml.apache.org/xerces-j/features.html">Setting features</a><br>SAX features | |||||
here: <a href="https://xml.apache.org/xerces-j/features.html">Setting features</a><br/>SAX features | |||||
are defined | are defined | ||||
here: <a href="http://www.saxproject.org/apidoc/org/xml/sax/package-summary.html#package_description"><code>http://xml.org/sax/features/</code></a></p> | here: <a href="http://www.saxproject.org/apidoc/org/xml/sax/package-summary.html#package_description"><code>http://xml.org/sax/features/</code></a></p> | ||||
<table class="attr"> | <table class="attr"> | ||||
@@ -41,7 +41,7 @@ either their <var>name</var> or <var>id</var> attributes (as long as their names | |||||
valid Java identifiers, that is). This is controlled by the <var>setbeans</var> attribute of the | valid Java identifiers, that is). This is controlled by the <var>setbeans</var> attribute of the | ||||
task. The name <code>project</code> is a pre-defined reference to the Project, which can be used | task. The name <code>project</code> is a pre-defined reference to the Project, which can be used | ||||
instead of the project name. The name <code>self</code> is a pre-defined reference to the | instead of the project name. The name <code>self</code> is a pre-defined reference to the | ||||
actual <code><script></code>-Task instance.<br>From these objects you have access to the Ant | |||||
actual <code><script></code>-Task instance.<br/>From these objects you have access to the Ant | |||||
Java API, see the <a href="../api/index.html">JavaDoc</a> (especially | Java API, see the <a href="../api/index.html">JavaDoc</a> (especially | ||||
for <a href="../api/org/apache/tools/ant/Project.html">Project</a> | for <a href="../api/org/apache/tools/ant/Project.html">Project</a> | ||||
and <a href="../api/org/apache/tools/ant/taskdefs/optional/Script.html">Script</a>) for more | and <a href="../api/org/apache/tools/ant/taskdefs/optional/Script.html">Script</a>) for more | ||||
@@ -272,11 +272,11 @@ be imported | |||||
with <code>importClass(<strong>Packages</strong>.org.apache.tools.ant.util.FileUtils)</code><br/> | with <code>importClass(<strong>Packages</strong>.org.apache.tools.ant.util.FileUtils)</code><br/> | ||||
The <code><script></code> task populates the Project instance under the | The <code><script></code> task populates the Project instance under the | ||||
name <code>project</code>, so we can use that reference. Another way is to use its given name or | name <code>project</code>, so we can use that reference. Another way is to use its given name or | ||||
getting its reference from the task itself.<br> The Project provides methods for accessing and | |||||
setting properties, creating DataTypes and Tasks and much more.<br> After creating a FileSet object | |||||
getting its reference from the task itself.<br/> The Project provides methods for accessing and | |||||
setting properties, creating DataTypes and Tasks and much more.<br/> After creating a FileSet object | |||||
we initialize that by calling its set-methods. Then we can use that object like a normal Ant task | we initialize that by calling its set-methods. Then we can use that object like a normal Ant task | ||||
(<code><copy></code> for example).<br> For getting the size of a file we instantiate | |||||
a <code>java.io.File</code>. So we are using normal Java API here.<br> Finally we use | |||||
(<code><copy></code> for example).<br/> For getting the size of a file we instantiate | |||||
a <code>java.io.File</code>. So we are using normal Java API here.<br/> Finally we use | |||||
the <code><echo></code> task for producing the output. The task is not executed by | the <code><echo></code> task for producing the output. The task is not executed by | ||||
its <code>execute()</code> method, because the <code>perform()</code> method (implemented in Task | its <code>execute()</code> method, because the <code>perform()</code> method (implemented in Task | ||||
itself) does the appropriate logging before and after invoking <code>execute()</code>.</p> | itself) does the appropriate logging before and after invoking <code>execute()</code>.</p> | ||||
@@ -62,7 +62,7 @@ and <code><fail></code> elements:</p> | |||||
<tr> | <tr> | ||||
<td>loops</td> | <td>loops</td> | ||||
<td>the number of extra times to play the sound file.</td> | <td>the number of extra times to play the sound file.</td> | ||||
<td>No; default is <code>0</code></td> | |||||
<td>No; default is <q>0</q></td> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>duration</td> | <td>duration</td> | ||||
@@ -73,7 +73,7 @@ JSCh earlier than 0.1.28.</p> | |||||
<tr> | <tr> | ||||
<td>remotetunnels</td> | <td>remotetunnels</td> | ||||
<td>A comma-delimited list of colon-delimited <samp>rport:lhost:lport</samp> triplets defining | <td>A comma-delimited list of colon-delimited <samp>rport:lhost:lport</samp> triplets defining | ||||
remote port forwarding.<br> If nested <a href="#RemoteTunnel">remotetunnel</a> elements are | |||||
remote port forwarding.<br/> If nested <a href="#RemoteTunnel">remotetunnel</a> elements are | |||||
also provided, both sets of tunnels will be established.</td> | also provided, both sets of tunnels will be established.</td> | ||||
<td>No</td> | <td>No</td> | ||||
</tr> | </tr> | ||||
@@ -219,8 +219,8 @@ path-like structure).</p> | |||||
<tr> | <tr> | ||||
<td>failOnError</td> | <td>failOnError</td> | ||||
<td>Whether the build should fail if any error occurs. Note that transformation errors can | <td>Whether the build should fail if any error occurs. Note that transformation errors can | ||||
still be suppressed by setting <q>failOnTransformationError</q> to <q>false</q> even if this | |||||
attribute is <q>true</q>. <em>Since Ant 1.8.0</em>.</td> | |||||
still be suppressed by setting <var>failOnTransformationError</var> to <q>false</q> even if | |||||
this attribute is <q>true</q>. <em>Since Ant 1.8.0</em>.</td> | |||||
<td>No; default is <q>true</q></td> | <td>No; default is <q>true</q></td> | ||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
@@ -77,8 +77,8 @@ directories. 2 different options are offered:</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>genericantfile</td> | <td>genericantfile</td> | ||||
<td>Build file path, to use in conjunction with directories.<br> Use <var>genericantfile</var>, | |||||
in order to run the same build file with different <var>basedir</var>s.<br> If this attribute | |||||
<td>Build file path, to use in conjunction with directories.<br/> Use <var>genericantfile</var>, | |||||
in order to run the same build file with different <var>basedir</var>s.<br/> If this attribute | |||||
is set, <var>antfile</var> is ignored.</td> | is set, <var>antfile</var> is ignored.</td> | ||||
<td class="left">File</td> | <td class="left">File</td> | ||||
</tr> | </tr> | ||||
@@ -74,7 +74,7 @@ set of property files to create links from.</p> | |||||
<tr> | <tr> | ||||
<td>failonerror</td> | <td>failonerror</td> | ||||
<td>Stop build if true, log a warning message, but do not stop the build, when the an error | <td>Stop build if true, log a warning message, but do not stop the build, when the an error | ||||
occurs if false.</td> | |||||
occurs if <q>false</q>.</td> | |||||
<td>No; defaults to <q>true</q></td> | <td>No; defaults to <q>true</q></td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
@@ -81,7 +81,7 @@ extract an Ant generated ZIP archive.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>compression</td> | <td>compression</td> | ||||
<td><strong>Note</strong>: This attribute is only available for the <code>untar</code> task.<br> | |||||
<td><strong>Note</strong>: This attribute is only available for the <code>untar</code> task.<br/> | |||||
compression method. Allowable values are <q>none</q>, <q>gzip</q>, <q>xz</q> | compression method. Allowable values are <q>none</q>, <q>gzip</q>, <q>xz</q> | ||||
and <q>bzip2</q>.</td> | and <q>bzip2</q>.</td> | ||||
<td>No; default is <q>none</q></td> | <td>No; default is <q>none</q></td> | ||||
@@ -112,7 +112,7 @@ extract an Ant generated ZIP archive.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>scanForUnicodeExtraFields</td> | <td>scanForUnicodeExtraFields</td> | ||||
<td><strong>Note</strong>: This attribute is not available for the <code>untar</code> task.<br> | |||||
<td><strong>Note</strong>: This attribute is not available for the <code>untar</code> task.<br/> | |||||
If the archive contains Unicode extra fields then use them to set the file names, ignoring the | If the archive contains Unicode extra fields then use them to set the file names, ignoring the | ||||
specified encoding. <br/>See also the <a href="zip.html#encoding">discussion in the zip task | specified encoding. <br/>See also the <a href="zip.html#encoding">discussion in the zip task | ||||
page</a></td> | page</a></td> | ||||
@@ -127,7 +127,7 @@ the input XML file is loaded:/p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>delimiter</td> | <td>delimiter</td> | ||||
<td>Delimiter for splitting multiple values.<br><em>since Apache Ant 1.7.1</em></td> | |||||
<td>Delimiter for splitting multiple values.<br/><em>since Apache Ant 1.7.1</em></td> | |||||
<td>No; defaults to <q>,</q> (comma)</td> | <td>No; defaults to <q>,</q> (comma)</td> | ||||
</tr> | </tr> | ||||
</table> | </table> | ||||
@@ -82,34 +82,34 @@ also.</p> | |||||
</filterchain> | </filterchain> | ||||
</loadfile></pre> | </loadfile></pre> | ||||
<p>The following built-in tasks support nested <code><filterchain></code> elements.<br> | |||||
<a href="../Tasks/concat.html">Concat</a>,<br> | |||||
<a href="../Tasks/copy.html">Copy</a>,<br> | |||||
<a href="../Tasks/loadfile.html">LoadFile</a>,<br> | |||||
<a href="../Tasks/loadproperties.html">LoadProperties</a>,<br> | |||||
<a href="../Tasks/loadresource.html">LoadResource</a>,<br> | |||||
<p>The following built-in tasks support nested <code><filterchain></code> elements.<br/> | |||||
<a href="../Tasks/concat.html">Concat</a>,<br/> | |||||
<a href="../Tasks/copy.html">Copy</a>,<br/> | |||||
<a href="../Tasks/loadfile.html">LoadFile</a>,<br/> | |||||
<a href="../Tasks/loadproperties.html">LoadProperties</a>,<br/> | |||||
<a href="../Tasks/loadresource.html">LoadResource</a>,<br/> | |||||
<a href="../Tasks/move.html">Move</a></p> | <a href="../Tasks/move.html">Move</a></p> | ||||
<p>A FilterChain is formed by defining zero or more of the following nested elements.<br> | |||||
<a href="#filterreader">FilterReader</a><br> | |||||
<a href="#classconstants">ClassConstants</a><br> | |||||
<a href="#escapeunicode">EscapeUnicode</a><br> | |||||
<a href="#expandproperties">ExpandProperties</a><br> | |||||
<a href="#headfilter">HeadFilter</a><br> | |||||
<a href="#linecontains">LineContains</a><br> | |||||
<a href="#linecontainsregexp">LineContainsRegExp</a><br> | |||||
<a href="#prefixlines">PrefixLines</a><br> | |||||
<a href="#replacetokens">ReplaceTokens</a><br> | |||||
<a href="#stripjavacomments">StripJavaComments</a><br> | |||||
<a href="#striplinebreaks">StripLineBreaks</a><br> | |||||
<a href="#striplinecomments">StripLineComments</a><br> | |||||
<a href="#suffixlines">SuffixLines</a><br> | |||||
<a href="#tabstospaces">TabsToSpaces</a><br> | |||||
<a href="#tailfilter">TailFilter</a><br> | |||||
<a href="#deletecharacters">DeleteCharacters</a><br> | |||||
<a href="#concatfilter">ConcatFilter</a><br> | |||||
<a href="#sortfilter">SortFilter</a><br> | |||||
<a href="#tokenfilter">TokenFilter</a><br> | |||||
<p>A FilterChain is formed by defining zero or more of the following nested elements.<br/> | |||||
<a href="#filterreader">FilterReader</a><br/> | |||||
<a href="#classconstants">ClassConstants</a><br/> | |||||
<a href="#escapeunicode">EscapeUnicode</a><br/> | |||||
<a href="#expandproperties">ExpandProperties</a><br/> | |||||
<a href="#headfilter">HeadFilter</a><br/> | |||||
<a href="#linecontains">LineContains</a><br/> | |||||
<a href="#linecontainsregexp">LineContainsRegExp</a><br/> | |||||
<a href="#prefixlines">PrefixLines</a><br/> | |||||
<a href="#replacetokens">ReplaceTokens</a><br/> | |||||
<a href="#stripjavacomments">StripJavaComments</a><br/> | |||||
<a href="#striplinebreaks">StripLineBreaks</a><br/> | |||||
<a href="#striplinecomments">StripLineComments</a><br/> | |||||
<a href="#suffixlines">SuffixLines</a><br/> | |||||
<a href="#tabstospaces">TabsToSpaces</a><br/> | |||||
<a href="#tailfilter">TailFilter</a><br/> | |||||
<a href="#deletecharacters">DeleteCharacters</a><br/> | |||||
<a href="#concatfilter">ConcatFilter</a><br/> | |||||
<a href="#sortfilter">SortFilter</a><br/> | |||||
<a href="#tokenfilter">TokenFilter</a><br/> | |||||
<a href="../Tasks/fixcrlf.html">FixCRLF</a></p> | <a href="../Tasks/fixcrlf.html">FixCRLF</a></p> | ||||
<h3 id="filterreader">FilterReader</h3> | <h3 id="filterreader">FilterReader</h3> | ||||
@@ -364,9 +364,8 @@ matching strings.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>regexp</td> | <td>regexp</td> | ||||
<td>Regular expression to be searched for.<br> | |||||
<em>Since Ant 1.10.2</em>, this also works as an attribute | |||||
on <code>linecontainsregexp</code>. In earlier versions of Ant you must use a nested | |||||
<td>Regular expression to be searched for.<br/><em>Since Ant 1.10.2</em>, this also works as an | |||||
attribute on <code>linecontainsregexp</code>. In earlier versions of Ant you must use a nested | |||||
element when using the convenience method. | element when using the convenience method. | ||||
</td> | </td> | ||||
<td>Yes</td> | <td>Yes</td> | ||||
@@ -1093,25 +1092,25 @@ following are understood: <q>\n</q>, <q>\r</q>, <q>\f</q>, <q>\t</q> and <q>\\</ | |||||
</table> | </table> | ||||
<p>The following tokenizers are provided by the default distribution.</p> | <p>The following tokenizers are provided by the default distribution.</p> | ||||
<p> | <p> | ||||
<a href="#linetokenizer">LineTokenizer</a><br> | |||||
<a href="#filetokenizer">FileTokenizer</a><br> | |||||
<a href="#stringtokenizer">StringTokenizer</a><br> | |||||
<a href="#linetokenizer">LineTokenizer</a><br/> | |||||
<a href="#filetokenizer">FileTokenizer</a><br/> | |||||
<a href="#stringtokenizer">StringTokenizer</a> | |||||
</p> | </p> | ||||
<p>The following string filters are provided by the default distribution.</p> | <p>The following string filters are provided by the default distribution.</p> | ||||
<p> | <p> | ||||
<a href="#replacestring">ReplaceString</a><br> | |||||
<a href="#containsstring">ContainsString</a><br> | |||||
<a href="#replaceregex">ReplaceRegex</a><br> | |||||
<a href="#containsregex">ContainsRegex</a><br> | |||||
<a href="#trim">Trim</a><br> | |||||
<a href="#ignoreblank">IgnoreBlank</a><br> | |||||
<a href="#filterdeletecharacters">DeleteCharacters</a><br> | |||||
<a href="#uniqfilter">UniqFilter</a><br> | |||||
<a href="#native2asciifilter">Native2AsciiFilter</a><br> | |||||
<a href="#replacestring">ReplaceString</a><br/> | |||||
<a href="#containsstring">ContainsString</a><br/> | |||||
<a href="#replaceregex">ReplaceRegex</a><br/> | |||||
<a href="#containsregex">ContainsRegex</a><br/> | |||||
<a href="#trim">Trim</a><br/> | |||||
<a href="#ignoreblank">IgnoreBlank</a><br/> | |||||
<a href="#filterdeletecharacters">DeleteCharacters</a><br/> | |||||
<a href="#uniqfilter">UniqFilter</a><br/> | |||||
<a href="#native2asciifilter">Native2AsciiFilter</a> | |||||
</p> | </p> | ||||
<p>The following string filters are provided by the optional distribution.</p> | <p>The following string filters are provided by the optional distribution.</p> | ||||
<p> | <p> | ||||
<a href="#scriptfilter">ScriptFilter</a><br> | |||||
<a href="#scriptfilter">ScriptFilter</a> | |||||
</p> | </p> | ||||
<p> | <p> | ||||
<a href="#custom">Custom</a> tokenizers and string filters can be declared | <a href="#custom">Custom</a> tokenizers and string filters can be declared | ||||
@@ -192,7 +192,7 @@ public class MySelectorTest { | |||||
<p>During development and maybe later you sometimes need the output of information. | <p>During development and maybe later you sometimes need the output of information. | ||||
Therefore Logging is needed. Because the selector extends BaseExtendSelector or directly | Therefore Logging is needed. Because the selector extends BaseExtendSelector or directly | ||||
BaseSelector it is an Ant <code>DataType</code> and therefore | BaseSelector it is an Ant <code>DataType</code> and therefore | ||||
a <code>ProjectComponent</code>.<br> That means that you have access to the project object | |||||
a <code>ProjectComponent</code>.<br/> That means that you have access to the project object | |||||
and its logging capability. <code>ProjectComponent</code> itself | and its logging capability. <code>ProjectComponent</code> itself | ||||
provides <code>log()</code> methods which will do the access to the project | provides <code>log()</code> methods which will do the access to the project | ||||
instance. Logging is therefore done simply with:</p> | instance. Logging is therefore done simply with:</p> | ||||
@@ -506,7 +506,7 @@ been configured.</p> | |||||
<h3>Example</h3> | <h3>Example</h3> | ||||
Writing an adapter to your favourite log library is very easy. | Writing an adapter to your favourite log library is very easy. | ||||
Just implement the BuildListener interface, instantiate your logger and delegate | Just implement the BuildListener interface, instantiate your logger and delegate | ||||
the message to that instance.<br> | |||||
the message to that instance.<br/> | |||||
When starting your build provide your adapter class and the log library to the | When starting your build provide your adapter class and the log library to the | ||||
build classpath and activate your logger via <code>-listener</code> option as | build classpath and activate your logger via <code>-listener</code> option as | ||||
described above. | described above. | ||||
@@ -143,7 +143,7 @@ were <samp>mypackage/test/**</samp>.</p> | |||||
<td><samp>**/CVS/*</samp></td> | <td><samp>**/CVS/*</samp></td> | ||||
<td>Matches all files in <samp>CVS</samp> | <td>Matches all files in <samp>CVS</samp> | ||||
directories that can be located | directories that can be located | ||||
anywhere in the directory tree.<br> | |||||
anywhere in the directory tree.<br/> | |||||
Matches: | Matches: | ||||
<pre> | <pre> | ||||
CVS/Repository | CVS/Repository | ||||
@@ -157,7 +157,7 @@ But not: | |||||
<tr> | <tr> | ||||
<td><samp>org/apache/jakarta/**</samp></td> | <td><samp>org/apache/jakarta/**</samp></td> | ||||
<td>Matches all files in the <samp>org/apache/jakarta</samp> | <td>Matches all files in the <samp>org/apache/jakarta</samp> | ||||
directory tree.<br> | |||||
directory tree.<br/> | |||||
Matches: | Matches: | ||||
<pre> | <pre> | ||||
org/apache/jakarta/tools/ant/docs/index.html | org/apache/jakarta/tools/ant/docs/index.html | ||||
@@ -171,7 +171,7 @@ But not: | |||||
<td><samp>org/apache/**/CVS/*</samp></td> | <td><samp>org/apache/**/CVS/*</samp></td> | ||||
<td>Matches all files in <samp>CVS</samp> directories | <td>Matches all files in <samp>CVS</samp> directories | ||||
that are located anywhere in the directory tree under | that are located anywhere in the directory tree under | ||||
<samp>org/apache</samp>.<br> | |||||
<samp>org/apache</samp>.<br/> | |||||
Matches: | Matches: | ||||
<pre> | <pre> | ||||
org/apache/CVS/Entries | org/apache/CVS/Entries | ||||
@@ -489,7 +489,7 @@ your build file. | |||||
<p> | <p> | ||||
Ant start up scripts (in their Windows and Unix version) return the | Ant start up scripts (in their Windows and Unix version) return the | ||||
return code of the <code>java</code> program. So a successful build | return code of the <code>java</code> program. So a successful build | ||||
returns 0, failed builds return other values. | |||||
returns <q>0</q>, failed builds return other values. | |||||
</p> | </p> | ||||
<h2 id="cygwin">Cygwin Users</h2> | <h2 id="cygwin">Cygwin Users</h2> | ||||
@@ -29,23 +29,23 @@ difficult to get an overall view of what each task can do. The following | |||||
tables provide a short description of each task and a link to the complete | tables provide a short description of each task and a link to the complete | ||||
documentation.</p> | documentation.</p> | ||||
<a href="#archive">Archive Tasks</a><br> | |||||
<a href="#audit">Audit/Coverage Tasks</a><br> | |||||
<a href="#compile">Compile Tasks</a><br> | |||||
<a href="#deploy">Deployment Tasks</a><br> | |||||
<a href="#doc">Documentation Tasks</a><br> | |||||
<a href="#ejb">EJB Tasks</a><br> | |||||
<a href="#exec">Execution Tasks</a><br> | |||||
<a href="#file">File Tasks</a><br> | |||||
<a href="#extensions">Java Extensions Tasks</a><br> | |||||
<a href="#log">Logging Tasks</a><br> | |||||
<a href="#mail">Mail Tasks</a><br> | |||||
<a href="#misc">Miscellaneous Tasks</a><br> | |||||
<a href="#preproc">Pre-process Tasks</a><br> | |||||
<a href="#prop">Property Tasks</a><br> | |||||
<a href="#remote">Remote Tasks</a><br> | |||||
<a href="#scm">SCM Tasks</a><br> | |||||
<a href="#testing">Testing Tasks</a><br> | |||||
<a href="#archive">Archive Tasks</a><br/> | |||||
<a href="#audit">Audit/Coverage Tasks</a><br/> | |||||
<a href="#compile">Compile Tasks</a><br/> | |||||
<a href="#deploy">Deployment Tasks</a><br/> | |||||
<a href="#doc">Documentation Tasks</a><br/> | |||||
<a href="#ejb">EJB Tasks</a><br/> | |||||
<a href="#exec">Execution Tasks</a><br/> | |||||
<a href="#file">File Tasks</a><br/> | |||||
<a href="#extensions">Java Extensions Tasks</a><br/> | |||||
<a href="#log">Logging Tasks</a><br/> | |||||
<a href="#mail">Mail Tasks</a><br/> | |||||
<a href="#misc">Miscellaneous Tasks</a><br/> | |||||
<a href="#preproc">Pre-process Tasks</a><br/> | |||||
<a href="#prop">Property Tasks</a><br/> | |||||
<a href="#remote">Remote Tasks</a><br/> | |||||
<a href="#scm">SCM Tasks</a><br/> | |||||
<a href="#testing">Testing Tasks</a><br/> | |||||
<div class="float" id="archive"> | <div class="float" id="archive"> | ||||
<span class="left">Archive Tasks</span> | <span class="left">Archive Tasks</span> | ||||
@@ -464,7 +464,7 @@ steps: 1. let <code><junit></code> log the information and 2. convert thes | |||||
define a report directory, create it before running the <q>junit</q> and redirect the logging to it. The log format is | define a report directory, create it before running the <q>junit</q> and redirect the logging to it. The log format is | ||||
XML so <q>junitreport</q> could parse it. In a second target <q>junitreport</q> should create a browsable HTML report | XML so <q>junitreport</q> could parse it. In a second target <q>junitreport</q> should create a browsable HTML report | ||||
for all generated XML log files in the report directory. Now you can open the <samp>${report.dir}\index.html</samp> and | for all generated XML log files in the report directory. Now you can open the <samp>${report.dir}\index.html</samp> and | ||||
see the result (looks something like JavaDoc).<br> Personally I use two different targets | |||||
see the result (looks something like JavaDoc).<br/> Personally I use two different targets | |||||
for <code><junit></code> and <code><junitreport></code>. Generating the HTML report needs some time and you | for <code><junit></code> and <code><junitreport></code>. Generating the HTML report needs some time and you | ||||
don't need the HTML report just for testing, e.g. if you are fixing an error or a integration server is doing a job.</p> | don't need the HTML report just for testing, e.g. if you are fixing an error or a integration server is doing a job.</p> | ||||
@@ -515,26 +515,26 @@ For the declaration there are several ways: | |||||
<li>declare a single task per using instruction using | <li>declare a single task per using instruction using | ||||
<code><<a href="Tasks/taskdef.html">taskdef</a> name="taskname" | <code><<a href="Tasks/taskdef.html">taskdef</a> name="taskname" | ||||
classname="ImplementationClass"/></code> | classname="ImplementationClass"/></code> | ||||
<br> | |||||
<br/> | |||||
<code><taskdef name="for" classname="net.sf.antcontrib.logic.For"/> | <code><taskdef name="for" classname="net.sf.antcontrib.logic.For"/> | ||||
<for ... /></code> | <for ... /></code> | ||||
</li> | </li> | ||||
<li>declare a bundle of tasks using a <samp>properties</samp> file holding these | <li>declare a bundle of tasks using a <samp>properties</samp> file holding these | ||||
taskname-ImplementationClass-pairs and <code><taskdef></code> | taskname-ImplementationClass-pairs and <code><taskdef></code> | ||||
<br> | |||||
<br/> | |||||
<code><taskdef resource="net/sf/antcontrib/antcontrib.properties"/> | <code><taskdef resource="net/sf/antcontrib/antcontrib.properties"/> | ||||
<for ... /></code> | <for ... /></code> | ||||
</li> | </li> | ||||
<li>declare a bundle of tasks using | <li>declare a bundle of tasks using | ||||
an <a href="Types/antlib.html">xml file</a> holding these | an <a href="Types/antlib.html">xml file</a> holding these | ||||
taskname-ImplementationClass-pairs and <code><taskdef></code> | taskname-ImplementationClass-pairs and <code><taskdef></code> | ||||
<br> | |||||
<br/> | |||||
<code><taskdef resource="net/sf/antcontrib/antlib.xml"/> | <code><taskdef resource="net/sf/antcontrib/antlib.xml"/> | ||||
<for ... /></code> | <for ... /></code> | ||||
</li> | </li> | ||||
<li>declare a bundle of tasks using an xml file named <samp>antlib.xml</samp>, XML namespace and | <li>declare a bundle of tasks using an xml file named <samp>antlib.xml</samp>, XML namespace and | ||||
<a href="Types/antlib.html#antlibnamespace"><code>antlib:</code> protocol handler</a> | <a href="Types/antlib.html#antlibnamespace"><code>antlib:</code> protocol handler</a> | ||||
<br> | |||||
<br/> | |||||
<code><project xmlns:ac="antlib:net.sf.antcontrib"/> | <code><project xmlns:ac="antlib:net.sf.antcontrib"/> | ||||
<ac:for ... /></code> | <ac:for ... /></code> | ||||
</li> | </li> | ||||