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 | |||