Copy a single file while changing its encoding from "latin1" to "utf-8".

<copy 
file="myfile.txt"
tofile="mycopy.txt"
inputencoding="latin1"
outputencoding="utf-8" />

Copy a set of files to a new directory.

    <copy todir="${build.dir}">
    <fileset basedir="bin">
        <include name="*.dll" />
    </fileset>
</copy>

Copy a set of files to a directory, replacing @TITLE@ with "Foo Bar" in all files.

    <copy todir="../backup/dir">
    <fileset basedir="src_dir">
        <include name="**/*" />
    </fileset>
    <filterchain>
        <replacetokens>
            <token key="TITLE" value="Foo Bar" />
        </replacetokens>
    </filterchain>
</copy>

Copy an entire directory and its contents.

    <copy tofile="target/dir">
  <fileset basedir="source/dir"/>
</copy>

Files are only copied if the source file is newer than the destination file, or if the destination file does not exist. However, you can explicitly overwrite files with the NAnt.Core.Tasks.CopyTask.Overwrite attribute.

When a NAnt.Core.Types.FileSet is used to select files to copy, the NAnt.Core.Tasks.CopyTask.ToDirectory attribute must be set. Files that are located under the base directory of the NAnt.Core.Types.FileSet will be copied to a directory under the destination directory matching the path relative to the base directory of the NAnt.Core.Types.FileSet, unless the NAnt.Core.Tasks.CopyTask.Flatten attribute is set to true.

Files that are not located under the the base directory of the NAnt.Core.Types.FileSet will be copied directly under to the destination directory, regardless of the value of the NAnt.Core.Tasks.CopyTask.Flatten attribute.

Encoding

Unless an encoding is specified, the encoding associated with the system's current ANSI code page is used.

An UTF-8, little-endian Unicode, and big-endian Unicode encoded text file is automatically recognized, if the file starts with the appropriate byte order marks.