From d3827f7d843d25d1919dcc669a689e9e01b4679c Mon Sep 17 00:00:00 2001 From: Gintas Grigelionis Date: Wed, 24 Jan 2018 21:40:28 +0100 Subject: [PATCH] Second reading: h5 and h6 must be styled; uniform style of notes and new feature markers --- manual/Tasks/ant.html | 2 +- manual/Tasks/antlr.html | 2 +- manual/Tasks/antversion.html | 2 +- manual/Tasks/apply.html | 16 +++++------ manual/Tasks/attrib.html | 8 +++--- manual/Tasks/augment.html | 2 +- manual/Tasks/bindtargets.html | 4 +-- manual/Tasks/changelog.html | 2 +- manual/Tasks/chgrp.html | 4 +-- manual/Tasks/chmod.html | 12 ++++---- manual/Tasks/chown.html | 4 +-- manual/Tasks/conditions.html | 38 ++++++++++++------------- manual/Tasks/copy.html | 10 +++---- manual/Tasks/cvs.html | 4 +-- manual/Tasks/cvspass.html | 2 +- manual/Tasks/cvsversion.html | 2 +- manual/Tasks/delete.html | 14 +++++----- manual/Tasks/dependset.html | 4 +-- manual/Tasks/diagnostics.html | 2 +- manual/Tasks/dirname.html | 2 +- manual/Tasks/ear.html | 2 +- manual/Tasks/echo.html | 2 +- manual/Tasks/echoxml.html | 2 +- manual/Tasks/exec.html | 10 +++---- manual/Tasks/fail.html | 2 +- manual/Tasks/fixcrlf.html | 10 +++---- manual/Tasks/ftp.html | 8 +++--- manual/Tasks/get.html | 6 ++-- manual/Tasks/import.html | 4 +-- manual/Tasks/include.html | 4 +-- manual/Tasks/input.html | 4 +-- manual/Tasks/jar.html | 10 +++---- manual/Tasks/java.html | 8 +++--- manual/Tasks/javac.html | 34 +++++++++++----------- manual/Tasks/javadoc.html | 20 ++++++------- manual/Tasks/javah.html | 20 ++++++------- manual/Tasks/jdepend.html | 2 +- manual/Tasks/junit.html | 14 +++++----- manual/Tasks/junitreport.html | 18 ++++++------ manual/Tasks/loadfile.html | 2 +- manual/Tasks/loadproperties.html | 2 +- manual/Tasks/local.html | 2 +- manual/Tasks/macrodef.html | 2 +- manual/Tasks/mail.html | 7 ++--- manual/Tasks/move.html | 4 +-- manual/Tasks/native2ascii.html | 12 ++++---- manual/Tasks/netrexxc.html | 2 +- manual/Tasks/propertyhelper.html | 2 +- manual/Tasks/pvcstask.html | 2 +- manual/Tasks/replace.html | 12 ++++---- manual/Tasks/replaceregexp.html | 2 +- manual/Tasks/resourcecount.html | 2 +- manual/Tasks/rexec.html | 2 +- manual/Tasks/rmic.html | 26 ++++++++--------- manual/Tasks/scp.html | 8 +++--- manual/Tasks/script.html | 8 +++--- manual/Tasks/scriptdef.html | 10 +++---- manual/Tasks/setpermissions.html | 2 +- manual/Tasks/sound.html | 2 +- manual/Tasks/sql.html | 6 ++-- manual/Tasks/sshexec.html | 9 +++--- manual/Tasks/sshsession.html | 7 ++--- manual/Tasks/style.html | 48 ++++++++++++++------------------ manual/Tasks/symlink.html | 6 ++-- manual/Tasks/sync.html | 2 +- manual/Tasks/tar.html | 6 ++-- manual/Tasks/telnet.html | 2 +- manual/Tasks/touch.html | 4 +-- manual/Tasks/truncate.html | 2 +- manual/Tasks/unzip.html | 4 +-- manual/Tasks/uptodate.html | 2 +- manual/Tasks/war.html | 2 +- manual/Tasks/whichresource.html | 2 +- manual/Tasks/xmlproperty.html | 2 +- manual/Tasks/zip.html | 26 ++++++++--------- manual/stylesheets/style.css | 44 +++++++++++++++++++++-------- 76 files changed, 301 insertions(+), 300 deletions(-) diff --git a/manual/Tasks/ant.html b/manual/Tasks/ant.html index 5579c2c00..7088d2cc2 100644 --- a/manual/Tasks/ant.html +++ b/manual/Tasks/ant.html @@ -59,7 +59,7 @@ parameterize your subprojects.

Properties defined on the command line cannot be overridden by nested <property> elements. Since Ant - 1.8.0. the same is true for nested structures + 1.8.0 the same is true for nested structures of <ant> tasks: if a build file A invokes B via an <ant> task setting a property with a nested <property> element diff --git a/manual/Tasks/antlr.html b/manual/Tasks/antlr.html index c680f1d36..36d22cb40 100644 --- a/manual/Tasks/antlr.html +++ b/manual/Tasks/antlr.html @@ -42,7 +42,7 @@ supergrammar specified by the glib attribute) is newer than the generated files.

-

Note: This task depends on external libraries not +

Note: This task depends on external libraries not included in the Apache Ant distribution. See Library Dependencies for more information.

Antlr 2.7.1 Note: diff --git a/manual/Tasks/antversion.html b/manual/Tasks/antversion.html index 740b0a521..d1f36c4f9 100644 --- a/manual/Tasks/antversion.html +++ b/manual/Tasks/antversion.html @@ -29,7 +29,7 @@

Stores the Apache Ant version (when used as task) or checks for a specific Ant version (when used as condition). -Since Ant 1.7.0 +Since Ant 1.7.0

diff --git a/manual/Tasks/apply.html b/manual/Tasks/apply.html index 78c3a4097..540be75a6 100644 --- a/manual/Tasks/apply.html +++ b/manual/Tasks/apply.html @@ -95,7 +95,7 @@ to send input to it is via the input and inputstring attributes.

@@ -272,31 +272,31 @@ to send input to it is via the input and inputstring attributes.

+ unlimited. Since Ant 1.6. + command automatically. Since Ant 1.6. + Since Ant 1.6. + via filelists. Since Ant 1.6.2. + for target files. Since Ant 1.6.3.
dir the directory in which the command should be executed. No.
- Note: the default used when dir has not been + Note: the default used when dir has not been specified depends on the vmlauncher attribute. If vmlauncher is true the task will use the current working directory, otherwise it uses the project's basedir. @@ -233,7 +233,7 @@ to send input to it is via the input and inputstring attributes.

both. If set to file, only the names of plain files will be sent to the command. If set to dir, only the names of directories are considered.
- Note: The type attribute does not apply to + Note: The type attribute does not apply to nested dirsets - dirsets always implicitly assume type to be dir.
No, default is file maxparallel Limit the amount of parallelism by passing at most this many sourcefiles at once. Set it to <= 0 for - unlimited. Since Ant 1.6. No, unlimited by default
addsourcefile Whether source file names should be added to the - command automatically. Since Ant 1.6. No, default is true
verbose Whether to print a summary after execution or not. - Since Ant 1.6. No, default false
ignoremissing Whether to ignore nonexistent files specified - via filelists. Since Ant 1.6.2. No, default is true
force Whether to bypass timestamp comparisons - for target files. Since Ant 1.6.3. No, default is false
@@ -386,7 +386,7 @@ specified if you also define a nested mapper.

system command via nested <env> elements. See the description in the section about exec

redirector

-Since Ant 1.6.2 +Since Ant 1.6.2

A nested I/O Redirector can be specified. <apply>'s behavior is like that of exec with regard to diff --git a/manual/Tasks/attrib.html b/manual/Tasks/attrib.html index a925384fe..22840f06c 100644 --- a/manual/Tasks/attrib.html +++ b/manual/Tasks/attrib.html @@ -25,7 +25,7 @@

Attrib

-

Since Apache Ant 1.6.

+

Since Apache Ant 1.6.

Description

Changes the attributes of a file or all files inside specified @@ -39,7 +39,7 @@ href="../Types/filelist.html">FileLists can be specified using nested <fileset>, <dirset> and <filelist> elements.

-

Starting with Ant 1.7, this task supports arbitrary Since Ant 1.7, this task supports arbitrary Resource Collections as nested elements.

@@ -96,7 +96,7 @@ directory tree), so you'll have to experiment a little. One of file, dir or both. If set to file, only the permissions of plain files are going to be changed. If set to dir, only the directories are considered.
- Note: The type attribute does not apply to + Note: The type attribute does not apply to nested dirsets - dirsets always implicitly assume type to be dir. No, default is file @@ -117,7 +117,7 @@ directory tree), so you'll have to experiment a little. maxparallel Limit the amount of parallelism by passing at most this many sourcefiles at once. Set it to <= 0 for - unlimited. Defaults to unlimited. Since Ant 1.6. + unlimited. Defaults to unlimited. Since Ant 1.6. No diff --git a/manual/Tasks/augment.html b/manual/Tasks/augment.html index 9a215b2e7..6699be84b 100644 --- a/manual/Tasks/augment.html +++ b/manual/Tasks/augment.html @@ -32,7 +32,7 @@ mapped as XML attributes. This is an unusual task that makes use of Ant's intern processing mechanisms to reload a previously declared reference by means of the 'id' attribute, then treats the declared augment element as though it were the original element. -Since Apache Ant 1.8.1

+Since Apache Ant 1.8.1

Parameters

diff --git a/manual/Tasks/bindtargets.html b/manual/Tasks/bindtargets.html index fd4767b2b..fdf679f12 100644 --- a/manual/Tasks/bindtargets.html +++ b/manual/Tasks/bindtargets.html @@ -40,7 +40,7 @@ on some other project which import them. This task helps then to modify the target dependencies but only in your context.

-

Note: this task is quite equivalent to the definition of an intermediate +

Note: this task is quite equivalent to the definition of an intermediate target which will be the bridge between the target to bind and the extension point. For instance:

@@ -55,7 +55,7 @@ This task basically avoid the creation of a target. it may not be used in a target. This is making the target dependency graph static and predictable as soon as every build file is loaded.

-

Since Apache Ant 1.8.2

+

Since Apache Ant 1.8.2

Parameters

diff --git a/manual/Tasks/changelog.html b/manual/Tasks/changelog.html index e63e2a4d1..47ac77cdd 100644 --- a/manual/Tasks/changelog.html +++ b/manual/Tasks/changelog.html @@ -59,7 +59,7 @@ operation may fail when using such an incompatible client. - diff --git a/manual/Tasks/chgrp.html b/manual/Tasks/chgrp.html index 783498ea9..036409b2e 100644 --- a/manual/Tasks/chgrp.html +++ b/manual/Tasks/chgrp.html @@ -25,7 +25,7 @@

Chgrp

-

Since Apache Ant 1.6.

+

Since Apache Ant 1.6.

Description

Changes the group of a file or all files inside specified @@ -92,7 +92,7 @@ could use as initial value for these experiments.

both. If set to file, only the group of plain files are going to be changed. If set to dir, only the directories are considered.
- Note: The type attribute does not apply to + Note: The type attribute does not apply to nested dirsets - dirsets always implicitly assume type to be dir. diff --git a/manual/Tasks/chmod.html b/manual/Tasks/chmod.html index 9410ddd83..bb37cd6ea 100644 --- a/manual/Tasks/chmod.html +++ b/manual/Tasks/chmod.html @@ -39,10 +39,10 @@ FileSet's attributes and nested elements directly. More sets can be specified using nested <fileset> or <dirset> (since Apache Ant 1.6) elements.

-

Starting with Ant 1.6, this task also supports nested Since Ant 1.6, this task also supports nested filelists.

-

Starting with Ant 1.7, this task supports arbitrary Since Ant 1.7, this task supports arbitrary Resource Collections as nested elements.

@@ -83,7 +83,7 @@ could use as initial value for these experiments.

@@ -123,7 +123,7 @@ could use as initial value for these experiments.

both. If set to file, only the permissions of plain files are going to be changed. If set to dir, only the directories are considered.
- Note: The type attribute does not apply to + Note: The type attribute does not apply to nested dirsets - dirsets always implicitly assume type to be dir. @@ -132,13 +132,13 @@ could use as initial value for these experiments.

+ unlimited. Defaults to unlimited. Since Ant 1.6. + Defaults to false. Since Ant 1.6. diff --git a/manual/Tasks/chown.html b/manual/Tasks/chown.html index 936248f76..4cda53512 100644 --- a/manual/Tasks/chown.html +++ b/manual/Tasks/chown.html @@ -25,7 +25,7 @@

Chown

-

Since Apache Ant 1.6.

+

Since Apache Ant 1.6.

Description

Changes the owner of a file or all files inside specified @@ -91,7 +91,7 @@ could use as initial value for these experiments.

both. If set to file, only the owner of plain files are going to be changed. If set to dir, only the directories are considered.
- Note: The type attribute does not apply to + Note: The type attribute does not apply to nested dirsets - dirsets always implicitly assume type to be dir. diff --git a/manual/Tasks/conditions.html b/manual/Tasks/conditions.html index ab392f994..2f891a4a1 100644 --- a/manual/Tasks/conditions.html +++ b/manual/Tasks/conditions.html @@ -264,7 +264,7 @@ TCP/IP listener at the specified host and port.

Test two files for matching. Nonexistence of one file results in "false", although if neither exists they are considered equal in terms of content. This test does a byte for byte comparison, so test time scales with -byte size. NB: if the files are different sizes, one of them is missing +byte size. Note: if the files are different sizes, one of them is missing or the filenames match the answer is so obvious the detailed test is omitted.

@@ -288,7 +288,7 @@ or the filenames match the answer is so obvious the detailed test is omitted. @@ -395,7 +395,7 @@ that is "true","yes", or "on"

signature validation; it only looks for the presence of a signature.

- This condition was added in Apache Ant 1.7. + Since Apache Ant 1.7.

packagethe package/module to check out. Note: + the package/module to check out. Note: multiple attributes can be split using spaces. Use a nested <module> element if you want to specify a module with spaces in its name. No, default is file dir the directory which holds the files whose permissions must be changed.
- Note: for backwards compatibility + Note: for backwards compatibility reasons <chmod dir="some-dir"/> will only change the permissions on "some-dir" but not recurse into it, unless you also specify any patterns.
No, default is file maxparallel Limit the amount of parallelism by passing at most this many sourcefiles at once. Set it to <= 0 for - unlimited. Defaults to unlimited. Since Ant 1.6. No
verbose Whether to print a summary after execution or not. - Defaults to false. Since Ant 1.6. No
No, default is file textfile Whether to ignore line endings when comparing files; defaults to false which triggers a binary - comparison. Since Ant 1.7 + comparison. Since Ant 1.7 No
@@ -424,7 +424,7 @@ that is "true","yes", or "on"

selector.

- This condition was added in Apache Ant 1.6.3. + Since Apache Ant 1.6.3.

@@ -461,7 +461,7 @@ that is "true","yes", or "on"

its implementation class can be loaded. Types include tasks, datatypes, scriptdefs, macrodefs and presetdefs.

-

This condition was added in Apache Ant 1.7.

+

Since Apache Ant 1.7.

@@ -504,7 +504,7 @@ See the Script task for an explanation of scripts and dependencies.

-

This condition was added in Apache Ant 1.7.

+

Since Apache Ant 1.7.

@@ -538,7 +538,7 @@ an explanation of scripts and dependencies. - + @@ -594,7 +594,7 @@ sets the value to false. This condition always evaluates to "false" feature or property, as per the SAX/JAXP specifications, by attempting to set the appropriate property/feature/

-

This condition was added in Apache Ant 1.7.

+

Since Apache Ant 1.7.

encodingThe encoding of the script source. since Ant 1.10.2.The encoding of the script source. Since Ant 1.10.2. No - defaults to default JVM encoding
@@ -668,9 +668,7 @@ using a protocol such as HTTP, while the lower level ICMP packets get dropped on the floor. Similarly, a host may detected as reachable with ICMP, but not reachable on other ports (i.e. port 80), because of firewalls.

-

- -This condition was added in Apache Ant 1.7.

+

Since Apache Ant 1.7.

@@ -718,7 +716,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti

length

This condition is a facet of the Length task. It is used to test the length of a string or one or more files. - Since Ant 1.6.3 + Since Ant 1.6.3

@@ -734,7 +732,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti
 

isfailure

Test the return code of an executable (see the -Exec task) for failure. Since Ant 1.7

+Exec task) for failure. Since Ant 1.7

@@ -754,7 +752,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti ResourceCount task. It is used to test the size of a resource collection. - Since Ant 1.7 + Since Ant 1.7

@@ -766,12 +764,12 @@ Probe for the maven repository being reachable using the hostname, ten second ti
 

Test resources for matching. Nonexistence of one or more resources results in "false", although if none exists they are considered equal in terms of content. By default this test does a byte for byte comparison, so test time scales with -byte size. NB: if the files are different sizes, one of them is missing +byte size. Note: if the files are different sizes, one of them is missing or the filenames match the answer is so obvious the detailed test is omitted. The resources to check are specified as nested resource collections, meaning that more than two resources can be checked; in this case all resources -must match. Since Ant 1.7 +must match. Since Ant 1.7

@@ -792,7 +790,7 @@ must match. Since Ant 1.7

resourcecontains

Tests whether a resource contains a given (sub)string.

The resources to check are specified via references or - in the - case of file resources via the resource attribute. Since Ant 1.7.1 + case of file resources via the resource attribute. Since Ant 1.7.1

@@ -829,7 +827,7 @@ must match. Since Ant 1.7 Tests for a class having a method or field. If the class is not found or fails to load, the build fails. - Since Ant 1.7 + Since Ant 1.7

@@ -886,7 +884,7 @@ must match. Since Ant 1.7

Test if the specified string matches the specified regular expression pattern. - Since Ant 1.7

+ Since Ant 1.7

@@ -997,7 +995,7 @@ is redundant and will be ignored.

Tests a partition to see if there is enough space. - Since Ant 1.7.0

+ Since Ant 1.7.0

Needed attribute can be specified using standard computing terms:

@@ -317,7 +317,7 @@ destination directory, flattening the directory structure.

The paragraph following the previous example applies to this example as well.

-

Unix Note: File permissions are not retained when files +

Unix Note: File permissions are not retained when files are copied; they end up with the default UMASK permissions instead. This is caused by the lack of any means to query or set file permissions in the @@ -325,14 +325,14 @@ current Java runtimes. If you need a permission-preserving copy function, use <exec executable="cp" ... > instead.

-

Windows Note: If you copy a file to a directory +

Windows Note: If you copy a file to a directory where that file already exists, but with different casing, the copied file takes on the case of the original. The workaround is to delete the file in the destination directory before you copy it.

- Important Encoding Note: + Important Encoding Note: The reason that binary files when filtered get corrupted is that filtering involves reading in the file using a Reader class. This has an encoding specifying how files are encoded. There are a number diff --git a/manual/Tasks/cvs.html b/manual/Tasks/cvs.html index 98d8f9888..a068c71dd 100644 --- a/manual/Tasks/cvs.html +++ b/manual/Tasks/cvs.html @@ -37,7 +37,7 @@ for certain other cvs clients - like CVSNT for example - and some operation may fail when using such an incompatible client.

-

CVSNT Note: CVSNT prefers users to store the passwords +

CVSNT Note: CVSNT prefers users to store the passwords inside the registry. If the cvspass task and the passfile attribute don't seem to work for you, the most likely reason is that CVSNT ignores your .cvspass file completely. See for recommended workarounds.

- diff --git a/manual/Tasks/cvspass.html b/manual/Tasks/cvspass.html index f0890a3a3..7e0819eb8 100644 --- a/manual/Tasks/cvspass.html +++ b/manual/Tasks/cvspass.html @@ -28,7 +28,7 @@

Description

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

-

CVSNT Note: CVSNT prefers users to store the passwords +

CVSNT Note: CVSNT prefers users to store the passwords inside the registry. If the task doesn't seem to work for you, the most likely reason is that CVSNT ignores your .cvspass file completely. See Description

This task allows to retrieve a CVS client and server version. - Since Apache Ant 1.6.1. + Since Apache Ant 1.6.1.

Parameters

filtering Indicates whether token filtering using the global build-file filters should take place during the copy. - Note: Nested <filterset> elements will + Note: Nested <filterset> elements will always be used, even if this attribute is not specified, or its value is false (no, or off). No; defaults to false.
packagethe package/module to check out. Note: + the package/module to check out. Note: multiple attributes can be split using spaces. Use a nested <module> element if you want to specify a module with spaces in its name.
diff --git a/manual/Tasks/delete.html b/manual/Tasks/delete.html index 2a2ecbf1a..3ddc82af1 100644 --- a/manual/Tasks/delete.html +++ b/manual/Tasks/delete.html @@ -71,10 +71,10 @@ in Directory-based Tasks, and see the - @@ -124,14 +124,14 @@ in Directory-based Tasks, and see the - - - - diff --git a/manual/Tasks/dependset.html b/manual/Tasks/dependset.html index 0f6099e60..f306bc17f 100644 --- a/manual/Tasks/dependset.html +++ b/manual/Tasks/dependset.html @@ -79,7 +79,7 @@ well as other stylesheets imported by the main stylesheet.

The <sources> element is a Union into which -arbitrary resource collections can be nested. Since Apache Ant 1.7 +arbitrary resource collections can be nested. Since Apache Ant 1.7

srcfileset

@@ -106,7 +106,7 @@ filelists. Multiple <srcfilelist> filelists may be specified

The <targets> element is a Path and thus can -include any filesystem-based resource. Since Ant 1.7 +include any filesystem-based resource. Since Ant 1.7

targetfileset

diff --git a/manual/Tasks/diagnostics.html b/manual/Tasks/diagnostics.html index 710b32ff5..57d08db08 100644 --- a/manual/Tasks/diagnostics.html +++ b/manual/Tasks/diagnostics.html @@ -29,7 +29,7 @@

Runs Apache Ant's -diagnostics code inside Ant itself. This is good for debugging Ant's configuration under an IDE. -Since Ant 1.7.0 +Since Ant 1.7.0

Examples

diff --git a/manual/Tasks/dirname.html b/manual/Tasks/dirname.html index fdef3605a..3a7b75adb 100644 --- a/manual/Tasks/dirname.html +++ b/manual/Tasks/dirname.html @@ -37,7 +37,7 @@ filename, the filename will be dropped. If the specified file is just a filename, the directory will be the current directory.

- Note: This is not the same as the UNIX dirname command, which is + Note: This is not the same as the UNIX dirname command, which is defined as "strip non-directory suffix from filename". <dirname> determines the full directory path of the specified file.

diff --git a/manual/Tasks/ear.html b/manual/Tasks/ear.html index c3adb56e1..b616011ec 100644 --- a/manual/Tasks/ear.html +++ b/manual/Tasks/ear.html @@ -209,7 +209,7 @@ to a value other than its default, "add".

that the permissions haven't been stored at all rather than real permissions and will instead apply its own default values.
Set this attribute to true if you really want to preserve the - original permission field.since Ant 1.8.0 + original permission field. since Ant 1.8.0 diff --git a/manual/Tasks/echo.html b/manual/Tasks/echo.html index 57371e3bc..e42ed5a1e 100644 --- a/manual/Tasks/echo.html +++ b/manual/Tasks/echo.html @@ -57,7 +57,7 @@ ignored

+ Since Apache Ant 1.8 diff --git a/manual/Tasks/echoxml.html b/manual/Tasks/echoxml.html index 9569b1452..b073f07e2 100644 --- a/manual/Tasks/echoxml.html +++ b/manual/Tasks/echoxml.html @@ -26,7 +26,7 @@

EchoXML

Description

-

Echo nested XML to the console or a file. Since Apache Ant 1.7

+

Echo nested XML to the console or a file. Since Apache Ant 1.7

Parameters

dir The directory to delete, including all its files and subdirectories.
- Note: dir is not used + Note: dir is not used to specify a directory name for file; file and dir are independent of each other.
- WARNING: Do not set dir to + Warning: Do not set dir to ".", "${basedir}", or the full-pathname equivalent unless you truly intend to recursively remove the entire contents of the current base directory @@ -116,7 +116,7 @@ in Directory-based Tasks, and see the
includesDeprecated. Use resource collections. + Deprecated. Use resource collections. Comma- or space-separated list of patterns of files that must be deleted. All files are relative to the directory specified in dir.
includesfileDeprecated. Use resource collections. + Deprecated. Use resource collections. The name of a file. Each line of this file is taken to be an include pattern. No
excludesDeprecated. Use resource collections. + Deprecated. Use resource collections. Comma- or space-separated list of patterns of files that must be excluded from the deletion list. All files are relative to the directory specified in dir. @@ -140,14 +140,14 @@ in Directory-based Tasks, and see the
excludesfileDeprecated. Use resource collections. + Deprecated. Use resource collections. The name of a file. Each line of this file is taken to be an exclude pattern No
defaultexcludesDeprecated. Use resource collections. + Deprecated. Use resource collections. Whether to use default excludes. No, default "true" No, default is false
output the Resource to write the message to (see note). - Since Apache Ant 1.8
append
diff --git a/manual/Tasks/exec.html b/manual/Tasks/exec.html index 00613358e..39fbf55ce 100644 --- a/manual/Tasks/exec.html +++ b/manual/Tasks/exec.html @@ -32,7 +32,7 @@ systems.

Note that you cannot interact with the forked program, the only way to send input to it is via the input and inputstring attributes. Also note that -since Ant 1.6, any attempt to read input in the forked program will receive an +since Ant 1.6, any attempt to read input in the forked program will receive an EOF (-1). This is a change from Ant 1.5, where such an attempt would block.

If you want to execute an executable using a path relative to the @@ -169,7 +169,7 @@ start with something like:

@@ -366,7 +366,7 @@ system command via nested <env> elements.

dir the directory in which the command should be executed. No.
- Note: the default used when dir has not been + Note: the default used when dir has not been specified depends on the vmlauncher attribute. If vmlauncher is true the task will use the current working directory, otherwise it uses the project's basedir. @@ -343,7 +343,7 @@ system command via nested <env> elements.

The name of the environment variable.
- Note: since Ant 1.7, + Note: since Ant 1.7, for Windows, the name is case-insensitive.
Yes

redirector

-Since Ant 1.6.2 +Since Ant 1.6.2

A nested I/O Redirector can be specified. In general, the attributes of the redirector behave as the corresponding attributes available at the task level. The most @@ -446,7 +446,7 @@ Output is sent to the file "redirector.out" and stored in a property of the same name. Similarly, error output is sent to a file and a property, both named "redirector.err". -

Note: do not try to specify arguments using +

Note: do not try to specify arguments using a simple arg-element and separate them by spaces. This results in only a single argument containing the entire string.

diff --git a/manual/Tasks/fail.html b/manual/Tasks/fail.html index 07d43228e..f803783b0 100644 --- a/manual/Tasks/fail.html +++ b/manual/Tasks/fail.html @@ -69,7 +69,7 @@ or character data nested into the element.

conditional failure can be achieved using a single nested <condition> element, which should contain exactly one core or custom condition. For information about conditions, see - here.
Since Ant 1.6.2 + here.
Since Ant 1.6.2

Examples

diff --git a/manual/Tasks/fixcrlf.html b/manual/Tasks/fixcrlf.html index 5f7ebce0b..e395ea403 100644 --- a/manual/Tasks/fixcrlf.html +++ b/manual/Tasks/fixcrlf.html @@ -62,7 +62,7 @@

- Since Apache Ant 1.7, this task can be used in a + Since Apache Ant 1.7, this task can be used in a filterchain.

@@ -85,7 +85,7 @@ file - Name of a single file to fix. Since Ant 1.7 + Name of a single file to fix. Since Ant 1.7   @@ -140,14 +140,14 @@ outputencoding The encoding to use when writing the files. - Since Ant 1.7 + Since Ant 1.7 No; defaults to the value of the encoding attribute.   preservelastmodified Whether to preserve the last modified - date of source files. Since Ant 1.6.3 + date of source files. Since Ant 1.6.3 No; default is false   @@ -280,7 +280,7 @@ fixlast Whether to add a missing EOL to the last line - of a processed file.
Ignored if EOL is asis.
Since Ant 1.6.1 + of a processed file.
Ignored if EOL is asis.
Since Ant 1.6.1 No; default is true diff --git a/manual/Tasks/ftp.html b/manual/Tasks/ftp.html index 494f0d891..905b418e8 100644 --- a/manual/Tasks/ftp.html +++ b/manual/Tasks/ftp.html @@ -29,7 +29,7 @@

The ftp task implements a basic FTP client that can send, receive, list, delete files, and create directories. See below for descriptions and examples of how to perform each task.

-

Note: This task depends on external libraries not included in the Apache Ant distribution. +

Note: This task depends on external libraries not included in the Apache Ant distribution. See Library Dependencies for more information. Get the latest version of this library, for the best support in Ant @@ -50,7 +50,7 @@ This task does not currently use the proxy information set by the <setproxy> task, and cannot go through a firewall via socks.

-Warning: there have been problems reported concerning the ftp get with the newer attribute. +Warning: there have been problems reported concerning the ftp get with the newer attribute. Problems might be due to format of ls -l differing from what is expected by commons-net, for instance due to specificities of language used by the ftp server in the directory listing. If you encounter such a problem, please send an email including a sample directory listing @@ -219,13 +219,13 @@ try to set up a new connection.

preservelastmodified Give the copied files the same last modified time as the original source files (applies to getting files only). - (Note: Ignored on Java 1.1) + (Note: Ignored on Java 1.1) No; defaults to false. retriesAllowed Set the number of retries allowed on an file-transfer operation. - If a number > 0 specified, each file transfer can fail up to that + If a number > 0 specified, each file transfer can fail up to that many times before the operation is failed. If -1 or "forever" specified, the operation will keep trying until it succeeds. No; defaults to 0 diff --git a/manual/Tasks/get.html b/manual/Tasks/get.html index eeeecfecd..cc750327b 100644 --- a/manual/Tasks/get.html +++ b/manual/Tasks/get.html @@ -33,13 +33,13 @@ the runtime is valid here, including http:, ftp: and jar:; The usetimestamp option enables you to control downloads so that the remote file is only fetched if newer than the local copy. If there is no local copy, the download always takes place. When a file is downloaded, the timestamp of the downloaded file is set to the remote timestamp. -NB: This timestamp facility only works on downloads using the HTTP protocol. +Note: This timestamp facility only works on downloads using the HTTP protocol.

A username and password can be specified, in which case basic 'slightly encoded plain text' authentication is used. This is only secure over an HTTPS link.

-

Proxies. Since Apache Ant 1.7.0, Ant running on Java 5 or later can +

Proxies. Since Apache Ant 1.7.0, Ant running on Java 5 or later can use the proxy settings of the operating system if enabled with the -autoproxy option. There is also the @@ -124,7 +124,7 @@ plain text' authentication is used. This is only secure over an HTTPS link. httpusecaches HTTP only - if true, allow caching at the HttpUrlConnection level. if false, turn caching off.
- Note this is only a hint to the underlying UrlConnection + Note this is only a hint to the underlying UrlConnection class, implementations and proxies are free to ignore the setting. No; default "true" diff --git a/manual/Tasks/import.html b/manual/Tasks/import.html index aaa75d0c9..5744bf613 100644 --- a/manual/Tasks/import.html +++ b/manual/Tasks/import.html @@ -35,7 +35,7 @@

- Note as seen above, this task heavily relies on the ProjectHelper + Note as seen above, this task heavily relies on the ProjectHelper implementation and doesn't really perform any work of its own. If you have configured Apache Ant to use a ProjectHelper other than Ant's default, this task may or may not work. @@ -176,7 +176,7 @@ project).

The file to import. If this is a relative file name, the file name will be resolved - relative to the importing file. Note, this is unlike most other + relative to the importing file. Note: this is unlike most other Ant file attributes, where relative files are resolved relative to ${basedir}. Yes or a nested resource collection diff --git a/manual/Tasks/include.html b/manual/Tasks/include.html index 23ab6ba00..3b9cdb7e7 100644 --- a/manual/Tasks/include.html +++ b/manual/Tasks/include.html @@ -30,7 +30,7 @@

since Apache Ant 1.8.0

- Note this task heavily relies on the ProjectHelper + Note this task heavily relies on the ProjectHelper implementation and doesn't really perform any work of its own. If you have configured Ant to use a ProjectHelper other than Ant's default, this task may or may not work. @@ -171,7 +171,7 @@ project).

The file to include. If this is a relative file name, the file name will be resolved - relative to the including file. Note, this is unlike most other + relative to the including file. Note, this is unlike most other ant file attributes, where relative files are resolved relative to ${basedir}. Yes or a nested resource collection diff --git a/manual/Tasks/input.html b/manual/Tasks/input.html index e0139c387..b40fc010d 100644 --- a/manual/Tasks/input.html +++ b/manual/Tasks/input.html @@ -99,7 +99,7 @@ file and load in before the input task.

Parameters Specified as Nested Elements

Handler

-

Since Ant 1.7, a nested <handler> element can be used to +

Since Ant 1.7, a nested <handler> element can be used to specify an InputHandler, so that different InputHandlers may be used among different Input tasks.

@@ -111,7 +111,7 @@ among different Input tasks.

type - one of "default","propertyfile", "greedy", or "secure" (since Ant 1.8). + one of "default","propertyfile", "greedy", or "secure" (since Ant 1.8). One of these diff --git a/manual/Tasks/jar.html b/manual/Tasks/jar.html index 5ec3cfe23..5ca7f7c77 100644 --- a/manual/Tasks/jar.html +++ b/manual/Tasks/jar.html @@ -90,9 +90,9 @@ to a value other than its default, "add".

To cryptographically sign your JAR file, use the SignJar task on the JAR that you create from this task.

-

For creating a simple version of a JEP-238 multi release jar, +

For creating a simple version of a JEP 238 multi-release jar, you don't need any special tools. Just set the required manifest entry and place the files where required, as you could see -in the JEP238-example. If you want to tune this kind of jar, e.g. decreasing the size by deleting +in the JEP 238 example. If you want to tune this kind of jar, e.g. decreasing the size by deleting 'same' classes from the versions-branches, you have to do more ...

Parameters

@@ -273,7 +273,7 @@ in the JEP238-example. If you want to tune this ki that the permissions haven't been stored at all rather than real permissions and will instead apply its own default values.
Set this attribute to true if you really want to preserve the - original permission field.since Ant 1.8.0 + original permission field. since Ant 1.8.0 No, default is false @@ -585,10 +585,10 @@ Sealed: false -

JEP238 example: a Multi-Release JAR Files

+

JEP 238 example: a Multi-Release JAR Files

Here we want to create a Multi-Release JAR File according the specification - JEP-238. + JEP 238. It defines on top of a JAR the possibility to place additional or overwriting classes in a jar, which are available according to the Java version you run.
Basically it sais, that you have to set the manifest entry Multi-Release: true diff --git a/manual/Tasks/java.html b/manual/Tasks/java.html index 880243d35..ee49be129 100644 --- a/manual/Tasks/java.html +++ b/manual/Tasks/java.html @@ -122,12 +122,12 @@ attributes.

module The initial or main module to resolve. To specify the module main class use the classname attribute. - Fork must be set to true if this option is selected.since Ant 1.9.7 + Fork must be set to true if this option is selected. since Ant 1.9.7 Either jar, classname or module modulepath - Specify where to find application modules. A list of directories of modules, module files or exploded modules.since Ant 1.9.7 + Specify where to find application modules. A list of directories of modules, module files or exploded modules. since Ant 1.9.7 No @@ -283,7 +283,7 @@ see permissions

When the permission RuntimePermission exitVM has not been granted (or has been revoked) the System.exit() call will be intercepted and treated like indicated in failonerror.

-

Note:
+

Note:
If you do not specify permissions, a set of default permissions will be added to your Java invocation to make sure that the Ant run will continue or terminated as indicated by @@ -303,7 +303,7 @@ subelement.

Assertion statements are currently ignored in non-forked mode.

-

since Ant 1.6.

+

since Ant 1.6.

redirector

Since Ant 1.6.2 diff --git a/manual/Tasks/javac.html b/manual/Tasks/javac.html index 045e1a309..88cefeab7 100644 --- a/manual/Tasks/javac.html +++ b/manual/Tasks/javac.html @@ -32,7 +32,7 @@ source files to compile. Only Java files that have no corresponding .class file or where the class file is older than the .java file will be compiled.

-

Note: Apache Ant uses only the names of the source and class files to find +

Note: Apache Ant uses only the names of the source and class files to find the classes that need a rebuild. It will not scan the source and therefore will have no knowledge about nested classes, classes that are named different from the source file, and so on. See the @@ -120,7 +120,7 @@ switch -depend instead of -Xdepend.

files/directories from the classpath it passes to the compiler.

The working directory for a forked executable (if any) is the project's base directory.

-

Windows Note:When the modern compiler is used +

Windows Note: When the modern compiler is used in unforked mode on Windows, it locks up the files present in the classpath of the <javac> task, and does not release them. The side effect of this is that you will not be able to delete or move @@ -224,7 +224,7 @@ invoking the compiler.

encoding - Encoding of source files. (Note: gcj doesn't support + Encoding of source files. (Note: gcj doesn't support this option yet.) No @@ -319,7 +319,7 @@ invoking the compiler.

Whether to include the default run-time libraries from the executing VM in the classpath; defaults to no.
- Note: In some setups the run-time libraries may be part + Note: In some setups the run-time libraries may be part of the "Ant run-time libraries" so you may need to explicitly set includeAntRuntime to false to ensure that the Java run-time libraries are not included. @@ -337,7 +337,7 @@ invoking the compiler.

executable to use in case of fork="yes". Defaults to the compiler of the Java version that is currently running Ant. Ignored if fork="no".
- Since Ant 1.6 this attribute can also be used to specify the + Since Ant 1.6 this attribute can also be used to specify the path to the executable when using jikes, jvc, gcj or sj. No @@ -461,8 +461,8 @@ invoking the compiler.

Some package level annotations in package-info.java files don't create any package-info.class files so Ant would recompile the same file every time.
- Starting with Ant 1.8 Ant will create an - empty package-info.class for + Since Ant 1.8, an + empty package-info.class is created for each package-info.java if there isn't one created by the compiler.
In some setups this additional class causes problems and it can @@ -594,7 +594,7 @@ used.

prefix See Command-line Arguments. - Since Ant 1.8. + Since Ant 1.8. No @@ -612,7 +612,7 @@ used.

-

compilerclasspath since Ant 1.8.0

+

compilerclasspath (since Ant 1.8.0)

A PATH like structure holding the classpath to use when loading the compiler implementation if a @@ -620,7 +620,7 @@ used.

using one of the built-in compilers.

Any nested element of a type that implements CompilerAdapter - since Ant 1.8.0

+ (since Ant 1.8.0)

If a defined type implements the CompilerAdapter interface a nested element of that type can be used as an @@ -713,7 +713,7 @@ Java VM of a different version:

executable="/opt/java/jdk1.1/bin/javac" compiler="javac1.1"/> -

Note: +

Note: If you wish to compile only source files located in certain packages below a common root, use the include/exclude attributes or <include>/<exclude> nested elements @@ -748,7 +748,7 @@ could show in the log, that these settings are fix.

fork="true" taskname="javac1.4"/> -

Note: If you are using Ant on Windows and a new DOS window pops up +

Note: If you are using Ant on Windows and a new DOS window pops up for every use of an external compiler, this may be a problem of the JDK you are using. This problem may occur with all JDKs < 1.2.

@@ -887,8 +887,8 @@ while all others are false.

The Sun javac compiler has a bootclasspath command line option - this corresponds to the "bootclasspath" attribute/element of the <javac> task. The Sun compiler also allows more - control over the boot classpath using the -X and -J-X attributes. - One can set these by using the <compilerarg>. Since Ant 1.6.0, + control over the boot classpath using the -X and -J-X attributes. + One can set these by using the <compilerarg>. Since Ant 1.6.0, there is a shortcut to convert path references to strings that can by used in an OS independent fashion (see pathshortcut). For example: @@ -934,7 +934,7 @@ while all others are false.

package-info.java files were introduced in Java 5 to allow package level annotations. On compilation, if the java file does not contain runtime annotations, there will be no .class file - for the java file. Up to Ant 1.7.1, when the <javac> + for the java file. Prior to Ant 1.7.1, when the <javac> task is run again, the task will try to compile the package-info java files again.

@@ -942,8 +942,8 @@ while all others are false.

involved the timestamp of the directory that would normally contain the .class file. This logic turned out to lead to Ant not recompiling package-info.java in certain setup.

-

Starting with Ant 1.8.0 Ant will create - "empty" package-info.class files if it compiles +

Since Ant 1.8.0, an + "empty" package-info.class file is created if Ant compiles a package-info.java and no package-info.class file has been created by the compiler itself.

diff --git a/manual/Tasks/javadoc.html b/manual/Tasks/javadoc.html index 390d893bb..a3f73f315 100644 --- a/manual/Tasks/javadoc.html +++ b/manual/Tasks/javadoc.html @@ -35,18 +35,18 @@ and management costs over time. This task, however, has no notion of "changed" files, unlike the javac task. This means all packages will be processed each time this task is run. In general, however, this task is used much less frequently.

-

NOTE: since javadoc calls System.exit(), javadoc cannot be run inside the +

Note: since javadoc calls System.exit(), javadoc cannot be run inside the same VM as Apache Ant without breaking functionality. For this reason, this task always forks the VM. This overhead is not significant since javadoc is normally a heavy application and will be called infrequently.

-

NOTE: the packagelist attribute allows you to specify the list of packages to +

Note: the packagelist attribute allows you to specify the list of packages to document outside of the Ant file. It's a much better practice to include everything inside the build.xml file. This option was added in order to make it easier to migrate from regular makefiles, where you would use this option of javadoc. The packages listed in packagelist are not checked, so the task performs even if some packages are missing or broken. Use this option if you wish to convert from an existing makefile. Once things are running you should then switch to the regular -notation.

+notation.

DEPRECATION: the javadoc2 task simply points to the javadoc task and it's there for back compatibility reasons. Since this task will be removed in future @@ -59,14 +59,14 @@ any VM of at least version 1.2 is acceptable. JDKs <1.4 are no longer support If you specify the executable attribute it is up to you to ensure that this command supports the attributes you wish to use.

-

Note:
When generating the JavaDocs for classes which contains annotations +

Note:
When generating the JavaDocs for classes which contains annotations you maybe get a java.lang.ClassCastException: com.sun.tools.javadoc.ClassDocImpl. This is due bug-6442982. The cause is that JavaDoc cannot find the implementations of used annotations. The workaround is providing the jars with these implementations (like JAXBs @XmlType, ...) to <javadoc> using classpath, classpathref attributes or nested <classpath> element.

-

Note: many problems with running javadoc stem from command +

Note: many problems with running javadoc stem from command lines that have become too long - even though the error message doesn't give the slightest hint this may be the problem. If you encounter problems with the task, try to set @@ -208,9 +208,9 @@ to <javadoc> using classpath, classpathref attributes or Old Generate output using JDK 1.1 emulating doclet.
- Note: as of Ant 1.8.0 this attribute doesn't have any - effect since the javadoc of Java 1.4 (required by Ant 1.8.0) - doesn't support the -1.1 switch anymore. + Note: Since Ant 1.8.0 this attribute has no + effect since javadoc of Java 1.4 and later + does not support the -1.1 switch anymore. 1.2 No @@ -791,12 +791,12 @@ not set the description attribute for those tags.

Javadoc reference guide:
ejb.bean:t:XDoclet EJB Tag
 todo:a:To Do
- Note: The Javadoc reference quide has double quotes around + Note: The Javadoc reference quide has double quotes around the description part of the definition. This will not work when used in a file, as the definition is quoted again when given to the javadoc program.
- Note: If this attribute is specified, all the other attributes in this + Note: If this attribute is specified, all the other attributes in this element will be ignored. No diff --git a/manual/Tasks/javah.html b/manual/Tasks/javah.html index 82de03b94..2331cafdf 100644 --- a/manual/Tasks/javah.html +++ b/manual/Tasks/javah.html @@ -38,7 +38,7 @@ systems are used.

attribute instead which allows you to compile the classes and generate the native header files with a single step.

-

Note the javah has been deprecated as of Java 9 +

Note: javah has been deprecated as of Java 9 and removed as of Java 10. Trying to use it with Java 10 will fail.

@@ -48,17 +48,17 @@ attribute or a nested element. Here are the choices of the attribute:

-

Note: if you are using this task to work on multiple files +

Note: if you are using this task to work on multiple files the command line may become too long on some operating systems. Unfortunately the javah command doesn't support command argument files the way javac (for example) does, so all that can be done is @@ -169,7 +169,7 @@ only if a given compiler implementation will be used.

prefix See Command-line Arguments. - Since Ant 1.8. + Since Ant 1.8. No @@ -186,7 +186,7 @@ only if a given compiler implementation will be used.

-

implementationclasspath since Ant 1.8.0

+

implementationclasspath (since Ant 1.8.0)

A PATH like structure holding the classpath to use when loading the compiler implementation if a @@ -194,7 +194,7 @@ only if a given compiler implementation will be used.

using one of the built-in compilers.

Any nested element of a type that implements JavahAdapter - since Ant 1.8.0

+ (since Ant 1.8.0)

If a defined type implements the JavahAdapter interface a nested element of that type can be used as an diff --git a/manual/Tasks/jdepend.html b/manual/Tasks/jdepend.html index 9b30e810a..0aabd7b0f 100644 --- a/manual/Tasks/jdepend.html +++ b/manual/Tasks/jdepend.html @@ -88,7 +88,7 @@ href="#nested">nested elements.

includeruntime Implicitly add the classes required to run jdepend - in forked mode. (Ignored if fork is disabled). Since Apache Ant 1.6. + in forked mode. (Ignored if fork is disabled). Since Apache Ant 1.6. No, default is "no". diff --git a/manual/Tasks/junit.html b/manual/Tasks/junit.html index d4b594df1..5e8d7b50a 100644 --- a/manual/Tasks/junit.html +++ b/manual/Tasks/junit.html @@ -30,7 +30,7 @@ version of the framework can be found at This task has been tested with JUnit 3.0 up to JUnit 3.8.2; it won't work with versions prior to JUnit 3.0. It also works with JUnit 4.0, including "pure" JUnit 4 tests using only annotations and no JUnit4TestAdapter.

-

Note: This task depends on external libraries not included +

Note: This task depends on external libraries not included in the Apache Ant distribution. See Library Dependencies for more information.

@@ -58,7 +58,7 @@ a <classpath> element in a <taskdef> in th
  • Leave ant-junit.jar in its default location in ANT_HOME/lib but include junit.jar in the <classpath> passed -to <junit>. (since Ant 1.7) +to <junit>. Since Ant 1.7
  • @@ -108,7 +108,7 @@ elements).

    failureproperty can share a VM, so even if you set forkmode to "once", Ant may have to create more than a single Java VM. This attribute is ignored for tests - that don't get forked into a new Java VM. since Ant 1.6.2 + that don't get forked into a new Java VM. Since Ant 1.6.2 No; default is perTest. @@ -196,7 +196,7 @@ elements).

    outputtoformatters - Since Ant 1.7.0.
    + Since Ant 1.7.0.
    Send any output generated by tests to the test formatters. This is "true" by default. @@ -369,7 +369,7 @@ subelement.

    Assertion statements are currently ignored in non-forked mode.

    -

    since Ant 1.6.

    +

    Since Ant 1.6.

    modulepath

    @@ -407,7 +407,7 @@ can be specified.

    that your tests have written as some characters are illegal in XML documents and will be dropped.

    -

    The fourth formatter named failure (since Ant 1.8.0) +

    The fourth formatter named failure (since Ant 1.8.0) collects all failing testXXX() methods and creates a new TestCase which delegates only these failing methods. The name and the location can be specified via Java System property or Ant property @@ -664,7 +664,7 @@ supported.

    test's tearDown method will never be called. The same is true if the forked VM crashes for some other reason.

    -

    Starting with Ant 1.8.0, a special formatter is distributed with +

    Since Ant 1.8.0, a special formatter is distributed with Ant that tries to load the testcase that was in the forked VM and invoke that class' tearDown method. This formatter has the following limitations:

    diff --git a/manual/Tasks/junitreport.html b/manual/Tasks/junitreport.html index c0219bee9..f52823cb0 100644 --- a/manual/Tasks/junitreport.html +++ b/manual/Tasks/junitreport.html @@ -28,7 +28,7 @@ Merge the individual XML files generated by the JUnit task and eventually apply a stylesheet on the resulting merged document to provide a browsable report of the testcases results. -

    Note: This task depends on external libraries not +

    Note: This task depends on external libraries not included in the Apache Ant distribution. See Library Dependencies for more information.

    @@ -36,9 +36,9 @@ for more information.

    The task needs Apache Xalan 2.4.1+ or Xalan XSLTC -(JDK 1.4 contains a version of Xalan-J 2.x while JDK 1.5 ships with a -version of XSLTC). Starting from JDK 1.4.2-01 it ships with a bundled -Xalan-J 2.4.1+, meaning that JDK version prior to 1.4.2-01 won't work +(JDK 1.4 contains a version of Xalan 2.x, while JDK 1.5 ships with a +version of XSLTC). Since version 1.4.2-01, JDK ships with a bundled +Xalan 2.4.1+, meaning that JDK version prior to 1.4.2-01 won't work out of the box. The table below summarize the compatibility status.

    @@ -46,13 +46,13 @@ out of the box. The table below summarize the compatibility status. +
    Upgrade Xalan using the JDK endorsement mechanism
    2.4.1+JDK 1.4.2-01+OK
    XSLTCJDK 1.5.xOK
    2.xJDK 1.4.xDEPRECATED
    Use ${ant.home}/etc/junit-frames-xalan1.xsl -
    Upgrade Xalan using the JDK endorsement mechanism
    -

    With Ant 1.6.2 we had to decide between supporting Xalan-J 1/Xalan J 2.4.1- +

    In Ant 1.6.2, we had to decide between supporting Xalan 1/Xalan 2.4.1- and Xalan 2.4.1+/XSLTC, since there was no way to support both couples at the same time.

    -

    With Ant 1.7 we had to drop support Xalan-J 1, since Xalan-J 1 has not +

    Since Ant 1.7, we dropped support for Xalan 1, since Xalan 1 was not available anymore for quite some time.

    Parameters

    @@ -170,12 +170,12 @@ These tags can pass XSL parameters to the stylesheet.

    classpath

    -

    Since Ant 1.9.5. +

    Since Ant 1.9.5. Like for the XSLT task, a nested <classpath> will be used to load the processor.

    factory

    -

    Since Ant 1.9.5. +

    Since Ant 1.9.5. Like for the XSLT task, a nested <factory> can be used to specify factory settings.

    diff --git a/manual/Tasks/loadfile.html b/manual/Tasks/loadfile.html index eb27f7b0c..b62abdde5 100644 --- a/manual/Tasks/loadfile.html +++ b/manual/Tasks/loadfile.html @@ -68,7 +68,7 @@ the property is not set.

    invoked with the -verbose or -debug switches) or modify the exit status to reflect an error. Setting this to "true" implies setting failonerror to "false". - Since Ant 1.7.0. + Since Ant 1.7.0. No, default "false" diff --git a/manual/Tasks/loadproperties.html b/manual/Tasks/loadproperties.html index d21027ace..a3a247905 100644 --- a/manual/Tasks/loadproperties.html +++ b/manual/Tasks/loadproperties.html @@ -33,7 +33,7 @@ Also if the file is missing, the build is halted with an error, rather than a warning being printed.

    -

    Note: the default value of this +

    Note: the default value of this task's prefixValues attribute is different from the default value of the same attribute in the <property> diff --git a/manual/Tasks/local.html b/manual/Tasks/local.html index 9b4b9bda1..cc1f6485e 100644 --- a/manual/Tasks/local.html +++ b/manual/Tasks/local.html @@ -34,7 +34,7 @@ property at a given scope "shadows" properties of the same name at higher scopes including the global scope. Note that using the Local task at the global level effectively makes the property local to the "anonymous target" in which top-level operations are carried out; it will not be defined for other targets -in the buildfile. Since Ant 1.8

    +in the buildfile. Since Ant 1.8

    A property is made local if the <local> task precedes its definition. See the examples section.

    diff --git a/manual/Tasks/macrodef.html b/manual/Tasks/macrodef.html index a5741f138..f655a22a6 100644 --- a/manual/Tasks/macrodef.html +++ b/manual/Tasks/macrodef.html @@ -195,7 +195,7 @@ If this element is not present, then any nested text in the macro invocation will be an error. If the text element is present, then the name becomes an attribute that gets set to the nested text of the macro invocation. - Since ant 1.6.1. + Since ant 1.6.1.

    The case of the text name is ignored. diff --git a/manual/Tasks/mail.html b/manual/Tasks/mail.html index f98b14139..93209a539 100644 --- a/manual/Tasks/mail.html +++ b/manual/Tasks/mail.html @@ -48,7 +48,7 @@ <attachments> container.

    - Note: This task may depend on external libraries + Note: This task may depend on external libraries that are not included in the Ant distribution. See Library Dependencies for more information. @@ -284,7 +284,7 @@ in the message, whether it is specified as an external file or as text within the <message> element.

    header

    -

    Since Ant 1.7, arbitrary mail headers can be added by +

    Since Ant 1.7, arbitrary mail headers can be added by specifying these attributes on one or more nested header elements:

    @@ -305,8 +305,7 @@ the <message> element.

    -

    It is permissible to duplicate the name attribute amongst multiple headers. -

    +

    It is permissible to duplicate the name attribute amongst multiple headers.

    Examples

    diff --git a/manual/Tasks/move.html b/manual/Tasks/move.html index db49ba55a..9e40d8e39 100644 --- a/manual/Tasks/move.html +++ b/manual/Tasks/move.html @@ -42,7 +42,7 @@ href="../using.html#path">path. Prior to Apache Ant 1.7 only To use a resource collection, the todir attribute must be set.

    -

    Since Ant 1.6.3, the file attribute may be used to move +

    Since Ant 1.6.3, the file attribute may be used to move (rename) an entire directory. If tofile denotes an existing file, or there is a directory by the same name in todir, the action will fail.

    @@ -63,7 +63,7 @@ there is a directory by the same name in todir, the action will fail. preservelastmodified Give the moved files the same last modified time as the original source files. - (Note: Ignored on Java 1.1) + (Note: Ignored on Java 1.1) No; defaults to false. diff --git a/manual/Tasks/native2ascii.html b/manual/Tasks/native2ascii.html index f187cd376..17faccd7c 100644 --- a/manual/Tasks/native2ascii.html +++ b/manual/Tasks/native2ascii.html @@ -65,11 +65,11 @@ element. Here are the choices of the attribute:

    @@ -191,7 +191,7 @@ only if a given converter implementation will be used.

    -

    implementationclasspath since Apache Ant 1.8.0

    +

    implementationclasspath (since Apache Ant 1.8.0)

    A PATH like structure holding the classpath to use when loading the converter implementation if a @@ -199,7 +199,7 @@ only if a given converter implementation will be used.

    using one of the built-in converters.

    Any nested element of a type that implements Native2AsciiAdapter - since Ant 1.8.0

    + (since Ant 1.8.0)

    If a defined type implements the Native2AsciiAdapter interface a nested element of that type can be used as an diff --git a/manual/Tasks/netrexxc.html b/manual/Tasks/netrexxc.html index bf1104c01..6231aa910 100644 --- a/manual/Tasks/netrexxc.html +++ b/manual/Tasks/netrexxc.html @@ -58,7 +58,7 @@ supports most attributes of <fileset> or from the command line as
    ant -Dant.netrexxc.verbose=noverbose ...

    -

    Note: This task depends on external libraries not +

    Note: This task depends on external libraries not included in the Apache Ant distribution. See Library Dependencies for more information.

    diff --git a/manual/Tasks/propertyhelper.html b/manual/Tasks/propertyhelper.html index 5b4cf343f..8295d9efd 100644 --- a/manual/Tasks/propertyhelper.html +++ b/manual/Tasks/propertyhelper.html @@ -32,7 +32,7 @@ PropertyHelper active on the current Project. This is somewhat advanced Apache Ant usage and assumes a working familiarity with the modern Ant APIs. See the description of Ant's Property Helper for more information. -Since Ant 1.8.0

    +Since Ant 1.8.0

    Parameters specified as nested elements

    diff --git a/manual/Tasks/pvcstask.html b/manual/Tasks/pvcstask.html index 726f5d986..91c85c4b0 100644 --- a/manual/Tasks/pvcstask.html +++ b/manual/Tasks/pvcstask.html @@ -24,7 +24,7 @@

    Apache Ant Pvcs Task User Manual

    -

    Note: +

    Note: Before using this task, the user running Ant must have access to the commands of PVCS (get and pcli) and must have access to the repository. Note that the way to specify the repository is platform diff --git a/manual/Tasks/replace.html b/manual/Tasks/replace.html index ef8f1831e..7cc6e0ab6 100644 --- a/manual/Tasks/replace.html +++ b/manual/Tasks/replace.html @@ -123,13 +123,13 @@ have been regenerated by this task.

    preserveLastModified Keep the file timestamp(s) even if the file(s) - is(are) modified. since Apache Ant 1.8.0. + is(are) modified. since Apache Ant 1.8.0. No, defaults to false failOnNoReplacements Whether to fail the build if the task didn't do - anything. since Ant 1.8.0. + anything. since Ant 1.8.0. No, defaults to false @@ -159,7 +159,7 @@ them.

    expandProperties Whether to expand properties in the nested text. - since Ant 1.8.0. + since Ant 1.8.0. No, defaults to true. @@ -208,7 +208,7 @@ token]]></replacevalue> Name of the property whose value is to serve as the replacement value. -

    Since Ant 1.8.0 token and value can be specified as nested elements +

    Since Ant 1.8.0 token and value can be specified as nested elements just like in the task itself.

    If neither value nor property is used, the value provided using the <replace> attribute value and/or the <replacevalue> element is used. If no value was specified using either of these options, the token is replaced with an empty string.

    @@ -233,9 +233,7 @@ token]]></replacevalue> </replace>

    In file configure.sh, replace all instances of "@token1@" with "defaultvalue", all instances of "@token2@" with "value2", and all instances of "@token3@" with the value of the property "property.key", as it appears in property file src/name.properties.

    -

    Note: It is possible to use either the token/<replacetoken> and value/<replacevalue> attributes/elements, the nested replacefilter elements, or both in the same operation. -

    - +

    Note: It is possible to use either the token/<replacetoken> and value/<replacevalue> attributes/elements, the nested replacefilter elements, or both in the same operation.

    diff --git a/manual/Tasks/replaceregexp.html b/manual/Tasks/replaceregexp.html index f0b612b57..9861b7364 100644 --- a/manual/Tasks/replaceregexp.html +++ b/manual/Tasks/replaceregexp.html @@ -90,7 +90,7 @@ See details in the documentation of the preserveLastModified Keep the file timestamp(s) even if the file(s) - is(are) modified. since Ant 1.8.0. + is(are) modified. since Ant 1.8.0. No, defaults to false diff --git a/manual/Tasks/resourcecount.html b/manual/Tasks/resourcecount.html index c463631ef..39d96270c 100644 --- a/manual/Tasks/resourcecount.html +++ b/manual/Tasks/resourcecount.html @@ -29,7 +29,7 @@

    Description

    Display or set a property containing the size of a nested Resource Collection. - Can also be used as a condition. Since Apache Ant 1.7

    + Can also be used as a condition. Since Apache Ant 1.7

    Parameters

    diff --git a/manual/Tasks/rexec.html b/manual/Tasks/rexec.html index 2aed66af0..7874c7bcb 100644 --- a/manual/Tasks/rexec.html +++ b/manual/Tasks/rexec.html @@ -30,7 +30,7 @@ Task to automate a remote rexec session. Just like the Telnet task, it uses nested <read> to indicate strings to wait for, and <write> tags to specify text to send to the remote process. -

    Note: This task depends on external libraries not included in the Apache Ant distribution. +

    Note: This task depends on external libraries not included in the Apache Ant distribution. See Library Dependencies for more information.

    You can specify the commands you want to execute as nested elements diff --git a/manual/Tasks/rmic.html b/manual/Tasks/rmic.html index 9c59c0c87..8de6f5874 100644 --- a/manual/Tasks/rmic.html +++ b/manual/Tasks/rmic.html @@ -52,17 +52,15 @@ with the "build.rmic" property, the compiler attribute, or a nested element. Here are the choices:

    + Since Ant 1.8. @@ -305,7 +303,7 @@ used.

    stubversion Specify the JDK version for the generated stub code. Specify "1.1" to pass the "-v1.1" option to rmic, - "1.2" for -v12, compat for -vcompat.
    + "1.2" for -v12, compat for -vcompat.
    Since Ant 1.7, if you do not specify a version, and do not ask for iiop or idl files, "compat" is selected. @@ -287,7 +285,7 @@ used.

    prefix See Command-line Arguments. - Since Ant 1.8. No
    -

    compilerclasspath since Ant 1.8.0

    +

    compilerclasspath (since Ant 1.8.0)

    A PATH like structure holding the classpath to use when loading the compiler implementation if a @@ -313,7 +311,7 @@ used.

    using one of the built-in compilers.

    Any nested element of a type that implements RmicAdapter - since Ant 1.8.0

    + (since Ant 1.8.0)

    If a defined type implements the RmicAdapter interface a nested element of that type can be used as an diff --git a/manual/Tasks/scp.html b/manual/Tasks/scp.html index 173b1b8e8..bcd99648e 100644 --- a/manual/Tasks/scp.html +++ b/manual/Tasks/scp.html @@ -33,7 +33,7 @@ FileSet only works for copying files from the local machine to a remote machine.

    -

    Note: This task depends on external libraries not included +

    Note: This task depends on external libraries not included in the Ant distribution. See Library Dependencies for more information. This task has been tested with jsch-0.1.2 and later.

    @@ -121,7 +121,7 @@ for more information. This task has been tested with jsch-0.1.2 and later.

    trust This trusts all unknown hosts if set to yes/true.
    - Note If you set this to false (the default), the + Note: If you set this to false (the default), the host you connect to must be listed in your knownhosts file, this also implies that the file exists. No, defaults to No. @@ -291,7 +291,7 @@ authentication.

    </scp> -

    Security Note: Hard coding passwords and/or usernames +

    Security Note: Hardcoding passwords and/or usernames in scp task can be a serious security hole. Consider using variable substitution and include the password on the command line. For example:

    @@ -309,7 +309,7 @@ system (via the ps command). The best approach is to use the .properties file.

    -

    Unix Note: File permissions are not retained when files +

    Unix Note: File permissions are not retained when files are downloaded; they end up with the default UMASK permissions instead. This is caused by the lack of any means to query or set file permissions in the current Java runtimes. If you need a permission- diff --git a/manual/Tasks/script.html b/manual/Tasks/script.html index ff8478d9e..eedbb176e 100644 --- a/manual/Tasks/script.html +++ b/manual/Tasks/script.html @@ -31,7 +31,7 @@ or JSR 223 supported language.

    -

    Note: +

    Note: This task depends on external libraries not included in the Apache Ant distribution. See Library Dependencies for more information. @@ -82,7 +82,7 @@ different location values.

    manager - Since: Ant 1.7. + Since Ant 1.7. The script engine manager to use. This can have one of three values ("auto", "bsf" or "javax"). The default value is "auto". @@ -104,7 +104,7 @@ different location values.

    encoding - The encoding of the script as a file. since Ant 1.10.2. + The encoding of the script as a file. Since Ant 1.10.2. No - defaults to default JVM encoding @@ -153,7 +153,7 @@ different location values.

    specific jar files.

    - NB: (Since Ant 1.7.1) + Note: (since Ant 1.7.1) This classpath can be used to specify the location of the BSF jar file and/or languages diff --git a/manual/Tasks/scriptdef.html b/manual/Tasks/scriptdef.html index a102891ea..1d016e6ff 100644 --- a/manual/Tasks/scriptdef.html +++ b/manual/Tasks/scriptdef.html @@ -41,7 +41,7 @@ of the script increases it would be better to migrate the task definition into a Java based custom task.

    -

    Note: This task depends on external libraries not included in the +

    Note: This task depends on external libraries not included in the Ant distribution. See Library Dependencies for more information.

    @@ -58,12 +58,12 @@ element name. This will return a list of all instances of the nested element. The instances in this list may be accessed by an integer index.

    -

    Note: Ant will turn all attribute and element names into all +

    Note: Ant will turn all attribute and element names into all lowercase names, so even if you use name="SomeAttribute", you'll have to use "someattribute" to retrieve the attribute's value from the attributes collection.

    -

    The name "self" (since Ant 1.6.3) is a pre-defined reference to the +

    The name "self" (since Ant 1.6.3) is a pre-defined reference to the script def task instance. It can be used for logging, or for integration with the rest of Ant. the self.text attribute contains @@ -117,7 +117,7 @@ more information on writing scripts, please refer to the encoding - The encoding of the script as a file. since Ant 1.10.2. + The encoding of the script as a file. since Ant 1.10.2. No - defaults to default JVM encoding @@ -126,7 +126,7 @@ more information on writing scripts, please refer to the evaluation for faster multiple executions, on the condition that the manager is "javax" and the target engine implements javax.script.Compilable. Note that the bsf manager may automatically compiles the script. - since Ant 1.10.2. + since Ant 1.10.2. No - defaults to false diff --git a/manual/Tasks/setpermissions.html b/manual/Tasks/setpermissions.html index 427c54534..28bf99950 100644 --- a/manual/Tasks/setpermissions.html +++ b/manual/Tasks/setpermissions.html @@ -25,7 +25,7 @@

    SetPermissions

    -

    Since Ant 1.10.0.

    +

    Since Ant 1.10.0.

    Description

    Changes the file permissions using Java's NIO support for permissions.

    diff --git a/manual/Tasks/sound.html b/manual/Tasks/sound.html index 96821f776..f0de67dd0 100644 --- a/manual/Tasks/sound.html +++ b/manual/Tasks/sound.html @@ -30,7 +30,7 @@ the build failed or succeeded. You can specify either a specific sound-file to play, or, if a directory is specified, the <sound> task will randomly select a file to play. -Note: At this point, the random selection is based on all the files +Note: At this point, the random selection is based on all the files in the directory, not just those ending in appropriate suffixes for sound-files, so be sure you only have sound-files in the directory you specify.

    diff --git a/manual/Tasks/sql.html b/manual/Tasks/sql.html index d7873aeb8..6094d530e 100644 --- a/manual/Tasks/sql.html +++ b/manual/Tasks/sql.html @@ -124,7 +124,7 @@ and abort execution and transaction and fail task.

    output Output file for result sets (defaults to System.out) - Since Ant 1.8 can specify any Resource that supports output (see + Since Ant 1.8 can specify any Resource that supports output (see note). No (print to System.out by default) @@ -226,7 +226,7 @@ and abort execution and transaction and fail task.

    showWarnings If true, SQLWarnings will be logged at the WARN level. Since Ant 1.8.0.
    - Note: even if the attribute is set to false, warnings that + Note: even if the attribute is set to false, warnings that apply to the connection will be logged at the verbose level. No, default false @@ -256,7 +256,7 @@ and abort execution and transaction and fail task.

    quote character itself will be surrounded by the quote character. The quote character itself will be doubled if it appears inside of the column's value.
    - Note: BLOB values will never be quoted. + Note: BLOB values will never be quoted. Since Ant 1.8.0. No, default is not set (i.e. no quoting ever occurs) diff --git a/manual/Tasks/sshexec.html b/manual/Tasks/sshexec.html index 5efa5bd53..1072d3e92 100644 --- a/manual/Tasks/sshexec.html +++ b/manual/Tasks/sshexec.html @@ -29,10 +29,9 @@

    since Apache Ant 1.6

    -

    Runs a command on a remote machine running SSH daemon. -

    +

    Runs a command on a remote machine running SSH daemon.

    -

    Note: This task depends on external libraries not included +

    Note: This task depends on external libraries not included in the Ant distribution. See Library Dependencies for more information. This task has been tested with jsch-0.1.29 and above @@ -78,7 +77,7 @@ and won't work with versions of jsch earlier than trust This trusts all unknown hosts if set to yes/true.
    - Note If you set this to false (the default), the + Note: If you set this to false (the default), the host you connect to must be listed in your knownhosts file, this also implies that the file exists. No, defaults to No. @@ -283,7 +282,7 @@ and won't work with versions of jsch earlier than commandResource="to_run"/> -

    Security Note: Hard coding passwords and/or usernames +

    Security Note: Hard coding passwords and/or usernames in sshexec task can be a serious security hole. Consider using variable substitution and include the password on the command line. For example:

    diff --git a/manual/Tasks/sshsession.html b/manual/Tasks/sshsession.html
    index 4758719a5..8c9052de5 100644
    --- a/manual/Tasks/sshsession.html
    +++ b/manual/Tasks/sshsession.html
    @@ -35,7 +35,7 @@ remote tunnels over that connection, then executes any nested tasks
     before taking down the connection.
     

    -

    Note: This task depends on external libraries not included +

    Note: This task depends on external libraries not included in the Ant distribution. See Library Dependencies for more information. This task has been tested with @@ -90,7 +90,7 @@ and scp tasks

    trust This trusts all unknown hosts if set to yes/true.
    - Note If you set this to false (the default), the + Note: If you set this to false (the default), the host you connect to must be listed in your knownhosts file, this also implies that the file exists. No, defaults to No. @@ -253,8 +253,7 @@ accessible, then run a get task using that tunnel.

    </sshsession>
    - -

    Security Note: Hard coding passwords or +

    Security Note: Hardcoding passwords or passphrases and/or usernames in sshsession task can be a serious security hole. Consider using variable substitution and include the password on the command line. For example:

    diff --git a/manual/Tasks/style.html b/manual/Tasks/style.html index 496e621b9..9c4afc1c4 100644 --- a/manual/Tasks/style.html +++ b/manual/Tasks/style.html @@ -30,7 +30,7 @@

    Process a set of documents via XSLT.

    This is useful for building views of XML based documentation, or for generating code.

    -

    Note: If you are using JDK 1.4 or higher, this task does not require external libraries +

    Note: If you are using JDK 1.4 or higher, this task does not require external libraries not supplied in the Apache Ant distribution. However, often the built in XSL engine is not as up to date as a fresh download, so an update is still highly recommended in particular since the built-in XSLT processors of Java 5 (and to a @@ -50,7 +50,7 @@ inclusion/exclusion of files works, and how to write patterns.

    as well as the nested <include>, <exclude> and <patternset> elements.

    -

    Note: Unlike other similar tasks, this task treats +

    Note: Unlike other similar tasks, this task treats directories that have been matched by the include/exclude patterns of the implicit fileset in a special way. It will apply the stylesheets to all files contain in them as well. Since the default include @@ -296,8 +296,8 @@ element is used to perform Entity and URI resolution.

    param

    Param is used to pass a parameter to the XSL stylesheet.

    -
    -

    Parameters

    + +
    Parameters
    @@ -347,9 +347,7 @@ element is used to perform Entity and URI resolution.

    -
    Attribute The param will not be passed if this property is set. No
    -

    The XPATH_* types says that the expression is not just a primitive-type value but an XPath expression. @@ -367,8 +365,8 @@ element is used to perform Entity and URI resolution.

    Used to specify how you wish the result tree to be output as specified in the XSLT specifications. -

    -

    Parameters

    + +
    Parameters
    @@ -386,12 +384,11 @@ XSLT specifications.
    AttributeYes
    -

    factory ('trax' processors only)

    Used to specify factory settings. -
    -

    Parameters

    + +
    Parameters
    @@ -409,8 +406,8 @@ Used to specify factory settings.
    AttributeNo. Defaults to the JAXP lookup mechanism.
    -

    Parameters specified as nested elements

    -

    attribute

    +
    Parameters specified as nested elements
    +
    attribute

    Used to specify settings of the processor factory. The attribute names and values are entirely processor specific so you must be aware of the implementation to figure them out. @@ -431,7 +428,7 @@ And in Saxon 7.x:

  • ...
  • -

    Parameters

    +
    Parameters
    @@ -460,8 +457,9 @@ And in Saxon 7.x: with the given id. since Ant 1.9.8
    Attribute
    +
    -

    Examples

    +
    Examples
       <path id="extension-path">
    @@ -478,10 +476,10 @@ And in Saxon 7.x:
     

    Sets the classloader to use when loading extension functions to a classloader using the path with the - id extension-path. -

    -

    feature

    + id extension-path.

    since Ant 1.9.8

    + +
    feature

    Used to specify settings of the processor factory. The feature names are mostly processor specific so you must be aware of the implementation to figure them out. Read the documentation of your @@ -489,7 +487,7 @@ processor. The only feature all implementations are required to support is http://javax.xml.XMLConstants/feature/secure-processing.

    -

    Parameters

    +
    Parameters
    @@ -504,12 +502,12 @@ is http://javax.xml.XMLConstants/feature/secure-processing. + (i.e. permitted values are true, false, yes, no, on, off).
    Attribute
    value value of the feature. A boolean value - (i.e. permitted values are true,false,yes,no,on,off). No, defaults to false
    - +

    mapper

    since Ant 1.6.2

    @@ -547,7 +545,6 @@ with syspropertysets.

    since Ant 1.8.0.

    Examples

    -
     <xslt basedir="doc" destdir="build/doc"
            extension=".html" style="style/apache.xsl"/>
    @@ -670,8 +667,7 @@ with syspropertysets.

    <project> <xslt style="printFilename.xsl" destdir="out" basedir="in" extension=".txt" filenameparameter="filename" - filedirparameter="filedir" - /> + filedirparameter="filedir"/> </project> <xsl:stylesheet @@ -693,11 +689,9 @@ with syspropertysets.

     <xslt ...>
         <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration"
    -                 value="org.apache.xerces.parsers.XIncludeParserConfiguration"
    -     />
    +                 value="org.apache.xerces.parsers.XIncludeParserConfiguration"/>
     <xslt>
     
    -
    diff --git a/manual/Tasks/symlink.html b/manual/Tasks/symlink.html index 2ed74fc2f..127514edb 100644 --- a/manual/Tasks/symlink.html +++ b/manual/Tasks/symlink.html @@ -52,7 +52,7 @@ set of links to record, or a set of property files to create links from. link The name of the link to be created or deleted.
    - Note this attribute is resolved against the current + Note: this attribute is resolved against the current working directory rather than the project's basedir for historical reasons. It is recommended you always use an absolute path or a path like ${basedir}/some-path @@ -124,7 +124,7 @@ set of links to record, or a set of property files to create links from. <symlink action="delete" link="${dir.top}/foo"/> -

    Java 1.2 and earlier: Due to limitations on executing system +

    Java 1.2 and earlier: Due to limitations on executing system level commands in Java versions earlier than 1.3 this task may have difficulty operating with a relative path in ANT_HOME. The typical symptom is an IOException where Apache Ant can't find /some/working/directory${ANT_HOME}/bin/antRun @@ -132,7 +132,7 @@ set of links to record, or a set of property files to create links from. variable to an absolute path, which will remove the /some/working/directory portion of the above path and allow Ant to find the correct commandline execution script. -

    NOTE: Starting Ant version 1.10.2, this task relies on the symbolic +

    Note: Since Ant 1.10.2, this task relies on the symbolic link support introduced in Java 7 through the java.nio.file.Files APIs

    diff --git a/manual/Tasks/sync.html b/manual/Tasks/sync.html index b1d4d1d62..e315cec4d 100644 --- a/manual/Tasks/sync.html +++ b/manual/Tasks/sync.html @@ -58,7 +58,7 @@ dir, it will get removed from the target.

    includeEmptyDirs Copy any empty directories included in the resource collection(s).
    - Note this attribute also controls the behavior for any + Note this attribute also controls the behavior for any nested <preserveintarget> element. If this attribute is false (the default) empty directories that only exist in the target directory will be removed even if they are matched by diff --git a/manual/Tasks/tar.html b/manual/Tasks/tar.html index ae972e7e7..aa7a6443f 100644 --- a/manual/Tasks/tar.html +++ b/manual/Tasks/tar.html @@ -243,11 +243,11 @@ and the rest are use the default mode (read-write by owner). The first fileset selects just the executable files. The second fileset must exclude the executable files and include all others.

    -

    Note: The tar task does not ensure that a file is only selected +

    Note: The tar task does not ensure that a file is only selected by one resource collection. If the same file is selected by more than one collection, it will be included in the tar file twice, with the same path.

    -

    Note: The patterns in the include and exclude +

    Note: The patterns in the include and exclude elements are considered to be relative to the corresponding dir attribute as with all other filesets. In the example above, ${dist.name} is not an absolute path, but a simple name @@ -265,7 +265,7 @@ Unix file permissions have been stored as part of the ZIP file, they will be retained in the resulting tar archive.

    -

    Note: +

    Note: Please note the tar task creates a tar file, it does not append to an existing tar file. The existing tar file is replaced instead. As with most tasks in Ant, the task only takes action if the output diff --git a/manual/Tasks/telnet.html b/manual/Tasks/telnet.html index c65886476..af507fbc9 100644 --- a/manual/Tasks/telnet.html +++ b/manual/Tasks/telnet.html @@ -32,7 +32,7 @@ nested <read> to indicate strings to wait for, and

    If you do specify a userid and password, the system will assume a common unix prompt to wait on. This behavior can be easily over-ridden.

    -

    Note: This task depends on external libraries not included in the Apache Ant distribution. +

    Note: This task depends on external libraries not included in the Apache Ant distribution. See Library Dependencies for more information.

    Parameters

    diff --git a/manual/Tasks/touch.html b/manual/Tasks/touch.html index 0acd73449..c265f50b8 100644 --- a/manual/Tasks/touch.html +++ b/manual/Tasks/touch.html @@ -32,7 +32,7 @@ at the same time. In addition to working with a single file, this Task can also work on resources and resource collections (which also includes directories). Prior to Apache Ant 1.7 only FileSet or Filelist -(since Ant 1.6) have been supported.

    +(since Ant 1.6) have been supported.

    Ant uses the API of java.io.File to set the last modification time which has some limitations. For example the @@ -99,7 +99,7 @@ resource collections (which also includes directories). Prior to Apache Ant

    You can use any number of nested resource collection elements to define the resources for this task and refer to resources defined -elsewhere. Note: resources passed to this task must implement +elsewhere. Note: resources passed to this task must implement the org.apache.tools.ant.types.resources.Touchable interface, this is true for all filesystem-based resources like those returned by path, fileset ot filelist.

    diff --git a/manual/Tasks/truncate.html b/manual/Tasks/truncate.html index 0644e0413..2dabff6a9 100644 --- a/manual/Tasks/truncate.html +++ b/manual/Tasks/truncate.html @@ -88,7 +88,7 @@ a single file, this Task can also work on

    You can use any number of nested resource collection elements to define the resources for this task and refer to resources defined -elsewhere. Note: resources passed to this task are expected +elsewhere. Note: resources passed to this task are expected to be filesystem-based.

    Examples

    diff --git a/manual/Tasks/unzip.html b/manual/Tasks/unzip.html index 8d7e68829..6b6c5791d 100644 --- a/manual/Tasks/unzip.html +++ b/manual/Tasks/unzip.html @@ -91,7 +91,7 @@ archive.

    compression - Note: This attribute is only available for + Note: This attribute is only available for the untar task.
    compression method. Allowable values are "none", "gzip", "xz" and "bzip2". Default is @@ -130,7 +130,7 @@ archive.

    scanForUnicodeExtraFields - Note: This attribute is not available for + Note: This attribute is not available for the untar task.
    If the archive contains uncode extra fields then use them to set the file names, ignoring the specified encoding. diff --git a/manual/Tasks/uptodate.html b/manual/Tasks/uptodate.html index 62cf7e506..b5a8f5cb1 100644 --- a/manual/Tasks/uptodate.html +++ b/manual/Tasks/uptodate.html @@ -82,7 +82,7 @@ target execution depending on the relative age of the specified files.

    fileset and allows you to specify a set of files to check against the target file(s).

    -

    Note: You can specify either the srcfile +

    Note: You can specify either the srcfile attribute or nested <srcfiles> elements, but not both.

    Note that the task will completely ignore any directories that seem diff --git a/manual/Tasks/war.html b/manual/Tasks/war.html index 4b17527fc..9f337a68f 100644 --- a/manual/Tasks/war.html +++ b/manual/Tasks/war.html @@ -212,7 +212,7 @@ to a value other than its default, "add".

    that the permissions haven't been stored at all rather than real permissions and will instead apply its own default values.
    Set this attribute to true if you really want to preserve the - original permission field.since Ant 1.8.0 + original permission field. since Ant 1.8.0 No, default is false diff --git a/manual/Tasks/whichresource.html b/manual/Tasks/whichresource.html index e4fc24390..0ec09013c 100644 --- a/manual/Tasks/whichresource.html +++ b/manual/Tasks/whichresource.html @@ -75,7 +75,7 @@ The classpath to use, given as a reference to a path defined elsewhere. - Since Apache Ant 1.7.1. + Since Apache Ant 1.7.1. No diff --git a/manual/Tasks/xmlproperty.html b/manual/Tasks/xmlproperty.html index 00f969096..dc8691293 100644 --- a/manual/Tasks/xmlproperty.html +++ b/manual/Tasks/xmlproperty.html @@ -145,7 +145,7 @@ is roughly equivalent to the following fragments in a build.xml file: delimiter - Delimiter for splitting multiple values.
    since Apache Ant 1.7.1 + Delimiter for splitting multiple values.
    since Apache Ant 1.7.1 No, defaults to comma diff --git a/manual/Tasks/zip.html b/manual/Tasks/zip.html index 4b0949fd9..c887d0890 100644 --- a/manual/Tasks/zip.html +++ b/manual/Tasks/zip.html @@ -210,7 +210,7 @@ archive.

    Whether the file modification times will be rounded up to the next even number of seconds.
    Zip archives store file modification times with a granularity of - two seconds, so the times will either be rounded up or down. If + two seconds, so the times will either be rounded up or down. If you round down, the archive will always seem out-of-date when you rerun the task, so the default is to round up. Rounding up may lead to a different type of problems like JSPs inside a web @@ -246,7 +246,7 @@ archive.

    useLanguageEncodingFlag Whether to set the language encoding flag if the - encoding is UTF-8. This setting doesn't have any effect if the + encoding is UTF-8. This setting doesn't have any effect if the encoding is not UTF-8. Since Ant 1.8.0.
    See also the discussion below @@ -301,7 +301,7 @@ archive.

    More recent versions of the ZIP specification introduce something called the "language encoding flag" which can be used to signal that a file name has been encoded using UTF-8. Since - Ant 1.8.0, all zip-/jar- and similar archives written by Ant will set + Ant 1.8.0, all zip, jar and similar archives written by Ant will set this flag, if the encoding has been set to UTF-8. Our interoperability tests with existing archivers didn't show any ill effects (in fact, most archivers ignore the flag to date), but you @@ -345,7 +345,7 @@ archive.

    jars from your CLASSPATH reads and writes UTF-8 names, it doesn't set or recognize any flags or unicode extra fields. -
  • Starting with Java 7 java.util.zip writes UTF-8 by +
  • Since Java 7, java.util.zip writes UTF-8 by default and uses the language encoding flag. It is possible to specify a different encoding when reading/writing ZIPs via new constructors. The package now recognizes the language encoding @@ -411,8 +411,8 @@ archive.

    will be written has to be made before writing the entry's content.

    -

    Starting with Ant 1.9.0 Ant supports Zip64 extensions but didn't - provide any control over their usage, starting with Ant 1.9.1 a +

    Ant 1.9.0 introduced support for Zip64 extensions but didn't + provide any control over their usage. Since Ant 1.9.1, a new zip64mode attribute was added to the zip family of tasks. It supports three values: @@ -420,7 +420,7 @@ archive.

  • never means no Zip64 extra fields will ever be written, this is the behavior of Ant 1.8.x and earlier and the default behavior of jar, ear - and war starting with Ant 1.9.1.
  • + and war since Ant 1.9.1.
  • always means Zip64 extra fields are written for all entries.
  • as-needed means Zip64 extra fields are written for all @@ -461,29 +461,25 @@ the same way that zipfileset src files are added.

    Examples

      <zip destfile="${dist}/manual.zip"
    -       basedir="htdocs/manual"
    -  />
    + basedir="htdocs/manual"/>

    zips all files in the htdocs/manual directory into a file called manual.zip in the ${dist} directory.

      <zip destfile="${dist}/manual.zip"
            basedir="htdocs/manual"
    -       update="true"
    -  />
    + update="true"/>

    zips all files in the htdocs/manual directory into a file called manual.zip in the ${dist} directory. If manual.zip doesn't exist, it is created; otherwise it is updated with the new/changed files.

      <zip destfile="${dist}/manual.zip"
            basedir="htdocs/manual"
    -       excludes="mydocs/**, **/todo.html"
    -  />
    + excludes="mydocs/**, **/todo.html"/>

    zips all files in the htdocs/manual directory. Files in the directory mydocs, or files with the name todo.html are excluded.

      <zip destfile="${dist}/manual.zip"
            basedir="htdocs/manual"
            includes="api/**/*.html"
    -       excludes="**/todo.html"
    -  />
    + excludes="**/todo.html"/>

    zips all files in the htdocs/manual directory. Only html files under the directory api are zipped, and files with the name todo.html are excluded.

      <zip destfile="${dist}/manual.zip">
    diff --git a/manual/stylesheets/style.css b/manual/stylesheets/style.css
    index cf26c60c3..f1e8f8479 100644
    --- a/manual/stylesheets/style.css
    +++ b/manual/stylesheets/style.css
    @@ -17,50 +17,70 @@
      */
     h2 {
       font-size: 200%;
    -  background-color: ffffff;
    +  background-color: white;
     }
     
     h3 {
       font-size: 130%;
    -  color:     #ffffff;
    +  color: white;
       background-color: #525D76;
     }
     
     h4 {
    -  color:  #ffffff;
    +  color: white;
       background-color: #828DA6;
     }
     
    +h5 {
    +  font-size: 100%;
    +  color: white;
    +  background-color: #a6adbe;
    +  margin-top: .5rem;
    +  margin-bottom: .5rem;
    +}
    +
    +h6 {
    +  font-size: 100%;
    +  color: white;
    +  background-color: #c1c5d1;
    +  margin-top: .5rem;
    +  margin-bottom: .5rem;
    +}
    +
    +h5 + p, h6 + p {
    +  margin-top: .5rem;
    +  margin-bottom: .5rem;
    +}
    +
     td {
    -   background-color: eeeeee;
    -   color:            000000;
    +   background-color: #eeeeee;
    +   color: black;
     }
     
     /* first row */
     table tr:first-child td {
    -   background-color: cccccc;
    -   color:            000000;
    +   background-color: silver;
    +   color: black;
     }
     
     /* or th as first row */
     table th {
    -   background-color: cccccc;
    -   color:            000000;
    +   background-color: silver;
    +   color: black;
     }
     
     pre {
    -   background-color: efefef;
    +   background-color: #efefef;
     }
     
     /* code snippets in examples and tutorials */
     .code { 
        background: #EFEFEF; 
    -   margin-top: 
     }
     
     /* highlight console output */
     .output { 
    -   color: #FFFFFF; 
    +   color: white;
        background: #837A67; 
     }