COPY FILE
 Copy a file to a new file or to a device
------------------------------------------------------------------------------
 Syntax

     COPY FILE <xcSourceFile> TO <xcTargetFile>|<xcDevice>

 Arguments

     <xcSourceFile> is the name of the source file to COPY including the
     extension.

     <xcTargetFile> is the name of the target file including the
     extension.

     Both arguments can be specified as literal filenames or as character
     expressions enclosed in parentheses.  COPY FILE supplies no default
     extensions.

     <xcDevice> is the name of the device where all subsequent output
     will be sent.  You can specify a device name as a literal character
     string or a character expression enclosed in parentheses.  Additionally,
     a device can be either local or network.  If you COPY TO a non-existing
     device you create a file with the name of the device.  When specifying
     device names, do not use a trailing colon.

 Description

     COPY FILE is a file command that copies files to and from the CA-Clipper
     default drive and directory unless you specify a drive and/or path.  If
     the <xcTargetFile> exists, it is overwritten without warning or error.

 Examples

     .  This example copies a file to a new file and then tests for
        the existence of the new file:

        COPY FILE Test.prg TO Real.prg
        ? FILE("Real.prg")                  // Result: .T.

 Files:  Library is EXTEND.LIB.