<mapper> has been set up to map *.file
to *.out, then this <mapper> is used to
-specify targetfiles for this <apply> task. A reference to out is
-then used as an <outputmapper> nested in a <redirector>, which
-in turn is nested beneath this <apply> instance. This allows us to perform
-dependency checking against output files—the target files in this case.
+specify targetfiles for this <apply> task. A reference
+to out is then used as an <outputmapper> nested in
+a <redirector>, which in turn is nested beneath this <apply>
+instance. This allows us to perform dependency checking against output files—the target files
+in this case.
<apply executable="ls" parallel="true"
force="true" dest="${basedir}" append="true" type="both">
diff --git a/manual/Tasks/javadoc.html b/manual/Tasks/javadoc.html
index d1acb0e19..a958c0dc4 100644
--- a/manual/Tasks/javadoc.html
+++ b/manual/Tasks/javadoc.html
@@ -52,8 +52,9 @@ running you should then switch to the regular notation.
In the table below, 1.2 means available if your current JVM is exactly of version 1.2 (not 1.3 or
later), 1.4+ for any JVM of at least version 1.4, otherwise any JVM of at least version 1.2 is
-acceptable. JDKs < 1.4 are no longer supported. If you specify the executable
-attribute it is up to you to ensure that this command supports the attributes you wish to use.
+acceptable. JDKs prior to 1.4 are no longer supported. 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 you
maybe get a java.lang.ClassCastException:
diff --git a/manual/Tasks/rmic.html b/manual/Tasks/rmic.html
index 0cb43b679..1ffdfbdc5 100644
--- a/manual/Tasks/rmic.html
+++ b/manual/Tasks/rmic.html
@@ -51,7 +51,7 @@ are the choices:
default—the default compiler (
kaffe,
sunor
forking) for the platform. -
sun—the standard compiler of the JDK < 9
sun—the standard compiler prior to JDK 9
kaffe—the standard compiler of Kaffe
weblogic
The next example shows the use of <classpath> and loaderref to get access to the -beanshell jar.
+The next example shows the use of <classpath>
+and loaderref to get access to the beanshell jar.
<scriptdef name="b1" language="beanshell"
loaderref="beanshell-ref">
diff --git a/manual/Tasks/sync.html b/manual/Tasks/sync.html
index 1de573c62..32d5f36db 100644
--- a/manual/Tasks/sync.html
+++ b/manual/Tasks/sync.html
@@ -56,10 +56,11 @@ present in the target 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
- 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 the patterns of <preserveintarget>. This can be overridden by
- <preserveintarget>'s preserveEmptyDirs attribute.
+ 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 the patterns of <preserveintarget>. This can be
+ overridden by <preserveintarget>'s preserveEmptyDirs
+ attribute.
No; defaults to false
diff --git a/manual/Types/mapper.html b/manual/Types/mapper.html
index bf8a10a0b..218b7485d 100644
--- a/manual/Types/mapper.html
+++ b/manual/Types/mapper.html
@@ -740,7 +740,7 @@ dependencies.
No
-This filename mapper can take a nested <classpath> element. See
+
This filename mapper can take a nested <classpath> element. See
the script task on how to use this element.
Example
diff --git a/manual/install.html b/manual/install.html
index 38df65a8b..191f3daa4 100644
--- a/manual/install.html
+++ b/manual/install.html
@@ -477,8 +477,8 @@ option on the command line. This is an easy way to test for classpath-related pr
The usual symptom of CLASSPATH problems is that Ant will not run with some error about not being able to
-find org.apache.tools.ant.launch.Launcher, or, if you have got the quotes/backslashes wrong, some very
-weird Java startup error. To see if this is the case, run ant -noclasspath or unset
+find org.apache.tools.ant.launch.Launcher, or, if you have got the quotes/backslashes wrong,
+some very weird Java startup error. To see if this is the case, run ant -noclasspath or unset
the CLASSPATH environment variable.
diff --git a/manual/platform.html b/manual/platform.html
index c9a89b0d5..590d0db27 100644
--- a/manual/platform.html
+++ b/manual/platform.html
@@ -34,19 +34,20 @@ against the shipping XSL engine.
Unix and Linux
tar to untar the Apache Ant source tree, if you
-have downloaded this as a tar file. If you get weird errors about missing files, this is the
+<chmod> to set permissions,
and when creating a tar archive, use the mode attribute
of <tarfileset> to set the permissions in the tar file,
-or <apply> the real tar program.<apply> the real tar program.
javac. Better yet, use jikes for extra compilation speed.<javac>. Better yet, use jikes for extra compilation
+speed.
Finally, if any Ant task fails with an error=2, it means that whatever native program
-Ant is trying to run, it is not on the path.
+Ant is trying to run, it is not on the Path.
There are reports of problems with Windows Vista security bringing up dialog boxes asking if the
-user wants to run an untrusted executable during an Ant run, such as when the <signjar> task
-runs the jarsigner.exe program. This is beyond Ant's control, and stems from the OS
-trying to provide some illusion of security by being reluctant to run unsigned native executables.
-The latest Java versions appear to resolve this problem by having signed binaries.
+user wants to run an untrusted executable during an Ant run, such as when
+the <signjar> task runs the jarsigner.exe program. This is beyond
+Ant's control, and stems from the OS trying to provide some illusion of security by being reluctant
+to run unsigned native executables. The latest Java versions appear to resolve this problem by
+having signed binaries.
ant.project.name<project>.
ant.project.default-target<project>.For more information about -logger and --listener see -Loggers & Listeners. -
For more information about -inputhandler see -InputHandler. -
Easiest way of changing the exit-behaviour is subclassing the original main class:
+For more information about -logger +and -listener see Loggers & +Listeners. +
For more information about -inputhandler +see InputHandler. +
Easiest way of changing the exit-behaviour is subclassing the +original main class:
public class CustomExitCode extends org.apache.tools.ant.Main {
protected void exit(int exitCode) {
@@ -141,7 +142,8 @@ public class CustomExitCode extends org.apache.tools.ant.Main {
}
}
-and starting Ant with access (-lib path-to-class) to this class.
+and starting Ant with access (-lib path-to-class) +to this class.
CLASSPATH environment variable, something the
-the -noclasspath option actually enforces. We get many
-more support calls related to classpath problems (especially quoting
+the -noclasspath option actually enforces. We get many more
+support calls related to classpath problems (especially quoting
problems) than we like.
The location of ${user.home}/.ant/lib is somewhat @@ -203,8 +205,7 @@ directory, on the target called dist.
ant -buildfile test.xml -Dbuild=build/classes dist
runs Ant using the test.xml file in the current
directory, on the target called dist, setting
-the build property to the
-value build/classes
.
build property to the value build/classes.
ant -lib /home/ant/extras
runs Ant picking up additional task and support jars from @@ -250,9 +251,12 @@ section for examples.
properties are available via Project instance, I searched for them with agrep -r -n "getPropert" * > ..\grep.txt
command. After that I filtered out the often-used but
- not-so-important values (most of them read-only
- values): path.separator, ant.home, basedir, user.dir, os.name, line.separator, java.home, java.version, java.version, user.home, java.class.path
- And I filtered out the getPropertyHelper access.
path.separator, ant.home, basedir,
+user.dir, os.name, line.separator,
+java.home, java.version, java.version,
+user.home, java.class.pathgetPropertyHelper access.
ant.build.javac.source |
Source-level version number | -Default source value for <javac>/<javadoc> | +Default source value
+ for <javac>/<javadoc> |
ant.build.javac.target |
Class-compatibility version number | -Default target value for <javac> | +Default target value for <javac> |
ant.executor.class |
classname; default is org. |
- Since Ant 1.6.3 Ant will delegate Target invocation to the
- org.apache.tools.ant.Executor implementation specified here.
- |
+ Since Ant 1.6.3 Ant will delegate Target invocation to
+ the org.apache.tools.ant.Executor
+ implementation specified here. |
ant.file |
read only: full filename of the build file | This is set to the name of the build - file. In <import>-ed files, - this is set to the containing build file. - | + file. In <import>-ed files, + this is set to the containing build file.|
ant.file.* |
- read only: full filename of the build file of Ant projects - | +read only: full filename of the build file of Ant projects | This is set to the name of a file by project; this lets you determine the location - of <import>-ed files, - | + of <import>-ed files.
ant.input.properties |
filename (required) | Name of the file holding the values for - the PropertyFileInputHandler. - | + the PropertyFileInputHandler.|
ant.logger.defaults |
filename (optional, default /org/) |
Name of the file holding the color mappings for - the AnsiColorLogger. - | + the AnsiColorLogger.|
ant.netrexxc.* |
several formats | -Use specified values as defaults for netrexxc. - | +Use specified values as defaults + for netrexxc. |
ant.PropertyHelper |
Ant reference name (optional) | Specify the PropertyHelper to use. The object must be of the
- type org.apache.tools.ant.PropertyHelper. By default,
- an object of org.apache.tools.ant.PropertyHelper will
- be used as PropertyHelper.
- |
+ type |
ant.regexp.regexpimpl |
classname | classname for a RegExp implementation; by default, JDK 1.4+ implementation; RegExp - Mapper "Choice of regular expression implementation". - | + Mapper "Choice of regular expression implementation".|
ant.reuse.loader |
boolean | allow to reuse classloaders used
- in org.apache.tools.ant.util.ClasspathUtil.
- |
+ in |
ant.XmlLogger.stylesheet.uri |
filename (default log.xsl) |
Name for the stylesheet to include in the logfile - by XmlLogger. - | + by XmlLogger.|
build.compiler |
@@ -351,36 +348,31 @@ properties are available via Project instance, I searched for them with a
Specify the default compiler to use; see javac, EJB Tasks (compiler - attribute), javah. - | + attribute), javah.||
build.compiler.emacs |
boolean (default false) |
Enable emacs-compatible error messages; - see javac "Jikes Notes". - | + see javac "Jikes Notes".|
build.compiler.fulldepend |
boolean (default false) | Enable full dependency checking; - see javac "Jikes Notes". - | + see javac "Jikes Notes".|
build.compiler.jvc.extensions |
Deprecated | Enable Microsoft extensions of their Java compiler; - see javac "Jvc Notes". - | + see javac "Jvc Notes".|
build.compiler.pedantic |
boolean (default false) |
Enable pedantic warnings; - see javac "Jikes Notes". - | + see javac "Jikes Notes".|
build.compiler.warnings |
@@ -401,13 +393,12 @@ properties are available via Project instance, I searched for them with a
file.encoding |
name of a supported character set (e.g. UTF-8, ISO-8859-1, US-ASCII) | use as default character set of email messages; use as default
- for srcencoding, destencoding
- and bundleencoding
- in translate see JavaDoc - of java.nio.charset.Charset for more information - about character sets (not used in Ant, but has nice docs). - |
+ for srcencoding, destencoding
+ and bundleencoding
+ in translate
jikes.class.path |
@@ -419,56 +410,51 @@ properties are available via Project instance, I searched for them with a
filename (optional, defaults derived from Project instance) | Name of the file holding properties for sending emails by the MailLogger. Override - properties set inside the buildfile or via command line. - | + properties set inside the buildfile or via command line.|
org.apache.tools.ant.ProjectHelper |
classname (optional, default org.) |
specifies the classname to use as ProjectHelper. The class must
- extend org.apache.tools.ant.ProjectHelper.
- |
+ extend |
org.apache.tools.ant.ArgumentProcessor |
classname (optional) | specifies the classname to use as ArgumentProcessor. The class
- must extend org.apache.tools.ant.ArgumentProcessor.
- |
+ must extend |
websphere.home |
path | Points to home directory of WebSphere; - see EJB Tasks - | + see EJB Tasks|
XmlLogger.file |
filename (default log.xml) |
- Name for the logfile for MailLogger. - | +Name for the logfile + for MailLogger. |
ant.project-helper-repo.debug |
boolean (default false) |
Set it to trueto enable debugging with Ant's ProjectHelper internal - repository. - |
+ repository.
|
ant.argument-processor-repo.debug |
boolean (default false) |
Set it to trueto enable debugging with Ant's ArgumentProcessor - internal repository. - |
+ internal repository.
|
ant.tstamp.now |
number, seconds since the epoch (midnight 1970-01-01) | -The value to use as current time and date for <tstamp> | +The value to use as current time and date
+ for <tstamp> |
ant.tstamp.now.iso |