git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@989020 13f79535-47bb-0310-9956-ffa450edef68master
@@ -114,7 +114,7 @@ or set the <tt>fileext</tt> attribute. | |||
<td valign="top">pattern</td> | |||
<td valign="top">Specifies the pattern to use as a pattern | |||
suitable for <a | |||
href="http://java.sun.com/j2se/1.4.2/docs/api/java/text/MessageFormat.html">MessageFormat</a> | |||
href="http://download.oracle.com/javase/6/docs/api/java/text/MessageFormat.html">MessageFormat</a> | |||
where <code>{0}</code> is replaced with the checksum and | |||
<code>{1}</code> with the file name. <em>Since Ant 1.7.0</em></td> | |||
<td valign="top" align="center">No - default is "{0}".</td> | |||
@@ -110,8 +110,8 @@ Resource Collection</a>s are used to | |||
<td valign="top">encoding</td> | |||
<td valign="top"> | |||
Specifies the encoding for the input files. Please see <a | |||
href="http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html"> | |||
http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html</a> | |||
href="http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html"> | |||
http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html</a> | |||
for a list of possible values. Defaults to the platform's | |||
default character encoding. | |||
</td> | |||
@@ -43,7 +43,7 @@ compiler. This is generally faster than parsing the Java source.</p> | |||
<p> | |||
To learn more about how this information is obtained from the class files, | |||
please refer to <a href="http://java.sun.com/docs/books/vmspec/">the Java | |||
please refer to <a href="http://java.sun.com/docs/books/jvms/">the Java | |||
Virtual Machine Specification</a> | |||
</p> | |||
@@ -147,7 +147,7 @@ to a value other than its default, <code>"add"</code>.</b></p> | |||
<tr> | |||
<td valign="top">index</td> | |||
<td valign="top">whether to create an <A | |||
HREF="http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html#JAR%20Index">index | |||
HREF="http://download.oracle.com/javase/1.5.0/docs/guide/jar/jar.html#JAR%20Index">index | |||
list</A> to speed up classloading. This is a JDK 1.3+ specific | |||
feature. Unless you specify additional jars with nested <a | |||
href="jar.html#indexjars"><code>indexjars</code></a> elements, only the | |||
@@ -62,7 +62,7 @@ ignored</p> | |||
<tr> | |||
<td valign="top">append</td> | |||
<td valign="top">Append to an existing file (or | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/api/java/io/FileWriter.html#FileWriter(java.lang.String, boolean)" target="_blank"> | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/io/FileWriter.html#FileWriter%28java.lang.String,%20boolean%29" target="_blank"> | |||
open a new file / overwrite an existing file</a>)? Default <i>false</i>. | |||
</td> | |||
<td valign="top" align="center">No; ignored unless <i>output</i> indicates a | |||
@@ -49,7 +49,7 @@ | |||
<hr> | |||
<h2><a name="introduction">Introduction</a></h2> | |||
<p>Ant provides a number of optional tasks for developing 1.x and 2.x | |||
<a href="http://java.sun.com/products/ejb" target="_top">Enterprise Java Beans (EJBs)</a>. | |||
<a href="http://www.oracle.com/technetwork/java/index-jsp-140203.html" target="_top">Enterprise Java Beans (EJBs)</a>. | |||
In general these tasks are specific to the particular vendor's EJB Server.</p> | |||
<p> The tasks support:<br> | |||
@@ -303,7 +303,7 @@ try to set up a new connection.</p> | |||
<tr> | |||
<td valign="top">serverTimeZoneConfig</td> | |||
<td valign="top">Specify as a Java | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/TimeZone.html"> | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/util/TimeZone.html"> | |||
TimeZone</a> identifier, (e.g. <code>GMT</code>, <code>America/Chicago</code> or | |||
<code>Asia/Jakarta</code>) the timezone used by the server for timestamps. This | |||
enables timestamp dependency checking even when the server is in a different | |||
@@ -318,7 +318,7 @@ try to set up a new connection.</p> | |||
<td valign="top">defaultDateFormatConfig</td> | |||
<td valign="top">Specify in Java | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html"> | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html"> | |||
SimpleDateFormat</a> notation, (e.g. | |||
<code>yyyy-MM-dd</code>), the date format generally used by the FTP server | |||
to parse dates. In some cases this will be the only date format used. | |||
@@ -335,7 +335,7 @@ try to set up a new connection.</p> | |||
<tr> | |||
<td valign="top">recentDateFormatConfig</td> | |||
<td valign="top">Specify in Java | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html"> | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html"> | |||
SimpleDateFormat</a> notation, | |||
(e.g. <code>MMM dd hh:mm</code>) the date format used by the FTP server | |||
to parse dates less than a year old. If not specified (or specified as | |||
@@ -73,12 +73,12 @@ attribute of a zipfileset in a Zip task. The one difference is that if the | |||
include an empty one for you.)</p> | |||
<p>Manifests are processed by the Jar task according to the | |||
<a target="_blank" href="http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html">Jar file specification.</a> | |||
<a target="_blank" href="http://download.oracle.com/javase/1.5.0/docs/guide/jar/jar.html">Jar file specification.</a> | |||
Note in particular that this may result in manifest lines greater than 72 bytes | |||
being wrapped and continued on the next line.</p> | |||
<p>The Jar task checks whether you specified package information according to the | |||
<a target="_blank" href="http://java.sun.com/j2se/1.3/docs/guide/versioning/spec/VersioningSpecification.html#PackageVersioning"> | |||
<a target="_blank" href="http://download.oracle.com/javase/1.3/docs/guide/versioning/spec/VersioningSpecification.html#PackageVersioning"> | |||
versioning specification</a>.</p> | |||
<p><b>Please note that the zip format allows multiple files of the same | |||
@@ -196,7 +196,7 @@ to a value other than its default, <code>"add"</code>.</b></p> | |||
<tr> | |||
<td valign="top">index</td> | |||
<td valign="top">whether to create an <A | |||
HREF="http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html#JAR%20Index">index | |||
HREF="http://download.oracle.com/javase/1.5.0/docs/guide/jar/jar.html#JAR%20Index">index | |||
list</A> to speed up classloading. This is a JDK 1.3+ specific | |||
feature. Unless you specify additional jars with nested <a | |||
href="#indexjars"><code>indexjars</code></a> elements, only the | |||
@@ -383,7 +383,7 @@ depend on your manifest:</p> | |||
<p> | |||
The nested <code>service</code> element specifies a service. | |||
Services are described by | |||
<a href="http://java.sun.com/j2se/1.5.0/docs/guide/jar/jar.html#Service%20Provider">http://java.sun.com/j2se/1.5.0/docs/guide/jar/jar.html#Service%20Provider</a>. | |||
<a href="http://download.oracle.com/javase/1.5.0/docs/guide/jar/jar.html#Service%20Provider">http://download.oracle.com/javase/1.5.0/docs/guide/jar/jar.html#Service%20Provider</a>. | |||
The approach is to have providers JARs include files named by the service | |||
provided, for example, | |||
META-INF/services/javax.script.ScriptEngineFactory | |||
@@ -35,8 +35,8 @@ works with extensions as defined by the "Optional Package" specification. | |||
<em>Optional Package Versioning</em> in the documentation bundle for your | |||
Java2 Standard Edition package, in file | |||
<code>guide/extensions/versioning.html</code> or online at | |||
<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> | |||
http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> | |||
<a href="http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html"> | |||
http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html | |||
<p>See the Extension and ExtensionSet documentation for further details</p> | |||
<h3>Parameters</h3> | |||
@@ -35,8 +35,8 @@ works with extensions as defined by the "Optional Package" specification. | |||
<em>Optional Package Versioning</em> in the documentation bundle for your | |||
Java2 Standard Edition package, in file | |||
<code>guide/extensions/versioning.html</code> or online at | |||
<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> | |||
http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> | |||
<a href="http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html"> | |||
http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html | |||
<p>See the Extension and ExtensionSet documentation for further details</p> | |||
<h3>Parameters</h3> | |||
@@ -37,8 +37,8 @@ works with extensions as defined by the "Optional Package" specification. | |||
<em>Optional Package Versioning</em> in the documentation bundle for your | |||
Java2 Standard Edition package, in file | |||
<code>guide/extensions/versioning.html</code> or online at | |||
<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> | |||
http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> | |||
<a href="http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html"> | |||
http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html | |||
<p>See the Extension and ExtensionSet documentation for further details</p> | |||
<h3>Parameters</h3> | |||
@@ -40,8 +40,8 @@ works with extensions as defined by the "Optional Package" specification. | |||
<em>Optional Package Versioning</em> in the documentation bundle for your | |||
Java2 Standard Edition package, in file | |||
<code>guide/extensions/versioning.html</code> or online at | |||
<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> | |||
http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> | |||
<a href="http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html"> | |||
http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html | |||
<p>See the Extension and ExtensionSet documentation for further details</p> | |||
<h3>Parameters</h3> | |||
@@ -321,7 +321,7 @@ task is run. If you need to locate a JAR file relative to the directory | |||
the task will be run in, you need to explicitly create the full path | |||
to the JAR file.</p> | |||
<p>When using the <tt>jar</tt> attribute, all classpath settings are | |||
ignored according to <a href="http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/java.html#-jar">Sun's | |||
ignored according to <a href="http://download.oracle.com/javase/1.5.0/docs/tooldocs/windows/java.html#-jar">Sun's | |||
specification</a>. | |||
@@ -703,7 +703,7 @@ with text contents, and the packages may be listed with nested | |||
<h4>doclet</h4> | |||
<p>The doclet nested element is used to specify the | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/tooldocs/javadoc/overview.html">doclet</a> | |||
<a href="http://download.oracle.com/javase/1.4.2/docs/tooldocs/javadoc/overview.html">doclet</a> | |||
that javadoc will use to process the input source files. A number of the standard javadoc arguments | |||
are actually arguments of the standard doclet. If these are specified in the javadoc | |||
task's attributes, they will be passed to the doclet specified in the | |||
@@ -767,7 +767,7 @@ not set the description attribute for those tags.</p> | |||
<td valign="top">If this attribute is specified, this element will behave as an implicit | |||
<a href="../Types/fileset.html">fileset</a>. The files included by this fileset should | |||
contain each tag definition on a separate line, as described in the | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/javadoc.html#tag">Javadoc reference guide</a>: | |||
<a href="http://download.oracle.com/javase/1.4.2/docs/tooldocs/windows/javadoc.html#tag">Javadoc reference guide</a>: | |||
<pre>ejb.bean:t:XDoclet EJB Tag | |||
todo:a:To Do</pre> | |||
<b>Note:</b> The Javadoc reference quide has double quotes around | |||
@@ -784,7 +784,7 @@ the javadoc program. | |||
<h4><a name="tagletelement">taglet</a></h4> | |||
<p>The taglet nested element is used to specify custom | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/tooldocs/javadoc/taglet/overview.html">taglets</a>.</p> | |||
<a href="http://download.oracle.com/javase/1.4.2/docs/tooldocs/javadoc/taglet/overview.html">taglets</a>.</p> | |||
<h5>Parameters</h5> | |||
<table width="90%" border="1" cellpadding="2" cellspacing="0"> | |||
@@ -796,7 +796,7 @@ the javadoc program. | |||
<tr> | |||
<td valign="top">name</td> | |||
<td valign="top">The name of the taglet class | |||
(e.g. <a href="http://java.sun.com/j2se/1.4.2/docs/tooldocs/javadoc/taglet/ToDoTaglet.java"> | |||
(e.g. <a href="http://download.oracle.com/javase/1.4.2/docs/tooldocs/javadoc/taglet/ToDoTaglet.java"> | |||
<code>com.sun.tools.doclets.ToDoTaglet</code></a>)</td> | |||
<td align="center" valign="top">Yes</td> | |||
</tr> | |||
@@ -837,7 +837,7 @@ arguments</a>. <em>Since Ant 1.6</em></p> | |||
<tag name="todo" scope="all" description="To do:"/> | |||
<group title="Group 1 Packages" packages="com.dummy.test.a*"/> | |||
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/> | |||
<link offline="true" href="http://java.sun.com/j2se/1.5.0/docs/api/" packagelistLoc="C:\tmp"/> | |||
<link offline="true" href="http://download.oracle.com/javase/6/docs/api/" packagelistLoc="C:\tmp"/> | |||
<link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/> | |||
</javadoc></pre> | |||
@@ -860,7 +860,7 @@ arguments</a>. <em>Since Ant 1.6</em></p> | |||
<tag name="todo" scope="all" description="To do:"/> | |||
<group title="Group 1 Packages" packages="com.dummy.test.a*"/> | |||
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/> | |||
<link offline="true" href="http://java.sun.com/j2se/1.5.0/docs/api/" packagelistLoc="C:\tmp"/> | |||
<link offline="true" href="http://download.oracle.com/javase/6/docs/api/" packagelistLoc="C:\tmp"/> | |||
<link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/> | |||
</javadoc></pre> | |||
@@ -883,7 +883,7 @@ arguments</a>. <em>Since Ant 1.6</em></p> | |||
<tag name="todo" scope="all" description="To do:"/> | |||
<group title="Group 1 Packages" packages="com.dummy.test.a*"/> | |||
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/> | |||
<link offline="true" href="http://java.sun.com/j2se/1.5.0/docs/api/" packagelistLoc="C:\tmp"/> | |||
<link offline="true" href="http://download.oracle.com/javase/6/docs/api/" packagelistLoc="C:\tmp"/> | |||
<link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/> | |||
</javadoc></pre> | |||
@@ -29,7 +29,7 @@ | |||
<p>Generates JNI headers from a Java class.</p> | |||
<p> When this task executes, it will generate the C header and source files that | |||
are needed to implement native methods. JNI operates differently depending on | |||
whether <a href="http://java.sun.com/j2se/1.3/docs/tooldocs/win32/javah.html">JDK1.2</a> | |||
whether <a href="http://download.oracle.com/javase/1.3/docs/tooldocs/win32/javah.html">JDK1.2</a> | |||
(or later) or <a href="http://java.sun.com/products/jdk/1.1/docs/tooldocs/win32/javah.html">pre-JDK1.2</a> | |||
systems are used.</p> | |||
@@ -34,7 +34,7 @@ replacing or updating an existing file.</p> | |||
<p>Manifests are processed according to the | |||
<a href="http://java.sun.com/j2se/1.5.0/docs/guide/jar/jar.html">Jar | |||
<a href="http://download.oracle.com/javase/1.5.0/docs/guide/jar/jar.html">Jar | |||
file specification.</a>. Specifically, a manifest element consists of | |||
a set of attributes and sections. These sections in turn may contain | |||
attributes. Note in particular that this may result in manifest lines | |||
@@ -169,7 +169,7 @@ href="#attribute">attribute</a> elements into sections.</p> | |||
attribute will take the value of the Ant property ${user.name}. The | |||
same is true for the ${version} and ${TODAY} properties. This example | |||
produces a MANIFEST.MF that contains | |||
<a href="http://java.sun.com/j2se/1.5.0/docs/guide/versioning/">package | |||
<a href="http://download-llnw.oracle.com/javase/1.5.0/docs/guide/versioning/">package | |||
version identification</a> for the package <code>common</code>.</p> | |||
<p>The manifest produced by the above would look like this:</p> | |||
@@ -31,8 +31,8 @@ | |||
<h3>Description</h3> | |||
<p>Sends SMTP mail with MIME attachments. | |||
<a href="http://java.sun.com/products/javamail/index.html">JavaMail</a> | |||
and <a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">Java | |||
<a href="http://www.oracle.com/technetwork/java/index-jsp-139225.html">JavaMail</a> | |||
and <a href="http://www.oracle.com/technetwork/java/javase/jaf-135115.html">Java | |||
Activation Framework</a> are required for this task.</p> | |||
<p>Multiple files can be attached using <a href="../Types/fileset.html">FileSets.</a></p> | |||
<h3>Parameters</h3> | |||
@@ -252,7 +252,7 @@ about this feature | |||
level. This lets you have optional configuration files for every | |||
project, that team members can customize. | |||
<li>The rules for this format are laid down | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Properties.html#load(java.io.InputStream)">by Sun</a>. | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/util/Properties.html#load%28java.io.InputStream%29">by Sun</a>. | |||
This makes it hard for Team Ant to field bug reports about it. | |||
<li>Trailing spaces are not stripped. It may have been what you wanted. | |||
<li>Want unusual characters? Escape them \u0456 or \" style. | |||
@@ -235,13 +235,7 @@ so the files will only be signed if they are not already signed. | |||
<p> | |||
Timestamped JAR files are a new feature in Java1.5; a feature supported in Ant since | |||
Ant 1.7. Ant does not yet support proxy setup for this singing process, and | |||
the whole TSA feature is not tested yet. Furthermore, the | |||
<a href="http://java.sun.com/j2se/1.5.0/docs/guide/security/time-of-signing-beta1.html"> | |||
official TSA documentation</a> | |||
warns that the API is subject to change. If a future version of Java changes the | |||
API, Ant will break. It may be possible to hide changes if and when they occur, | |||
but this can not be guaranteed. | |||
Ant 1.7. Ant does not yet support proxy setup for this singing process. | |||
</p> | |||
@@ -180,7 +180,7 @@ and <b>abort</b> execution and transaction and fail task.</p> | |||
<td width="78%" valign="top">Control whether the Java statement | |||
object will perform escape substitution.<br> | |||
See <a | |||
href="http://java.sun.com/j2se/1.4.2/docs/api/java/sql/Statement.html#setEscapeProcessing(boolean)">Statement's | |||
href="http://download.oracle.com/javase/6/docs/api/java/sql/Statement.html#setEscapeProcessing%28boolean%29">Statement's | |||
API docs</a> for details. <em>Since Ant 1.6</em>. | |||
<td width="10%" valign="top">No (default=true)</td> | |||
</tr> | |||
@@ -58,7 +58,7 @@ probably in an initialization target.</p> | |||
The Tstamp task supports a <code><format></code> nested element that | |||
allows a property to be set to the current date and time in a given format. | |||
The date/time patterns are as defined in the Java | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html">SimpleDateFormat</a> class. | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html">SimpleDateFormat</a> class. | |||
The format element also allows offsets to be applied to the time to generate different time values. | |||
<br><br> | |||
<table width="60%" border="1" cellpadding="2" cellspacing="0"> | |||
@@ -81,7 +81,7 @@ The format element also allows offsets to be applied to the time to generate dif | |||
</tr> | |||
<tr> | |||
<td valign="top">timezone</td> | |||
<td valign="top">The timezone to use for displaying time. The values are as defined by the Java <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/TimeZone.html">TimeZone</a> class.</td> | |||
<td valign="top">The timezone to use for displaying time. The values are as defined by the Java <a href="http://download.oracle.com/javase/6/docs/api/java/util/TimeZone.html">TimeZone</a> class.</td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
<tr> | |||
@@ -112,7 +112,7 @@ The format element also allows offsets to be applied to the time to generate dif | |||
form is "language, country, variant" but either variant or variant and | |||
country may be omitted. For more information please refer to documentation | |||
for the | |||
<a href="http://java.sun.com/j2se/1.3/docs/api/java/util/Locale.html">Locale</a> | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/util/Locale.html">Locale</a> | |||
class.</td> | |||
<td align="center" valign="top">No</td> | |||
</tr> | |||
@@ -104,7 +104,7 @@ archive.</p> | |||
the <code>untar</code> task.<br> | |||
The character encoding that has been used for filenames | |||
inside the zip file. For a list of possible values see <a | |||
href="http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html">http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html</a>.<br> | |||
href="http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html">http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html</a>.<br> | |||
Defaults to "UTF8", use the magic value | |||
<code>native-encoding</code> for the platform's default character | |||
encoding. | |||
@@ -149,7 +149,7 @@ archive.</p> | |||
<td valign="top">encoding</td> | |||
<td valign="top">The character encoding to use for filenames | |||
inside the zip file. For a list of possible values see <a | |||
href="http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html">http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html</a>. | |||
href="http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html">http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html</a>. | |||
Defaults to the platform's default character encoding. | |||
<br/>See also the <a href="#encoding">discussion below</a></td> | |||
<td align="center" valign="top">No</td> | |||
@@ -33,7 +33,7 @@ in <a href="../Tasks/java.html"><code><java></code></a> and | |||
<p> | |||
Assertions are covered in the | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/guide/lang/assert.html">J2SDK 1.4 documentation</a>, | |||
<a href="http://download.oracle.com/javase/1.4.2/docs/guide/lang/assert.html">J2SDK 1.4 documentation</a>, | |||
and the | |||
<a href="http://java.sun.com/docs/books/jls/assert-spec.html">Java Language Specification</a>. | |||
@@ -32,8 +32,8 @@ works with extensions as defined by the "Optional Package" specification. | |||
<em>Optional Package Versioning</em> in the documentation bundle for your | |||
Java2 Standard Edition package, in file | |||
<code>guide/extensions/versioning.html</code> or online at | |||
<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> | |||
http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> | |||
<a href="http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html"> | |||
http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html.</p> | |||
<h3>Attributes</h3> | |||
<p>The extension type supports the following attributes</a>: | |||
@@ -30,8 +30,8 @@ works with extensions as defined by the "Optional Package" specification. | |||
<em>Optional Package Versioning</em> in the documentation bundle for your | |||
Java2 Standard Edition package, in file | |||
<code>guide/extensions/versioning.html</code> or online at | |||
<a href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html"> | |||
http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.</p> | |||
<a href="http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html"> | |||
http://download.oracle.com/javase/1.3/docs/guide/extensions/versioning.html.</p> | |||
<h3>Nested Elements</h3> | |||
@@ -364,7 +364,7 @@ another dollar-sign in Ant.</p> | |||
<p>The regexp mapper needs a supporting library and an implementation | |||
of <code>org.apache.tools.ant.util.regexp.RegexpMatcher</code> that | |||
hides the specifics of the library. Ant comes with implementations for | |||
<a href="http://java.sun.com/j2se/1.4/docs/api/java/util/regex/package-summary.html" target="_top">the java.util.regex package of JDK 1.4 or higher</a>, | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/util/regex/package-summary.html" target="_top">the java.util.regex package</a>, | |||
<a href="http://jakarta.apache.org/regexp/" target="_top">jakarta-regexp</a> and <a | |||
href="http://jakarta.apache.org/oro/" target="_top">jakarta-ORO</a>. If you compile | |||
from sources and plan to use one of them, make sure the libraries are | |||
@@ -58,7 +58,7 @@ Use the regular expression with id myregexp. | |||
<p> | |||
Ant comes with | |||
wrappers for | |||
<a href="http://java.sun.com/j2se/1.4/docs/api/java/util/regex/package-summary.html" target="_top">the java.util.regex package of JDK 1.4</a>, | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/util/regex/package-summary.html" target="_top">the java.util.regex package</a>, | |||
<a href="http://jakarta.apache.org/regexp/" target="_top">jakarta-regexp</a> | |||
and <a href="http://jakarta.apache.org/oro/" target="_top">jakarta-ORO</a>, | |||
See <a href="../install.html#librarydependencies">installation dependencies</a> | |||
@@ -47,7 +47,7 @@ OASIS "Open Catalog" standard</a>. The catalog entries are used | |||
both for Entity resolution and URI resolution, in accordance with | |||
the <code>org.xml.sax.EntityResolver</code> and <code> | |||
javax.xml.transform.URIResolver</code> interfaces as defined | |||
in the <a href="http://java.sun.com/xml/jaxp">Java API for XML | |||
in the <a href="https://jaxp.dev.java.net/">Java API for XML | |||
Processing (JAXP) Specification</a>.</p> | |||
<p>For example, in a <code>web.xml</code> file, the DTD is referenced as: | |||
<pre> | |||
@@ -93,7 +93,7 @@ directories. Default is 755. <em>since Ant 1.5.2</em>.</td> | |||
<td valign="top">encoding</td> | |||
<td valign="top">The character encoding to use for filenames | |||
inside the zip file. For a list of possible values see <a | |||
href="http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html">http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html</a>. | |||
href="http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html">http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html</a>. | |||
Defaults to the platform's default character encoding. | |||
<b>Only supported by zipfileset.</b></td> | |||
<td align="center" valign="top">No</td> | |||
@@ -564,7 +564,7 @@ mechanism with <code>-autoproxy</code>. | |||
<li><b>With explicit JVM properties.</b><br> | |||
<p> | |||
These are documented <a | |||
href="http://java.sun.com/j2se/1.5.0/docs/guide/net/properties.html" target="_top">by Sun</a>, | |||
href="http://download.oracle.com/javase/1.5.0/docs/guide/net/properties.html" target="_top">by Oracle</a>, | |||
and control the proxy behaviour of the entire JVM. To set them in Ant, declare | |||
them in the <code>ANT_OPTS</code> environment variable. This is the best option | |||
for a non-mobile system. For a laptop, you have to change these settings as you | |||
@@ -986,23 +986,14 @@ you need jakarta-oro 2.0.8 or later, and <a href="#commons-net">commons-net</a>< | |||
<tr> | |||
<td>mail.jar</td> | |||
<td>Mail task with Mime encoding, and the MimeMail task</td> | |||
<td><a href="http://java.sun.com/products/javamail/" | |||
target="_top">http://java.sun.com/products/javamail/</a></td> | |||
</tr> | |||
<tr> | |||
<td>jsse.jar</td> | |||
<td> | |||
Support for SMTP over TLS/SSL <br> | |||
in the Mail task<br> | |||
Already included Java 1.4+</td> | |||
<td><a href="http://java.sun.com/products/jsse/" | |||
target="_top">http://java.sun.com/products/jsse/</a></td> | |||
<td><a href="http://www.oracle.com/technetwork/java/index-jsp-139225.html" | |||
target="_top">http://www.oracle.com/technetwork/java/index-jsp-139225.html</a></td> | |||
</tr> | |||
<tr> | |||
<td>activation.jar</td> | |||
<td>Mail task with Mime encoding, and the MimeMail task</td> | |||
<td><a href="http://java.sun.com/products/javabeans/glasgow/jaf.html" | |||
target="_top">http://java.sun.com/products/javabeans/glasgow/jaf.html</a></td> | |||
<td><a href="http://www.oracle.com/technetwork/java/javase/jaf-135115.html" | |||
target="_top">http://www.oracle.com/technetwork/java/javase/jaf-135115.html</a></td> | |||
</tr> | |||
<tr> | |||
<td>jdepend.jar</td> | |||
@@ -31,31 +31,6 @@ You may need a bigger stack than default, especially if you are using the built | |||
XSLT engine. We recommend you use Apache Xalan; indeed, some tasks (JUnit report in XML, | |||
for example) may not work against the shipping XSL engine. | |||
<h3>Java 1.2</h3> | |||
You may sometimes see messages like | |||
<pre> | |||
A nonfatal internal JIT (3.10.107(x)) error 'chgTarg: Conditional' has | |||
occurred in : | |||
'org/apache/tools/ant/Project.addReference | |||
(Ljava/lang/String;Ljava/lang/Object;)V': Interpreting method. | |||
Please report this error in detail to | |||
http://java.sun.com/cgi-bin/bugreport.cgi | |||
</pre> | |||
These are caused by subtle incompatibilities between the Java1.4+ compiled | |||
release; bugs in the Java runtime that Sun won't fix. Possible solutions:- | |||
<ol> | |||
<li>Upgrade your JVM. | |||
<li>Recompile Ant on a Java1.2 machine | |||
<li>Add <tt>-Djava.compiler=NONE</tt> to | |||
the value of your ANT_OPTS environment variable. This turns the JIT off. | |||
<li>Ignore the messages. | |||
</ol> | |||
<h2>Unix and Linux</h2> | |||
<ul> | |||
@@ -57,7 +57,7 @@ | |||
example, <code>${os.name}</code> expands to the name of the | |||
operating system.</p> | |||
<p>For a list of system properties see | |||
<a href="http://java.sun.com/j2se/1.3/docs/api/java/lang/System.html#getProperties()">the Javadoc of System.getProperties</a>. | |||
<a href="http://download.oracle.com/javase/6/docs/api/java/lang/System.html#getProperties%28%29">the Javadoc of System.getProperties</a>. | |||
</p> | |||
<p>In addition, Ant has some built-in properties:</p> | |||
@@ -284,7 +284,7 @@ use one of the alternate mechanisms to configure the JVM. | |||
<h4>Further reading</h4> | |||
<ul> | |||
<li><a href="http://java.sun.com/j2se/1.5.0/docs/guide/net/properties.html"> | |||
<li><a href="http://download.oracle.com/javase/1.5.0/docs/guide/net/properties.html"> | |||
Java Networking Properties</a>. Notice how not all proxy settings are documented | |||
there. | |||
<li><a href="http://blogs.sun.com/roller/resources/jcc/Proxies.pdf">Proxies</a> | |||
@@ -421,7 +421,7 @@ org.apache.tools.ant.Executor implementation specified here. | |||
<td>name of a supported character set (e.g. UTF-8, ISO-8859-1, US-ASCII)</td> | |||
<td>use as default character set of email messages; use as default for source-, dest- and bundleencoding | |||
in <a href="Tasks/translate.html">translate</a> <br> | |||
see JavaDoc of <a target="_blank" href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">java.nio.charset.Charset</a> | |||
see JavaDoc of <a target="_blank" href="http://download.oracle.com/javase/6/docs/api/java/nio/charset/Charset.html">java.nio.charset.Charset</a> | |||
for more information about character sets (not used in Ant, but has nice docs). | |||
</td> | |||
</tr> | |||
@@ -836,7 +836,7 @@ is the same as directly after the cvs update (without our modifications).</p> | |||
<h3>Test on JDK 1.2</h3> | |||
<p>Until version 1.5 Ant must be able to run on a JDK 1.1. With version 1.6 this is not a | |||
requisite any more. But JDK 1.2 is a must-to-work-with. So we have to test that. You can download older | |||
JDKs from <a href="http://java.sun.com/products/archive/index.html">Sun [8]</a>.</p> | |||
JDKs from <a href="http://www.oracle.com/technetwork/java/archive-139210.html">Oracle [8]</a>.</p> | |||
<p>Clean the ANT_HOME variable, delete the <i>build, bootstrap</i> and <i>dist</i> directory | |||
and point JAVA_HOME to the JDK 1.2 home directory. Then do the <tt>build</tt>, set ANT_HOME | |||
@@ -849,7 +849,7 @@ and run <tt>ant test</tt> (like above).</p> | |||
<h3>Checkstyle</h3> | |||
<p>There are many things we have to ensure. Indentation with 4 spaces, blanks here and there, ... | |||
(all described in the <a href="../ant_task_guidelines.html">Ant Task Guidelines [6]</a> which | |||
includes the <a href="http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html">Sun code style | |||
includes the <a href="http://www.oracle.com/technetwork/java/codeconvtoc-136057.html">Sun code style | |||
[9]</a>). Because there are so many things we would be happy to have a tool for do the checks. | |||
There is one: checkstyle. Checkstyle is available at <a href="http://checkstyle.sourceforge.net/"> | |||
Sourceforge [10]</a> and Ant provides with the <tt>check.xml</tt> a buildfile which will do the job | |||
@@ -956,8 +956,8 @@ Now the new task is uploaded into the bug database. | |||
[5] <a href="Tasks/java.html">Tasks/java.html</a><br> | |||
[6] <a href="http://ant.apache.org/ant_task_guidelines.html">http://ant.apache.org/ant_task_guidelines.html</a><br> | |||
[7] <a href="http://ant.apache.org/cvs.html">http://ant.apache.org/cvs.html</a><br> | |||
[8] <a href="http://java.sun.com/products/archive/index.html">http://java.sun.com/products/archive/index.html</a><br> | |||
[9] <a href="http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html">http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html</a><br> | |||
[8] <a href="http://www.oracle.com/technetwork/java/archive-139210.html">http://www.oracle.com/technetwork/java/archive-139210.html</a><br> | |||
[9] <a href="http://www.oracle.com/technetwork/java/codeconvtoc-136057.html">http://www.oracle.com/technetwork/java/codeconvtoc-136057.html</a><br> | |||
[10] <a href="http://checkstyle.sourceforge.net/">http://checkstyle.sourceforge.net/</a><br> | |||
[11] <a href="http://issues.apache.org/bugzilla/">http://issues.apache.org/bugzilla/</a><br> | |||
[12] <a href="http://issues.apache.org/bugzilla/createaccount.cgi">http://issues.apache.org/bugzilla/createaccount.cgi</a><br> | |||
@@ -1414,7 +1414,7 @@ | |||
<subsection name="J2ME Ant Tasks"> | |||
<p>There are different sets of tasks to help build <a | |||
href="http://java.sun.com/j2me/">Java 2 Platform, Micro | |||
href="http://www.oracle.com/technetwork/java/javame/overview/index.html">Java 2 Platform, Micro | |||
Edition</a> (J2ME) applications.</p> | |||
<subsubsection name="Antenna"> | |||
@@ -1048,7 +1048,7 @@ shell-prompt> m4 foo.m4 > foo | |||
<answer> | |||
<p> | |||
Ant implements the Java | |||
<a href="http://java.sun.com/j2se/1.4.2/docs/guide/jar/jar.html">Jar | |||
<a href="http://download.oracle.com/javase/1.4.2/docs/guide/jar/jar.html">Jar | |||
file specification</a>. Please refer to the notes section where it | |||
discusses the maximum allowable length of a line and the concept of | |||
continuation characters. | |||
@@ -1294,7 +1294,7 @@ while(<STDIN>) { | |||
BuildListener that sends out an email | |||
in the buildFinished() method. Will Glozer | |||
<will.glozer@jda.com> has written such a listener based | |||
on <a href="http://java.sun.com/products/javamail/">JavaMail</a>. | |||
on <a href="http://www.oracle.com/technetwork/java/index-jsp-139225.html">JavaMail</a>. | |||
The source is:</p> | |||
<source><![CDATA[ | |||
@@ -1439,7 +1439,7 @@ ant -listener BuildMonitor -logfile build.log | |||
<p>Make sure that <code>mail.jar</code> from JavaMail and | |||
<code>activation.jar</code> from the | |||
<a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">Java | |||
<a href="http://www.oracle.com/technetwork/java/javase/jaf-135115.html">Java | |||
Beans Activation Framework</a> are in your <code>CLASSPATH</code>.</p> | |||
</answer> | |||
@@ -1614,7 +1614,7 @@ mv /tmp/foo $ANT_HOME/bin/antRun | |||
<p>Ant's class loader implementation uses Java's | |||
delegation model, see <a | |||
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/ClassLoader.html">http://java.sun.com/products/jdk/1.2/docs/api/java/lang/ClassLoader.html</a> | |||
href="http://download.oracle.com/javase/6/docs/api/java/lang/ClassLoader.html">http://download.oracle.com/javase/6/docs/api/java/lang/ClassLoader.html</a> | |||
the paragraph</p> | |||
<blockquote>The <code>ClassLoader</code> class uses a | |||