home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 262.lha / ArpDoc_v1.3 / Copy < prev    next >
Text File  |  1989-07-01  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4.      Copy(V1.3)              ARP User's Manual              Copy(V1.3)
  5.  
  6.  
  7.  
  8.      NAME
  9.           Copy - Copy files.
  10.  
  11.      SYNOPSIS
  12.           Copy From To/a ALL/s QUIET/s BUF=BUFFER/k CLONE/s DATES/s
  13.                NOPRO/s COM/s FLAGS/k QUICK/s
  14.  
  15.      DESCRIPTION
  16.           COPY duplicates the contents of the file or files (if
  17.           wildcards or a directory is given) of its FROM argument to
  18.           the file or directory specified in its TO argument,
  19.           overwriting any existing file or files of the same names.
  20.  
  21.      FILE SPECIFICATION
  22.           The From argument may be a file, a directory or a wildcard
  23.           pattern.  You can use a dot '.' as either the From or To
  24.           directory to indicate the current directory.
  25.  
  26.           If the From argument is a directory or a pattern, the To
  27.           argument is assumed to be a directory or destination
  28.           replacement pattern.  If the directory specified in the To
  29.           argument does not exist, it will be created for you.
  30.  
  31.           If you include wildcard characters in the To argument, these
  32.           are taken to be a request to use a pattern substitution for
  33.           the destination filename.  The expected syntax is:
  34.  
  35.           <optional_prefix>*<optional_postfix>
  36.  
  37.           You may specify neither, one, or both of these optional
  38.           tags.  If you exceed the length of an AmigaDOS filename (30
  39.           characters as of this writing) the name will be silently
  40.           truncated.  You can also indicate which portion of the From
  41.           filename you want to be replaced by using the wildcard
  42.           characters in the source pattern.  The rule followed is that
  43.           any constant (i.e., non-wildcarded) portion of the
  44.           source pattern is discarded.  As an example, the
  45.           command:
  46.  
  47.              Copy l* start*end
  48.  
  49.           will copy all files beginning with an 'l'.  The destination
  50.           names these will be copied to will be formed by removing the
  51.           'l', and sticking 'start' on the front, and 'end' on the
  52.           back.  So, for example, the file 'LXXX' would be copied to
  53.           the file 'startXXXend'. If the start or end patterns are
  54.           omitted, these are regarded as null strings.
  55.  
  56.      OPTIONS
  57.           ALL  Copies ALL the files from the source directory to the
  58.                destination directory or device.  This will recursively
  59.                descend all subdirectories found in the From directory,
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/28/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      Copy(V1.3)              ARP User's Manual              Copy(V1.3)
  71.  
  72.  
  73.  
  74.                and create them (if they do not already exist) in the
  75.                To directory.  Without this switch, only the first
  76.                level of the directory hierarchy will be duplicated.
  77.  
  78.           QUIET
  79.                Performs a Copy without reporting what it is doing.
  80.                This is useful for doing copies in the background, when
  81.                you do not wish to be disturbed by informative
  82.                messages.  Note that errors will still be reported.
  83.  
  84.           BUF=BUFFER
  85.                This allows you to specify the number of 512 byte
  86.            buffers used during the copy. Unlike the Commodore
  87.            Copy, which uses a fixed number of buffers if this
  88.            option is not specified (currently, 200 buffers),
  89.            the ARP Copy sets its internal buffer size
  90.            intelligently as a function of how much memory your
  91.            system contains and the size of the file to be copied.
  92.            Using this option overrides this intelligent behavior.
  93.  
  94.           CLONE
  95.                This instructs Copy to duplicate the date, comments and
  96.                protection bits (except the archive bit) of the
  97.                original file.  The default is to Copy only the
  98.                protection bits. (also see Environment, below).
  99.  
  100.           DATES
  101.                This option instructs Copy to duplicate the datestamp
  102.                (also see Environment, below).
  103.  
  104.           NOPRO
  105.                By default, Copy duplicates the protection bits of the
  106.                file(s) (except the archive bit).  Using this option
  107.                will override this behavior, and cause the file to be
  108.                created with the current system default protection
  109.                (also see Environment, below).
  110.  
  111.           COM  This forces Copy to duplicate the comment for the file.
  112.                The default is not to duplicate the comment (also see
  113.                Environment, below).
  114.  
  115.           QUICK
  116.                This ARP addition is a highly useful option which will
  117.                duplicate files only if the destination file does not
  118.                exist or is not the same. Copy uses the Datestamp,
  119.                Filesize, Protect bits, and also the Filenote (but only
  120.            if you have enabled copying filenotes) to determine
  121.            whether or not the file is the same. Since a byte by
  122.            byte compare is not done, it is possible to fool Copy.
  123.            However, in normal operation of the Amiga, this
  124.            dramatically speeds up Copies between directories and is
  125.            perfectly safe (also see Environment, below).
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/28/89)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      Copy(V1.3)              ARP User's Manual              Copy(V1.3)
  137.  
  138.  
  139.  
  140.           FLAGS
  141.                You can override the current setting of your
  142.                environment flags using this keyword.  Any option
  143.                specified on the command line overrides the default
  144.                settings specified by the copyflags environment
  145.                variable. This keyword takes a string of the same type
  146.                used for the copyflags variable.  For a discussion of
  147.                these flags, see Environment, below.
  148.  
  149.      ENVIRONMENT
  150.           If you prefer a behavior for copy other than the default,
  151.           you can specify this behavior permanently by setting a value
  152.           for the copyflags environment variable.  This variable takes
  153.           a string of characters composed of the following:
  154.  
  155.           N    Always copy filenotes (see COM, above).
  156.  
  157.           C    Always copy original datestamp (see DATES, above).
  158.  
  159.           Q    Always copy QUICK (see QUICK, above).
  160.  
  161.           P    Never copy protection flags (see NOPRO, above).
  162.  
  163.           O    This flag does not correspond to any command line
  164.                arguments.  When this flag is set, Copy will only
  165.                duplicate files which already exist in the destination
  166.                directory, it stands for 'OLD', and essentially
  167.                performs an update operation.  This is extremely useful
  168.                when trying to update old software with new software.
  169.  
  170.           These flags can be overridden by using a command line
  171.           option, or by using the FLAGS keyword to specify new ones.
  172.           Note also that case is not significant.  You can set the
  173.           copyflags variable using Set, SetEnv, or directly from the
  174.           command line if you are using Ash (the Arp Shell) as shown
  175.           below:
  176.  
  177.              Set copyflags=CQ
  178.              SetEnv copyflags=CQ
  179.              copyflags=CQ        ; This only works in ASH
  180.  
  181.           The settings shown above is perhaps the most common: it
  182.           enables copying datestamps, protection bits, and the QUICK
  183.           option.
  184.  
  185.      EXAMPLE
  186.           To perform an update from one directory to another without
  187.           using copyflags, use:
  188.  
  189.           Copy NewDir OldDir FLAGS=O
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/28/89)
  196.  
  197.  
  198.  
  199.