From cc3962b0da2450796a73cd469da8338c81696d0e Mon Sep 17 00:00:00 2001 From: Stefan Bodewig Date: Thu, 9 Oct 2008 11:29:17 +0000 Subject: [PATCH] Improve copy documentation, PR 45944. git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@703136 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/CoreTasks/copy.html | 17 ++++++++++++++++- src/tests/antunit/taskdefs/copy-test.xml | 18 ------------------ 2 files changed, 16 insertions(+), 19 deletions(-) diff --git a/docs/manual/CoreTasks/copy.html b/docs/manual/CoreTasks/copy.html index ff95b4cee..acfbcfded 100644 --- a/docs/manual/CoreTasks/copy.html +++ b/docs/manual/CoreTasks/copy.html @@ -33,7 +33,12 @@ overwrite files with the overwrite attribute.

Resource Collections are used to select a group of files to copy. To use a -resource collection, the todir attribute must be set.

+resource collection, the todir attribute must be set. +Note that some resources (for example +the file resource) +return absolute paths as names and the result of using them without +using a nested mapper (or the flatten attribute) may not be what you +expect.

Note: If you employ filters in your copy operation, @@ -153,6 +158,7 @@ operation as filtersets. systems. This can also be useful if source and target files live on separate machines with clocks being out of sync. since Ant 1.6.2. + No

Parameters specified as nested elements

@@ -263,6 +269,13 @@ destination directory, flattening the directory structure.

</copy> +

If the example above didn't use the flatten attribute, + the <file> resource would have returned its full + path as source and target name and would not have been copied at + all. In general it is a good practice to use an explicit mapper + together with resources that use an absolute path as their + names.

+

Copies the two newest resources into a destination directory.

   <copy todir="dest" flatten="true">
@@ -280,6 +293,8 @@ destination directory, flattening the directory structure.

   </copy>
+

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

Unix Note: File permissions are not retained when files are copied; they end up with the default UMASK permissions diff --git a/src/tests/antunit/taskdefs/copy-test.xml b/src/tests/antunit/taskdefs/copy-test.xml index 37aa00b7e..91db6fb5d 100644 --- a/src/tests/antunit/taskdefs/copy-test.xml +++ b/src/tests/antunit/taskdefs/copy-test.xml @@ -24,24 +24,6 @@ - - - - - - - - - - - - - - - - - -