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
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 | @@ -272,31 +272,31 @@ to send input to it is via the input and inputstring attributes.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. | + 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. | + command automatically. Since Ant 1.6.No, default is true |
verbose | Whether to print a summary after execution or not. - Since Ant 1.6. | + Since Ant 1.6.No, default false |
ignoremissing | Whether to ignore nonexistent files specified - via filelists. Since Ant 1.6.2. | + 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. | + for target files. Since Ant 1.6.3.No, default is false |
<env>
elements. See the
description in the section about exec
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 @@
Since Apache Ant 1.6.
+Since Apache Ant 1.6.
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.augment
element as though it were the
original element.
-Since Apache Ant 1.8.1
+Since Apache Ant 1.8.1
package | -the 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/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 @@No, default is file | 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 nesteddir | 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. |
@@ -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.No, default is file | @@ -132,13 +132,13 @@ could use as initial value for these experiments.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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
verbose | Whether to print a summary after execution or not.
- Defaults to false . Since Ant 1.6. |
+ Defaults to No | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
No, default is file | 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.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 |
encoding | -The 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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. | @@ -317,7 +317,7 @@ destination directory, flattening the directory structure.||||||||||||||||||||||||||||||||||||||||||||||||
package | -the 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/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 @@
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
| ||||
includes | -Deprecated. 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 . |
@@ -124,14 +124,14 @@ in Directory-based Tasks, and see the
|||
includesfile | -Deprecated. 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 | ||
excludes | -Deprecated. 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
| |||
excludesfile | -Deprecated. 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 | ||
defaultexcludes | -Deprecated. Use resource collections. + | Deprecated. Use resource collections. Whether to use default excludes. | No, default "true" | 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.No, default is false | output | the Resource to write the message to (see note). - Since Apache Ant 1.8 | + Since Apache Ant 1.8
append | 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 @@
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 | @@ -366,7 +366,7 @@ system command via nested
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 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 @@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.
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.
- 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).
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).
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."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 ...
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.
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.
.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
.
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.
no
.fork="yes"
.
Defaults to the compiler of the Java version that is currently
running Ant. Ignored if fork="no"
.package-info.java
files don't create any package-info.class
files so
Ant would recompile the same file every time.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.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.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:
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.
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 arefalse
.
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.
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.
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
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 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.
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.
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.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.
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
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
perTest
.Assertion statements are currently ignored in non-forked mode.
-since Ant 1.6.
+Since Ant 1.6.
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.
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:
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.
2.4.1+ | JDK 1.4.2-01+ | OK |
XSLTC | JDK 1.5.x | OK |
2.x | JDK 1.4.x | DEPRECATED 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.
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.
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.
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
A property is made local if the <local>
task
precedes its definition. See the examples section.
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.
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:
It is permissible to duplicate the name attribute amongst multiple headers. -
+It is permissible to duplicate the name attribute amongst multiple headers.
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.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.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.0Note: +
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.
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.
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.
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.7stubversion | 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. | + Since Ant 1.8.No |
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.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.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.
- 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
javax.script.Compilable
.
Note that the bsf
manager may automatically compiles the script.
- since Ant 1.10.2.
+ since Ant 1.10.2.
Since Ant 1.10.0.
+Since Ant 1.10.0.
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.
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
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 is used to pass a parameter to the XSL stylesheet.
--Parameters
+ +Parameters
-
- Attribute @@ -347,9 +347,7 @@ element is used to perform Entity and URI resolution.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
-
Attribute @@ -386,12 +384,11 @@ XSLT specifications.Yes
--Parameters
+ +Parameters
-
Attribute @@ -409,8 +406,8 @@ Used to specify factory settings.No. 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
+
Attribute @@ -460,8 +457,9 @@ And in Saxon 7.x: with the given id. since Ant 1.9.8Examples
+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 - idextension-path
. -
extension-path
.
since Ant 1.9.8
+ +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
Attribute @@ -504,12 +502,12 @@ ishttp://javax.xml.XMLConstants/feature/secure-processing
.value value of the feature. A boolean value - (i.e. permitted values are true,false,yes,no,on,off). + (i.e. permitted values are true, false, yes, no, on, off).No, defaults to false
since Ant 1.6.2
@@ -547,7 +545,6 @@ with syspropertysets.since Ant 1.8.0.
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.<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>-
${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