next up previous contents index
Next: Parameters specified as nested Up: Copy Previous: Description   Contents   Index

Parameters

file The file to copy. Yes, unless a nested <fileset> element is used.
preservelastmodified Give the copied files the same last modified time as the original source files. (Note: Ignored on Java 1.1) No; defaults to false.
Attribute
tofile
todir

The file to copy to.
The directory to copy to.

With the file attribute, either tofile or todir can be used. With nested <fileset> elements, if the set of files is greater than 1, or if only the dir attribute is specified in the <fileset>, or if the file attribute is also specified, then only todir is allowed.

overwrite Overwrite existing files even if the destination files are newer. No; defaults to false.
filtering Indicates whether token filtering using the global build-file filters should take place during the copy. 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. flatten Ignore the directory structure of the source files, and copy all files into the directory specified by the todir attribute. Note that you can achieve the same effect by using a flatten mapper. No; defaults to false.
includeEmptyDirs Copy any empty directories included in the FileSet(s). No; defaults to true.
failonerror Log a warning message, but do not stop the build, when the file to copy does not exist. Only meaningful when copying a single file. No; defaults to true.
verbose Log the files that are being copied. No; defaults to false.
encoding The encoding to assume when filter-copying the files. since Ant 1.5. No - defaults to default JVM encoding


next up previous contents index
Next: Parameters specified as nested Up: Copy Previous: Description   Contents   Index
Andrew Marlow 2003-07-08