blob: a84b7a812cfd6017c2194d48bd05be9a2ab05c5d [file] [log] [blame]
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Mozilla/4.7 [en] (WinNT; I) [Netscape]">
<title>AntTasks</title>
</head>
<body link="#0000FF" vlink="#800080">
<center>
<h1>
AntTasks</h1></center>
<b><i>Identifier: </i></b>org.eclipse.ant.core.antTasks
<p><b><i>Description: </i></b>Allows plug-ins to define arbitrary Ant tasks
for use by the Ant infrastructure.&nbsp; The standard Ant infrastructure
allows for the addition of arbitrary tasks.&nbsp; Unfortunately, it is
unlikely that the Ant Core plug-in would have the classes required by these
tasks on its classpath (or that of any of its prerequisites).&nbsp; To
address this, clients should define an extension which plugs into this
extension-point and maps a task name onto a class.&nbsp; The Ant plug-in
can then request that the declaring plug-in load the specified class.
<p><b><i>Configuration Markup:</i></b>
<p><tt>&nbsp;&nbsp; &lt;!ELEMENT antTask EMPTY></tt>
<br><tt>&nbsp;&nbsp; &lt;!ATTLIST antTask</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
CDATA #REQUIRED</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; class&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
CDATA #REQUIRED</tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; library&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
CDATA #REQUIRED</tt>
<br><tt>&nbsp;&nbsp; ></tt>
<ul>
<li>
<b>name -</b> name of the task to be defined</li>
<li>
<b>class</b> - the fully qualified name of a Java class implementing the
task.&nbsp; Generally this class must be a subclass of&nbsp; <tt>org.apache.tools.ant.Task</tt>.</li>
<li>
<b>library</b> - a path relative to the plug-in install location for the
library containing the task</li>
</ul>
<b><i>Examples: </i></b>The following is an example of an object declaration:
<p><tt>&nbsp;&nbsp; &lt;extension point="org.eclipse.ant.core.antTasks"></tt>
<br><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;antTask name="coolTask" class="com.example.CoolTask" library= "lib/examples.jar"/></tt>
<br><tt>&nbsp;&nbsp; &lt;/extension></tt>
<p><b><i>Supplied Implementation:</i></b> The platform itself supplies
a number of tasks including <tt>incremental, javac and refreshLocal</tt>.
<p><a href="hglegal.htm"><img SRC="ngibmcpy.gif" ALT="Copyright IBM Corp. 2000, 2001. All Rights Reserved." BORDER=0 height=12 width=195></a>
</body>
</html>