The  'copy' function copies an object from one environment on the search path (source) to another environment (target) on the search path. The object remains in the source environment after it has been copied; it also saves the target environment to its corresponding file.  The typical use of 'copy' copies an object from .GlobalEnv to a file that is attached to the search path.  By default, the copy is not carried out if an object with the same name exists in the destination directory.  The default can be overridden (replace=T).  The copy function also applies to a character vector of object names.  The 'copy' function is a wrapper for the move function with the default set to 'copy.only = TRUE'.  

ARGUMENTS:

list = object to be copied;  or a character vector of object names.

to = the destination file to which the objects are to be copied.  to can be specified as either a position, e.g., to = 3, or as a named environment, e.g., to = "data.rda".  Partial matching is used to match the named environment if an incomplete name is given. 

from = the source file or environment from which the objects are to be copied.  from can be specified as either a position, e.g., from = 3, or as a named environment, e.g., from = "data.rda". Partial matching is used to match the named environment if an incomplete name is given. 

fn.object = FALSE (default) means that the object to be copied is in a file on the search path (starting with .GlobalEnv).  fn.object = TRUE should be used only if the copy function is called by another function. fn.object = TRUE means that the the object to be copied is within the environment created by a calling function.  In this case, the object exists in an environment that is not named by the search() function.  

replace.objects = T to replace a same name object in destination directory; If replace.objects = F, then no copy is carried out when a same name object exists in the destination file. 

If feedback = TRUE (default), then feedback is printed to the screen regarding which objects have been successfully copied and which copies have failed.  If feedback = FALSE, this feedback is suppressed.

If map = TRUE, a table showing the existence and replacement of objects is displayed; if FALSE, no table is displayed. The default is map = TRUE.