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">pattern</td> | ||||
<td valign="top">Specifies the pattern to use as a pattern | <td valign="top">Specifies the pattern to use as a pattern | ||||
suitable for <a | 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 | 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> | <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> | <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">encoding</td> | ||||
<td valign="top"> | <td valign="top"> | ||||
Specifies the encoding for the input files. Please see <a | 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 | for a list of possible values. Defaults to the platform's | ||||
default character encoding. | default character encoding. | ||||
</td> | </td> | ||||
@@ -43,7 +43,7 @@ compiler. This is generally faster than parsing the Java source.</p> | |||||
<p> | <p> | ||||
To learn more about how this information is obtained from the class files, | 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> | Virtual Machine Specification</a> | ||||
</p> | </p> | ||||
@@ -147,7 +147,7 @@ to a value other than its default, <code>"add"</code>.</b></p> | |||||
<tr> | <tr> | ||||
<td valign="top">index</td> | <td valign="top">index</td> | ||||
<td valign="top">whether to create an <A | <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 | list</A> to speed up classloading. This is a JDK 1.3+ specific | ||||
feature. Unless you specify additional jars with nested <a | feature. Unless you specify additional jars with nested <a | ||||
href="jar.html#indexjars"><code>indexjars</code></a> elements, only the | href="jar.html#indexjars"><code>indexjars</code></a> elements, only the | ||||
@@ -62,7 +62,7 @@ ignored</p> | |||||
<tr> | <tr> | ||||
<td valign="top">append</td> | <td valign="top">append</td> | ||||
<td valign="top">Append to an existing file (or | <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>. | open a new file / overwrite an existing file</a>)? Default <i>false</i>. | ||||
</td> | </td> | ||||
<td valign="top" align="center">No; ignored unless <i>output</i> indicates a | <td valign="top" align="center">No; ignored unless <i>output</i> indicates a | ||||
@@ -49,7 +49,7 @@ | |||||
<hr> | <hr> | ||||
<h2><a name="introduction">Introduction</a></h2> | <h2><a name="introduction">Introduction</a></h2> | ||||
<p>Ant provides a number of optional tasks for developing 1.x and 2.x | <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> | In general these tasks are specific to the particular vendor's EJB Server.</p> | ||||
<p> The tasks support:<br> | <p> The tasks support:<br> | ||||
@@ -303,7 +303,7 @@ try to set up a new connection.</p> | |||||
<tr> | <tr> | ||||
<td valign="top">serverTimeZoneConfig</td> | <td valign="top">serverTimeZoneConfig</td> | ||||
<td valign="top">Specify as a Java | <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 | 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 | <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 | 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">defaultDateFormatConfig</td> | ||||
<td valign="top">Specify in Java | <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. | SimpleDateFormat</a> notation, (e.g. | ||||
<code>yyyy-MM-dd</code>), the date format generally used by the FTP server | <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. | 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> | <tr> | ||||
<td valign="top">recentDateFormatConfig</td> | <td valign="top">recentDateFormatConfig</td> | ||||
<td valign="top">Specify in Java | <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, | SimpleDateFormat</a> notation, | ||||
(e.g. <code>MMM dd hh:mm</code>) the date format used by the FTP server | (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 | 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> | include an empty one for you.)</p> | ||||
<p>Manifests are processed by the Jar task according to the | <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 | Note in particular that this may result in manifest lines greater than 72 bytes | ||||
being wrapped and continued on the next line.</p> | being wrapped and continued on the next line.</p> | ||||
<p>The Jar task checks whether you specified package information according to the | <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> | versioning specification</a>.</p> | ||||
<p><b>Please note that the zip format allows multiple files of the same | <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> | <tr> | ||||
<td valign="top">index</td> | <td valign="top">index</td> | ||||
<td valign="top">whether to create an <A | <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 | list</A> to speed up classloading. This is a JDK 1.3+ specific | ||||
feature. Unless you specify additional jars with nested <a | feature. Unless you specify additional jars with nested <a | ||||
href="#indexjars"><code>indexjars</code></a> elements, only the | href="#indexjars"><code>indexjars</code></a> elements, only the | ||||
@@ -383,7 +383,7 @@ depend on your manifest:</p> | |||||
<p> | <p> | ||||
The nested <code>service</code> element specifies a service. | The nested <code>service</code> element specifies a service. | ||||
Services are described by | 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 | The approach is to have providers JARs include files named by the service | ||||
provided, for example, | provided, for example, | ||||
META-INF/services/javax.script.ScriptEngineFactory | 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 | <em>Optional Package Versioning</em> in the documentation bundle for your | ||||
Java2 Standard Edition package, in file | Java2 Standard Edition package, in file | ||||
<code>guide/extensions/versioning.html</code> or online at | <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> | <p>See the Extension and ExtensionSet documentation for further details</p> | ||||
<h3>Parameters</h3> | <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 | <em>Optional Package Versioning</em> in the documentation bundle for your | ||||
Java2 Standard Edition package, in file | Java2 Standard Edition package, in file | ||||
<code>guide/extensions/versioning.html</code> or online at | <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> | <p>See the Extension and ExtensionSet documentation for further details</p> | ||||
<h3>Parameters</h3> | <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 | <em>Optional Package Versioning</em> in the documentation bundle for your | ||||
Java2 Standard Edition package, in file | Java2 Standard Edition package, in file | ||||
<code>guide/extensions/versioning.html</code> or online at | <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> | <p>See the Extension and ExtensionSet documentation for further details</p> | ||||
<h3>Parameters</h3> | <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 | <em>Optional Package Versioning</em> in the documentation bundle for your | ||||
Java2 Standard Edition package, in file | Java2 Standard Edition package, in file | ||||
<code>guide/extensions/versioning.html</code> or online at | <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> | <p>See the Extension and ExtensionSet documentation for further details</p> | ||||
<h3>Parameters</h3> | <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 | the task will be run in, you need to explicitly create the full path | ||||
to the JAR file.</p> | to the JAR file.</p> | ||||
<p>When using the <tt>jar</tt> attribute, all classpath settings are | <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>. | specification</a>. | ||||
@@ -703,7 +703,7 @@ with text contents, and the packages may be listed with nested | |||||
<h4>doclet</h4> | <h4>doclet</h4> | ||||
<p>The doclet nested element is used to specify the | <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 | 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 | 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 | 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 | <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 | <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 | 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 | <pre>ejb.bean:t:XDoclet EJB Tag | ||||
todo:a:To Do</pre> | todo:a:To Do</pre> | ||||
<b>Note:</b> The Javadoc reference quide has double quotes around | <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> | <h4><a name="tagletelement">taglet</a></h4> | ||||
<p>The taglet nested element is used to specify custom | <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> | <h5>Parameters</h5> | ||||
<table width="90%" border="1" cellpadding="2" cellspacing="0"> | <table width="90%" border="1" cellpadding="2" cellspacing="0"> | ||||
@@ -796,7 +796,7 @@ the javadoc program. | |||||
<tr> | <tr> | ||||
<td valign="top">name</td> | <td valign="top">name</td> | ||||
<td valign="top">The name of the taglet class | <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> | <code>com.sun.tools.doclets.ToDoTaglet</code></a>)</td> | ||||
<td align="center" valign="top">Yes</td> | <td align="center" valign="top">Yes</td> | ||||
</tr> | </tr> | ||||
@@ -837,7 +837,7 @@ arguments</a>. <em>Since Ant 1.6</em></p> | |||||
<tag name="todo" scope="all" description="To do:"/> | <tag name="todo" scope="all" description="To do:"/> | ||||
<group title="Group 1 Packages" packages="com.dummy.test.a*"/> | <group title="Group 1 Packages" packages="com.dummy.test.a*"/> | ||||
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/> | <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/"/> | <link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/> | ||||
</javadoc></pre> | </javadoc></pre> | ||||
@@ -860,7 +860,7 @@ arguments</a>. <em>Since Ant 1.6</em></p> | |||||
<tag name="todo" scope="all" description="To do:"/> | <tag name="todo" scope="all" description="To do:"/> | ||||
<group title="Group 1 Packages" packages="com.dummy.test.a*"/> | <group title="Group 1 Packages" packages="com.dummy.test.a*"/> | ||||
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/> | <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/"/> | <link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/> | ||||
</javadoc></pre> | </javadoc></pre> | ||||
@@ -883,7 +883,7 @@ arguments</a>. <em>Since Ant 1.6</em></p> | |||||
<tag name="todo" scope="all" description="To do:"/> | <tag name="todo" scope="all" description="To do:"/> | ||||
<group title="Group 1 Packages" packages="com.dummy.test.a*"/> | <group title="Group 1 Packages" packages="com.dummy.test.a*"/> | ||||
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/> | <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/"/> | <link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/> | ||||
</javadoc></pre> | </javadoc></pre> | ||||
@@ -29,7 +29,7 @@ | |||||
<p>Generates JNI headers from a Java class.</p> | <p>Generates JNI headers from a Java class.</p> | ||||
<p> When this task executes, it will generate the C header and source files that | <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 | 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> | (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> | systems are used.</p> | ||||
@@ -34,7 +34,7 @@ replacing or updating an existing file.</p> | |||||
<p>Manifests are processed according to the | <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 | file specification.</a>. Specifically, a manifest element consists of | ||||
a set of attributes and sections. These sections in turn may contain | a set of attributes and sections. These sections in turn may contain | ||||
attributes. Note in particular that this may result in manifest lines | 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 | attribute will take the value of the Ant property ${user.name}. The | ||||
same is true for the ${version} and ${TODAY} properties. This example | same is true for the ${version} and ${TODAY} properties. This example | ||||
produces a MANIFEST.MF that contains | 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> | version identification</a> for the package <code>common</code>.</p> | ||||
<p>The manifest produced by the above would look like this:</p> | <p>The manifest produced by the above would look like this:</p> | ||||
@@ -31,8 +31,8 @@ | |||||
<h3>Description</h3> | <h3>Description</h3> | ||||
<p>Sends SMTP mail with MIME attachments. | <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> | Activation Framework</a> are required for this task.</p> | ||||
<p>Multiple files can be attached using <a href="../Types/fileset.html">FileSets.</a></p> | <p>Multiple files can be attached using <a href="../Types/fileset.html">FileSets.</a></p> | ||||
<h3>Parameters</h3> | <h3>Parameters</h3> | ||||
@@ -252,7 +252,7 @@ about this feature | |||||
level. This lets you have optional configuration files for every | level. This lets you have optional configuration files for every | ||||
project, that team members can customize. | project, that team members can customize. | ||||
<li>The rules for this format are laid down | <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. | 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>Trailing spaces are not stripped. It may have been what you wanted. | ||||
<li>Want unusual characters? Escape them \u0456 or \" style. | <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> | <p> | ||||
Timestamped JAR files are a new feature in Java1.5; a feature supported in Ant since | 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> | </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 | <td width="78%" valign="top">Control whether the Java statement | ||||
object will perform escape substitution.<br> | object will perform escape substitution.<br> | ||||
See <a | 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>. | API docs</a> for details. <em>Since Ant 1.6</em>. | ||||
<td width="10%" valign="top">No (default=true)</td> | <td width="10%" valign="top">No (default=true)</td> | ||||
</tr> | </tr> | ||||
@@ -58,7 +58,7 @@ probably in an initialization target.</p> | |||||
The Tstamp task supports a <code><format></code> nested element that | 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. | 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 | 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. | The format element also allows offsets to be applied to the time to generate different time values. | ||||
<br><br> | <br><br> | ||||
<table width="60%" border="1" cellpadding="2" cellspacing="0"> | <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> | ||||
<tr> | <tr> | ||||
<td valign="top">timezone</td> | <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> | <td align="center" valign="top">No</td> | ||||
</tr> | </tr> | ||||
<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 | form is "language, country, variant" but either variant or variant and | ||||
country may be omitted. For more information please refer to documentation | country may be omitted. For more information please refer to documentation | ||||
for the | 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> | class.</td> | ||||
<td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
</tr> | </tr> | ||||
@@ -104,7 +104,7 @@ archive.</p> | |||||
the <code>untar</code> task.<br> | the <code>untar</code> task.<br> | ||||
The character encoding that has been used for filenames | The character encoding that has been used for filenames | ||||
inside the zip file. For a list of possible values see <a | 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 | Defaults to "UTF8", use the magic value | ||||
<code>native-encoding</code> for the platform's default character | <code>native-encoding</code> for the platform's default character | ||||
encoding. | encoding. | ||||
@@ -149,7 +149,7 @@ archive.</p> | |||||
<td valign="top">encoding</td> | <td valign="top">encoding</td> | ||||
<td valign="top">The character encoding to use for filenames | <td valign="top">The character encoding to use for filenames | ||||
inside the zip file. For a list of possible values see <a | 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. | Defaults to the platform's default character encoding. | ||||
<br/>See also the <a href="#encoding">discussion below</a></td> | <br/>See also the <a href="#encoding">discussion below</a></td> | ||||
<td align="center" valign="top">No</td> | <td align="center" valign="top">No</td> | ||||
@@ -33,7 +33,7 @@ in <a href="../Tasks/java.html"><code><java></code></a> and | |||||
<p> | <p> | ||||
Assertions are covered in the | 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 | and the | ||||
<a href="http://java.sun.com/docs/books/jls/assert-spec.html">Java Language Specification</a>. | <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 | <em>Optional Package Versioning</em> in the documentation bundle for your | ||||
Java2 Standard Edition package, in file | Java2 Standard Edition package, in file | ||||
<code>guide/extensions/versioning.html</code> or online at | <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> | <h3>Attributes</h3> | ||||
<p>The extension type supports the following attributes</a>: | <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 | <em>Optional Package Versioning</em> in the documentation bundle for your | ||||
Java2 Standard Edition package, in file | Java2 Standard Edition package, in file | ||||
<code>guide/extensions/versioning.html</code> or online at | <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> | <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 | <p>The regexp mapper needs a supporting library and an implementation | ||||
of <code>org.apache.tools.ant.util.regexp.RegexpMatcher</code> that | of <code>org.apache.tools.ant.util.regexp.RegexpMatcher</code> that | ||||
hides the specifics of the library. Ant comes with implementations for | 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 | <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 | 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 | 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> | <p> | ||||
Ant comes with | Ant comes with | ||||
wrappers for | 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> | <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>, | and <a href="http://jakarta.apache.org/oro/" target="_top">jakarta-ORO</a>, | ||||
See <a href="../install.html#librarydependencies">installation dependencies</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 | both for Entity resolution and URI resolution, in accordance with | ||||
the <code>org.xml.sax.EntityResolver</code> and <code> | the <code>org.xml.sax.EntityResolver</code> and <code> | ||||
javax.xml.transform.URIResolver</code> interfaces as defined | 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> | Processing (JAXP) Specification</a>.</p> | ||||
<p>For example, in a <code>web.xml</code> file, the DTD is referenced as: | <p>For example, in a <code>web.xml</code> file, the DTD is referenced as: | ||||
<pre> | <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">encoding</td> | ||||
<td valign="top">The character encoding to use for filenames | <td valign="top">The character encoding to use for filenames | ||||
inside the zip file. For a list of possible values see <a | 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. | Defaults to the platform's default character encoding. | ||||
<b>Only supported by zipfileset.</b></td> | <b>Only supported by zipfileset.</b></td> | ||||
<td align="center" valign="top">No</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> | <li><b>With explicit JVM properties.</b><br> | ||||
<p> | <p> | ||||
These are documented <a | 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 | 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 | 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 | 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> | <tr> | ||||
<td>mail.jar</td> | <td>mail.jar</td> | ||||
<td>Mail task with Mime encoding, and the MimeMail task</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> | ||||
<tr> | <tr> | ||||
<td>activation.jar</td> | <td>activation.jar</td> | ||||
<td>Mail task with Mime encoding, and the MimeMail task</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> | ||||
<tr> | <tr> | ||||
<td>jdepend.jar</td> | <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, | 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. | 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> | <h2>Unix and Linux</h2> | ||||
<ul> | <ul> | ||||
@@ -57,7 +57,7 @@ | |||||
example, <code>${os.name}</code> expands to the name of the | example, <code>${os.name}</code> expands to the name of the | ||||
operating system.</p> | operating system.</p> | ||||
<p>For a list of system properties see | <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> | ||||
<p>In addition, Ant has some built-in properties:</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> | <h4>Further reading</h4> | ||||
<ul> | <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 | Java Networking Properties</a>. Notice how not all proxy settings are documented | ||||
there. | there. | ||||
<li><a href="http://blogs.sun.com/roller/resources/jcc/Proxies.pdf">Proxies</a> | <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>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 | <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> | 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). | for more information about character sets (not used in Ant, but has nice docs). | ||||
</td> | </td> | ||||
</tr> | </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> | <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 | <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 | 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 | <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 | 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> | <h3>Checkstyle</h3> | ||||
<p>There are many things we have to ensure. Indentation with 4 spaces, blanks here and there, ... | <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 | (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. | [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/"> | 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 | 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> | [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> | [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> | [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> | [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> | [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> | [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"> | <subsection name="J2ME Ant Tasks"> | ||||
<p>There are different sets of tasks to help build <a | <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> | Edition</a> (J2ME) applications.</p> | ||||
<subsubsection name="Antenna"> | <subsubsection name="Antenna"> | ||||
@@ -1048,7 +1048,7 @@ shell-prompt> m4 foo.m4 > foo | |||||
<answer> | <answer> | ||||
<p> | <p> | ||||
Ant implements the Java | 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 | file specification</a>. Please refer to the notes section where it | ||||
discusses the maximum allowable length of a line and the concept of | discusses the maximum allowable length of a line and the concept of | ||||
continuation characters. | continuation characters. | ||||
@@ -1294,7 +1294,7 @@ while(<STDIN>) { | |||||
BuildListener that sends out an email | BuildListener that sends out an email | ||||
in the buildFinished() method. Will Glozer | in the buildFinished() method. Will Glozer | ||||
<will.glozer@jda.com> has written such a listener based | <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> | The source is:</p> | ||||
<source><![CDATA[ | <source><![CDATA[ | ||||
@@ -1439,7 +1439,7 @@ ant -listener BuildMonitor -logfile build.log | |||||
<p>Make sure that <code>mail.jar</code> from JavaMail and | <p>Make sure that <code>mail.jar</code> from JavaMail and | ||||
<code>activation.jar</code> from the | <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> | Beans Activation Framework</a> are in your <code>CLASSPATH</code>.</p> | ||||
</answer> | </answer> | ||||
@@ -1614,7 +1614,7 @@ mv /tmp/foo $ANT_HOME/bin/antRun | |||||
<p>Ant's class loader implementation uses Java's | <p>Ant's class loader implementation uses Java's | ||||
delegation model, see <a | 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> | the paragraph</p> | ||||
<blockquote>The <code>ClassLoader</code> class uses a | <blockquote>The <code>ClassLoader</code> class uses a | ||||