Return-Path: Delivered-To: apmail-ant-notifications-archive@minotaur.apache.org Received: (qmail 41399 invoked from network); 26 May 2010 20:34:26 -0000 Received: from unknown (HELO mail.apache.org) (140.211.11.3) by 140.211.11.9 with SMTP; 26 May 2010 20:34:26 -0000 Received: (qmail 82468 invoked by uid 500); 26 May 2010 20:34:26 -0000 Delivered-To: apmail-ant-notifications-archive@ant.apache.org Received: (qmail 82432 invoked by uid 500); 26 May 2010 20:34:26 -0000 Mailing-List: contact notifications-help@ant.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@ant.apache.org Delivered-To: mailing list notifications@ant.apache.org Received: (qmail 82425 invoked by uid 99); 26 May 2010 20:34:25 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 26 May 2010 20:34:25 +0000 X-ASF-Spam-Status: No, hits=-1556.1 required=10.0 tests=ALL_TRUSTED,AWL X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 26 May 2010 20:34:17 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id B6A082388A93; Wed, 26 May 2010 20:33:57 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r948574 [3/3] - in /ant/core/trunk: docs/ docs/manual/ docs/manual/CoreTasks/ docs/manual/CoreTypes/ docs/manual/OptionalTasks/ docs/manual/OptionalTypes/ docs/manual/Tasks/ docs/manual/Types/ xdocs/ xdocs/antlibs/svn/ Date: Wed, 26 May 2010 20:33:55 -0000 To: notifications@ant.apache.org From: jglick@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20100526203357.B6A082388A93@eris.apache.org> Modified: ant/core/trunk/docs/manual/install.html URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/install.html?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/install.html (original) +++ ant/core/trunk/docs/manual/install.html Wed May 26 20:33:51 2010 @@ -694,16 +694,16 @@ least the following:

  • The classpath for Ant must contain ant.jar and any jars/classes needed for your chosen JAXP-compliant XML parser.
  • When you need JDK functionality -(such as for the javac task or the -rmic task), then tools.jar +(such as for the javac task or the +rmic task), then tools.jar must be added. The scripts supplied with Ant, in the bin directory, will add the required JDK classes automatically, if the JAVA_HOME environment variable is set.
  • When you are executing platform-specific applications, such as the -exec task or the -cvs task, the property ant.home +exec task or the +cvs task, the property ant.home must be set to the directory containing where you installed Ant. Again this is set by the Ant scripts to the value of the ANT_HOME environment variable.
  • Modified: ant/core/trunk/docs/manual/properties.html URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/properties.html?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/properties.html (original) +++ ant/core/trunk/docs/manual/properties.html Wed May 26 20:33:51 2010 @@ -29,7 +29,7 @@ expand ${key} to value at runtime.

    There are many tasks that can set properties, the most common one - is the property task. In + is the property task. In addition properties can be defined via command line arguments or similar mechanisms from outside of Ant.

    @@ -40,14 +40,14 @@ defined they are available for any task or target invoked subsequently - it is not possible to set a property in a child build process created via - the ant, antcall or subant tasks + the ant, antcall or subant tasks and make it available to the calling build process, though.

    Starting with Ant 1.8.0 - the local task can be used to + the local task can be used to create properties that are locally scoped to a target or - a sequential element like - the one of the macrodef + a sequential element like + the one of the macrodef task.

    Built-in Properties

    @@ -109,7 +109,7 @@ ant.library.dir the directory that h marker interface) to take care of discrete tasks such as property setting, retrieval, parsing, etc. This makes Ant's property handling highly extensible; also of interest is the - new propertyhelper + new propertyhelper task used to manipulate the PropertyHelper and its delegates from the context of the Ant buildfile. @@ -139,7 +139,7 @@ ant.library.dir the directory that h would be org.apache.tools.ant.property.LocalProperties which implements storage - for local properties.

    + for local properties.

    Another reason to implement this interface is if you wanted to provide your own "property protocol" like @@ -157,7 +157,7 @@ ant.library.dir the directory that h would be org.apache.tools.ant.property.LocalProperties which implements storage - for local properties.

    + for local properties.

    Modified: ant/core/trunk/docs/manual/proxy.html URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/proxy.html?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/proxy.html (original) +++ ant/core/trunk/docs/manual/proxy.html Wed May 26 20:33:51 2010 @@ -174,7 +174,7 @@ command line.

    SetProxy Task

    - The setproxy task can be used to + The setproxy task can be used to explicitly set a proxy in a build file. This manipulates the many proxy configuration properties of a JVM, and controls the proxy settings for all network operations in the same JVM from that moment. @@ -243,7 +243,7 @@ command line.

    If you wish to have a forked process pick up the Ant's settings, use the - <syspropertyset> + <syspropertyset> element to propagate the normal proxy settings. The following propertyset is a datatype which can be referenced in a <java> task to pass down the current values. Modified: ant/core/trunk/docs/manual/running.html URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/running.html?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/running.html (original) +++ ant/core/trunk/docs/manual/running.html Wed May 26 20:33:51 2010 @@ -56,7 +56,7 @@ the -Dproperty=val where property is the name of the property, and value is the value for that property. If you specify a property that is also set in the build file -(see the property task), +(see the property task), the value specified on the command line will override the value specified in the build file. @@ -67,7 +67,7 @@ the value of environment variables; just to Ant. You can then access these variables inside your build file as ${MYVAR}. You can also access environment variables using the - property task's + property task's environment attribute.

    @@ -296,7 +296,7 @@ org.apache.tools.ant.Executor implementa ant.file read only: full filename of the build file This is set to the name of the build file. In - + <import>-ed files, this is set to the containing build file. @@ -306,7 +306,7 @@ org.apache.tools.ant.Executor implementa read only: full filename of the build file of Ant projects This is set to the name of a file by project; - this lets you determine the location of + this lets you determine the location of <import>-ed files, @@ -329,7 +329,7 @@ org.apache.tools.ant.Executor implementa ant.netrexxc.* several formats - Use specified values as defaults for netrexxc. + Use specified values as defaults for netrexxc. @@ -344,7 +344,7 @@ org.apache.tools.ant.Executor implementa ant.regexp.regexpimpl classname classname for a RegExp implementation; if not set Ant uses JDK 1.4's implementation; - RegExp-Mapper + RegExp-Mapper "Choice of regular expression implementation" @@ -366,49 +366,49 @@ org.apache.tools.ant.Executor implementa build.compiler name Specify the default compiler to use. - see javac, - EJB Tasks + see javac, + EJB Tasks (compiler attribute), - javah + javah build.compiler.emacs boolean (default false) Enable emacs-compatible error messages. - see javac "Jikes Notes" + see javac "Jikes Notes" build.compiler.fulldepend boolean (default false) Enable full dependency checking - see javac "Jikes Notes" + see javac "Jikes Notes" build.compiler.jvc.extensions boolean (default true) enable Microsoft extensions of their java compiler - see javac "Jvc Notes" + see javac "Jvc Notes" build.compiler.pedantic boolean (default false) Enable pedantic warnings. - see javac "Jikes Notes" + see javac "Jikes Notes" build.compiler.warnings Deprecated flag - see javac "Jikes Notes" + see javac "Jikes Notes" build.rmic name - control the rmic compiler + control the rmic compiler build.sysclasspath @@ -420,7 +420,7 @@ org.apache.tools.ant.Executor implementa file.encoding name of a supported character set (e.g. UTF-8, ISO-8859-1, US-ASCII) use as default character set of email messages; use as default for source-, dest- and bundleencoding - in translate
    + in translate
    see JavaDoc of java.nio.charset.Charset for more information about character sets (not used in Ant, but has nice docs). @@ -450,14 +450,14 @@ org.apache.tools.ant.Executor implementa p4.port, p4.client, p4.user several formats Specify defaults for port-, client- and user-setting of the - perforce tasks. + perforce tasks. websphere.home path Points to home directory of websphere. - see EJB Tasks + see EJB Tasks Modified: ant/core/trunk/docs/manual/targets.html URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/targets.html?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/targets.html (original) +++ ant/core/trunk/docs/manual/targets.html Wed May 26 20:33:51 2010 @@ -131,7 +131,7 @@ option is used.

    It is a good practice to place - your tstamp tasks in a + your tstamp tasks in a so-called initialization target, on which all other targets depend. Make sure that target is always the first one in the depends list of the other targets. In this manual, most @@ -245,7 +245,7 @@

    The main purpose of an extension-point is to act as an extension point for build files designed to - be imported. In the imported + be imported. In the imported file an extension-point defines a state that must be reached and targets from other build files can join the depends list of said extension-point in order to contribute to that state.

    Copied: ant/core/trunk/docs/manual/tasklist.html (from r948529, ant/core/trunk/docs/manual/coretasklist.html) URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/tasklist.html?p2=ant/core/trunk/docs/manual/tasklist.html&p1=ant/core/trunk/docs/manual/coretasklist.html&r1=948529&r2=948574&rev=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/coretasklist.html (original) +++ ant/core/trunk/docs/manual/tasklist.html Wed May 26 20:33:51 2010 @@ -28,115 +28,166 @@

    Table of Contents

    -

    Core Tasks

    +

    Tasks

    Modified: ant/core/trunk/docs/manual/tasksoverview.html URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/tasksoverview.html?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/tasksoverview.html (original) +++ ant/core/trunk/docs/manual/tasksoverview.html Wed May 26 20:33:51 2010 @@ -67,109 +67,109 @@ documentation.

    - BUnzip2 + BUnzip2

    Expands a file packed using GZip or BZip2.

    - BZip2 + BZip2

    Packs a file using the GZip or BZip2 algorithm. This task does not do any dependency checking; the output file is always generated

    - Cab + Cab

    Creates Microsoft CAB archive files. It is invoked - similar to the Jar or - Zip tasks. This task will work on + similar to the Jar or + Zip tasks. This task will work on Windows using the external cabarc tool (provided by Microsoft), which must be located in your executable path.

    - Ear -

    An extension of the Jar task with + Ear +

    An extension of the Jar task with special treatment for files that should end up in an Enterprise Application archive.

    - GUnzip + GUnzip

    Expands a GZip file.

    - GZip + GZip

    GZips a set of files.

    - Jar + Jar

    Jars a set of files.

    - Jlink + Jlink

    Deprecated. Use the zipfileset and zipgroupfileset attributes of the - Jar or - Zip tasks instead.

    + Jar or + Zip tasks instead.

    - Manifest + Manifest

    Creates a manifest file.

    - Rpm + Rpm

    Invokes the rpm executable to build a Linux installation file. This task currently only works on Linux or other Unix platforms with RPM support.

    - SignJar + SignJar

    Signs a jar or zip file with the javasign command-line tool.

    - Tar + Tar

    Creates a tar archive.

    - Unjar + Unjar

    Unzips a jarfile.

    - Untar + Untar

    Untars a tarfile.

    - Unwar + Unwar

    Unzips a warfile.

    - Unzip + Unzip

    Unzips a zipfile.

    - War -

    An extension of the Jar task + War +

    An extension of the Jar task with special treatment for files that should end up in the WEB-INF/lib, WEB-INF/classes, or WEB-INF directories of the Web Application Archive.

    - Zip + Zip

    Creates a zipfile.

    @@ -191,7 +191,7 @@ documentation.

    - JDepend + JDepend

    Invokes the JDepend parser. This parser "traverses a set of Java source-file directories and generates design-quality metrics for each Java @@ -217,54 +217,54 @@ documentation.

    - Depend + Depend

    Determines which classfiles are out-of-date with respect to their source, removing the classfiles of any other classes that depend on the out-of-date classes, forcing the re-compile of the removed classfiles. Typically used in conjunction with the - Javac task.

    + Javac task.

    - Javac + Javac

    Compiles the specified source file(s) within the running (Ant) VM, or in another VM if the fork attribute is specified.

    - Apt + Apt

    Runs the annotation processor tool (apt), and then optionally compiles the original code, and any generated source code.

    - JspC + JspC

    Runs the JSP compiler. It can be used to precompile JSP pages for fast initial invocation of JSP pages, deployment on a server without the full JDK installed, or simply to syntax-check the pages without - deploying them. The Javac task + deploying them. The Javac task can be used to compile the generated Java source. (For Weblogic JSP compiles, - see the Wljspc task.)

    + see the Wljspc task.)

    - NetRexxC + NetRexxC

    Compiles a NetRexx source tree within the running (Ant) VM.

    - Rmic + Rmic

    Runs the rmic compiler on the specified file(s).

    - Wljspc + Wljspc

    Compiles JSP pages using Weblogic's JSP compiler, weblogic.jspc. (For non-Weblogic JSP compiles, see the - JspC task.

    + JspC task.

    @@ -286,7 +286,7 @@ documentation.

    - ServerDeploy + ServerDeploy

    Task to run a "hot" deployment tool for vendor-specific J2EE server.

    @@ -310,7 +310,7 @@ documentation.

    - Javadoc/Javadoc2 + Javadoc/Javadoc2

    Generates code documentation using the javadoc tool. The Javadoc2 task is deprecated; use the Javadoc task instead.

    @@ -334,7 +334,7 @@ documentation.

    - EJB Tasks + EJB Tasks

    (See the documentation describing the EJB tasks.)

    @@ -356,54 +356,54 @@ documentation.

    - Ant + Ant

    Runs Ant on a supplied buildfile, optionally passing properties (with possibly new values). This task can be used to build sub-projects.

    - AntCall + AntCall

    Runs another target within the same buildfile, optionally passing properties (with possibly new values).

    - Apply/ExecOn + Apply/ExecOn

    Executes a system command. When the os attribute is specified, the command is only executed when Ant is run on one of the specified operating systems.

    - Dependset + Dependset

    This task compares a set of source files with a set of target files. If any of the source files is newer than any of the target files, all the target files are removed.

    - Exec + Exec

    Executes a system command. When the os attribute is specified, the command is only executed when Ant is run on one of the specified operating systems.

    - Java + Java

    Executes a Java class within the running (Ant) VM, or in another VM if the fork attribute is specified.

    - Parallel + Parallel

    A container task that can contain other Ant tasks. Each nested task specified within the <parallel> tag will be executed in its own thread.

    - Sequential + Sequential

    A container task that can contain other Ant tasks. The nested tasks are simply executed in sequence. Its primary use is to support the sequential execution of a subset of tasks within @@ -411,22 +411,22 @@ documentation.

    - Sleep + Sleep

    A task for suspending execution for a specified period of time. Useful when a build or deployment process requires an interval between tasks.

    - Subant + Subant

    Calls a given target for all defined sub-builds. This is an extension of ant for bulk project execution.

    - Waitfor + Waitfor

    Blocks execution until a set of specified conditions become true. This task is intended to be used with the - Parallel task to synchronize + Parallel task to synchronize a set of processes.

    @@ -448,27 +448,27 @@ documentation.

    - Attrib + Attrib

    Changes the permissions and/or attributes of a file or all files inside the specified directories. Currently, it has effect only under Windows.

    - Checksum + Checksum

    Generates a checksum for a file or set of files. This task can also be used to perform checksum verifications.

    - Chgrp + Chgrp

    Changes the group ownership of a file or all files inside the specified directories. Currently, it has effect only under Unix.

    - Chmod + Chmod

    Changes the permissions of a file or all files inside the specified directories. Currently, it has effect only under Unix. The permissions are also UNIX style, like the arguments for the @@ -476,105 +476,105 @@ documentation.

    - Chown + Chown

    Changes the owner of a file or all files inside the specified directories. Currently, it has effect only under Unix.

    - Concat + Concat

    Concatenates multiple files into a single one or to Ant's logging system.

    - Copy + Copy

    Copies a file or Fileset to a new file or directory.

    - Copydir + Copydir

    Deprecated. Use the - Copy task instead.

    + Copy task instead.

    - Copyfile + Copyfile

    Deprecated. Use the - Copy task instead.

    + Copy task instead.

    - Delete + Delete

    Deletes either a single file, all files and sub-directories in a specified directory, or a set of files specified by one or more - FileSets.

    + FileSets.

    - Deltree + Deltree

    Deprecated. Use the - Delete task instead.

    + Delete task instead.

    - Filter + Filter

    Sets a token filter for this project, or reads multiple token filters from a specified file and sets these as filters. Token filters are used by all tasks that perform file-copying operations.

    - FixCRLF + FixCRLF

    Modifies a file to add or remove tabs, carriage returns, linefeeds, and EOF characters.

    - Get + Get

    Gets a file from a URL.

    - Mkdir + Mkdir

    Creates a directory. Non-existent parent directories are created, when necessary.

    - Move + Move

    Moves a file to a new file or directory, or a set(s) of file(s) to a new directory.

    - Patch + Patch

    Applies a "diff" file to originals.

    - Rename -

    Deprecated. Use the Move + Rename +

    Deprecated. Use the Move task instead.

    - + RenameExtensions -

    Deprecated. Use the Move - task with a glob mapper +

    Deprecated. Use the Move + task with a glob mapper instead.

    - Replace + Replace

    Replace is a directory-based task for replacing the occurrence of a given string with another string in selected file.

    - + ReplaceRegExp

    Directory-based task for replacing the occurrence of a given regular expression with a substitution pattern in a file or set of @@ -582,18 +582,18 @@ documentation.

    - Sync + Sync

    Synchronize two directory trees.

    - Tempfile + Tempfile

    Generates a name for a new temporary file and sets the specified property to that name.

    - Touch + Touch

    Changes the modification time of a file and possibly creates it at the same time.

    @@ -617,7 +617,7 @@ documentation.

    - Jarlib-available + Jarlib-available

    Check whether an extension is present in a FileSet or an ExtensionSet. If the extension is present, the specified property is set.

    @@ -626,7 +626,7 @@ documentation.

    - Jarlib-display + Jarlib-display

    Display the "Optional Package" and "Package Specification" information contained within the specified jars.

    @@ -635,7 +635,7 @@ documentation.

    - Jarlib-manifest + Jarlib-manifest

    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" @@ -645,7 +645,7 @@ documentation.

    - Jarlib-resolve + Jarlib-resolve

    Try to locate a jar to satisfy an extension, and place the location of the jar into the specified property.

    @@ -670,7 +670,7 @@ documentation.

    - Record + Record

    Runs a listener that records the logging output of the build-process events to a file. Several recorders can exist at the same time. Each recorder is associated with a file.

    @@ -694,13 +694,13 @@ documentation.

    - Mail + Mail

    A task to send SMTP email.

    - MimeMail -

    Deprecated. Use the Mail + MimeMail +

    Deprecated. Use the Mail task instead.

    @@ -723,60 +723,60 @@ documentation.

    - Defaultexcludes + Defaultexcludes

    Modify the list of default exclude patterns from within your build file.

    - Echo + Echo

    Echoes text to System.out or to a file.

    - Fail + Fail

    Exits the current build by throwing a BuildException, optionally printing additional information.

    - GenKey + GenKey

    Generates a key in keystore.

    - HostInfo + HostInfo

    Sets properties related to the provided host, or to the host the process is run on.

    - Input + Input

    Allows user interaction during the build process by displaying a message and reading a line of input from the console.

    - Script + Script

    Executes a script in a Apache BSF-supported language.

    - Sound + Sound

    Plays a sound file at the end of the build, according to whether the build failed or succeeded.

    - Splash + Splash

    Displays a splash screen.

    - Sql + Sql

    Executes a series of SQL statements via JDBC to a database. Statements can either be read in from a text file using the src attribute, or from between the enclosing SQL @@ -784,26 +784,26 @@ documentation.

    - Taskdef + Taskdef

    Adds a task definition to the current project, such that this new task can be used in the current project.

    - TStamp + TStamp

    Sets the DSTAMP, TSTAMP, and TODAY properties in the current project, based on the current date and time.

    - Typedef + Typedef

    Adds a data-type definition to the current project, such that this new type can be used in the current project.

    - XmlValidate + XmlValidate

    Checks that XML files are valid (or only well-formed). This task uses the XML parser that is currently used by Ant by default, but any SAX1/2 parser can be specified, if needed.

    @@ -827,42 +827,42 @@ documentation.

    - ANTLR + ANTLR

    Invokes the ANTLR Translator generator on a grammar file.

    - AntStructure + AntStructure

    Generates a DTD for Ant buildfiles that contains information about all tasks currently known to Ant.

    - Import + Import

    Import another build file and potentially override targets in it with targets of your own.

    - Include + Include

    Include another build file.

    - JavaCC + JavaCC

    Invokes the JavaCC compiler-compiler on a grammar file.

    - Javah + Javah

    Generates JNI headers from a Java class.

    - JJDoc + JJDoc

    Invokes the JJDoc documentation generator for the JavaCC compiler-compiler. JJDoc takes a JavaCC parser specification and produces documentation @@ -872,7 +872,7 @@ documentation.

    - JJTree + JJTree

    Invokes the JJTree preprocessor for the JavaCC compiler-compiler. It inserts parse-tree building actions at various places in the JavaCC source that @@ -882,12 +882,12 @@ documentation.

    - Macrodef + Macrodef

    Define a new task as a macro built-up upon other tasks.

    - + Native2Ascii

    Converts files from native encodings to ASCII with escaped Unicode. A common usage is to convert source files maintained in a native @@ -895,19 +895,19 @@ documentation.

    - Presetdef + Presetdef

    Define a new task by instrumenting an existing task with default values for attributes or child elements.

    - Translate + Translate

    Identifies keys in files, delimited by special tokens, and translates them with values read from resource bundles.

    - XSLT + XSLT

    Processes a set of documents via XSLT.

    @@ -930,49 +930,49 @@ documentation.

    - Available + Available

    Sets a property if a specified file, directory, class in the classpath, or JVM system resource is available at runtime.

    - Basename + Basename

    Sets a property to the last element of a specified path. - BuildNumber + BuildNumber

    Task that can be used to track build numbers. - Condition + Condition

    Sets a property if a certain condition holds true; this is a - generalization of Available and - Uptodate.

    + generalization of Available and + Uptodate.

    - Dirname + Dirname

    Sets a property to the value of the specified file up to, but not including, the last path element. - Echoproperties
    + Echoproperties

    Lists the current properties.

    - LoadFile + LoadFile

    Loads a file into a property.

    - LoadProperties + LoadProperties

    Load a file's contents as Ant properties. This task is equivalent to using <property file="..."/> except that it supports nested <filterchain> elements, @@ -980,12 +980,12 @@ documentation.

    - MakeURL + MakeURL

    Creates a URL (list) from a file/fileset or path

    - PathConvert + PathConvert

    Converts a nested path, path reference, filelist reference, or fileset reference to the form usable on a specified platform and/or to a list of items separated by the specified separator and stores @@ -993,13 +993,13 @@ documentation.

    - Property + Property

    Sets a property (by name and value), or set of properties (from a file or resource) in the project.

    - + PropertyFile

    Creates or modifies property files. Useful when wanting to make unattended modifications to configuration files for application @@ -1009,18 +1009,18 @@ documentation.

    - Uptodate + Uptodate

    Sets a property if a given target file is newer than a set of source files.

    - Whichresource + Whichresource

    Find a class or resource.

    - XmlProperty + XmlProperty

    Loads property values from a well-formed XML file.

    @@ -1042,34 +1042,34 @@ documentation.

    - FTP + FTP

    Implements a basic FTP client that can send, receive, list, and delete files, and create directories.

    - Rexec + Rexec

    Task to automate a remote rexec session.

    - Scp + Scp

    Copy files to or from a remote server using SSH.

    - setproxy + setproxy

    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.

    - Sshexec + Sshexec

    Execute a command on a remote server using SSH.

    - Telnet + Telnet

    Task to automate a remote telnet session. This task uses nested <read> and <write> tags to indicate strings to wait for and specify text to send.

    @@ -1094,47 +1094,47 @@ documentation.

    - Cvs + Cvs

    Handles packages/modules retrieved from a CVS repository.

    - CvsChangeLog + CvsChangeLog

    Generates an XML report of the changes recorded in a CVS repository.

    - CVSPass + CVSPass

    Adds entries to a .cvspass file. Adding entries to this file has the same affect as a cvs login command.

    - CvsTagDiff + CvsTagDiff

    Generates an XML-formatted report file of the changes between two tags or dates recorded in a CVS repository.

    - ClearCase + ClearCase

    Tasks to perform the ClearCase cleartool checkin, checkout, uncheckout, update, lock, unlock, mklbtype, rmtype, mklabel, mkattr, mkdir, mkelem, and mkbl commands.

    - Continuus/Synergy + Continuus/Synergy

    Tasks to perform the Continuus ccmcheckin, ccmcheckout, ccmcheckintask, ccmreconfigure, and ccmcreateTask commands.

    - + Microsoft Visual SourceSafe

    Tasks to perform the Visual SourceSafe vssget, vsslabel, vsshistory, vsscheckin, @@ -1143,7 +1143,7 @@ documentation.

    - Perforce + Perforce

    Tasks to perform the Perforce p4sync, p4change, p4edit, p4submit, p4have, p4label, p4counter, p4reopen, p4revert, and p4add @@ -1151,13 +1151,13 @@ documentation.

    - Pvcs + Pvcs

    Allows the user extract the latest edition of the source code from a PVCS repository.

    - SourceOffSite + SourceOffSite

    Tasks to perform the SourceOffSite sosget, soslabel, soscheckin, and soscheckout commands.

    @@ -1181,16 +1181,16 @@ documentation.

    - Junit + Junit

    Runs tests from the Junit testing framework. This task has been tested with JUnit 3.0 up to JUnit 3.7; it won't work with versions prior to JUnit 3.0.

    - JunitReport + JunitReport

    Merges the individual XML files generated by the - Junit task and applies a + Junit task and applies a stylesheet on the resulting merged document to provide a browsable report of the testcases results.

    Modified: ant/core/trunk/docs/manual/tutorial-HelloWorldWithAnt.html URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/tutorial-HelloWorldWithAnt.html?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/tutorial-HelloWorldWithAnt.html (original) +++ ant/core/trunk/docs/manual/tutorial-HelloWorldWithAnt.html Wed May 26 20:33:51 2010 @@ -408,7 +408,7 @@ public class HelloWorldTest extends juni }

    Because we dont have real business logic to test, this test class is very small: just show how to start. For -further information see the JUnit documentation [3] and the manual of junit task. +further information see the JUnit documentation [3] and the manual of junit task. Now we add a junit instruction to our buildfile:

    
    Modified: ant/core/trunk/docs/manual/tutorial-tasks-filesets-properties.html
    URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/tutorial-tasks-filesets-properties.html?rev=948574&r1=948573&r2=948574&view=diff
    ==============================================================================
    --- ant/core/trunk/docs/manual/tutorial-tasks-filesets-properties.html (original)
    +++ ant/core/trunk/docs/manual/tutorial-tasks-filesets-properties.html Wed May 26 20:33:51 2010
    @@ -551,7 +551,7 @@ form you do that depends on your favouri
     it has advantages if you use that: all task users know that form, this form is requested if
     you decide to contribute your task. So we will doc our task in that form.

    -

    If you have a look at the manual page of the Java task [5] +

    If you have a look at the manual page of the Java task [5] you will see that it:

    • is plain html
    • starts with the name
    • @@ -715,8 +715,7 @@ information on that.

    • Patch files generated using cvs diff -u to do
    • patch files include a patch to defaults.properties to register the tasks to do
    • -
    • patch files include a patch to coretasklist.html or -optionaltasklist.html to link to the new task page to do
    • +
    • patch files include a patch to tasklist.html to link to the new task page to do
    • Message to dev contains [SUBMIT] and task name in subject to do
    • Message body contains a rationale for the task to do
    • Message attachments contain the required files -source, documentation, @@ -783,9 +782,9 @@ necessary and saves a lot of work if you
    • delete the dependency to "use.init" in the find.xml
    • in FindTest.java change the line configureProject("build.xml"); to configureProject("src/etc/testcases/taskdefs/find.xml");
    • -
    • move the find.html to ANTHOME/docs/manual/CoreTasks/find.html
    • -
    • add a <a href="CoreTasks/find.html">Find</a><br> - in the ANTHOME/docs/manual/coretasklist.html
    • +
    • move the find.html to ANTHOME/docs/manual/Tasks/find.html
    • +
    • add a <a href="Tasks/find.html">Find</a><br> + in the ANTHOME/docs/manual/tasklist.html
    Now our modifications are done and we will retest it: @@ -954,7 +953,7 @@ Now the new task is uploaded into the bu   [2] tutorial-tasks-filesets-properties.zip
      [3] properties.html#built-in-props
      [4] http://ant-contrib.sourceforge.net/
    -  [5] CoreTasks/java.html
    +  [5] Tasks/java.html
      [6] http://ant.apache.org/ant_task_guidelines.html
      [7] http://ant.apache.org/cvs.html
      [8] http://java.sun.com/products/archive/index.html
    Modified: ant/core/trunk/docs/manual/tutorial-writing-tasks.html URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/tutorial-writing-tasks.html?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/tutorial-writing-tasks.html (original) +++ ant/core/trunk/docs/manual/tutorial-writing-tasks.html Wed May 26 20:33:51 2010 @@ -127,7 +127,7 @@ its depends-clause the "compile"

    Use the Task

    But after creating the jar we want to use our new Task. Therefore we need a new target "use". Before we can use our new task we have to declare it with - + <taskdef> [2]. And for easier process we change the default clause:

     <?xml version="1.0" encoding="ISO-8859-1"?>
    @@ -284,7 +284,7 @@ arguments of the set-method:
     Before calling the set-method all properties are resolved. So a <helloworld message="${msg}"/>
    @@ -756,7 +756,7 @@ The last sources and the buildfile are a
     
     Used Links:
      [1] http://ant.apache.org/manual/properties.html#built-in-props
    -  [2] http://ant.apache.org/manual/CoreTasks/taskdef.html
    +  [2] http://ant.apache.org/manual/Tasks/taskdef.html
      [3] http://ant.apache.org/manual/develop.html#set-magic
      [4] http://ant.apache.org/manual/develop.html#nested-elements
      [5] http://gump.covalent.net/jars/latest/ant/ant-testutil.jar
    Modified: ant/core/trunk/docs/manual/using.html URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/using.html?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/docs/manual/using.html (original) +++ ant/core/trunk/docs/manual/using.html Wed May 26 20:33:51 2010 @@ -67,7 +67,7 @@ to be unique. (For additional informatio

    Optionally, a description for the project can be provided as a top-level <description> element (see the description type).

    +href="Types/description.html">description type).

    Each project defines one or more targets. A target is a set of tasks you want @@ -101,9 +101,7 @@ resolved before the task is executed.

    where name is the name of the task, attributeN is the attribute name, and valueN is the value for this attribute.

    -

    There is a set of built-in tasks, along with a -number of - optional tasks, but it is also very +

    There is a set of built-in tasks, but it is also very easy to write your own.

    All tasks share a task name attribute. The value of this attribute will be used in the logging messages generated by @@ -146,7 +144,7 @@ task instances at all, only proxies. inside a build file.

    In its most simple form properties are defined in the build file - (for example by the property + (for example by the property task) or might be set outside Ant. A property has a name and a value; the name is case-sensitive. Properties may be used in the value of task attributes or in the nested text of tasks that support @@ -225,7 +223,7 @@ should be stored in a directory tree whi

    A project can have a set of tokens that might be automatically expanded if found when a file is copied, when the filtering-copy behavior is selected in the tasks that support this. These might be set in the buildfile -by the filter task.

    +by the filter task.

    Since this can potentially be a very harmful behavior, the tokens in the files must be of the form @token@, where @@ -277,14 +275,14 @@ supports path and <classpath path="${classpath}"/>

    In addition, one or more -Resource Collections +Resource Collections can be specified as nested elements (these must consist of -file-type resources only). +file-type resources only). Additionally, it should be noted that although resource collections are processed in the order encountered, certain resource collection types -such as fileset, -dirset and -files +such as fileset, +dirset and +files are undefined in terms of order.

         <classpath>
    @@ -502,15 +500,15 @@ replicate the same snippet of XML over a
     </project>
     

    All tasks that use nested elements for -PatternSets, -FileSets, -ZipFileSets or +PatternSets, +FileSets, +ZipFileSets or path-like structures accept references to these structures as shown in the examples. Using refid on a task will ordinarily have the same effect (referencing a task already declared), but the user should be aware that the interpretation of this attribute is dependent on the implementation of the element upon which it is specified. Some tasks (the -property task is a handy example) +property task is a handy example) deliberately assign a different meaning to refid.

    @@ -532,7 +530,7 @@ for adding libraries: For the declaration there are several ways:
    • declare a single task per using instruction using - <taskdef name="taskname" + <taskdef name="taskname" classname="ImplementationClass"/>
      <taskdef name="for" classname="net.sf.antcontrib.logic.For" /> @@ -544,14 +542,14 @@ For the declaration there are several wa <taskdef resource="net/sf/antcontrib/antcontrib.properties" /> <for ... />
    • -
    • declare a bundle of tasks using a xml-file holding these +
    • declare a bundle of tasks using a xml-file holding these taskname-ImplementationClass-pairs and <taskdef>
      <taskdef resource="net/sf/antcontrib/antlib.xml" /> <for ... />
    • declare a bundle of tasks using a xml-file named antlib.xml, XML-namespace and - antlib: protocoll handler + antlib: protocoll handler
      <project xmlns:ac="antlib:net.sf.antconrib"/> <ac:for ... /> Modified: ant/core/trunk/xdocs/antlibs/svn/index.xml URL: http://svn.apache.org/viewvc/ant/core/trunk/xdocs/antlibs/svn/index.xml?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/xdocs/antlibs/svn/index.xml (original) +++ ant/core/trunk/xdocs/antlibs/svn/index.xml Wed May 26 20:33:51 2010 @@ -42,14 +42,14 @@

      A very thin layer on top of the command line executable, comparable to the CVS + href="http://ant.apache.org/manual/Tasks/cvs.html">the CVS task.

      Creates a log of change comments between two revisions, comparable to CvsChangeLog.

      + href="http://ant.apache.org/manual/Tasks/changelog.html">CvsChangeLog.

      @@ -60,7 +60,7 @@ for the changes between two revisions.

      Together comparable to CvsTagDiff.

      + href="http://ant.apache.org/manual/Tasks/cvstagdiff.html">CvsTagDiff.

      Modified: ant/core/trunk/xdocs/faq.xml URL: http://svn.apache.org/viewvc/ant/core/trunk/xdocs/faq.xml?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/xdocs/faq.xml (original) +++ ant/core/trunk/xdocs/faq.xml Wed May 26 20:33:51 2010 @@ -335,7 +335,7 @@ Apache Ant version 1.6.2 compiled on Jul How to I precompile Java Server Pages (JSPs)? -

      Ant has a built in optional task <jspc> +

      Ant has a built in optional task <jspc> which was intended for that. But this task is deprecated. Here the alternative suggested by the manual:

      Instead of relying on container specific JSP-compilers we suggest deploying @@ -682,7 +682,7 @@ shell-prompt> m4 foo.m4 > foo course, comes with the overhead of adding JAR files to support the language, to say nothing of the added maintenance in requiring two languages to implement a single system. See the - + <script> task documentation for more details.

      Modified: ant/core/trunk/xdocs/resources.xml URL: http://svn.apache.org/viewvc/ant/core/trunk/xdocs/resources.xml?rev=948574&r1=948573&r2=948574&view=diff ============================================================================== --- ant/core/trunk/xdocs/resources.xml (original) +++ ant/core/trunk/xdocs/resources.xml Wed May 26 20:33:51 2010 @@ -56,7 +56,7 @@

      Benoit Moussaud, the original author of the Borland Application Server specific EJB tasks has put + href="manual/Tasks/ejb.html#ejbtasks">EJB tasks has put together a FAQ for this specific subtask.