@@ -27,7 +27,7 @@ by | |||||
<ul> | <ul> | ||||
<li>Klaus Hartlage (<a href="mailto:KHartlage@t-online.de">KHartlage@t-online.de</a>)</li> | <li>Klaus Hartlage (<a href="mailto:KHartlage@t-online.de">KHartlage@t-online.de</a>)</li> | ||||
</ul> | </ul> | ||||
<hr> | |||||
<hr/> | |||||
<p>You can download the plugin | <p>You can download the plugin | ||||
at: <a href="http://sourceforge.net/projects/jext/files/OldFiles/antwork_plugin.zip/download">http://sourceforge.net/projects/jext/files/OldFiles/antwork_plugin.zip/download</a></p> | at: <a href="http://sourceforge.net/projects/jext/files/OldFiles/antwork_plugin.zip/download">http://sourceforge.net/projects/jext/files/OldFiles/antwork_plugin.zip/download</a></p> | ||||
@@ -26,10 +26,10 @@ | |||||
<h2 id="filter">Filter</h2> | <h2 id="filter">Filter</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Sets a token filter for this project or read multiple token filter from an input file and sets | |||||
these as filters. Token filters are used by all tasks that perform file copying operations through | |||||
the Project commodity methods. See the warning <a href="../using.html#filters"><em>here</em></a> | |||||
before using.</p> | |||||
<p>Sets a token filter for this project or reads a properties file as multiple token filter | |||||
definitions and sets them. Token filters are used by all tasks that perform file copying operations | |||||
through the Project commodity methods. See the | |||||
warning <a href="../using.html#filters"><em>here</em></a> before using.</p> | |||||
<p>The task uses <q>@</q> as token separator. Token strings cannot contain separator characters; | <p>The task uses <q>@</q> as token separator. Token strings cannot contain separator characters; | ||||
incorrect tokens are ignored.</p> | incorrect tokens are ignored.</p> | ||||
@@ -42,8 +42,9 @@ out of the box. The table below summarize the compatibility status.</p> | |||||
<tr><th>Xalan</th><th>Sun JDK Bundle</th><th>Status<th></tr> | <tr><th>Xalan</th><th>Sun JDK Bundle</th><th>Status<th></tr> | ||||
<tr><td>2.4.1+</td><td>JDK 1.4.2-01+</td><td>OK</td></tr> | <tr><td>2.4.1+</td><td>JDK 1.4.2-01+</td><td>OK</td></tr> | ||||
<tr><td>XSLTC</td><td>JDK 1.5.x</td><td>OK</td></tr> | <tr><td>XSLTC</td><td>JDK 1.5.x</td><td>OK</td></tr> | ||||
<tr><td>2.x</td><td>JDK 1.4.x</td><td><em><u>Deprecated</u>, use <samp>${ant.home}/etc/junit-frames-xalan1.xsl</samp> | |||||
<br/>Upgrade Xalan using the JDK endorsement mechanism</em></td></tr> | |||||
<tr><td>2.x</td><td>JDK 1.4.x</td><td><em><u>Deprecated</u>, | |||||
use <samp>${ant.home}/etc/junit-frames-xalan1.xsl</samp><br/>Upgrade Xalan using the JDK endorsement | |||||
mechanism</em></td></tr> | |||||
</table> | </table> | ||||
<p>In Ant 1.6.2, we had to decide between supporting Xalan 1/Xalan 2.4.1- and Xalan 2.4.1+/XSLTC, | <p>In Ant 1.6.2, we had to decide between supporting Xalan 1/Xalan 2.4.1- and Xalan 2.4.1+/XSLTC, | ||||
@@ -94,8 +95,10 @@ using the nested <a href="../Types/fileset.html"><code><FileSet></code></a | |||||
<td>The directory where the stylesheets are defined. They must be conforming to the following | <td>The directory where the stylesheets are defined. They must be conforming to the following | ||||
conventions: | conventions: | ||||
<ul> | <ul> | ||||
<li><q>frames</q> format: the stylesheet must be named <samp>junit-frames.xsl</samp>, or <i>junit-frames-saxon.xsl if you are using Saxon 9+.</li> | |||||
<li><q>noframes</q> format: the stylesheet must be named <samp>junit-noframes.xsl</samp>, or <i>junit-noframes-saxon.xsl if you are using Saxon 9+.</li> | |||||
<li><q>frames</q> format: the stylesheet must be named <samp>junit-frames.xsl</samp>, | |||||
or <samp>junit-frames-saxon.xsl</samp> if you are using Saxon 9+.</li> | |||||
<li><q>noframes</q> format: the stylesheet must be named <samp>junit-noframes.xsl</samp>, | |||||
or <samp>junit-noframes-saxon.xsl</samp> if you are using Saxon 9+.</li> | |||||
</ul> | </ul> | ||||
</td> | </td> | ||||
<td>No; defaults to embedded stylesheets</td> | <td>No; defaults to embedded stylesheets</td> | ||||
@@ -34,7 +34,7 @@ | |||||
<li>Gary S. Weaver</li> | <li>Gary S. Weaver</li> | ||||
<li>Jesse Stockall</li> | <li>Jesse Stockall</li> | ||||
</ul> | </ul> | ||||
<hr> | |||||
<hr/> | |||||
<h2>Contents</h2> | <h2>Contents</h2> | ||||
<ul> | <ul> | ||||
<li><a href="#intro">Introduction</a></li> | <li><a href="#intro">Introduction</a></li> | ||||
@@ -207,9 +207,7 @@ and write them to the local directory <samp>C:\mysrc\myproject</samp>. The local | |||||
writable.</p> | writable.</p> | ||||
<hr/> | <hr/> | ||||
<!-- VSSLABEL --> | <!-- VSSLABEL --> | ||||
<h2 id="vsslabel">VssLabel</h2> | <h2 id="vsslabel">VssLabel</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Task to perform LABEL commands to Microsoft Visual SourceSafe.</p> | <p>Task to perform LABEL commands to Microsoft Visual SourceSafe.</p> | ||||
@@ -291,9 +289,7 @@ label <q>1.03.004</q>. If this version already has a label, the operation (and t | |||||
fail.</p> | fail.</p> | ||||
<hr/> | <hr/> | ||||
<!-- VSSHISTORY --> | <!-- VSSHISTORY --> | ||||
<h2 id="vsshistory">VssHistory</h2> | <h2 id="vsshistory">VssHistory</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
Task to perform HISTORY commands to Microsoft Visual SourceSafe. | Task to perform HISTORY commands to Microsoft Visual SourceSafe. | ||||
@@ -423,10 +419,9 @@ specified according to your locale).</p> | |||||
toDate="${to.tstamp}"/></pre> | toDate="${to.tstamp}"/></pre> | ||||
<p>Shows all changes in the 14 days before today.</p> | <p>Shows all changes in the 14 days before today.</p> | ||||
<hr/> | |||||
<hr/> | |||||
<!-- VSSCHECKIN --> | <!-- VSSCHECKIN --> | ||||
<h2 id="vsscheckin">VssCheckin</h2> | <h2 id="vsscheckin">VssCheckin</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Task to perform CHECKIN commands to Microsoft Visual SourceSafe.</p> | <p>Task to perform CHECKIN commands to Microsoft Visual SourceSafe.</p> | ||||
@@ -503,9 +498,7 @@ specified according to your locale).</p> | |||||
directory <samp>D:\build</samp>.</p> | directory <samp>D:\build</samp>.</p> | ||||
<hr/> | <hr/> | ||||
<!-- VSSCHECKOUT --> | <!-- VSSCHECKOUT --> | ||||
<h2 id="vsscheckout">VssCheckout</h2> | <h2 id="vsscheckout">VssCheckout</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Task to perform CHECKOUT commands to Microsoft Visual SourceSafe.</p> | <p>Task to perform CHECKOUT commands to Microsoft Visual SourceSafe.</p> | ||||
@@ -605,9 +598,7 @@ order <var>version</var>, <var>date</var>, <var>label</var>.</p> | |||||
directory <samp>D:\build</samp>.</p> | directory <samp>D:\build</samp>.</p> | ||||
<hr/> | <hr/> | ||||
<!-- VSSADD --> | <!-- VSSADD --> | ||||
<h2 id="vssadd">VssAdd</h2> | <h2 id="vssadd">VssAdd</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
Task to perform ADD commands to Microsoft Visual SourceSafe. | Task to perform ADD commands to Microsoft Visual SourceSafe. | ||||
@@ -677,9 +668,7 @@ Task to perform ADD commands to Microsoft Visual SourceSafe. | |||||
(see <code>vsscp</code>).</p> | (see <code>vsscp</code>).</p> | ||||
<hr/> | <hr/> | ||||
<!-- VSSCP --> | <!-- VSSCP --> | ||||
<h2 id="vsscp">VssCp</h2> | <h2 id="vsscp">VssCp</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Task to perform CP (Change Project) commands to Microsoft Visual SourceSafe.</p> | <p>Task to perform CP (Change Project) commands to Microsoft Visual SourceSafe.</p> | ||||
@@ -727,9 +716,7 @@ Task to perform ADD commands to Microsoft Visual SourceSafe. | |||||
<p>Sets the current VSS project to <samp>$/Projects/ant</samp>.</p> | <p>Sets the current VSS project to <samp>$/Projects/ant</samp>.</p> | ||||
<hr/> | <hr/> | ||||
<!-- VSSCREATE --> | <!-- VSSCREATE --> | ||||
<h2 id="vsscreate">VssCreate</h2> | <h2 id="vsscreate">VssCreate</h2> | ||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Task to perform CREATE commands to Microsoft Visual Source Safe.</p> | <p>Task to perform CREATE commands to Microsoft Visual Source Safe.</p> | ||||
@@ -61,7 +61,7 @@ | |||||
a <code>BuildException</code>. This method implements the task itself.</li> | a <code>BuildException</code>. This method implements the task itself.</li> | ||||
</ol> | </ol> | ||||
<hr> | |||||
<hr/> | |||||
<p id="footnote-1"><a href="#footnote-1-back">*</a> Actually the case of the letters after the first | <p id="footnote-1"><a href="#footnote-1-back">*</a> Actually the case of the letters after the first | ||||
one doesn't really matter to Ant, using all lower case is a good convention, though.</p> | one doesn't really matter to Ant, using all lower case is a good convention, though.</p> | ||||
@@ -108,7 +108,7 @@ one doesn't really matter to Ant, using all lower case is a good convention, tho | |||||
<li id="execute"><code>execute()</code> is called at runtime. If <q>target1</q> | <li id="execute"><code>execute()</code> is called at runtime. If <q>target1</q> | ||||
and <q>target2</q> both depend on <q>target3</q>, then running <code>'ant target1 | and <q>target2</q> both depend on <q>target3</q>, then running <code>'ant target1 | ||||
target2'</code> will run all tasks in <q>target3</code> twice.</li> | |||||
target2'</code> will run all tasks in <q>target3</q> twice.</li> | |||||
</ol> | </ol> | ||||
<h3 id="set-magic">Conversions Ant will perform for attributes</h3> | <h3 id="set-magic">Conversions Ant will perform for attributes</h3> | ||||
@@ -381,7 +381,7 @@ just been compiled.</p> | |||||
to the <samp>default.properties</samp> file in the <code>org.apache.tools.ant.taskdefs</code> | to the <samp>default.properties</samp> file in the <code>org.apache.tools.ant.taskdefs</code> | ||||
package. Then you can use it as if it were a built-in task.</p> | package. Then you can use it as if it were a built-in task.</p> | ||||
<hr> | |||||
<hr/> | |||||
<h2 id="buildevents">Build Events</h2> | <h2 id="buildevents">Build Events</h2> | ||||
<p>Ant is capable of generating build events as it performs the tasks necessary to build a project. | <p>Ant is capable of generating build events as it performs the tasks necessary to build a project. | ||||
Listeners can be attached to Ant to receive these events. This capability could be used, for | Listeners can be attached to Ant to receive these events. This capability could be used, for | ||||
@@ -466,7 +466,7 @@ public class MyLogAdapter implements BuildListener { | |||||
// implement all methods in that way | // implement all methods in that way | ||||
}</pre> | }</pre> | ||||
<hr> | |||||
<hr/> | |||||
<h2 id="integration">Source code integration</h2> | <h2 id="integration">Source code integration</h2> | ||||
<p>The other way to extend Ant through Java is to make changes to existing tasks, which is | <p>The other way to extend Ant through Java is to make changes to existing tasks, which is | ||||
@@ -31,11 +31,11 @@ | |||||
To get up and running with the binary distribution of Ant quickly, follow these steps: | To get up and running with the binary distribution of Ant quickly, follow these steps: | ||||
</p> | </p> | ||||
<ol> | <ol> | ||||
<li>Make sure you have a Java environment installed, See <a href="#sysrequirements">System Requirements</a> for | |||||
<li>Make sure you have a Java environment installed. See <a href="#sysrequirements">System Requirements</a> for | |||||
details.</li> | details.</li> | ||||
<li>Download Ant. See <a href="#getBinary">Binary Distribution</a> for details.</li> | <li>Download Ant. See <a href="#getBinary">Binary Distribution</a> for details.</li> | ||||
<li>Uncompress the downloaded file into a directory.</li> | <li>Uncompress the downloaded file into a directory.</li> | ||||
<li>Set environmental variables <code>JAVA_HOME</code> to your Java environment, <code>ANT_HOME</code> to the directory | |||||
<li>Set environmental variables: <code>JAVA_HOME</code> to your Java environment, <code>ANT_HOME</code> to the directory | |||||
you uncompressed Ant to, and add <samp>${ANT_HOME}/bin</samp> (Unix) or <samp>%ANT_HOME%/bin</samp> (Windows) to | you uncompressed Ant to, and add <samp>${ANT_HOME}/bin</samp> (Unix) or <samp>%ANT_HOME%/bin</samp> (Windows) to | ||||
your <code>PATH</code>. See <a href="#setup">Setup</a> for details.</li> | your <code>PATH</code>. See <a href="#setup">Setup</a> for details.</li> | ||||
<li>Optionally, from the <code>ANT_HOME</code> directory run <code>ant -f fetch.xml -Ddest=system</code> to get the | <li>Optionally, from the <code>ANT_HOME</code> directory run <code>ant -f fetch.xml -Ddest=system</code> to get the | ||||
@@ -615,7 +615,7 @@ proprietary packages. For example, suppose you want to install support for NetRe | |||||
usually <samp>/usr/share/ant/lib</samp>. Another, less messy option is to create an <samp>.ant/lib</samp> subdirectory | usually <samp>/usr/share/ant/lib</samp>. Another, less messy option is to create an <samp>.ant/lib</samp> subdirectory | ||||
of your home directory and place your non-JPackage Ant JARs there, thereby avoiding mixing JPackage libraries with | of your home directory and place your non-JPackage Ant JARs there, thereby avoiding mixing JPackage libraries with | ||||
non-JPackage stuff in the same folder. More information on where Ant finds its libraries is | non-JPackage stuff in the same folder. More information on where Ant finds its libraries is | ||||
available <a href="https://ant.apache.org/manual/running.html#libs">here</a></li> | |||||
available <a href="running.html#libs">here</a></li> | |||||
<li>Download a non-JPackage binary distribution from the regular <a href="https://ant.apache.org/bindownload.cgi" | <li>Download a non-JPackage binary distribution from the regular <a href="https://ant.apache.org/bindownload.cgi" | ||||
target="_top">Apache Ant site</a></li> | target="_top">Apache Ant site</a></li> | ||||
<li>Unzip or untar the distribution into a temporary directory</li> | <li>Unzip or untar the distribution into a temporary directory</li> | ||||
@@ -71,7 +71,7 @@ | |||||
access, although in practise the results are inconsistent. | access, although in practise the results are inconsistent. | ||||
</p> | </p> | ||||
<p> | <p> | ||||
It is has also been reported a breaking the IBM Java 5 JRE on AIX, | |||||
It is has also been reported a breaking the IBM Java 5 runtime on AIX, | |||||
and does not always work on Linux (presumably due to | and does not always work on Linux (presumably due to | ||||
missing <code>gconf</code> settings) Other odd things can go wrong, | missing <code>gconf</code> settings) Other odd things can go wrong, | ||||
like Oracle JDBC drivers or pure Java SVN clients. | like Oracle JDBC drivers or pure Java SVN clients. | ||||