@@ -2,7 +2,7 @@
<head> <head>
<meta http-equiv="Content-Language" content="en-us"> <meta http-equiv="Content-Language" content="en-us">
<title>Apache Ant User Manual </title>
<title>Copy Task </title>
</head> </head>
<body> <body>
@@ -70,9 +70,9 @@ To use a fileset, the <var>todir</var> attribute must be set.</p>
</tr> </tr>
<tr> <tr>
<td valign="top">includeEmptyDirs</td> <td valign="top">includeEmptyDirs</td>
<td valign="top">Copy empty directories included with the nested FileSet(s).
Defaults to "yes".</td>
<td valign="top" align="center">No</td>
<td valign="top">Copy empty directories included with the nested FileSet(s).
Defaults to "yes".</td>
<td valign="top" align="center">No</td>
</tr> </tr>
</table> </table>
<h3>Parameters specified as nested elements</h3> <h3>Parameters specified as nested elements</h3>
@@ -110,20 +110,20 @@ To use a fileset, the <var>todir</var> attribute must be set.</p>
<p><b>Copy a set of files to a directory</b></p> <p><b>Copy a set of files to a directory</b></p>
<pre> <pre>
<copy todir="../dest/dir" > <copy todir="../dest/dir" >
<fileset dir="src_dir" >
<fileset dir="src_dir" >
<exclude name="**/*.java"/> <exclude name="**/*.java"/>
</fileset> </fileset>
</copy> </copy>
<copy todir="../dest/dir" > <copy todir="../dest/dir" >
<fileset dir="src_dir" excludes="**/*.java"/>
<fileset dir="src_dir" excludes="**/*.java"/>
</copy> </copy>
</pre> </pre>
<p><b>Copy a set of files to a directory appending <p><b>Copy a set of files to a directory appending
"<code>.bak</code>" to the file name on the fly</b></p> "<code>.bak</code>" to the file name on the fly</b></p>
<pre> <pre>
<copy todir="../backup/dir" > <copy todir="../backup/dir" >
<fileset dir="src_dir" />
<fileset dir="src_dir" />
<mapper type="glob" from="*" to="*.bak"/> <mapper type="glob" from="*" to="*.bak"/>
</copy> </copy>
</pre> </pre>
@@ -139,6 +139,11 @@ To use a fileset, the <var>todir</var> attribute must be set.</p>
</copy> </copy>
</pre> </pre>
<p><strong>Unix Note:</strong> 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
current Java runtimes. If you need a permission preserving copy function,
use <exec executable="cp" ... > instead.
<hr><p align="center">Copyright © 2000,2001 Apache Software Foundation. All rights <hr><p align="center">Copyright © 2000,2001 Apache Software Foundation. All rights
Reserved.</p> Reserved.</p>
Steve Loughran