<patternset id="non.test.sources" >
<include name="**/*.java" />
@@ -818,7 +819,7 @@ as PatternSet's attributes.
No
-Examples:
+Examples
<fileset dir="${server.src}" >
<patternset id="non.test.sources" >
@@ -841,6 +842,7 @@ same patterns as the example before.
Built in tasks
- Ant
+ - AntCall
- AntStructure
- Available
- Chmod
@@ -863,6 +865,7 @@ same patterns as the example before.
- Java
- Javac
- Javadoc/Javadoc2
+ - Mail
- Mkdir
- Patch
- Property
@@ -876,17 +879,17 @@ same patterns as the example before.
- Taskdef
- Touch
- Tstamp
- - Uptodate
- Unjar
- Untar
- Unwar
- Unzip
+ - Uptodate
- War
- Zip
Ant
-Description:
+Description
Runs Ant on a supplied buildfile. This can be used to build subprojects.
When the antfile attribute is omitted, the file "build.xml"
in the supplied directory (dir attribute) is used.
@@ -897,7 +900,7 @@ These properties will override the properties that are set in the new project.
(See also the properties task). You can set properties
in the new project from the old project by using nested property tags. This
allows you to parameterize your subprojects.
-Parameters:
+Parameters
Attribute
@@ -913,7 +916,7 @@ allows you to parameterize your subprojects.
dir
the directory to use as a basedir for the new Ant project.
Defaults to the current directory.
- No
+ No
target
@@ -929,18 +932,55 @@ allows you to parameterize your subprojects.
Examples
- <ant antfile="subproject/subbuild.xml" dir="subproject" target="compile" />
+ <ant antfile="subproject/subbuild.xml" dir="subproject" target="compile" />
+
+ <ant dir="subproject" />
- <ant dir="subproject" />
+ <ant antfile="subproject/property_based_subbuild.xml">
+ <property name="param1" value="version 1.x" />
+ <property file="config/subproject/default.properties" />
+ </ant>
+
+
+AntCall
+Description
+Call another target within the same build-file optionally specifying some
+properties (param's in this context)
+Parameters
+
+
+ Attribute
+ Description
+ Required
+
+
+ target
+ The target to execute.
+ Yes
+
+
+Parameters specified as nested elements
+param
+Specifies the properties to set before running the specified target. See property for usage guidelines.
+This will only set the specified properties if the property is not already
+set in the current project!
+Examples
+
+ <target name="default">
+ <calltarget target="doSomethingElse">
+ <param name="param1" value="value"/>
+ </calltarget>
+ </target>
- <ant antfile="subproject/property_based_subbuild.xml">
- <property name="param1" value="version 1.x" />
- <property file="config/subproject/default.properties" />
- </ant>
+ <target name="doSomethingElse">
+ <echo message="param1=${param1}"/>
+ </target>
+Will run the target 'doSomethingElse' and echo 'param1=value'.
AntStructure
-Description:
+Description
Generates a DTD for Ant build files which contains information
about all tasks currently known to Ant.
Note that the DTD generated by this task is incomplete, you can
@@ -950,7 +990,7 @@ href="http://www.sdv.fr/pages/casa/html/ant-dtd.en.html">here for
a way to get around this problem.
This task doesn't know about required attributes, all will be
listed as #IMPLIED.
-Parameters:
+Parameters
Attribute
@@ -973,7 +1013,7 @@ listed as #IMPLIED.
Sets a property if a resource is available at runtime. This resource can be a
file resource, a class in classpath or a JVM system resource.
If the resource is present, the property value is set to true by
-default, otherwise the property is not set. You can set the value to
+default, otherwise the property is not set. You can set the value to
something specific by using the value attribute.
Normally, this task is used to set properties that are useful to avoid target
execution depending on system parameters.
@@ -989,11 +1029,11 @@ execution depending on system parameters.
the name of the property to set.
Yes
-
- value
- the value to set the property to. Defaults to "true".
- No
-
+
+ value
+ the value to set the property to. Defaults to "true".
+ No
+
classname
the class to look for in classpath.
@@ -3002,6 +3042,56 @@ respectively.
</javadoc>
+Mail
+Description
+A task to send SMTP email.
+Parameters
+
+
+ Attribute
+ Description
+ Required
+
+
+ from
+ Email address of sender.
+ Yes
+
+
+ tolist
+ Comma-separated list of recipients.
+ Yes
+
+
+ message
+ Message to send in the body of the email.
+ Yes
+
+
+ files
+ Filename(s) of text to send in the body of the email.
+ Multiple files are comma-separated.
+
+
+ mailhost
+ Host name of the mail server.
+ No, default to "localhost"
+
+
+ subject
+ Email subject line.
+ No
+
+
+Examples
+
+ <mail from="me" tolist="you" subject="Results of nightly build"
+ files="build.log"/>
+Sends an eMail from me to you with a subject of
+Results of nightly build and includes the contents of build.log
+in the body of the message.
+
+
Mkdir
Description
Creates a directory. Also non-existent parent directories are created, when
@@ -4113,7 +4203,7 @@ it had been located at htdocs/manual/ChangeLog.txt.
Cab
-Description:
+Description
The cab task creates Microsoft cab archive files. It is invoked
similar to the jar or zip tasks.
This task will only work on Windows, and will be silently ignored on
@@ -4127,7 +4217,7 @@ supports all attributes of <fileset>
(dir becomes basedir) as well as the nested
<include>, <exclude> and
<patternset> elements.
-Parameters:
+Parameters
Attribute
@@ -4226,7 +4316,7 @@ excluded. Output from the cabarc tool is displayed in the build
output.
FTP
-Description:
+Description
The ftp task implements a basic FTP client that can send, receive,
list, and delete files. See below for descriptions and examples of how
to perform each task.
@@ -4239,7 +4329,7 @@ instead.
See the section on directory based
tasks, on how the inclusion/exclusion of files works, and how to
write patterns.
-Parameters:
+Parameters
Attribute
@@ -4413,7 +4503,7 @@ tries to delete all *.tmp files from the default directory for that user.
If you don't have permission to delete a file, a BuildException is thrown.
Listing Files
- <ftp action="list"
+ <ftp action="list"
server="ftp.apache.org"
userid=quot;anonymous"
password="me@myorg.com"
@@ -4425,10 +4515,10 @@ If you don't have permission to delete a file, a BuildException is thrown.
This provides a file listing in data/ftp.listing of all the files on
the FTP server relative to the default directory of the anonymous
-user. The listing is in whatever format the FTP server normally lists files.
+user. The listing is in whatever format the FTP server normally lists files.
NetRexxC
-Description:
+Description
Compiles a NetRexx
source tree within the running (Ant) VM.
The source and destination directory will be recursively scanned for
@@ -4456,7 +4546,7 @@ supports all attributes of <fileset>
<include>, <exclude> and
<patternset> elements.
-Parameters:
+Parameters
Attribute
@@ -4690,7 +4780,7 @@ supports all attributes of <fileset>
RenameExtensions
-Description:
+Description
Renames files in the srcDir directory ending with the
fromExtension string so that they end with the
toExtension string. Files are only replaced if
@@ -4704,7 +4794,7 @@ supports all attributes of <fileset>
(dir becomes srcDir) as well as the nested
<include>, <exclude> and
<patternset> elements.
-Parameters:
+Parameters
Attribute
@@ -4780,14 +4870,14 @@ supports all attributes of <fileset>
Script
-Description:
+Description
Execute a script in a
BSF supported language.
All items (tasks, targets, etc) of the running project are
accessible from the script, using either their name or
id attributes.
Scripts can do almost anything a task written in Java could do.
-Parameters:
+Parameters
Attribute
@@ -4885,11 +4975,11 @@ BUILD SUCCESSFUL
VssGet
-Description:
+Description
Task to perform GET commands to Microsoft Visual Source Safe.
If you specify two or more attributes from version, date and
label only one will be used in the order version, date, label.
-Parameters:
+Parameters
Attribute
@@ -4954,11 +5044,11 @@ label only one will be used in the order version, date, label.
vsspath="/source/aProject"
writable="true"/>
-Does a get on the VSS-Project $/source/aproject using the username
+
+Does a get on the VSS-Project $/source/aproject using the username
me and the password mypassword. It will recursively get the files
which are labeled Release1 and write them to the local directory
-C:\mysrc\myproject. The local files will be writable.
-
+C:\mysrc\myproject. The local files will be writable.
Build Events
Ant is capable of generating build events as it performs the tasks necessary to build a project.
@@ -5126,7 +5216,7 @@ href="mailto:ant-dev-subscribe@jakarta.apache.org">ant-dev-subscribe@jakarta.apa
href="http://archive.covalent.net/">http://archive.covalent.net/. Many
thanks to Covalent Technologies.
-Copyright © 2000 Apache Software Foundation. All rights
+
Copyright © 2000 Apache Software Foundation. All rights
Reserved.