You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by mb...@apache.org on 2005/05/25 23:58:19 UTC
cvs commit: ant/docs/manual/CoreTasks typedef.html
mbenson 2005/05/25 14:58:19
Modified: docs/manual/CoreTasks typedef.html
Log:
various inconsequentials/cleanup
Revision Changes Path
1.20 +34 -37 ant/docs/manual/CoreTasks/typedef.html
Index: typedef.html
===================================================================
RCS file: /home/cvs/ant/docs/manual/CoreTasks/typedef.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- typedef.html 29 Apr 2005 18:58:13 -0000 1.19
+++ typedef.html 25 May 2005 21:58:19 -0000 1.20
@@ -15,8 +15,8 @@
such that this new type or task can be used in the current project.
</p>
<p>
- Tasks are any class that extend org.apache.tools.ant.Task or
- a class that is adapted to a Task using an adapter class.
+ A Task is any class that extends org.apache.tools.ant.Task or
+ can be adapted as a Task using an adapter class.
</p>
<p>
Data types are things like <a href="../using.html#path">paths</a> or
@@ -25,10 +25,9 @@
Custom data types usually need custom tasks to put them to good use.
</p>
<p>
- Two attributes are needed to make a definition,
- the name that identifies this data type uniquely, and the full
- name of the class (including the packages) that implements this
- type.
+ Two attributes are needed to make a definition: the name that
+ identifies this data type uniquely, and the full name of the class
+ (including its package name) that implements this type.
</p>
<p>
You can also define a group of definitions at once using the file or
@@ -44,8 +43,7 @@
<p>
The xml format is described in the
- <a href="../CoreTypes/antlib.html">Antlib</a>
- section.
+ <a href="../CoreTypes/antlib.html">Antlib</a> section.
</p>
<h3>Parameters</h3>
@@ -64,7 +62,7 @@
<tr>
<td valign="top">classname</td>
<td valign="top">the full class name implementing the data type</td>
- <td valign="top" align="center">Yes, unless file or resource
+ <td valign="top" align="center">Yes, unless file or resource
have been specified.</td>
</tr>
<tr>
@@ -75,10 +73,10 @@
<tr>
<td valign="top">resource</td>
<td valign="top">
- Name of the resource to load definitions from.
- If there is multiple resources of this name in the classpath, and the
- format is "properties", the first resource will be loaded, otherwise
- all the resources will be loaded.
+ Name of the resource to load definitions from.
+ If multiple resources by this name are found along the classpath,
+ and the format is "properties", the first resource will be loaded;
+ otherwise all such resources will be loaded.
</td>
<td valign="top" align="center">No</td>
</tr>
@@ -88,41 +86,42 @@
are "properties" or "xml". If the value is "properties" the file/resource
is a property file contains name to classname pairs. If the value
is "xml", the file/resource is an xml file/resource structured according
- to <a href="../CoreTypes/antlib.html">Antlib</a>.
+ to <a href="../CoreTypes/antlib.html">Antlib</a>.
The default is "properties" unless the file/resource name ends with
".xml", in which case the format attribute will have the value "xml".
- (introduced in ant1.6)
+ <b>since Ant 1.6</b>
</td>
<td valign="top" align="center">No</td>
</tr>
<tr>
<td valign="top">classpath</td> <td valign="top">the classpath to
- use when looking up <code>classname</code>.</td> <td
- align="center" valign="top">No</td>
+ use when looking up <code>classname</code>.</td>
+ <td align="center" valign="top">No</td>
</tr>
<tr>
<td valign="top">classpathref</td>
<td valign="top">
- a reference to a classpath to use when looking up <code>classname</code>.</td>
+ a reference to a classpath to use when looking up <code>classname</code>.
+ </td>
<td align="center" valign="top">No</td>
</tr>
<tr>
- <td valign="top">loaderRef</td> <td valign="top">the name of the loader that is
- used to load the class, constructed from the specified classpath. Use this to
- allow multiple tasks/types to be loaded with the same loader, so they can call
- each other. ( introduced in ant1.5 )</td>
+ <td valign="top">loaderRef</td>
+ <td valign="top">the name of the loader that is
+ used to load the class, constructed from the specified classpath. Use
+ this to allow multiple tasks/types to be loaded with the same loader,
+ so they can call each other. <b>since Ant 1.5</b> </td>
<td align="center" valign="top">No</td>
</tr>
<tr>
<td valign="top">onerror</td>
<td valign="top">The action to take if there was a failure in defining the
- type. The values are <i>fail</i> - cause a build exception, <i>report</i>,
- output a warning, but continue, <i>ignore</i>, do nothing.
- (introduced in ant1.6)
- An additional value is <i>failall</i> - causes all behavior of fail but also
- causes a build exception for the resource or file attribute
- if the resource or file is not found.
- (introduced in ant1.7)
+ type. The values are <i>fail</i>: cause a build exception; <i>report</i>:
+ output a warning, but continue; <i>ignore</i>: do nothing.
+ <b>since Ant 1.6</b>
+ An additional value is <i>failall</i>: cause all behavior of fail,
+ as well as a build exception for the resource or file attribute
+ if the resource or file is not found. <b>since Ant 1.7</b>
The default is <i>fail</i>.
</td>
<td valign="top" align="center">No</td>
@@ -134,9 +133,8 @@
"org.apache.tools.ant.TypeAdapter". The adapter class will be used
to wrap the defined class unless the defined class implements/extends
the class defined by the attribute "adaptto".
- If "adaptto" is not set,
- the defined class will always be wrapped.
- (introduced in ant1.6)
+ If "adaptto" is not set, the defined class will always be wrapped.
+ <b>since Ant 1.6</b>
</td>
<td valign="top" align="center">No</td>
</tr>
@@ -146,8 +144,7 @@
adapter attribute.
If the defined class does not implement/extend the interface/class
specified by this attribute, the adaptor class will be used
- to wrap the class.
- (introduced in ant1.6)
+ to wrap the class. <b>since Ant 1.6</b>
</td>
<td valign="top" align="center">No</td>
</tr>
@@ -155,7 +152,7 @@
<td valign="top">uri</td>
<td valign="top">
The uri that this definition should live in.
- <em>since Ant1.6</em>
+ <b>since Ant 1.6</b>
</td>
<td valign="top" align="center">No</td>
</tr>
@@ -163,7 +160,7 @@
<h3>Parameters specified as nested elements</h3>
<h4>classpath</h4>
<p><code>Typedef</code>'s <i>classpath</i> attribute is a
- <a href="../using.html#path">PATH like structure</a> and can also be set
+ <a href="../using.html#path">path-like structure</a> and can also be set
via a nested <i>classpath</i> element.</p>
<h3>Examples</h3>
@@ -177,7 +174,7 @@
extends Task and implements <i>org.apache.tools.ant.TypeAdapter</i>,
and in the execute method invokes <i>run</i> on the proxied object,
one may use a Runnable class as an Ant task. The following fragment
- defines a task called <i>runclock</i>.
+ defines a task called <i>runclock</i>.
</p>
<pre>
<typedef name="runclock"
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org