home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 26 / CD_ASCQ_26_1295.iso / vrac / upcsh4.zip / UPCOPY.DOC < prev    next >
Text File  |  1995-07-20  |  12KB  |  241 lines
  1.                ╔════════════════════════════════════════╗
  2.                ║                UPCOPY                  ║
  3.                ║   Author and copyright Lewis Williams  ║
  4.                ║          All rights reserved           ║
  5.                ║   Issue 4.0             Date: 20Jul95  ║
  6.                ╚════════════════════════════════════════╝
  7.  
  8.      UPCOPY is an intelligent copy system - it copies files both ways as
  9.      necessary to make directories identical. It picks out new files, and
  10.      updated files, and chooses the right copy direction. UPCOPY can also
  11.      erase files, ask questions, show file information, and show file
  12.      comparisons. Afterwards you're told if the directories are the same.
  13.  
  14.      UPCOPY has a menu mode well suited to Windows. See UPCWIN.DOC for
  15.      Windows installation instructions. As a simple DOS command:
  16.  
  17.      Useage:    UPCOPY path1 [path2]     (e.g. UPCOPY a:)
  18.  
  19.      The parameters are:
  20.  
  21.        path1         Specifies the first directory or file(s) to be
  22.                      handled.
  23.        path2         Specifies the other directory and/or filename(s).
  24.        /B            Run in DOS batch or command mode
  25.        /C            Only processes common files and ignores new files.
  26.        /D            Differencing. Also asks if you want to compare files
  27.                      when they are different.
  28.        /E            New files not copied can be erased.
  29.        /F            Forward only. Only copies or asks to copy from path1
  30.                      (source) to path2(target). Path1 is not altered.
  31.        /I            Information only. Compares directories without
  32.                      copying.
  33.        /N            Processes new files and ignores common files
  34.        /O            Will ask to overwrite new with old, as well.
  35.        /Q            Quick and quiet. This suppresses a lot of information
  36.                      and does no checks after copying.
  37.        /R            Can overwrite/erase read only files.
  38.        /S            Processes subdirectories (registered version only)
  39.        /W            Run in windowed menu mode (default for no parameters)
  40.        /Y            Automatic mode. No prompts.
  41.  
  42.      You can put the options where you like, and stop UPCOPY any time with
  43.      CTRL+Break or CTRL+C.
  44.  
  45.      The minimal list of files is:
  46.             UPCOPY.EXE - the program
  47.             UPCOPY.DOC - this documentation
  48.             UPCOPY.HLP - help file for windowed mode
  49.      These are optional:
  50.             UPCWIN.DOC - Windows installation instructions for UPCOPY as a
  51.                          non-Windows application
  52.             UPCOPY.REC - Windows recorder macro for installing UPCOPY
  53.             UPCOPY.PIF - Windows Program Information File
  54.             UPCOPY.ICO - Windows icon
  55.             UPCEG.BAT  - batch example creating temporary directories
  56.             DC.BAT     - handy directory-compare batch file using UPCOPY
  57.  
  58.  
  59.  
  60.                                   Page 1 of 4
  61.      These are not copied from the disk or source directory:
  62.             HISTORY.DOC- issue notes showing changes over time
  63.             SURVEY.DOC - feedback questions
  64.             README.BAT - a short introduction
  65.             INSTALL.BAT- just copies to a suitable directory
  66.  
  67.      Examples of Use
  68.      ───────────────
  69.      *   Keeps directories aligned on a home PC, and one at work, using a
  70.          transfer disk.
  71.  
  72.      *   Copies the latest files in both directions to a master disk (or
  73.          network directory), which is shared by a group working together
  74.  
  75.      *   Keeps straightforward backups (or many rotated backups) of a
  76.          directory  - no need to worry about file attributes or
  77.          incremental and absolute backups.
  78.  
  79.      UPCOPY is ideal for use with the Interlnk connection system,
  80.      removable hard disks, and parallel port hard disks.
  81.  
  82.      UPCOPY uses the date and time of the files. It doesn't use the DOS
  83.      archive attribute, and it doesn't check the contents of the files -
  84.      that makes it fast.
  85.  
  86.      Example
  87.      ───────
  88.      Suppose two directories on disk C \temp1 \temp2 contain files as
  89.      follows:UMAIN.C00 is the same in both, UUTL.C00 is newer in \temp2,
  90.      UGLOB.H00 is newer in \temp1, UEXTERN.H00 exists only in \temp1 and
  91.      UDEF.H00 exists only in \temp2.
  92.  
  93.      The command 'upcopy \temp1 \temp2 /y' produces this result:
  94.      UPCOPY 4.0, Shareware Version, (c) 1994-95 L.I.Williams.
  95.          C:\TEMP1\*.*                    ..   C:\TEMP2\*.*
  96.      UMAIN   C00   12k 14Jul95 16:58  ==  UMAIN   C00   12k 14Jul95 16:58
  97.      UUTL    C00   14k 15Jul95 11:51  <=  UUTL    C00   14k 18Jul95 16:08
  98.      ... file C:\TEMP2\UUTL.C00 copied to C:\TEMP1\UUTL.C00
  99.      UEXTERN H00  4561 17Jul95 16:39  =>  ... New file, no version here
  100.      ... file C:\TEMP1\UEXTERN.H00 copied to C:\TEMP2\UEXTERN.H00
  101.      UGLOB   H00  8401 18Jul95 16:07  =>  UGLOB   H00  8401 18Jul95 14:50
  102.      ... file C:\TEMP1\UGLOB.H00 copied to C:\TEMP2\UGLOB.H00
  103.      ... New file, no version here    <=  UDEF    H00  3431 17Jul95 16:49
  104.      ... file C:\TEMP2\UDEF.H00 copied to C:\TEMP1\UDEF.H00
  105.      Checking result ...
  106.      File(s) specified are now the same
  107.  
  108.      Both directories are now identical and up-to-date. Just to confirm
  109.      this if we now type 'upcopy \temp1 \temp2 /i' we get:
  110.  
  111.      UPCOPY 4.0, Shareware Version, (c) 1994-95 L.I.Williams.
  112.          C:\TEMP1\*.*                    ..   C:\TEMP2\*.*
  113.      UMAIN   C00   12k 14Jul95 16:58  ==  UMAIN   C00   12k 14Jul95 16:58
  114.      UUTL    C00   14k 18Jul95 16:08  ==  UUTL    C00   14k 18Jul95 16:08
  115.      UDEF    H00  3431 17Jul95 16:49  ==  UDEF    H00  3431 17Jul95 16:49
  116.      UEXTERN H00  4561 17Jul95 16:39  ==  UEXTERN H00  4561 17Jul95 16:39
  117.      UGLOB   H00  8401 18Jul95 16:07  ==  UGLOB   H00  8401 18Jul95 16:07
  118.      File(s) specified are the same
  119.  
  120.                                   Page 2 of 4
  121.      Restrictions
  122.      ────────────
  123.      UPCOPY cannot rename files as it copies. A hard disk is desirable.
  124.      Specifically, 'UPCOPY' will not do file compares and ignores /C if
  125.      there is no access to the DOS 'FC' program. Also help is restricted
  126.      if there is no access to the DOS 'MORE' program, or no access to this
  127.      file 'UPCOPY.DOC'.
  128.  
  129.      Hints
  130.      ─────
  131.      You need to keep the clock on your PC about right, especially if you
  132.      use UPCOPY to move files between PC's. If you put the PC clock back
  133.      an hour during the working day you can make a new file version look
  134.      old, so it's best to change the clock first thing in the morning, and
  135.      keep all PC's on the same time.
  136.  
  137.      /f/y/o/e/q is a handy combination for quick simple copying. It will
  138.      quickly make the target a copy of the source overwriting differences
  139.      and erasing additional files, but without re-copying files that are
  140.      already up-to-date.
  141.  
  142.      Your Questions Answered
  143.      ───────────────────────
  144.      What is UPCOPY for? What's wrong with just copying files like I've
  145.      always done? - 1) You never find out if it was necessary 2) You may
  146.      overwrite new with old 3) You can't get rid of new files (often junk)
  147.      4) The files aren't copied both ways 5) You make new copies of files
  148.      that are already up-to-date and fragment your disk, wasting time.
  149.  
  150.      Can I update a whole disk or directory structure? - When you register
  151.      UPCOPY (only £10 or $15) you will receive the professional version
  152.      that includes the bonus /s option which does this automatically. With
  153.      the shareware version you must specify the individual sub-
  154.      directories.
  155.  
  156.      I already use backup software. Can I use UPCOPY too? - Yes. In
  157.      general you have to be careful with mixing backup systems because
  158.      they may assume exclusive use of a thing called the 'archive
  159.      attribute' for a file, (which marks whether or not a file should be
  160.      backed up.) Because UPCOPY uses only the date and time of a file it
  161.      does not suffer from this problem, or affect other backup systems.
  162.      UPCOPY works like normal copying, the new copy has its archive
  163.      attribute set so that it will be backed up by any other system).
  164.  
  165.      How safe is UPCOPY? - It's very safe, especially when you don't set
  166.      any of the options. This is  because differences only trigger
  167.      questions. You can use UPCOPY very occasionally without worrying that
  168.      you'll forget what to do, or what it does.
  169.  
  170.      What happens with newly created files? -  For UPCOPY 'new' means an
  171.      additional file that exists in one directory, but not the other. The
  172.      objective is to make the directories the same. So with /E if you
  173.      don't want to copy the file it will ask you if you want to erase it.
  174.      You can set /E/F/Y to erase unwanted new files in the target
  175.      directory automatically, /C if you want to update just the common
  176.      files and ignore all new additional files, or /F if you want to copy
  177.      new files only from the source to the target.
  178.  
  179.  
  180.                                   Page 3 of 4
  181.      What happens if I've altered more than one copy of a file? -
  182.      Basically the newest one wins. If you register UPCOPY you'll get
  183.      UNITE, which will merge two ASCII files highlighting the differences
  184.      (disaster recovery you might say).
  185.  
  186.      When is a file updated? - Copying a file or changing its attributes
  187.      doesn't update a file. Essentially a newer version has to be made.
  188.      (Often major applications update their data files every time they
  189.      run.)
  190.  
  191.      What about attributes - system, hidden and read-only? - System and
  192.      hidden files are ignored and not copied. Normally UPCOPY will not
  193.      overwrite or even ask to overwrite read-only files (you'll get an
  194.      informative message). If you specify /R then any read-only attributes
  195.      will be ignored and the file can be updated. A copy of a read-only
  196.      file is not read-only (this is the DOS convention).
  197.  
  198.      How can I make UPCOPY not copy a file? Use the DOS attrib command to
  199.      make it system or hidden or the target read-only, that's  one way.
  200.      Another is to post-date the target file - set a future date on your
  201.      PC and type 'COPY FILE.EXT+,,'.
  202.  
  203.      What is shareware? - Try before buy. Make as many copies as you like
  204.      and pass them on. The price you've paid, if any, is just for
  205.      distribution. You should register your use of UPCOPY, get the /s
  206.      option and lose the annoying reminders.
  207.  
  208.      Coming Soon
  209.      ───────────
  210.      I am planning a MIRAGE option. MIRAGE will make a dummy file entry in
  211.      the target - a correctly dated empty file. That way you can make an
  212.      initial directory copy of a 500MB disk on a single floppy. Then
  213.      standard UPCOPY will add just your application files as you change
  214.      them. Beat that with file compression! I also hope to do a full
  215.      Windows version of UPCOPY. If you're interested register mentioning
  216.      your requirement - advance supporters will get their upgrade FREE.
  217.  
  218.      Registration and Support
  219.      ────────────────────────
  220.      UPCOPY is shareware. Registration brings the bonus '/s' option to
  221.      update entire disks and directory trees. To register GO SWREG on
  222.      Compuserve, or send £10/$15 to: Lewis Williams, Cybernetic Software,
  223.      29a Hannams Close, Lytchett Matravers, Poole, Dorset, BH16 6DN, UK.
  224.      E-mail 100103.2675@compuserve.com. Tel/fax +44 1202 623363. Price
  225.      includes e-mail despatch worldwide. You can also introduce UPCOPY to
  226.      a shareware repository (or get it mentioned in a magazine), and apply
  227.      for your FREE registered copy!
  228.  
  229.      If you require a disk (which comes with a photocopy of this manual),
  230.      please add £2/$3 postage and packing.
  231.  
  232.      THE END
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                   Page 4 of 4
  241.