home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ibm1 / ralphson.arj / DATEUTLS / DATEFILE.DOC < prev    next >
Encoding:
Text File  |  1991-08-05  |  2.9 KB  |  88 lines
  1.  
  2.        DATEFILE.DOC - Documentation for DateFile version 1.03  05/08/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 information.
  22.  
  23.  
  24. Introduction:
  25. =============
  26.  
  27. DateFile is a companion program to DateCopy and DateRen. It alters the last
  28. modified-on stamp (the date-time stamp) of files quickly and easily.
  29.  
  30. DateFile owes its existence to Mark Cracknell who originally asked for such a
  31. utility and specified how it should work.
  32.  
  33.  
  34. Usage:
  35. ======
  36.  
  37. Basically there are four different combinations of DateFile operations.
  38.  
  39. 1) DateFile <filespec>
  40.  
  41. DateFile will 're-touch' all those files covered by <filespec> (eg: *.*) with
  42. the current system date and time.
  43.  
  44. 2) DateFile <filespec> <date>
  45.  
  46. As above, but the date is as specified and the time is 00:00:00 (which does not
  47. show up in DIRectory listings under most versions of DOS).
  48.  
  49. 3) DateFile <filespec> <date> <time>
  50.  
  51. As above, but the time-stamp is as specified in the command-line.
  52.  
  53. 4) DateFile <filespec> today <time>
  54.  
  55. Mainly for batch files. The date-stamp is set to the current system date, while
  56. the time-stamp is set to that specified in the command-line. This might be used
  57. to indicate a version number, eg:
  58.  
  59. DateFile c:\release\*.* today 0100
  60.  
  61. Would stamp all the files in the directory C:\RELEASE with today's date and
  62. 1:00 as the time-stamp (indicating version 1.00).
  63.  
  64.  
  65. Other Notes:
  66. ============
  67.  
  68. DateFile is functional with any date between the first of January 1980 (the
  69. date set on many computers if the battery backed-up clock fails) and the
  70. thirty-first of December 2079.
  71.  
  72. On the command-line when specifying dates always include leading zeroes. For
  73. instance always enter 01JAN91 rather than 1JAN91. This also applies to month
  74. numbers if you use the numeric format, ie: always 010190 rather than 1190!
  75.  
  76. The format for specified <time> is always 24-hour clock (military) either HHMM
  77. or HHMMSS if you wish to specify seconds.
  78.  
  79.  
  80. Revision History:
  81. =================
  82.  
  83.  1.01  -  Never existed. Date-Utility versions are always the same.
  84.  
  85.  1.02  -  From Mark Cracknell's original specification.
  86.  
  87.  1.03  -  General revision, display new stamp.
  88.