youys
/
ant

 
			
			   
				 
					
						
						
							
							<html>

<head>
<meta http-equiv="Content-Language" content="en-us">
<title>Ant User Manual</title>
</head>

<body>

<h2><a name="antjar">AntJar</a></h2>
<h3>Description</h3>
<p>An extension of the <a href="jar.html">Jar</a> task with special
treatment for the library descriptor file that should end up in the
<code>META-INF</code> directory of the Ant Archive.</p>
<p>This task validates the provided library descriptor making certain
it specifies the following SYSTEM ID: 
<b>&quot;http://jakarta.apache.org/ant/AntlibV1_0.dtd&quot;</b>. 
This DTD is defined as follows:</p>
<pre>
&lt;?xml version='1.0' encoding="UTF8" ?&gt;

&lt;!-- 
This file defines the XML format for ANT library descriptors.
Descriptors must especify a DOCTYPE of 
"http://jakarta.apache.org/ant/Antlib-V1_0.dtd"
as the SystemId for the document.
--&gt;

&lt;!-- Root element for the Antlib descriptor.                 --&gt;
&lt;!ELEMENT antlib (task | type)* &gt;
&lt;!ATTLIST antlib
          version  CDATA #IMPLIED
&gt;

&lt;!-- Declaration of tasks contained in the library.          --&gt;
&lt;!ELEMENT task EMPTY&gt;
&lt;!ATTLIST task 
          name     CDATA #REQUIRED
          class    CDATA #REQUIRED
&gt;

&lt;!-- Declaration of datatypes contained in the library       --&gt;
&lt;!ELEMENT type EMPTY&gt;
&lt;!ATTLIST type 
          name     CDATA #REQUIRED
          class    CDATA #REQUIRED
&gt;

</pre>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
  <tr>
    <td valign="top"><b>Attribute</b></td>
    <td valign="top"><b>Description</b></td>
    <td align="center" valign="top"><b>Required</b></td>
  </tr>
  <tr>
    <td valign="top">antxml</td>
    <td valign="top">The library descriptor to use (META-INF/antlib.xml).</td>
    <td valign="top" align="center">Yes</td>
  </tr>
  <tr>
    <td valign="top"><b>Others...</b></td>
    <td valign="top">All attributes inherited form the 
                     <a href="jar.html">Jar task</a>.</td>
    <td valign="top" align="center"> </td>
  </tr>
</table>
<h3>Nested elements</h3>
See the nested elements of the <a href="jar.html">Jar task</a>.
<h3>Examples</h3>
<pre>  &lt;antjar file=&quot;${dist}/lib/app.jar&quot; 
       antxml=&quot;${src}/applib.xml&quot; basedir=&quot;${build}/classes&quot;/&gt;</pre>
<p>jars all files in the <code>${build}/classes</code> directory into a file
called <code>app.jar</code> in the <code>${dist}/lib</code> directory and
sets the content of <code>${src}/applib.xml</code> as the library descriptor
in <code>META-INF/antlib.xml</code>.</p>
<p>Here is a sample <code>META-INF/antlib.xml</code>:</p>
<pre>
&lt;?xml version="1.0" encoding="UTF8" ?&gt;
&lt;!DOCTYPE antlib  SYSTEM "http://jakarta.apache.org/ant/Antlib-V1_0.dtd" &gt;

&lt;antlib version="1.0" &gt;
  &lt;task name="case" class="org.apache.ant.contrib.Case" /&gt;
&lt;/antlib&gt;

</pre>
<hr>
<p align="center">Copyright &copy; 2000,2001 Apache Software Foundation. All rights
Reserved.</p>

</body>
</html>