home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ibm1 / ralphson.arj / DATEUTLS / DATECOPY.DOC next >
Encoding:
Text File  |  1991-05-20  |  3.5 KB  |  104 lines
  1.  
  2.        DATECOPY.DOC - Documentation for DateCopy version 1.03  12/05/1991
  3.  
  4.     Documentation and executable code Copyright (c) 1991 Michael E. Ralphson
  5.  
  6.  
  7. Disclaimer:
  8. ===========
  9.  
  10. The Author retains copyright in that he alone has the right to make copies for
  11. profit. In all other respects users may treat this software as if it were in
  12. the Public Domain, as long as the package is distributed whole and unmodified.
  13.  
  14. In my opinion this software is perfectly safe and is free of any serious bugs,
  15. however I have to make it clear that use of this software constitutes the
  16. user's full acknowledgement that the author takes no responsibility WHATSOEVER
  17. for the consequences of such use.
  18.  
  19. Commercial users must register within 30 days if they wish to continue using
  20. this software. For non-commercial users registration is purely voluntary. See
  21. enclosed Register.Txt for more details.
  22.  
  23.  
  24. Introduction:
  25. =============
  26.  
  27. DateCopy is a companion program to DateRen. It copies files that were last
  28. modified on or after a specified date. Optionally you may limit the files
  29. copied to only those date-stamped ON the specified date, those date-stamped on
  30. or BEFORE the specified date, or by omitting any date on the command-line use
  31. the current system date instead.
  32.  
  33. You may also opt to move the files instead of copying them. If the source and
  34. destination directories are on the same logical drive DateCopy will do an
  35. extended RENAME instead of a copy and delete. The word FAST appears by the file
  36. name when this happens.
  37.  
  38. You can also use DateCopy as a general purpose 'Move' utility if you haven't
  39. already got one.
  40.  
  41. DateCopy owes its existence to Mark Cracknell who originally asked for such a
  42. utility and specified how it should work.
  43.  
  44.  
  45. Usage:
  46. ======
  47.  
  48. Basically there are four different combinations of DateCopy operations.
  49.  
  50. 1) DateCopy <filespec> <path>
  51.  
  52. DateCopy will copy all those files matching <filespec> (eg: *.PAS) to the drive
  53. / directory <path> that are date-stamped with the current system date (or
  54. later). If you suspect some of your files have a corrupt (ie future)
  55. date-stamps then specify the /O (only) switch. The above with the /B switch
  56. would be equivalent to the DOS COPY command.
  57.  
  58. 2) DateCopy <filespec> <path> <date>
  59.  
  60. Copies all files date-stamped <date> or AFTER.
  61.  
  62. 3) DateCopy <filespec> <path> <date> /O
  63.  
  64. Copies all files date-stamped <date> ONLY.
  65.  
  66. 4) DateCopy <filespec> <path> <date> /B
  67.  
  68. Copies all files date-stamped <date> or BEFORE.
  69.  
  70. Any of the above could have /M specified, indicating that the files would be
  71. moved instead of copied.
  72.  
  73.  
  74. Other Notes:
  75. ============
  76.  
  77. DateCopy is functional with any date between the first of January 1980 (the
  78. date set on many computers if the battery backed-up clock fails) and the
  79. thirty-first of December 2079.
  80.  
  81. On the command-line when specifying dates always include leading zeroes. For
  82. instance always enter 01JAN91 rather than 1JAN91. This also applies to month
  83. numbers if you use the numeric format, ie: always 010190 rather than 1190!
  84.  
  85. DateCopy only allows you to specify a drive and / or directory to copy the
  86. files to. Unlike DOS Copy you may not use a command such as:
  87.  
  88.  DateCopy *.pas d:\*.bak
  89.  
  90. Remember that DateCopy will not change the file-name in any way.
  91.  
  92.  
  93. Revision History:
  94. =================
  95.  
  96.  1.00  -  Never existed. Date???? utility versions are always the same.
  97.  
  98.  1.01  -  From Mark Cracknell's original specification.
  99.  
  100.  1.02  -  Copies Read-Only files and retains file's original attributes and
  101.       date-time stamp.
  102.  
  103.  1.03  -  /B switch and file moving.
  104.