                  Copy All Files and Directorys in a Tree

   This function makes a complete copy of a tree or sub tree in another
spot. The directory at the tree cursor is the root of the tree to be
copied. The destination directory will be chosen with the directory
selection window. All subdirectorys at the destination will be created
as necessary. If the destination tree already exists, you can also
replace or update the files that are already there. There are 3 gadgets
that control replacement. If you activate the REPL gadget any like named
files in like named sub directorys will be overwritten unless their
protection bits don't allow it. If they are protected, you will be prompted
for permission to overwrite. If you select the UPDATE gadget, like named
files will be overwritten only if the modification date/time is later on
the source file than the destination file. UPDATE implys REPLACE. You
may also force the override of any protection bits by selecting the OVER
gadget. OVER also implys REPLACE. OVER and UPDATE may be used together.
Files that are overwritten using the OVER gadget will not have their
protection bits changed, so they will still be protected after the copy
if they were before.

   When you have set the above three gadgets as desired click the OK gadget
and you will then be asked to select the destination directory. If you
decide not to copy, click the CANCEL gadget to abort the operation.

   Note: If you are copying a tree to a like named tree on another drive,
the tree is copied into the directory you select. For example, to copy
the tree DH0:Test to DH1:Test choose DH1: as the destination directory,
not DH1:Test. If you choose DH1:Test as the destination, you will get
tree DH1:Test/Test created.

