diff --git a/docs/manual/CoreTasks/available.html b/docs/manual/CoreTasks/available.html index 818291873..471a2f9c8 100644 --- a/docs/manual/CoreTasks/available.html +++ b/docs/manual/CoreTasks/available.html @@ -104,7 +104,6 @@ if the directory /usr/local/lib is found.

sets the jaxp11.present property to the value "true" if the class javax.xml.transform.Transformer is found in the classpath referenced by jaxp (in this case, ./lib/jaxp11/jaxp.jar).

-

 <available property="have.extras" resource="extratasks.properties">
   <classpath>
diff --git a/docs/manual/CoreTasks/cvspass.html b/docs/manual/CoreTasks/cvspass.html
index c6b370425..789a5739c 100644
--- a/docs/manual/CoreTasks/cvspass.html
+++ b/docs/manual/CoreTasks/cvspass.html
@@ -9,7 +9,7 @@
 
 

cvspass

Description

-

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

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

Parameters

diff --git a/docs/manual/CoreTasks/dependset.html b/docs/manual/CoreTasks/dependset.html index 61a78ae3f..3112ecd6f 100644 --- a/docs/manual/CoreTasks/dependset.html +++ b/docs/manual/CoreTasks/dependset.html @@ -109,14 +109,14 @@ filelists, and if any are older, they are all deleted.

In this example derived HTML files in the ${output.dir} directory -will be removed if any are out-of-date with respect to: +will be removed if any are out-of-date with respect to:

  1. the DTD of their source XML files
  2. a common DTD (imported by the main DTD)
  3. a subordinate XSLT stylesheet (imported by the main stylesheet), or
  4. the buildfile
-

+

If any of the source files in the above example does not exist, all target files will also be removed. To ignore missing source files instead, diff --git a/docs/manual/CoreTasks/jar.html b/docs/manual/CoreTasks/jar.html index d44209310..931e2024e 100644 --- a/docs/manual/CoreTasks/jar.html +++ b/docs/manual/CoreTasks/jar.html @@ -37,7 +37,7 @@ You should not include META-INF/MANIFEST.MF in your set of files.yes, the JAR file is updated with the files specified. When set to no (the default) the JAR file is overwritten. An example use of this is -provided in the Zip task documentation. +provided in the Zip task documentation.

The whenempty parameter controls what happens when no files match. If create (the default), the JAR is created anyway with only a manifest. If skip, the JAR is not created and a warning is issued. diff --git a/docs/manual/CoreTasks/javac.html b/docs/manual/CoreTasks/javac.html index 18d020841..2d74ccee4 100644 --- a/docs/manual/CoreTasks/javac.html +++ b/docs/manual/CoreTasks/javac.html @@ -304,7 +304,7 @@ properties prior to invoking the task. The ant developers are aware that this is ugly and inflexible -expect a better solution in the future. All the options are boolean, and must be set to "true" or "yes" to be interpreted as anything other than false; by default -build.compiler.warnings is "true" while all others are "false" +build.compiler.warnings is "true" while all others are "false"

diff --git a/docs/manual/CoreTasks/javadoc.html b/docs/manual/CoreTasks/javadoc.html index c4a3b30bc..5e9ff9861 100644 --- a/docs/manual/CoreTasks/javadoc.html +++ b/docs/manual/CoreTasks/javadoc.html @@ -396,9 +396,9 @@ the second one a colon delimited list of packages.

contains a comma or a space character, using nested group elements is highly recommended.

-

E.g., +

E.g.,

    group="XSLT_Packages org.apache.xalan.xslt*,XPath_Packages org.apache.xalan.xpath*"
-

+

Parameters specified as nested elements

@@ -519,7 +519,7 @@ arguments.

The title may be specified as a nested <title> element with text contents, and the packages may be listed with nested -<package> elements as for the main task. +<package> elements as for the main task.

doclet

The doclet nested element is used to specify the doclet that javadoc will diff --git a/docs/manual/CoreTasks/overview.html b/docs/manual/CoreTasks/overview.html index 58d5ae536..959443eea 100644 --- a/docs/manual/CoreTasks/overview.html +++ b/docs/manual/CoreTasks/overview.html @@ -93,7 +93,7 @@ file, a directory, a class in the classpath, or a JVM system resource.

+ FileSets.

diff --git a/docs/manual/CoreTasks/parallel.html b/docs/manual/CoreTasks/parallel.html index 183389c5c..9de110acb 100644 --- a/docs/manual/CoreTasks/parallel.html +++ b/docs/manual/CoreTasks/parallel.html @@ -12,7 +12,7 @@

Parallel is a container task - it can contain other Ant tasks. Each nested task within the parallel task will be executed in its own thread.

-

Parallel tasks have a number of uses in an Ant build file including: +

Parallel tasks have a number of uses in an Ant build file including:

Delete

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

@@ -66,7 +66,7 @@ a buildFinished event.

Examples

The following build.xml snippet is an example of how to use the recorder -to record just the <javac> task: +to record just the <javac> task:

     ...
     <compile >
@@ -80,7 +80,7 @@ to record just the <javac> task:
 

The following two calls to <record> set up two recorders: one to file "records-simple.log" at logging level info (the default) and one to file "ISO.log" using logging level of -verbose. +verbose.

     ...
     <record name="records-simple.log" />
@@ -90,7 +90,7 @@ recorders: one to file "records-simple.log" at logging level inf
 
 

Notes

There is some functionality that I would like to be able to add in the -future. They include things like the following: +future. They include things like the following:

diff --git a/docs/manual/CoreTasks/sequential.html b/docs/manual/CoreTasks/sequential.html index 38603c9f0..62bae9c7e 100644 --- a/docs/manual/CoreTasks/sequential.html +++ b/docs/manual/CoreTasks/sequential.html @@ -30,7 +30,7 @@ sequential task.

</parallel>

This example shows how the sequential task is used to execute three tasks in -sequence, while another task is being executed in a separate thread. +sequence, while another task is being executed in a separate thread.


Copyright © 2000,2001 Apache Software Foundation. All rights diff --git a/docs/manual/CoreTasks/tar.html b/docs/manual/CoreTasks/tar.html index 86d1f21ac..d237625df 100644 --- a/docs/manual/CoreTasks/tar.html +++ b/docs/manual/CoreTasks/tar.html @@ -66,7 +66,7 @@ the limit.

diff --git a/docs/manual/CoreTasks/tstamp.html b/docs/manual/CoreTasks/tstamp.html index 894d98596..81dd19a41 100644 --- a/docs/manual/CoreTasks/tstamp.html +++ b/docs/manual/CoreTasks/tstamp.html @@ -14,12 +14,12 @@ properties in the current project. The DSTAMP property is in the format "yyyymmdd", TSTAMP is in the format "hhmm", and TODAY is in the -format "month day year". +format "month day year".

These properties can be used in the build-file, for instance, to create time-stamped filenames, or used to replace placeholder tags inside documents to indicate, for example, the release date. The best place for this task is -probably in an initialization target. +probably in an initialization target.

Parameters

AttributeDetermines how long files (>100 chars) are to be handled. Allowable values are "truncate", "fail", "warn", "omil" and "gnu". Default is - "warn". + "warn". No
@@ -108,7 +108,7 @@ and TODAY properties according to the default formats.

sets the standard properties as well as the property TODAY_UK with the date/time pattern "d-MMMM-yyyy" -using English locale (eg. 21-May-2001). +using English locale (eg. 21-May-2001).

   <tstamp>
diff --git a/docs/manual/CoreTasks/zip.html b/docs/manual/CoreTasks/zip.html
index 315c8624a..f9f7092c4 100644
--- a/docs/manual/CoreTasks/zip.html
+++ b/docs/manual/CoreTasks/zip.html
@@ -37,7 +37,7 @@ only reflect the relative paths of files within each fileset. The Zip tas
 ZIP file already exists. When set to yes, the ZIP file is
 updated with the files specified. (New files are added; old files are
 replaced with the new versions.) When set to no (the
-default) the ZIP file is overwritten.
+default) the ZIP file is overwritten.

The whenempty parameter controls what happens when no files match. If skip (the default), the ZIP is not created and a warning is issued. If fail, the ZIP is not created and the build is halted with an error. diff --git a/docs/manual/Integration/Antidote.html b/docs/manual/Integration/Antidote.html index cce925978..e4cadd215 100644 --- a/docs/manual/Integration/Antidote.html +++ b/docs/manual/Integration/Antidote.html @@ -31,7 +31,7 @@

Status

Antidote is still in the early stages of development, but does - have a set of usable features, including: + have a set of usable features, including:

  • Reading Ant build files.
  • Selecting targets and executing them.
  • @@ -39,9 +39,8 @@
  • Modification of (some) build file components.
  • Saving modified build file.
-

-

Current development tasks include: +

Current development tasks include:

  • A more complete set of target and task editing capabilities.
  • @@ -49,7 +48,6 @@ existing code bases.
  • Better build progress monitoring.
-

The Antidote source distribution comes with requirements and design documentation that better cover the details of application @@ -62,7 +60,7 @@

The source code for Antidote is located in a separate Module (jakarta-ant-antidote) in CVS. All the existing documentation can - be found there where new contributors should read: + be found there where new contributors should read:

- @@ -561,7 +561,7 @@ Project name at the beginning of the "includes" parameter.

Q: When I import Ant into my Workspace, I get Problems reported. Can I ignore them?
A: It depends on the problems reported, and what you want to do with Ant. -Problems you can't ignore: +Problems you can't ignore:

-

Q: Why is the task name vajload when the class is called VAJLoadProjects?
A: At the moment this task can load only project versions. This is reflected diff --git a/docs/manual/OptionalTasks/BorlandEJBTasks.html b/docs/manual/OptionalTasks/BorlandEJBTasks.html index c4723e2cc..8759b5197 100644 --- a/docs/manual/OptionalTasks/BorlandEJBTasks.html +++ b/docs/manual/OptionalTasks/BorlandEJBTasks.html @@ -9,11 +9,11 @@

BorlandDeployTool

Description

-

The BorlandDeployTool is a vendor specific nested element for the Ejbjar optional task. +

The BorlandDeployTool is a vendor specific nested element for the Ejbjar optional task.

BorlandDeploymentTool is dedicated to the Borland Application Server 4.5. It generates and compiles the stubs and skeletons for all ejb described into the Deployment Descriptor, builds the jar file including the support files and - verify whether the produced jar is valid or not. + verify whether the produced jar is valid or not.

Borland element

defaultexcludes use default excludes when exporting (default: "yes") + use default excludes when exporting (default: "yes") no
@@ -76,7 +76,7 @@

Examples

The following build.xml snippet is an example of how to use Borland element - into the ejbjar task + into the ejbjar task

    <ejbjar srcdir="${build.classes}"  basejarname="vsmp"  descriptordir="${rsc.dir}/hrmanager">
         <borland destdir="lib" verify="on" generateclient="on">
           <classpath refid="classpath" />
diff --git a/docs/manual/OptionalTasks/BorlandGenerateClient.html b/docs/manual/OptionalTasks/BorlandGenerateClient.html
index 82159d729..2a0c9f3a1 100644
--- a/docs/manual/OptionalTasks/BorlandGenerateClient.html
+++ b/docs/manual/OptionalTasks/BorlandGenerateClient.html
@@ -11,7 +11,7 @@
 

Description

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. + file.

Parameters

@@ -47,7 +47,7 @@

Examples

The following build.xml snippet is an example of how to use Borland element - into the ejbjar task using the java mode. + into the ejbjar task using the java mode.

 <blgenclient ejbjar="lib/secutest-ejb.jar" clientjar="lib/client.jar" debug="true" mode="java">
     <classpath>
diff --git a/docs/manual/OptionalTasks/dotnet.html b/docs/manual/OptionalTasks/dotnet.html
index 2d710e6a7..727afa228 100644
--- a/docs/manual/OptionalTasks/dotnet.html
+++ b/docs/manual/OptionalTasks/dotnet.html
@@ -120,9 +120,9 @@ version crimson.jar and jaxp.jar.
 This is the beta-2 revision of the tasks. 
 
  1. ILASM: pulled the owner attribute, added keyfile for giving binaries a strong name -(MD5 hash of the checksum) -
  2. CSC: added win32res , noConfig, utf8output, fullpaths -
  3. CSC: +(MD5 hash of the checksum)
  4. +
  5. CSC: added win32res , noConfig, utf8output, fullpaths
  6. +
  7. CSC:

Version 0.3

diff --git a/docs/manual/OptionalTasks/ejb.html b/docs/manual/OptionalTasks/ejb.html index 736c8e6ee..5325cb65c 100644 --- a/docs/manual/OptionalTasks/ejb.html +++ b/docs/manual/OptionalTasks/ejb.html @@ -198,7 +198,7 @@ task will also attempt to locate the EJB stubs and skeletons in this directory. If found, the timestamps on the stubs and skeletons will be checked to ensure they are up to date. Only if these files cannot be found or if they are out of date will the iAS ejbc utility be called to generate new stubs -and skeletons. +and skeletons.

Parameters:

@@ -222,7 +222,7 @@ Parameters:
- + @@ -529,7 +529,7 @@ include:

  • Borland Application Server 4.5
  • iPlanet Application Server 6.0
  • Jboss 2.1 and above
  • -
  • Weblogic 5.1/6.0 session/entity beans using the weblogic.ejbc tool +
  • Weblogic 5.1/6.0 session/entity beans using the weblogic.ejbc tool
  • TOPLink for WebLogic 2.5.1-enabled entity beans
  • @@ -716,9 +716,8 @@ Each vendor-specific nested element controls the generation of a deployable jar specific to that vendor's EJB container. The parameters for each supported deployment element are detailed here. - -

    Jboss element

    -
    + +

    Jboss element

    The jboss element searches for the jboss specific deployment descriptors and adds them to the final ejb jar file. Jboss has two deployment descriptors jboss.xml and jaws.xml @@ -764,9 +763,8 @@ not require compilation of additional stubs and skeletons.

    iasdescriptoriAS-specific EJB XML descriptor (typically titled "ias-ejb-jar.xml).iAS-specific EJB XML descriptor (typically titled "ias-ejb-jar.xml"). Yes
    - -

    Weblogic element

    -
    + +

    Weblogic element

    The weblogic element is used to control the weblogic.ejbc compiler for generating weblogic EJB jars. Prior to Ant 1.3, the method of locating CMP @@ -1044,7 +1042,7 @@ This will create only one TOPLink-enabled ejb jar file - 'Address.jar'.

    This final example shows how you would set-up ejbjar under Weblogic 6.0. It also shows the use of the -<support> element to add support files +<support> element to add support files

         <ejbjar descriptordir="${dd.dir}" srcdir="${build.classes.server}">
    @@ -1067,9 +1065,8 @@ This will create only one TOPLink-enabled ejb jar file - 'Address.jar'.

    </ejbjar>
    - -

    iPlanet Application Server (iAS) element

    -
    + +

    iPlanet Application Server (iAS) element

    The <iplanet> nested element is used to build iAS-specific stubs and skeletons and construct a JAR file which may be deployed to the iPlanet @@ -1084,11 +1081,11 @@ EJB descriptor file named ejb/Account-ias-ejb-jar.xml (if it isn't found, the task will fail) and a JAR file named ejb/Account.jar will be written in the destination directory. Note that when the EJB descriptors are added to the JAR file, they are automatically renamed META-INF/ejb-jar.xml -and META-INF/ias-ejb-jar.xml. +and META-INF/ias-ejb-jar.xml.

    Of course, this naming behavior can be modified by specifying attributes in the ejbjar task (for example, basejarname, basenameterminator, and flatdestdir) as well as the iplanet element (for example, suffix). Refer to the -appropriate documentation for more details. +appropriate documentation for more details.

    Parameters:

    @@ -1166,7 +1163,7 @@ If omitted, it defaults to ".jar".

    As noted above, the iplanet element supports additional <classpath> -nested elements. +nested elements.

    Examples

    This example demonstrates the typical use of the <iplanet> nested element. diff --git a/docs/manual/OptionalTasks/icontract.html b/docs/manual/OptionalTasks/icontract.html index f57fe52de..a8fe2319a 100644 --- a/docs/manual/OptionalTasks/icontract.html +++ b/docs/manual/OptionalTasks/icontract.html @@ -44,7 +44,6 @@ Instruments Java classes with i builddir Indicates where the compiled instrumented classes should go. Defaults to the value of instrumentdir. -

    NOTE: Don't use the same directory for compiled instrumented classes and uninstrumented classes. It will break the dependency checking. (Classes will not be reinstrumented if you change them). diff --git a/docs/manual/OptionalTasks/jdepend.html b/docs/manual/OptionalTasks/jdepend.html index a8b190256..5bbe5c75e 100644 --- a/docs/manual/OptionalTasks/jdepend.html +++ b/docs/manual/OptionalTasks/jdepend.html @@ -15,9 +15,9 @@

    Invokes the JDepend parser.

    -

    This parser "traverses a set of Java source file directories and generates design quality metrics for each Java package". -It allows to "automatically measure the quality of a design in terms of its extensibility, reusability, and maintainability to -effectively manage and control package dependencies."

    +

    This parser "traverses a set of Java source file directories and generates design quality metrics for each Java package". +It allows to "automatically measure the quality of a design in terms of its extensibility, reusability, and maintainability to +effectively manage and control package dependencies."

    Source file directories are defined by nested <sourcespath>, see nested elements.

    @@ -27,8 +27,6 @@ effectively manage and control package dependencies."

    Note: whereas the JDepend tool can be customized to exclude some packages, the current jdepend And Task does not have parameters to allow these exclusions. Read JDepend specific documentation for that purpose.

    -

    -

    Parameters

    diff --git a/docs/manual/OptionalTasks/jjtree.html b/docs/manual/OptionalTasks/jjtree.html index 4e76e9c8d..6a72bb866 100644 --- a/docs/manual/OptionalTasks/jjtree.html +++ b/docs/manual/OptionalTasks/jjtree.html @@ -23,11 +23,11 @@ so that ant can find the JavaCC classes. Optionally, you can also set the outputdirectory to write the generated file to a specific directory. Otherwise jjtree writes the generated JavaCC grammar file to the directory containing the JJTree -grammar file. +grammar file.

    This task only invokes JJTree if the grammar file is newer than the -generated JavaCC file. -

    -Parameters

    +generated JavaCC file.

    + +

    Parameters

    diff --git a/docs/manual/OptionalTasks/jpcoverage.html b/docs/manual/OptionalTasks/jpcoverage.html index 5b8709e24..4bf18fe00 100644 --- a/docs/manual/OptionalTasks/jpcoverage.html +++ b/docs/manual/OptionalTasks/jpcoverage.html @@ -24,7 +24,6 @@ and is not intended as a replacement to the manual.

    Tasks

    -
    @@ -39,7 +38,6 @@ and is not intended as a replacement to the manual.
    JPCoverageCreate a report from a snapshot
    -
    @@ -97,8 +95,8 @@ Perform code covering functions by comparing source code line execution to the p exitprompt - Toggles display of the console prompt: "Press Enter to close - this window." "always": Always displays the prompt. "never": Never displays the + Toggles display of the console prompt: "Press Enter to close + this window." "always": Always displays the prompt. "never": Never displays the prompt. "error": Only displays prompt after an error. No, default is "never" @@ -150,7 +148,7 @@ Perform code covering functions by comparing source code line execution to the p

    classpath

    jpcoverage supports a nested <classpath> -element, that represents a PATH like +element, that represents a PATH like structure.

    jvmarg

    @@ -169,13 +167,13 @@ attributes, for example:

    would run the coverage on "MyClass" in classic mode VM.

    <jvmarg> allows all attributes described in Command line arguments.

    +href="../using.html#arg">Command line arguments.

    arg

    Parameters may be passed to the executed class via nested <arg> -attributes, as described in Command line arguments. +attributes, as described in Command line arguments.

    socket

    @@ -204,7 +202,7 @@ attributes, as described in Command line arguments.

    filters

    Defines class/method filters based on pattern matching. -The syntax is filters is similar to a fileset. +The syntax is filters is similar to a fileset.

    @@ -348,7 +346,7 @@ same class.

    -jpcovmerge collects snapshots using the nested <FileSet> +jpcovmerge collects snapshots using the nested <FileSet> element.

    @@ -368,7 +366,7 @@ directory snapshots. The resulting file will be named merge.jpc -

    JPCovReport

    +

    JPCovReport

    Description

    @@ -425,7 +423,7 @@ Oro in Ant classpath, to run the reference feature.

    sourcepath

    -Path to source files can be set via nested sourcepath elements that are PATH like structures. +Path to source files can be set via nested sourcepath elements that are PATH like structures.

    reference (only applies to format="xml")

    @@ -456,7 +454,7 @@ the XML report accordingly. In short, it will:

    -Path to the reference set of files can be set via nested classpath elements that are PATH like structures. +Path to the reference set of files can be set via nested classpath elements that are PATH like structures.

    filters diff --git a/docs/manual/OptionalTasks/junit.html b/docs/manual/OptionalTasks/junit.html index 97e3e1496..da49c2f80 100644 --- a/docs/manual/OptionalTasks/junit.html +++ b/docs/manual/OptionalTasks/junit.html @@ -97,7 +97,7 @@ structure.

    jvmarg

    If fork is enabled, additional parameters may be passed to the new -VM via nested <jvmarg> attributes, for example: +VM via nested <jvmarg> attributes, for example:

     <junit fork="yes">
    @@ -106,7 +106,7 @@ VM via nested <jvmarg> attributes, for example:
     </junit>
     
    -would run the test in a VM without JIT.

    +

    would run the test in a VM without JIT.

    <jvmarg> allows all attributes described in Command line arguments.

    @@ -116,7 +116,7 @@ href="../using.html#arg">Command line arguments.

    Use nested <sysproperty> elements to specify system properties required by the class. These properties will be made available to the VM during the execution of the test (either ANT's VM or the forked VM). -The attributes for this element are the same as for environment variables. +The attributes for this element are the same as for environment variables.

     <junit fork="no">
    @@ -125,7 +125,7 @@ The attributes for this element are the same as for 
     
    -Runs the test defined in my.test.TestCase in the same
    +

    Runs the test defined in my.test.TestCase in the same VM. No output will be generated unless the test fails.

    -

    +
     <junit printsummary="yes" fork="yes" haltonfailure="yes">
       <formatter type="plain" />
       <test name="my.test.TestCase" />
     </junit>
     
    -Runs the test defined in my.test.TestCase in a +

    Runs the test defined in my.test.TestCase in a separate VM. At the end of the test a single line summary will be printed. A detailed report of the test can be found in TEST-my.test.TestCase.txt. The build process will be stopped if the test fails.

    -

    +
     <junit printsummary="yes" haltonfailure="yes">
       <classpath>
         <pathelement location="${build.tests}" />
    @@ -361,7 +361,7 @@ stopped if the test fails.

    </junit>
    -Runs my.test.TestCase in the same VM (ignoring the +

    Runs my.test.TestCase in the same VM (ignoring the given CLASSPATH), only a warning is printed if this test fails. In addition to the plain text test results, for this test a XML result will be output to result.xml.

    diff --git a/docs/manual/OptionalTasks/junitreport.html b/docs/manual/OptionalTasks/junitreport.html index fa2f3642e..71cbfde14 100644 --- a/docs/manual/OptionalTasks/junitreport.html +++ b/docs/manual/OptionalTasks/junitreport.html @@ -11,13 +11,13 @@ a stylesheet on the resulting merged document to provide a browsable report of the testcases results.

    Requirements

    The task will run with either Xalan 2.x -or Xalan 1.2.2. +or Xalan 1.2.2.

    Note:For a framed format Xalan 1.2.2 will need Xerces(xerces.jar) as well as BSF(bsf.jar) that can be found in the distribution archive. Xerces will need to be before any other parser (such as the shipped crimson). It is *highly* recommended to use Xalan2 instead because Xalan1 is no more supported. - +

    Parameters

    @@ -41,7 +41,7 @@ because Xalan1 is no more supported.

    Nested Elements

    fileset

    junitreport collects individual xml files generated by the JUnit -task using the nested <FileSet> +task using the nested <FileSet> element.

    report

    Generate a browsable report based on the document created by the merge.

    diff --git a/docs/manual/OptionalTasks/maudit.html b/docs/manual/OptionalTasks/maudit.html index 2ba41b2c6..7de7cfc01 100644 --- a/docs/manual/OptionalTasks/maudit.html +++ b/docs/manual/OptionalTasks/maudit.html @@ -76,20 +76,20 @@ An evaluation version is available at Command +attributes. <jvmarg> allows all attributes described in Command line arguments.

    classpath

    Sets class path (also source path unless one explicitly set). Overrides -METAPATH/CLASSPATH environment variables. The classpath element represents a PATH like +METAPATH/CLASSPATH environment variables. The classpath element represents a PATH like structure.

    sourcepath

    -

    Sets source path. Overrides the SOURCEPATH environment variable. The sourcepath element represents a PATH like +

    Sets source path. Overrides the SOURCEPATH environment variable. The sourcepath element represents a PATH like structure.

    sourcepath

    -

    Sets the search path to use as the use domain when looking for unused global declarations. The searchpath element represents a PATH like +

    Sets the search path to use as the use domain when looking for unused global declarations. The searchpath element represents a PATH like structure.

    fileset

    -

    Sets the Java files to audit via a FILESET structure. +

    Sets the Java files to audit via a FILESET structure. Whatever the filter is, only the files that ends with .java will be included for processing. Note that the base directory used for the fileset MUST be the root of the source files otherwise package names deduced from the file path will be incorrect. @@ -128,10 +128,5 @@ in the current directory), it can be run in Ant as follows: </java> -


    - - - -
    - - + + diff --git a/docs/manual/OptionalTasks/mimemail.html b/docs/manual/OptionalTasks/mimemail.html index 2cc6e367c..2747ac8c7 100644 --- a/docs/manual/OptionalTasks/mimemail.html +++ b/docs/manual/OptionalTasks/mimemail.html @@ -10,7 +10,7 @@

    MimeMail

    Description

    Sends SMTP mail with MIME attachments.   If  no attachments -are needed, use the built-in Mail +are needed, use the built-in Mail task.  JavaMail and Java Activation Framework are required for this task.

    diff --git a/docs/manual/OptionalTasks/mmetrics.html b/docs/manual/OptionalTasks/mmetrics.html index 14af8de2f..26f26bf48 100644 --- a/docs/manual/OptionalTasks/mmetrics.html +++ b/docs/manual/OptionalTasks/mmetrics.html @@ -19,7 +19,7 @@ An evaluation version is available at Xalan 2.x) via JAXP 1.1

    Description

    - Invokes the Metamata Metrics / WebGain Quality Analyzer source code + Invokes the Metamata Metrics / WebGain Quality Analyzer source code analyzer on a set of Java files.

    @@ -60,23 +60,23 @@ You also need a TRaX compliant processor(such as Command +attributes. <jvmarg> allows all attributes described in Command line arguments.

    classpath

    Sets class path (also source path unless one explicitly set). Overrides -METAPATH/CLASSPATH environment variables. The classpath element represents a PATH like +METAPATH/CLASSPATH environment variables. The classpath element represents a PATH like structure.

    sourcepath

    -

    Sets source path. Overrides the SOURCEPATH environment variable. The sourcepath element represents a PATH like +

    Sets source path. Overrides the SOURCEPATH environment variable. The sourcepath element represents a PATH like structure.

    path

    -

    Sets the list of directories to analyze the code for metrics.;It represents a PATH structure.

    +

    Sets the list of directories to analyze the code for metrics.;It represents a PATH structure.

    fileset

    -

    Sets a set of files to analyze for metrics.source It represents a FILESET structure.

    +

    Sets a set of files to analyze for metrics.source It represents a FILESET structure.

    @@ -122,7 +122,5 @@ in the current directory), it can be run in Ant as follows: <param value="&quot;'${report.dir}'&quot;"/> </java> - -


    - - + + diff --git a/docs/manual/OptionalTasks/mparse.html b/docs/manual/OptionalTasks/mparse.html index 49436b071..8c2c71412 100644 --- a/docs/manual/OptionalTasks/mparse.html +++ b/docs/manual/OptionalTasks/mparse.html @@ -91,14 +91,14 @@

    Nested elements

    jvmarg

    Additional parameters may be passed to the VM via nested <jvmarg> -attributes. <jvmarg> allows all attributes described in Command +attributes. <jvmarg> allows all attributes described in Command line arguments.

    classpath

    Sets class path (also source path unless one explicitly set). Overrides -METAPATH/CLASSPATH environment variables.  The classpath element represents a PATH like +METAPATH/CLASSPATH environment variables.  The classpath element represents a PATH like structure.

    sourcepath

    -

    Sets source path. Overrides the SOURCEPATH environment variable. The sourcepath element represents a PATH like +

    Sets source path. Overrides the SOURCEPATH environment variable. The sourcepath element represents a PATH like structure.

    Example

      <mparse target="c:/metamata/examples/parseexamples/javagrammars/singlefile/JavaParser.jj"
    @@ -112,6 +112,5 @@ structure.

    example (JavaParser.jj) and cleans up the intermediate Sun JavaCC file.

    -
    - - + + diff --git a/docs/manual/OptionalTasks/native2ascii.html b/docs/manual/OptionalTasks/native2ascii.html index 816fa54c9..51310e87e 100644 --- a/docs/manual/OptionalTasks/native2ascii.html +++ b/docs/manual/OptionalTasks/native2ascii.html @@ -19,7 +19,7 @@ includes and excludes attributes. For more information on file matching patterns, see the section on - directory based tasks. + directory based tasks. If no encoding is specified, the default encoding for the JVM is used. If ext is specified, then output files are renamed @@ -33,7 +33,7 @@

    - This task forms an implicit File Set, + This task forms an implicit File Set, and supports all attributes of <fileset> (dir becomes src) as well as nested <include>, <exclude>, diff --git a/docs/manual/OptionalTasks/pvcstask.html b/docs/manual/OptionalTasks/pvcstask.html index 3cddbfa21..87f30a0be 100644 --- a/docs/manual/OptionalTasks/pvcstask.html +++ b/docs/manual/OptionalTasks/pvcstask.html @@ -23,19 +23,14 @@ Version 1.0 - 2001/01/31


    Table of Contents

    -
    -

    -Introduction

    -The <pvcs> task allows the user of ant to extract the latest edition + +

    Introduction

    +The pvcs task allows the user of ant to extract the latest edition of the source code from a PVCS repository. PVCS is a version control system developed by Merant.
    @@ -44,13 +39,10 @@ of PVCS (get and pcli) and must have access to the repository. Note that the way the repository is platform dependent so use property to specify location of repository.
    This version has been tested agains PVCS version 6.5 and 6.6 under Windows and Solaris. -
    -
    -

    -Pvcs Task

    -

    -Description

    +
    +

    Pvcs Task

    +

    Description

    The pvcs task is set to point at a PVCS repository and optionally a project within that repository, and can from that specification get the latest version of the files contained by the repository. @@ -79,7 +71,7 @@ manuals)
    @@ -176,74 +168,68 @@ specified.

    pvcsproject The project within the PVCS repository to extract -files from ("/" is root project and that is default if this attribute isn't +files from ("/" is root project and that is default if this attribute isn't specified) No
    -

    -Examples

    -The following set-up extracts the latest version of the files in the pvcs -repository. -
          <!-- =================================================================== ---> -
          <!-- Get the latest version                                                                                                                         ---> -
          <!-- =================================================================== ---> -
          <target name="getlatest"> -
              < pvcs repository="/mnt/pvcs" -pvcsproject="/myprj"/> -
          </target>
    -Now run: -

            ant getlatest -

    This will cause the following output to appear: -

        getlatest:
    -     [pvcs] PVCS Version Manager (VMGUI) v6.6.10 (Build 870) for Windows NT/80x86
    -     [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
    -     [pvcs] PVCS Version Manager (get) v6.6.10 (Build 870) for Windows NT/80x86
    -     [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
    -     [pvcs] c:\myws\myprj\main.java <- C:\mypvcs\archives\myprj\main.java-arc
    -     [pvcs] rev 1.1
    -     [pvcs] c:\myws\myprj\apache\tool.java <- C:\mypvcs\archives\myprj\apache\tools.java-arc
    -     [pvcs] rev 1.5
    -
    -    BUILD SUCCESSFUL
    -
    -    Total time: 19 seconds
    +

    Examples

    +The following set-up extracts the latest version of the files in the pvcs repository. +
    +  <!-- =================================================================== -->
    +  <!-- Get the latest version                                              -->
    +  <!-- =================================================================== -->
    +  <target name="getlatest">
    +    <pvcs repository="/mnt/pvcs" pvcsproject="/myprj"/>
    +  </target>
    +
    +

    Now run:

    +ant getlatest +

    This will cause the following output to appear:

    +
    +  getlatest:
    +  [pvcs] PVCS Version Manager (VMGUI) v6.6.10 (Build 870) for Windows NT/80x86
    +  [pvcs] Copyright 1985-2000 MERANT. All rights reserved.
    +  [pvcs] PVCS Version Manager (get) v6.6.10 (Build 870) for Windows NT/80x86
    +  [pvcs] Copyright 1985-2000 MERANT. All rights reserved.
    +  [pvcs] c:\myws\myprj\main.java <- C:\mypvcs\archives\myprj\main.java-arc
    +  [pvcs] rev 1.1
    +  [pvcs] c:\myws\myprj\apache\tool.java <- C:\mypvcs\archives\myprj\apache\tools.java-arc
    +  [pvcs] rev 1.5
    +
    +  BUILD SUCCESSFUL
    +
    +  Total time: 19 seconds
    This next example extracts the latest version of the files in the pvcs repository from two projects using nested <pvcsproject> elements. -
          <!-- =================================================================== ---> -
          <!-- Get latest from myprj and myprj2                                                                                                      ---> -
          <!-- =================================================================== ---> -
          <target name="getlatest2"> -
              <pvcs repository="/mnt/pvcs"> -
                 <pvcsproject name="/myprj" /> -
                 <pvcsproject name="/myprj2" /> -
              </pvcs> -
          </target>
    -Now run: -

            ant getlatest2 -

    This will cause the following output to appear: -

        getlatest2:
    -     [pvcs] PVCS Version Manager (VMGUI) v6.6.10 (Build 870) for Windows NT/80x86
    -     [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
    -     [pvcs] PVCS Version Manager (get) v6.6.10 (Build 870) for Windows NT/80x86
    -     [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
    -     [pvcs] c:\myws\myprj\main.java <- C:\mypvcs\archives\myprj\main.java-arc
    -     [pvcs] rev 1.1
    -     [pvcs] c:\myws\myprj\apache\tool.java <- C:\mypvcs\archives\myprj\apache\tool.java-arc
    -     [pvcs] rev 1.5
    -     [pvcs] c:\myws\myprj2\apache\tool2.java <- C:\mypvcs\archives\myprj2\apache\tool2.java-arc
    -     [pvcs] rev 1.2
    -
    -    BUILD SUCCESSFUL
    -
    -    Total time: 22 seconds
    -
    +  <!-- ===================================================================-->
    +  <!-- Get latest from myprj and myprj2                                   -->
    +  <!-- ===================================================================-->
    +  <target name="getlatest2">
    +    <pvcs repository="/mnt/pvcs">
    +      <pvcsproject name="/myprj"/>
    +      <pvcsproject name="/myprj2"/>
    +    </pvcs>
    +  </target>
     
    - -
    +

    Now run:

    +ant getlatest2 +

    This will cause the following output to appear:

    +
    +  getlatest2:
    +  [pvcs] PVCS Version Manager (VMGUI) v6.6.10 (Build 870) for Windows NT/80x86
    +  [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
    +  [pvcs] PVCS Version Manager (get) v6.6.10 (Build 870) for Windows NT/80x86
    +  [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
    +  [pvcs] c:\myws\myprj\main.java <- C:\mypvcs\archives\myprj\main.java-arc
    +  [pvcs] rev 1.1
    +  [pvcs] c:\myws\myprj\apache\tool.java <- C:\mypvcs\archives\myprj\apache\tool.java-arc
    +  [pvcs] rev 1.5
    +  [pvcs] c:\myws\myprj2\apache\tool2.java <- C:\mypvcs\archives\myprj2\apache\tool2.java-arc
    +  [pvcs] rev 1.2
    +
    +  BUILD SUCCESSFUL
    +
    +  Total time: 22 seconds
    + +
    PVCS is a registered trademark of MERANT. diff --git a/docs/manual/OptionalTasks/starteam.html b/docs/manual/OptionalTasks/starteam.html index 7b426d360..40b20470f 100644 --- a/docs/manual/OptionalTasks/starteam.html +++ b/docs/manual/OptionalTasks/starteam.html @@ -14,14 +14,14 @@ Checks out files from a StarTeam project.

    The includes and excludes attributes function differently from other tasks in Ant. Multiple patters must be seperated by spaces, not -commas. See the examples for more information. +commas. See the examples for more information.

    This program makes use of functions from the StarTeam API. As a result this task is only available to licensed users of StarTeam. You must have starteam-sdk.jar in your classpath to run this task. For more information about the StarTeam API and how to license it, see -the StarBase web site. +the StarBase web site.

    Parameters

    @@ -149,7 +149,6 @@ This is an example of overlapping includes and excludes attributes excludes takes precedence over includes, files named index.html will not be checked out by this command. -


    Copyright © 2000,2001 Apache Software Foundation. All rights Reserved. diff --git a/docs/manual/OptionalTasks/wljspc.html b/docs/manual/OptionalTasks/wljspc.html index 8321e8dff..be50f0b8e 100644 --- a/docs/manual/OptionalTasks/wljspc.html +++ b/docs/manual/OptionalTasks/wljspc.html @@ -67,18 +67,14 @@ Example
    </wljspc>
    </target>

    -

    -
    -Limitations -

    -

    -This works only on weblogic 4.5.1 -
    -It compiles the files thru the Classic compiler only.
    - Since it is my experience that weblogic jspc throws out of memory error on being given too
    -many files at one go, it is called multiple times with one jsp file each. - +

    Limitations

    +
      +
    • This works only on weblogic 4.5.1
    • +
    • It compiles the files thru the Classic compiler only.
    • +
    • Since it is my experience that weblogic jspc throws out of memory error on being given too +many files at one go, it is called multiple times with one jsp file each.
    • +
    diff --git a/docs/manual/coretasklist.html b/docs/manual/coretasklist.html index e8ba44ba8..74f1b9743 100644 --- a/docs/manual/coretasklist.html +++ b/docs/manual/coretasklist.html @@ -13,8 +13,10 @@

    Concepts and Types

    Directory Based Tasks
    build.sysclasspath
    +Description
    Patternset
    -Fileset
    +FileList
    +FileSet
    Filterset
    File Mappers
    Common Attributes
    diff --git a/docs/manual/dirtasks.html b/docs/manual/dirtasks.html index 053f8ee37..7a7946ed9 100644 --- a/docs/manual/dirtasks.html +++ b/docs/manual/dirtasks.html @@ -126,7 +126,7 @@ way to select just the files you want.

    Examples

      
    -<copy todir="${dist}">
    +<copy todir="${dist}">
       <fileset dir="${src}" 
                includes="**/images/*" 
                excludes="**/*.gif" 
    @@ -138,7 +138,7 @@ destination directory defined by ${dist},
     but excludes all *.gif files from the copy.

    This example can also be expressed using nested elements:

    -<copy todir="${dist}">
    +<copy todir="${dist}">
       <fileset dir="${src}">
         <include name="**/images/*"/>
         <exclude name="**/*.gif"/>
    diff --git a/docs/manual/install.html b/docs/manual/install.html
    index 94f2d57f0..1762c6dc3 100644
    --- a/docs/manual/install.html
    +++ b/docs/manual/install.html
    @@ -68,7 +68,7 @@ required to run Ant.
     
     To install Ant, choose a directory and copy the distribution
     file there. This directory will be known as ANT_HOME. 
    -
    +

    @@ -87,8 +87,8 @@ installed in a short path, such as C:\Ant.
    -
    +

    Before you can run ant there is some additional set up you will need to do:

      @@ -201,7 +201,7 @@ used for the remainder of the build steps.
    • Invokes the bootstrapped Ant with the parameters passed to the build script. In this case, these parameters define an Ant property value and specify the "dist" target -in Ant's own build.xml file. +in Ant's own build.xml file.

    On most occasions you will not need to explicitly bootstrap Ant since the build diff --git a/docs/manual/using.html b/docs/manual/using.html index 12abd42d5..1d65532ed 100644 --- a/docs/manual/using.html +++ b/docs/manual/using.html @@ -136,9 +136,8 @@ have the name "init".

    - -

    Tasks

    -
    + +

    Tasks

    A task is a piece of code that can be executed.

    A task can have multiple attributes (or arguments, if you prefer). The value of an attribute might contain references to a property. These references will be @@ -207,6 +206,7 @@ For example, ${os.name} expands to the name of the operating system.

    For a list of system properties see the Javadoc of System.getProperties. +

    In addition, Ant has some built-in properties:

     basedir             the absolute path of the project's basedir (as set