diff --git a/WHATSNEW b/WHATSNEW index 52387d175..7593b0ecd 100644 --- a/WHATSNEW +++ b/WHATSNEW @@ -17,18 +17,18 @@ Fixed bugs: * bootstrapping Ant on Windows failed Bugzilla Report 61027 - * Fixed the issue where the SCP based tasks would try to change + * Fixed the issue where the SCP based tasks would try to change the permissions on the parent directory of a transferred file, instead of changing it on the transferred file itself. Bugzilla Reports 59648 and 43271 - * Fixed the issue where the source file being copied could end - up being corrupted if the target of the copy happened to be + * Fixed the issue where the source file being copied could end + up being corrupted if the target of the copy happened to be the same source file (symlinked back to itself). Bugzilla Report 60644 * Fixed the issue where symlink creation with "overwrite=false", - on existing symlink whose target was a directory, would end + on existing symlink whose target was a directory, would end up creating a new symlink under the target directory. Bugzilla Report 58683 @@ -66,15 +66,15 @@ Other changes: * Bugzilla Report 58589 - SCP task, when configured to use SFTP protocol, now preserves last modified timestamp on files that it uploads, if the preserveLastModified attribute is set to - true for that task + true for that task * zip and the related tasks can now set the modfication time of all entries to a fixed timestamp. Github Pull Request #36 * Bugzilla report 61718 - Jsch library dependency has now been - upgraded to 0.1.54. Jsch is the library behind the sshexec - and scp Ant tasks. + upgraded to 0.1.54. Jsch is the library behind the sshexec + and scp Ant tasks. * Added a new condition. @@ -820,11 +820,11 @@ Fixed bugs: * Updated documentation to fix spelling errors / broken links. Bugzilla Reports 53215, 53291, 53202 - + * Unable to override system properties. It was not possible not to override system properties from the command line (or from a property file). Bugzilla Report 51792 - + * by default fails when run on JDK 8. Bugzilla Report 53347. @@ -1001,7 +1001,7 @@ Fixed bugs: * Exec task may mix the stderr and stdout output while logging it Bugzilla Report 50507. - * Missing space between "finished" and timestamp in task/target + * Missing space between "finished" and timestamp in task/target finish message from ProfileLogger. Bugzilla Report 51109. @@ -1015,10 +1015,10 @@ Fixed bugs: Bugzilla Report 42696. * quiet attribute added to the copy and move tasks, to be used together - with failonerror=false, so warnings won't get logged + with failonerror=false, so warnings won't get logged Bugzilla Report 48789. - * System.in was closed and not readable anymore by the DefaultInputHandler + * System.in was closed and not readable anymore by the DefaultInputHandler when Ant is used via its Java API. Bugzilla Report 51161 @@ -1182,10 +1182,10 @@ Changes that could break older environments: Fixed bugs: ----------- - * hostinfo now prefers addresses with a hostname over addresses without + * hostinfo now prefers addresses with a hostname over addresses without a hostname, provided the addresses have the same scope. For local lookup, no IP address will be put in NAME / DOMAIN anymore. - For remote lookup, if a host name was provided and only an IP address is + For remote lookup, if a host name was provided and only an IP address is found, the IP address will no longer overwrite the host name provided to the task. Bugzilla Report 49513 @@ -1193,8 +1193,8 @@ Fixed bugs: * mmap-based file copy problems under JDK 1.4 on Linux. Bugzilla Report 49430. - * The Sun JVM tries to mmap the entire file during a copy. - For large files this is not feasible. + * The Sun JVM tries to mmap the entire file during a copy. + For large files this is not feasible. We now explicitly request to copy at most 16 MiB per request. Bugzilla Report 49326. @@ -1347,7 +1347,7 @@ Other changes: The wildcards are not expanded or even evaluated by Ant and will be used literally. The resulting path may be unusable as a CLASSPATH for Java versions prior to Java6 and likely doesn't mean anything - when used in any other way than a CLASSPATH for a forked Java VM. + when used in any other way than a CLASSPATH for a forked Java VM. Bugzilla Report 46842. * A new attribute allows targets to deal with nonexistent extension @@ -1417,7 +1417,7 @@ Other changes: should also benefit any operation that scans directories in Ant. Bugzilla Report 50200. -Changes from Ant 1.8.0 TO Ant 1.8.1 +Changes from Ant 1.8.0 TO Ant 1.8.1 =================================== Changes that could break older environments: @@ -1477,7 +1477,7 @@ Fixed bugs: 1.7.1 Bugzilla Report 48853 - * ANT_CMD_LINE_ARGS are rippling through lower level Ant usage + * ANT_CMD_LINE_ARGS are rippling through lower level Ant usage Bugzilla Report 48876 * email : IO error sending mail with plain mimetype @@ -1541,7 +1541,7 @@ Other changes: equals condition allowed Object args, but Ant 1.8.x+ property evaluation may yield values of any type. - * BuildFileTest.assertPropertyUnset() fails with a slightly more + * BuildFileTest.assertPropertyUnset() fails with a slightly more meaningful error message Bugzilla Report 48834 @@ -1581,7 +1581,7 @@ Fixed bugs: * stack traces were not reported at all by when filtertrace="on", which is the default. - * ant.bat can now also process the -noclasspath switch when it is + * ant.bat can now also process the -noclasspath switch when it is the first switch on a command line. Bugzilla Report 48186. @@ -1777,7 +1777,7 @@ Changes that could break older environments: * A new property syntax can be used to set attributes from references: ${ant.ref:some-reference} - In most cases this will yield the exact same result as + In most cases this will yield the exact same result as ${toString:some-reference} - only when an attribute setter method accepts an object type other than string and the project's reference is an Object of matching type the new syntax will pass in @@ -1814,12 +1814,12 @@ Fixed bugs: * RPM task needed an inserted space between the define and the value. Bugzilla Report 46659. - * Got rid of deadlock between in, out and err in the Redirector. + * Got rid of deadlock between in, out and err in the Redirector. Bugzilla Report 44544. * Caused by AssertionError no longer filtered. Bugzilla Report 45631. - + * would sometimes recreate JARs unnecessarily. Bugzilla Report 45902. @@ -1869,7 +1869,7 @@ Fixed bugs: * would fail if the executed statement didn't return a result set with some JDBC driver that dissalow Statement.getResultSet to be called in such a situation. - Bugzilla Report 36265 + Bugzilla Report 36265 * if the executed statement in returned a result set and an update count, the count would be lost. @@ -2076,7 +2076,7 @@ Fixed bugs: Bugzilla Report 29731. * didn't work properly with nested builds. - Bugzilla Report 41368. + Bugzilla Report 41368. * with filesetmanifest different from skip didn't work if the update attribute has been set to true. @@ -2130,7 +2130,7 @@ Fixed bugs: * The tar task failed to recognize that the archive had to be (re-)created in some cases where the sources are filesystem based resources but not filesets. - Bugzilla Report 48035. + Bugzilla Report 48035. * 's outputproperty was prefixed by the executed command when the command attribute has been used, breaking backwards @@ -2151,8 +2151,8 @@ Other changes: * The get task now also follows redirects from http to https Bugzilla Report 47433 - * A HostInfo task was added performing information on hosts, including info on - the host ant is running on. + * A HostInfo task was added performing information on hosts, including info on + the host ant is running on. Bugzilla Reports 45861 and 31164. * There is now a FileProvider interface for resources that act as a source @@ -2271,7 +2271,7 @@ Other changes: expression. Bugzilla Report 45284 - * Enhanced performance of Project.fireMessageLoggedEvent and DirectoryScanner + * Enhanced performance of Project.fireMessageLoggedEvent and DirectoryScanner Bugzilla Reports 45651 and 45665 * The package list location for offline links can now be specified as @@ -2424,7 +2424,7 @@ Other changes: process proceed if an error occurs. Bugzilla Report 36260. - * has a new attribute failOnNoResources that can be used to + * has a new attribute failOnNoResources that can be used to make the build fail/continue if the collection of resources to transform is empty. Bugzilla Report 46274. @@ -2671,7 +2671,7 @@ Changes that could break older environments: incoming (OutputStream) content. * with fork now returns gives -1 instead of 0 as result when failonerror - is false and some exception (including timeout) occurs. Br 42377. + is false and some exception (including timeout) occurs. Br 42377. * ant-type attribute has been marked as deprecated and a warning has been issued if it is encountered in the build file. @@ -2747,7 +2747,7 @@ Fixed bugs: * Synchonization issues in PropertyHelper. Bugzilla 41353. * did not append. Bugzilla 41399. - + * -autoproxy turns Java1.5+ automatic proxy support on. Bugzilla 41904 * Handle null result of system getProperty(). Bugzilla 42334. @@ -2973,10 +2973,10 @@ Changes that could break older environments: * IContract optional task removed as the required library is no longer available. -* Metamata (maudit, mmetrics, and mparse tasks) removed as the required +* Metamata (maudit, mmetrics, and mparse tasks) removed as the required library is no longer available. -* Sitraka (jpcoverage, jpcovmerge, jpcovreport) tasks suppressed as the +* Sitraka (jpcoverage, jpcovmerge, jpcovreport) tasks suppressed as the required library is no longer available. * used \r (Mac) line endings on OS X, whose proper line separator diff --git a/manual/Tasks/symlink.html b/manual/Tasks/symlink.html index 331bd79f6..af14949d4 100644 --- a/manual/Tasks/symlink.html +++ b/manual/Tasks/symlink.html @@ -27,8 +27,8 @@

Symlink

Description

Manages symbolic links on platforms where Java supports symbolic links. -Can be used to make an individual link, delete a link, create multiple links -from properties files, or create properties files describing links in the +Can be used to make an individual link, delete a link, create multiple links +from properties files, or create properties files describing links in the specified directories. Existing links are not overwritten by default.

FileSets are used to select a @@ -42,7 +42,7 @@ set of links to record, or a set of property files to create links from.

action - The type of action to perform, may be "single", + The type of action to perform, may be "single", "record", "recreate" or "delete". No, defaults to single. @@ -55,7 +55,7 @@ set of links to record, or a set of property files to create links from.

absolute path or a path like ${basedir}/some-path as its value. - required for + required for action="single" or "delete". Ignored in other actions. @@ -65,9 +65,9 @@ set of links to record, or a set of property files to create links from.

linkfilename - The name of the properties file to create in + The name of the properties file to create in each included directory. - required for action="record". + required for action="record". Ignored in other actions. @@ -84,21 +84,21 @@ set of links to record, or a set of property files to create links from.

Parameters specified as nested elements

- +

fileset

FileSets - are used when action = "record" to select directories and linknames to be recorded. - They are also used when action = "recreate" to specify both the name of the property - files to be processed, and the directories in which they can be found. At least one + are used when action = "record" to select directories and linknames to be recorded. + They are also used when action = "recreate" to specify both the name of the property + files to be processed, and the directories in which they can be found. At least one fileset is required for each case.

- +

Examples

Make a link named "foo" to a resource named "bar.foo" in subdir:

   <symlink link="${dir.top}/foo" resource="${dir.top}/subdir/bar.foo"/>
- +

Record all links in subdir and it's descendants in files named "dir.links"

@@ -106,14 +106,14 @@ set of links to record, or a set of property files to create links from. 

      <fileset dir="${dir.top}" includes="subdir/**"/>
   </symlink>
- +

Recreate the links recorded in the previous example:

   <symlink action="recreate">
-     <fileset dir="${dir.top}" includes="subdir/**/dir.links"/>  
+     <fileset dir="${dir.top}" includes="subdir/**/dir.links"/>
   </symlink>
- +

Delete a link named "foo": 

  <symlink action="delete" link="${dir.top}/foo"/>
@@ -121,12 +121,12 @@ set of links to record, or a set of property files to create links from. 

 
   
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 
+  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
   or something similar. The workaround is to change your ANT_HOME environment
   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
     link support introduced in Java 7 through the java.nio.file.Files APIs