Menu
▾
▴
[Tm4j-commits] tm4j/lib/ant/apache-ant-1.7.0/docs/manual/OptionalTasks BorlandEJBTasks.html, NONE, 1.1 BorlandGenerateClient.html, NONE, 1.1 antlr.html, NONE, 1.1 attrib.html, NONE, 1.1 cab.html, NONE, 1.1 ccm.html, NONE, 1.1 chgrp.html, NONE, 1.1 chown.html, NONE, 1.1 clearcase.html, NONE, 1.1 csc.html, NONE, 1.1 depend.html, NONE, 1.1 dotnet.html, NONE, 1.1 echoproperties.html, NONE, 1.1 ejb.html, NONE, 1.1 ftp.html, NONE, 1.1 ilasm.html, NONE, 1.1 ildasm.html, NONE, 1.1 image-classdiagram.gif, NONE, 1.1 image.html, NONE, 1.1 importtypelib.html, NONE, 1.1 jarlib-available.html, NONE, 1.1 jarlib-display.html, NONE, 1.1 jarlib-manifest.html, NONE, 1.1 jarlib-resolve.html, NONE, 1.1 javacc.html, NONE, 1.1 javah.html, NONE, 1.1 jdepend.html, NONE, 1.1 jjdoc.html, NONE, 1.1 jjtree.html, NONE, 1.1 jlink.html, NONE, 1.1 jsharpc.html, NONE, 1.1 jspc.html, NONE, 1.1 junit.html, NONE, 1.1 junitreport.html, NONE, 1.1 mimemail.html, NONE, 1.1 native2ascii.html, NONE, 1.1 netrexxc.html, NONE, 1.1 perforce.html, NONE, 1.1 propertyfile.html, NONE, 1.1 pvcstask.html, NONE, 1.1 renameextensions.html, NONE, 1.1 replaceregexp.html, NONE, 1.1 rexec.html, NONE, 1.1 rpm.html, NONE, 1.1 schemavalidate.html, NONE, 1.1 scp.html, NONE, 1.1 script.html, NONE, 1.1 scriptdef.html, NONE, 1.1 serverdeploy.html, NONE, 1.1 setproxy.html, NONE, 1.1 sos.html, NONE, 1.1 sound.html, NONE, 1.1 splash.html, NONE, 1.1 sshexec.html, NONE, 1.1 starteam.html, NONE, 1.1 stylebook.html, NONE, 1.1 symlink.html, NONE, 1.1 telnet.html, NONE, 1.1 translate.html, NONE, 1.1 vbc.html, NONE, 1.1 vss.html, NONE, 1.1 wljspc.html, NONE, 1.1 wsdltodotnet.html, NONE, 1.1 xmlvalidate.html, NONE, 1.1
Update of /cvsroot/tm4j/tm4j/lib/ant/apache-ant-1.7.0/docs/manual/OptionalTasks In directory sc8-pr-cvs10.sourceforge.net:/tmp/cvs-serv12860/lib/ant/apache-ant-1.7.0/docs/manual/OptionalTasks Added Files: BorlandEJBTasks.html BorlandGenerateClient.html antlr.html attrib.html cab.html ccm.html chgrp.html chown.html clearcase.html csc.html depend.html dotnet.html echoproperties.html ejb.html ftp.html ilasm.html ildasm.html image-classdiagram.gif image.html importtypelib.html jarlib-available.html jarlib-display.html jarlib-manifest.html jarlib-resolve.html javacc.html javah.html jdepend.html jjdoc.html jjtree.html jlink.html jsharpc.html jspc.html junit.html junitreport.html mimemail.html native2ascii.html netrexxc.html perforce.html propertyfile.html pvcstask.html renameextensions.html replaceregexp.html rexec.html rpm.html schemavalidate.html scp.html script.html scriptdef.html serverdeploy.html setproxy.html sos.html sound.html splash.html sshexec.html starteam.html stylebook.html symlink.html telnet.html translate.html vbc.html vss.html wljspc.html wsdltodotnet.html xmlvalidate.html Log Message: Update 4 years old ant. --- NEW FILE: setproxy.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <title>Setproxy Task</title> </head> <body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"> <table border="0" width="100%" cellspacing="4"> <!-- PAGE HEADER --> <tr> <td> <table border="0" width="100%"><tr> <td valign="bottom"> <font size="+3" face="arial,helvetica,sanserif"><strong>Setproxy Task</strong></font> <br><font face="arial,helvetica,sanserif">Sets Java's web proxy properties, so that tasks and code run in the same JVM can have through-the-firewall access to remote web sites, and remote ftp sites.</font> </td> <td> <!-- PROJECT LOGO --> <a href="http://ant.apache.org/"> <img src="../../images/ant_logo_large.gif" align="right" alt="Apache Ant" border="0"> </a> </td> </tr></table> </td> </tr> <!-- START RIGHT SIDE MAIN BODY --> <tr> <td valign="top" align="left"> <!-- Applying task/long-description --> <!-- Start Description --> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td> </td></tr> <tr><td bgcolor="#525D76"> <font color="#ffffff" face="arial,helvetica.sanserif"> <a name="description"> <strong>Description</strong></a></font> </td></tr> <tr><td><blockquote> Sets Java's web proxy properties, so that tasks and code run in the same JVM can have through-the-firewall access to remote web sites, and remote ftp sites. You can nominate an http and ftp proxy, or a socks server, reset the server settings, or do nothing at all. <p> Examples <pre><setproxy/></pre> do nothing <pre><setproxy proxyhost="firewall"/></pre> set the proxy to firewall:80 <pre><setproxy proxyhost="firewall" proxyport="81"/></pre> set the proxy to firewall:81 <pre><setproxy proxyhost=""/></pre> stop using the http proxy; don't change the socks settings <pre><setproxy socksproxyhost="socksy"/></pre> use socks via socksy:1080 <pre><setproxy socksproxyhost=""/></pre> stop using the socks server. <p> You can set a username and password for http with the <tt>proxyHost</tt> and <tt>proxyPassword</tt> attributes. On Java1.4 and above these can also be used against SOCKS5 servers. </p> </blockquote></td></tr> </table> <!-- End Description --> <!-- Ignore --> <!-- Start Attributes --> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td> </td></tr> <tr><td bgcolor="#525D76"> <font color="#ffffff" face="arial,helvetica.sanserif"> <a name="attributes"> <strong>Parameters</strong></a></font> </td></tr> <tr><td><blockquote> <table> <tr> <td bgcolor="#cccccc" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Attribute</b></font> </td> <td bgcolor="#cccccc" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Description</b></font> </td> <td bgcolor="#cccccc" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Type</b></font> </td> <td bgcolor="#cccccc" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Requirement</b></font> </td> </tr> <!-- Attribute Group --> <!-- Attribute Group --> <!-- Attribute --> <tr> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">nonproxyhosts</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">A list of hosts to bypass the proxy on. These should be separated with the vertical bar character '|'. Only in Java 1.4 does ftp use this list. e.g. fozbot.corp.sun.com|*.eng.sun.com</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font> </td> <td bgcolor="#eeeeee" valign="top" align="left" rowspan="7"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">Optional</font> </td> </tr> <!-- Attribute --> <tr> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">proxyhost</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">the HTTP/ftp proxy host. Set this to "" for the http proxy option to be disabled</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font> </td> </tr> <!-- Attribute --> <tr> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">proxypassword</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">Set the password for the proxy. Used only if the proxyUser is set.</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font> </td> </tr> <!-- Attribute --> <tr> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">proxyport</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">the HTTP/ftp proxy port number; default is 80</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">int</font> </td> </tr> <!-- Attribute --> <tr> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">proxyuser</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">set the proxy user. Probably requires a password to accompany this setting. Default=""</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font> </td> </tr> <!-- Attribute --> <tr> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">socksproxyhost</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">The name of a Socks server. Set to "" to turn socks proxying off.</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font> </td> </tr> <!-- Attribute --> <tr> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">socksproxyport</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">Set the ProxyPort for socks connections. The default value is 1080</font> </td> <td bgcolor="#eeeeee" valign="top" align="left"> <font color="#000000" size="-1" face="arial,helvetica,sanserif">int</font> </td> </tr> </table> </blockquote></td></tr> </table> <!-- End Attributes --> <!-- Start Elements --> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td> </td></tr> <tr><td bgcolor="#525D76"> <font color="#ffffff" face="arial,helvetica.sanserif"> <a name="elements"> <strong>Parameters as nested elements</strong></a></font> </td></tr> <tr><td><blockquote> </blockquote></td></tr> </table> <!-- End Elements --> </td> </tr> <!-- END RIGHT SIDE MAIN BODY --> </table> </body> </html> --- NEW FILE: BorlandGenerateClient.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> <title>BorlandGenerateClient Task</title> </head> <body> <h2><a name="log">BorlandGenerateClient</a></h2> <p>by Benoit Moussaud (<a href="mailto:ben...@cr...">ben...@cr...</a>)</p> <h3>Description</h3> <p>The BorlandGenerateClient is a task dedicated to Borland Application Server v 4.5. It offers to generate the client jar file corresponding to an ejb jar file.</p> <h3>Parameters</h3> <table border="1" cellpadding="2" cellspacing="0"> <tr> <td valign="top" width="63"><b>Attribute</b></td> <td valign="top" width="915"><b>Description</b></td> <td align="center" valign="top" width="62"><b>Required</b></td> </tr> <tr> <td valign="top" width="63">ejbjar</td> <td valign="top" width="915">ejb jar file</td> <td align="center" valign="middle" width="62">yes</td> </tr> <tr> <td valign="top" width="63">debug</td> <td valign="top" width="915">If true, turn on the debug mode for each borland tools (java2iiop, iastool ...) default = false</td> <td align="center" valign="middle" width="62">no</td> </tr> <tr> <td valign="top" width="63">clientjar</td> <td valign="top" width="915">client jar file name. If missing the client jar file name is build using the ejbjar file name: ejbjar = hellobean-ejb.jar => hellobean-ejbclient.jar</td> <td align="center" valign="middle" width="62">no</td> </tr> <tr> <td valign="top" width="63">mode</td> <td valign="top" width="915">choose the command launching mode. Two values: java or fork. default = fork. java is not supported for version=5.Possibility to specify a classpath.</td> <td align="center" valign="middle" width="62">no</td> </tr> <tr> <td valign="top" width="63">version</td> <td valign="top" width="915">set the Borland Application Version. <ul> <li>4 means B.A.S (Borland Application Server 4.x)</li> <li>5 means B.E.S (Borland Application Server 5.x)</li> </ul> </td> <td align="center" valign="middle" width="62">No, defaults to 4</td> </tr> </table> <h3>Examples</h3> <p>The following build.xml snippet is an example of how to use Borland element into the ejbjar task using the java mode.</p> <pre> <blgenclient ejbjar="lib/secutest-ejb.jar" clientjar="lib/client.jar" debug="true" mode="fork"> version="5"> <classpath> <pathelement location="mymodule.jar"/> </classpath> </blgenclient> </pre> <pre> </pre> </body> </html> --- NEW FILE: jarlib-manifest.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> <title>jarlib-manifest Task</title> </head> <body> <h2><a name="jarlib-manifest">jarlib-manifest</a></h2> <h3>Description</h3> <p>Task to generate a manifest that declares all the dependencies in manifest. The dependencies are determined by looking in the specified path and searching for Extension / "Optional Package" specifications in the manifests of the jars.</p> <p>Note that this task works with extensions as defined by the "Optional Package" specification. For more information about optional packages, see the document <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> <p>See the Extension and ExtensionSet documentation for further details</p> <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">destfile</td> <td valign="top">The file to generate Manifest into</td> <td valign="top" align="center">Yes.</td> </tr> </table> <h3>Parameters specified as nested elements</h3> <h4>extension</h4> <p><a href="../OptionalTypes/extension.html">Extension</a> the extension that this library implements.</p> <h4>depends</h4> <p><a href="../OptionalTypes/extensionset.html">ExtensionSet</a>s containing all dependencies for jar.</p> <h4>options</h4> <p><a href="../OptionalTypes/extensionset.html">ExtensionSet</a>s containing all optional dependencies for jar. (Optional dependencies will be used if present else they will be ignored)</p> <h3>Examples</h3> <p><b>Basic Manifest generated for single Extension</b></p> <pre> <extension id="e1" extensionName="MyExtensions" specificationVersion="1.0" specificationVendor="Peter Donald" implementationVendorID="vv" implementationVendor="Apache" implementationVersion="2.0" implementationURL="http://somewhere.com"/> <jarlib-manifest destfile="myManifest.txt"> <extension refid="e1"/> </jarlib-manifest> </pre> <p><b>Search for extension in fileset</b></p> <p><b>A large example with required and optional dependencies</b></p> <pre> <extension id="e1" extensionName="MyExtensions" specificationVersion="1.0" specificationVendor="Peter Donald" implementationVendorID="vv" implementationVendor="Apache" implementationVersion="2.0" implementationURL="http://somewhere.com"/> <extensionSet id="option.ext"> <libfileset dir="lib/option"> <include name="**/*.jar"/> </libfileset> </extensionSet> <extensionSet id="depends.ext"> <libfileset dir="lib/required"> <include name="*.jar"/> </libfileset> </extensionSet> <jarlib-manifest destfile="myManifest.txt"> <extension refid="e1"/> <depends refid="depends.ext"/> <options refid="option.ext"/> </jarlib-manifest> </pre> </body> </html> --- NEW FILE: perforce.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> [...967 lines suppressed...] additional global options to be set.<br> Added p4fstat task</td> </tr> <tr> <td valign="top">May 2003</td> <td valign="top">V1.3</td> <td valign="top">Added p4labelsync, p4resolve, p4integrate.<br> Changed p4submit (detection of changes of change numbers, and of failed submits due to resolution needed)</td> </tr> <tr> <td valign="top">Jan 2004</td> <td valign="top">ant 1.6.1</td> <td valign="top"> Changed p4submit, needsresolveproperty and changeproperty added</td> </tr> </table> </body> </html> --- NEW FILE: cab.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> <title>Cab Task</title> </head> <body> <h2><a name="cab">Cab</a></h2> <h3>Description</h3> <p>The cab task creates Microsoft cab archive files. It is invoked similar to the <a href="../CoreTasks/jar.html">jar</a> or <a href="../CoreTasks/zip.html">zip</a> tasks. This task will work on Windows using the external cabarc tool (provided by Microsoft) which must be located in your executable path.</p> <p>To use this task on other platforms you need to download and compile libcabinet from <a href="http://trill.cis.fordham.edu/~barbacha/cabinet_library/"> http://trill.cis.fordham.edu/~barbacha/cabinet_library/</a>.</p> <p>See the section on <a href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the inclusion/exclusion of files works, and how to write patterns.</p> <p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and supports all attributes of <code><fileset></code> (<code>dir</code> becomes <code>basedir</code>) as well as the nested <code><include></code>, <code><exclude></code> and <code><patternset></code> elements.</p> <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">cabfile</td> <td valign="top">the name of the cab file to create.</td> <td valign="top" align="center">Yes</td> </tr> <tr> <td valign="top">basedir</td> <td valign="top">the directory to start archiving files from.</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">verbose</td> <td valign="top">set to "yes" if you want to see the output from the cabarc tool. defaults to "no".</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">compress</td> <td valign="top">set to "no" to store files without compressing. defaults to "yes".</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">options</td> <td valign="top">use to set additional command-line options for the cabarc tool. should not normally be necessary.</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">includes</td> <td valign="top">comma- or space-separated list of patterns of files that must be included. All files are included when omitted.</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">includesfile</td> <td valign="top">the name of a file. Each line of this file is taken to be an include pattern</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">excludes</td> <td valign="top">comma- or space-separated list of patterns of files that must be excluded. No files (except default excludes) are excluded when omitted.</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">excludesfile</td> <td valign="top">the name of a file. Each line of this file is taken to be an exclude pattern</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">defaultexcludes</td> <td valign="top">indicates whether default excludes should be used or not ("yes"/"no"). Default excludes are used when omitted.</td> <td valign="top" align="center">No</td> </tr> </table> <h3>Parameters specified as nested elements</h3> <h4>fileset</h4> <p>The cab task supports one nested <a href="../CoreTypes/fileset.html"><code><fileset></code></a> element to specify the files to be included in the archive. If this is specified, the "basedir" attribute cannot be used. </p> <h3>Examples</h3> <blockquote><pre> <cab cabfile="${dist}/manual.cab" basedir="htdocs/manual" /> </pre></blockquote> <p>cabs all files in the htdocs/manual directory into a file called manual.cab in the ${dist} directory.</p> <blockquote><pre> <cab cabfile="${dist}/manual.cab" basedir="htdocs/manual" excludes="mydocs/**, **/todo.html" /> </pre></blockquote> <p>cabs all files in the htdocs/manual directory into a file called manual.cab in the ${dist} directory. Files in the directory mydocs, or files with the name todo.html are excluded.</p> <blockquote><pre> <cab cabfile="${dist}/manual.cab" basedir="htdocs/manual" includes="api/**/*.html" excludes="**/todo.html" verbose="yes" /> </pre></blockquote> <p>Cab all files in the htdocs/manual directory into a file called manual.cab in the ${dist} directory. Only html files under the directory api are archived, and files with the name todo.html are excluded. Output from the cabarc tool is displayed in the build output.</p> <blockquote><pre> <cab cabfile="${dist}/manual.cab" verbose="yes"> <fileset dir="htdocs/manual" includes="api/**/*.html" excludes="**/todo.html" /> </cab> </pre></blockquote> <p>is equivalent to the example above.</p> </body> </html> --- NEW FILE: jarlib-available.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> <title>jarlib-available Task</title> </head> <body> <h2><a name="jarlib-available">jarlib-available</a></h2> <h3>Description</h3> <p>Check whether an extension is present in a fileset or an extensionSet. If the extension is present then a property is set.</p> <p>Note that this task works with extensions as defined by the "Optional Package" specification. For more information about optional packages, see the document <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> <p>See the Extension and ExtensionSet documentation for further details</p> <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">property</td> <td valign="top">The name of property to set if extensions is available.</td> <td valign="top" align="center">Yes</td> </tr> <tr> <td valign="top">file</td> <td valign="top">The file to check for extension</td> <td valign="top" align="center">No, one of file, nested ExtensionSet or nested fileset must be present.</td> </tr> </table> <h3>Parameters specified as nested elements</h3> <h4>extension</h4> <p><a href="../OptionalTypes/extension.html">Extension</a> the extension to search for.</p> <h4>fileset</h4> <p><a href="../CoreTypes/fileset.html">FileSet</a>s are used to select sets of files to check for extension.</p> <h4>extensionSet</h4> <p><a href="../OptionalTypes/extensionset.html">ExtensionSet</a>s is the set of extensions to search for extension in.</p> <h3>Examples</h3> <p><b>Search for extension in single file</b></p> <pre> <jarlib-available property="myext.present" file="myfile.jar"> <extension extensionName="org.apache.tools.ant" specificationVersion="1.4.9" specificationVendor="Apache Software Foundation"/> </jarlib-available> </pre> <p><b>Search for extension in single file referencing external Extension</b></p> <pre> <extension id="myext" extensionName="org.apache.tools.ant" specificationVersion="1.4.9" specificationVendor="Apache Software Foundation"/> <jarlib-available property="myext.present" file="myfile.jar"> <extension refid="myext"/> </jarlib-available> </pre> <p><b>Search for extension in fileset</b></p> <pre> <extension id="myext" extensionName="org.apache.tools.ant" specificationVersion="1.4.9" specificationVendor="Apache Software Foundation"/> <jarlib-available property="myext.present"> <extension refid="myext"/> <fileset dir="lib"> <include name="*.jar"/> </fileset> </jarlib-available> </pre> <p><b>Search for extension in extensionSet</b></p> <pre> <extension id="myext" extensionName="org.apache.tools.ant" specificationVersion="1.4.9" specificationVendor="Apache Software Foundation"/> <jarlib-available property="myext.present"> <extension refid="myext"/> <extensionSet id="exts3"> <libfileset includeUrl="false" includeImpl="true" dir="lib"> <include name="*.jar"/> </libfileset> </extensionSet> </jarlib-available> </pre> </body> </html> --- NEW FILE: jarlib-resolve.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> <title>jarlib-resolve Task</title> </head> <body> <h2><a name="jarlib-resolve">jarlib-resolve</a></h2> <h3>Description</h3> <p>Try to locate a jar to satisfy an extension and place location of jar into property. The task allows you to add a number of resolvers that are capable of locating a library for a specific extension. Each resolver will be attempted in specified order until library is found or no resolvers are left. If no resolvers are left and failOnError is true then a BuildException will be thrown.</p> <p>Note that this task works with extensions as defined by the "Optional Package" specification. For more information about optional packages, see the document <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> <p>See the Extension and ExtensionSet documentation for further details</p> <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">property</td> <td valign="top">The name of property to set to library location.</td> <td valign="top" align="center">Yes</td> </tr> <tr> <td valign="top">failOnError</td> <td valign="top">True if failure to locate library should result in build exception.</td> <td valign="top" align="center">No, defaults to true.</td> </tr> <tr> <td valign="top">checkExtension</td> <td valign="top">True if libraries returned by nested resolvers should be checked to see if they supply extension.</td> <td valign="top" align="center">No, defaults to true.</td> </tr> </table> <h3>Parameters specified as nested elements</h3> <h4>extension</h4> <p><a href="../OptionalTypes/extension.html">Extension</a> the extension to resolve. Must be present</p> <h4>location</h4> <p>The location sub element allows you to look for a library in a location relative to project directory.</p> <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">location</td> <td valign="top">The pathname of library.</td> <td valign="top" align="center">Yes</td> </tr> </table> <h4>url</h4> <p>The url resolver allows you to download a library from a URL to a local file.</p> <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">url</td> <td valign="top">The URL to download.</td> <td valign="top" align="center">Yes</td> </tr> <tr> <td valign="top">destfile</td> <td valign="top">The file to download URL into.</td> <td valign="top" align="center">No, But one of destfile or destdir must be present</td> </tr> <tr> <td valign="top">destdir</td> <td valign="top">The directory in which to place downloaded file.</td> <td valign="top" align="center">No, But one of destfile or destdir must be present</td> </tr> </table> <h4>ant</h4> <p>The ant resolver allows you to run a ant build file to generate a library.</p> <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">antfile</td> <td valign="top">The build file.</td> <td valign="top" align="center">Yes</td> </tr> <tr> <td valign="top">destfile</td> <td valign="top">The file that the ant build creates.</td> <td valign="top" align="center">Yes</td> </tr> <tr> <td valign="top">target</td> <td valign="top">The target to run in build file.</td> <td valign="top" align="center">No</td> </tr> </table> <h3>Examples</h3> <p><b>Resolve Extension to file.</b> If file does not exist or file does not implement extension then throw an exception.</p> <pre> <extension id="dve.ext" extensionName="org.realityforge.dve" specificationVersion="1.2" specificationVendor="Peter Donald"/> <jarlib-resolve property="dve.library"> <extension refid="dve.ext"/> <location location="/opt/jars/dve.jar"/> </jarlib-resolve> </pre> <p><b>Resolve Extension to url.</b> If url does not exist or can not write to destfile or files does not implement extension then throw an exception.</p> <pre> <extension id="dve.ext" extensionName="org.realityforge.dve" specificationVersion="1.2" specificationVendor="Peter Donald"/> <jarlib-resolve property="dve.library"> <extension refid="dve.ext"/> <url url="http://www.realityforge.net/jars/dve.jar" destfile="lib/dve.jar"/> </jarlib-resolve> </pre> <p><b>Resolve Extension to file produce by ant build.</b> If file does not get produced or ant file is missing or build fails then throw an exception (Note does not check that library implements extension).</p> <pre> <extension id="dve.ext" extensionName="org.realityforge.dve" specificationVersion="1.2" specificationVendor="Peter Donald"/> <jarlib-resolve property="dve.library" checkExtension="false"> <extension refid="dve.ext"/> <ant antfile="../dve/build.xml" target="main" destfile="lib/dve.jar"/> </jarlib-resolve> </pre> <p><b>Resolve Extension via multiple methods.</b> First check local file to see if it implements extension. If it does not then try to build it from source in parallel directory. If that fails then finally try to download it from a website. If all steps fail then throw a build exception.</p> <pre> <extension id="dve.ext" extensionName="org.realityforge.dve" specificationVersion="1.2" specificationVendor="Peter Donald"/> <jarlib-resolve property="dve.library"> <extension refid="dve.ext"/> <location location="/opt/jars/dve.jar"/> <ant antfile="../dve/build.xml" target="main" destfile="lib/dve.jar"/> <url url="http://www.realityforge.net/jars/dve.jar" destfile="lib/dve.jar"/> </jarlib-resolve> </pre> </body> </html> --- NEW FILE: antlr.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> <title>ANTLR Task</title> </head> <body> <h2><a name="antlr">ANTLR</a></h2> <h3>Description</h3> <p> Invokes the <a HREF="http://www.antlr.org/" target="_top">ANTLR</a> Translator generator on a grammar file. </p> <p> To use the ANTLR task, set the <i>target</i> attribute to the name of the grammar file to process. Optionally, you can also set the <i>outputdirectory</i> to write the generated file to a specific directory. Otherwise ANTLR writes the generated files to the directory containing the grammar file. </p> <p> This task only invokes ANTLR if the grammar file (or the supergrammar specified by the glib attribute) is newer than the generated files. </p> <p>Antlr 2.7.1 Note: <i> To successfully run ANTLR, your best option is probably to build the whole jar with the provided script <b>mkalljar</b> and drop the resulting jar (about 300KB) into /Users/antoine/dev/asf/ant-core/bootstrap/lib. Dropping the default jar (70KB) is probably not enough for most needs and your only option will be to add ANTLR home directory to your classpath as described in ANTLR <tt>install.html</tt> document. </i> </p> <p>Antlr 2.7.2 Note: <i> Instead of the above, you will need antlrall.jar that can be created by the <b>antlr-all.jar</b> target of the Makefile provided with the download. </i> </p> <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">target</td> <td valign="top">The grammar file to process.</td> <td valign="top" align="center">Yes</td> </tr> <tr> <td valign="top">outputdirectory</td> <td valign="top"> The directory to write the generated files to. If not set, the files are written to the directory containing the grammar file. </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">glib</td> <td valign="top"> An optional super grammar file that the target grammar overrides. This feature is only needed for advanced vocabularies. </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">debug</td> <td valign="top"> When set to "yes", this flag adds code to the generated parser that will launch the ParseView debugger upon invocation. The default is "no". <br> Note: ParseView is a separate component that needs to be installed or your grammar will have compilation errors. </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">html</td> <td valign="top"> Emit an html version of the grammar with hyperlinked actions. </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">diagnostic</td> <td valign="top"> Generates a text file with debugging information based on the target grammar. </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">trace</td> <td valign="top"> Forces <b>all</b> rules to call traceIn/traceOut if set to "yes". The default is "no". </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">traceParser</td> <td valign="top"> Only forces parser rules to call traceIn/traceOut if set to "yes". The default is "no". </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">traceLexer</td> <td valign="top"> Only forces lexer rules to call traceIn/traceOut if set to "yes". The default is "no". </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">traceTreeWalker</td> <td valign="top"> Only forces tree walker rules to call traceIn/traceOut if set to "yes". The default is "no". </td> <td valign="top" align="center">No</td> </tr> <!--tr> <td valign="top">fork</td> <td valign="top">Run ANTLR in a separate VM.</td> <td align="center" valign="top">No, default is "off"</td> </tr--> <tr> <td valign="top">dir</td> <td valign="top">The directory to invoke the VM in. <!--(ignored if fork is disabled)--></td> <td align="center" valign="top">No</td> </tr> </table> <h3><a name="nested">Nested Elements</a></h3> <p><code>ANTLR</code> supports a nested <code><classpath></code> element, that represents a <a href="../using.html#path">PATH like structure</a>. It is given as a convenience if you have to specify the original ANTLR directory. In most cases, dropping the appropriate ANTLR jar in the normal Ant lib repository will be enough.</p> <h4>jvmarg</h4> <p><!--If fork is enabled, -->Additional parameters may be passed to the new VM via nested <code><jvmarg></code> attributes, for example:</p> <pre> <antlr target="..."> <jvmarg value="-Djava.compiler=NONE"/> ... </antlr> </pre> <p>would run ANTLR in a VM without JIT.</p> <p><code><jvmarg></code> allows all attributes described in <a href="../using.html#arg">Command line arguments</a>.</p> <h3>Example</h3> <blockquote><pre> <antlr target="etc/java.g" outputdirectory="build/src" /> </pre></blockquote> <p> This invokes ANTLR on grammar file etc/java.g, writing the generated files to build/src. </p> </body> </html> --- NEW FILE: echoproperties.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> <title>Echoproperties Task</title> </head> <body> <h2><a name="echoproperties">echoproperties</a></h2> <h3>Description</h3> <p>Displays all the current properties (or a subset of them specified by a nested <code><propertyset></code>) in the project. The output can be sent to a file if desired. This task can be used as a somewhat contrived means of returning data from an <tt><ant></tt> invocation, but is really for debugging build files.</p> <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">destfile</td> <td valign="top">If specified, the value indicates the name of the file to send the output of the statement to. The generated output file is compatible for loading by any Java application as a property file. If not specified, then the output will go to the Ant log.</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">prefix</td> <td valign="top"> a prefix which is used to filter the properties only those properties starting with this prefix will be echoed. <P> </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">regex</td> <td valign="top"> a regular expression which is used to filter the properties only those properties whose names match it will be echoed. </td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">failonerror</td> <td valign="top">By default, the "failonerror" attribute is enabled. If an error occurs while writing the properties to a file, and this attribute is enabled, then a BuildException will be thrown, causing the build to fail. If disabled, then IO errors will be reported as a log statement, and the build will continue without failure from this task.</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">format</td> <td valign="top">One of <code>text</code> or <code>xml</code>. Determines the output format. Defaults to <code>text</code>.</td> <td valign="top" align="center">No</td> </tr> </table> <h3>Parameters specified as nested elements</h3> <h4>propertyset</h4> <p>You can specify subsets of properties to be echoed with <a href="../CoreTypes/propertyset.html">propertyset</a>s. Using <tt>propertyset</tt>s gives more control on which properties will be picked up. The attributes <tt>prefix</tt> and <tt>regex</tt> are just shorcuts that use <tt>propertyset</tt>s internally. </p> <p><em>since Ant 1.6</em>.</p> <h3>Examples</h3> <blockquote><pre> <echoproperties/> </pre></blockquote> <p>Report the current properties to the log.</p> <blockquote><pre> <echoproperties destfile="my.properties"/> </pre></blockquote> <p>Report the current properties to the file "my.properties", and will fail the build if the file could not be created or written to.</p> <blockquote><pre> <echoproperties destfile="my.properties" failonerror="false"/> </pre></blockquote> <p>Report the current properties to the file "my.properties", and will log a message if the file could not be created or written to, but will still allow the build to continue.</p> <blockquote><pre> <echoproperties prefix="java."/> </pre></blockquote> <p>List all properties beginning with "java."</p> <blockquote><pre> <echoproperties> <propertyset> <propertyref prefix="java."/> </propertyset> </echoproperties> </pre></blockquote> <p>This again lists all properties beginning with "java." using a nested <tt></propertyset></tt> which is an equivalent but longer way.</p> <blockquote><pre> <echoproperties regex=".*ant.*"/> </pre></blockquote> <p>Lists all properties that contain "ant" in their names. The equivalent snippet with <tt></propertyset></tt> is:</p> <blockquote><pre> <echoproperties> <propertyset> <propertyref regex=".*ant.*"/> </propertyset> </echoproperties> </pre></blockquote> </body> </html> --- NEW FILE: attrib.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> <title>Ant User Manual</title> </head> <body> <h2><a name="attrib">Attrib</a></h2> <p><em>Since Ant 1.6.</em></p> <h3>Description</h3> <p>Changes the attributes of a file or all files inside specified directories. Right now it has effect only under Windows. Each of the 4 possible permissions has its own attribute, matching the arguments for the attrib command.</p> <p><a href="../CoreTypes/fileset.html">FileSet</a>s, <a href="../CoreTypes/dirset.html">DirSet</a>s or <a href="../CoreTypes/filelist.html">FileList</a>s can be specified using nested <code><fileset></code>, <code><dirset></code> and <code><filelist></code> elements.</p> <p>Starting with Ant 1.7, this task supports arbitrary <a href="../CoreTypes/resources.html#collection">Resource Collection</a>s as nested elements.</p> <p>By default this task will use a single invocation of the underlying attrib command. If you are working on a large number of files this may result in a command line that is too long for your operating system. If you encounter such problems, you should set the maxparallel attribute of this task to a non-zero value. The number to use highly depends on the length of your file names (the depth of your directory tree), so you'll have to experiment a little.</p> <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">file</td> <td valign="top">the file or directory of which the permissions must be changed.</td> <td valign="top" valign="middle">Yes or nested <code><fileset/list></code> elements.</td> </tr> <tr> <td valign="top">readonly</td> <td valign="top">the readonly permission.</td> <td valign="top" rowspan="4">at least one of the four. </td> </tr> <tr> <td valign="top">archive</td> <td valign="top">the archive permission.</td> </tr> <tr> <td valign="top">system</td> <td valign="top">the system permission.</td> </tr> <tr> <td valign="top">hidden</td> <td valign="top">the hidden permission.</td> </tr> <tr> <td valign="top">type</td> <td valign="top">One of <i>file</i>, <i>dir</i> or <i>both</i>. If set to <i>file</i>, only the permissions of plain files are going to be changed. If set to <i>dir</i>, only the directories are considered.<br> <strong>Note:</strong> The type attribute does not apply to nested <i>dirset</i>s - <i>dirset</i>s always implicitly assume type to be <i>dir</i>.</td> <td align="center" valign="top">No, default is <i>file</i></td> </tr> <tr> <td valign="top">verbose</td> <td valign="top">Whether to print a summary after execution or not. Defaults to <code>false</code>.</td> <td align="center" valign="top">No</td> </tr> <tr> <td valign="top">parallel</td> <td valign="top">process all specified files using a single <code>chmod</code> command. Defaults to true.</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">maxparallel</td> <td valign="top">Limit the amount of parallelism by passing at most this many sourcefiles at once. Set it to <= 0 for unlimited. Defaults to unlimited. <em>Since Ant 1.6.</em></td> <td align="center" valign="top">No</td> </tr> </table> <h3>Examples</h3> <blockquote> <pre><attrib file="${dist}/run.bat" readonly="true" hidden="true"/></pre> </blockquote> <p>makes the "run.bat" file read-only and hidden.</p> <blockquote> <pre><attrib readonly="false"> <fileset dir="${meta.inf}" includes="**/*.xml"/> <attrib> </pre> </blockquote> <p>makes all ".xml" files below <code>${meta.inf}</code> readable.</p> <blockquote> <pre> <attrib readonly="true" archive="true"> <fileset dir="shared/sources1"> <exclude name="**/trial/**"/> </fileset> <fileset refid="other.shared.sources"/> </attrib> </pre> </blockquote> <p>makes all files below <code>shared/sources1</code> (except those below any directory named trial) read-only and archived. In addition all files belonging to a FileSet with <code>id</code> <code>other.shared.sources</code> get the same attributes.</p> </body> </html> --- NEW FILE: netrexxc.html --- <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"> <link rel="stylesheet" type="text/css" href="../stylesheets/style.css"> <title>NetRexxC Task</title> </head> <body> <h2><a name="netrexxc">NetRexxC</a></h2> <h3>Description</h3> <p>Compiles a <a href="http://www2.hursley.ibm.com/netrexx" target="_top">NetRexx</a> source tree within the running (Ant) VM.</p> <p>The source and destination directory will be recursively scanned for NetRexx source files to compile. Only NetRexx files that have no corresponding class file or where the class file is older than the java file will be compiled.</p> <p>Files in the source tree are copied to the destination directory, allowing support files to be located properly in the classpath. The source files are copied because the NetRexx compiler cannot produce class files in a specific directory via parameters</p> <p>The directory structure of the source tree should follow the package hierarchy.</p> <p>It is possible to refine the set of files that are being compiled/copied. This can be done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i> attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to have included by using patterns. The <i>exclude</i> or <i>excludesfile</i> attribute is used to specify the files you want to have excluded. This is also done with patterns. And finally with the <i>defaultexcludes</i> attribute, you can specify whether you want to use default exclusions or not. See the section on <a href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the inclusion/exclusion of files works, and how to write patterns.</p> <p>This task forms an implicit <a href="../CoreTypes/fileset.html">FileSet</a> and supports all attributes of <code><fileset></code> (<code>dir</code> becomes <code>srcdir</code>) as well as the nested <code><include></code>, <code><exclude></code> and <code><patternset></code> elements.</p> <p>All properties except classpath, srcdir and destDir are also available as properties in the form <code>ant.netrexxc.<i>attributename</i></code>, eg.<br> <code><property name="ant.netrexxc.verbose" value="noverbose"/></code><br> or from the command line as<br> <code>ant -Dant.netrexxc.verbose=noverbose ...</code> </p> <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">binary</td> <td valign="top">Whether literals are treated as the java binary type rather than the NetRexx types</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">classpath</td> <td valign="top">The classpath to use during compilation</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">comments</td> <td valign="top">Whether comments are passed through to the generated java source</td> <td valign="top" align="center">No</td> </tr> <tr> <td valign="top">compact</td> <td valign="top">Whether error messages come out in compact or verbose format. Default is the compact format.</td> <td valign="top" align="center">No</... [truncated message content] |
