home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ibm1 / ralphson.arj / DATEUTLS / DATEREN.DOC < prev    next >
Encoding:
Text File  |  1991-07-28  |  4.4 KB  |  140 lines
  1.  
  2.     DATEREN.DOC - Documentation for DateRen 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 information.
  22.  
  23.  
  24. Introduction:
  25. =============
  26.  
  27. DateRen renames files to incorporate the current date. There are other programs
  28. that achieve this, some are American (and thus put the day and month in the
  29. 'wrong' order) and some use the Julian day-of-year number which is a compact
  30. three digit format, but rather difficult for human beings to decipher.
  31.  
  32. DateRen owes its existence to Mark Cracknell who originally asked for such a
  33. utility and specified how it should work.
  34.  
  35.  
  36. Usage:
  37. ======
  38.  
  39. Basically there are four different ways in which DateRen can be used.
  40.  
  41. 1) DateRen <filespec>
  42.  
  43. DateRen will look for files that match <filespec> (which could be a single file
  44. name or a wild-card group such as *.DAT) and rename them in the following way:
  45.  
  46.    NAME.EXT  becomes DDMONYY.EXT
  47.  
  48.    FILES.TXT becomes 28OCT90.TXT if DateRen is run on the 28th of October 1990
  49.  
  50. If a file already exists with the target name, DateRen will append a one-letter
  51. suffix to the main part of the name eg: 28OCT90A.TXT, if this already exists
  52. DateRen tries 28OCT90B.TXT etc etc. In the current version DateRen will stop
  53. processing after it reaches 28OCT90Z.TXT
  54.  
  55. 2) DateRen <filespec> <.extension>
  56.  
  57. DateRen will look for files matching <filespec> as above, but will replace each
  58. file's extension with <.extension>
  59.  
  60.    Assuming a command-line: DateRen Files.Txt .Fls
  61.  
  62.    FILES.TXT becomes 28OCT90.FLS
  63.  
  64. The one-letter suffix is applied as above if the target file already exists.
  65.  
  66. 3) DateRen <filespec> /F
  67.  
  68. DateRen will look for files matching <filespec>, but will replace each file's
  69. extension with the first three letters of the file's original name. Command
  70. line switches may be in upper or lower case.
  71.  
  72.    Assuming a command-line: DateRen Files.Txt /F
  73.  
  74.    FILES.TXT becomes 28OCT90.FIL
  75.  
  76. 4) DateRen <filespec> /S
  77.  
  78. DateRen will look for files matching <filespec>, renaming each to reflect the
  79. last date the file was modified.
  80.  
  81.  
  82. Further Examples:
  83. =================
  84.  
  85. 1) At the end of each working day, a report produced by a program must be
  86.    renamed ready for archiving at the end of the week.
  87.  
  88. Command-line: DateRen Daily.Rep
  89.  
  90. DateRen v1.03 (12/05/91), Copyright (c) 1991 Michael E. Ralphson
  91.  
  92. C:\REPORTS\DAILY.REP -> C:\REPORTS\29OCT90.REP
  93.  
  94.  
  95. 2) A group of related files of different types must be dated, so they can be
  96.    referred to as either *.Ext or DDMONYY*.*
  97.  
  98. Command-line: DateRen Aurora.* .Aur
  99.  
  100. DateRen v1.03 (12/05/91), Copyright (c) 1991 Michael E. Ralphson
  101.  
  102. Using extension .AUR
  103.  
  104. C:\TURBO\AURORA.EXT -> C:\TURBO\29OCT90.AUR
  105. C:\TURBO\AURORA.EXE -> C:\TURBO\29OCT90A.AUR
  106. C:\TURBO\AURORA.CFG -> C:\TURBO\29OCT90B.AUR
  107. C:\TURBO\AURORA.PRO -> C:\TURBO\29OCT90C.AUR
  108. C:\TURBO\AURORA.HLP -> C:\TURBO\29OCT90D.AUR
  109. C:\TURBO\AURORA.FON -> C:\TURBO\29OCT90E.AUR
  110.  
  111.  
  112. 3) A group of files with the same extension must be dated, it must be obvious
  113.    both what the original file was called and when it was created. Used when
  114.    the file-type (the extension) can be safely assumed.
  115.  
  116. Command-line: DateRen *.Acc /F
  117.  
  118. DateRen v1.03 (12/05/91), Copyright (c) 1991 Michael E. Ralphson
  119.  
  120. The extension will be the first three letters of the file name.
  121.  
  122. C:\ACCOUNTS\WALES.ACC -> C:\ACCOUNTS\29OCT90.WAL
  123. C:\ACCOUNTS\ENGLAND.ACC -> C:\ACCOUNTS\29OCT90.ENG
  124. C:\ACCOUNTS\IRELAND.ACC -> C:\ACCOUNTS\29OCT90.IRE
  125. C:\ACCOUNTS\SCOTLAND.ACC -> C:\ACCOUNTS\29OCT90.SCO
  126.  
  127. 4)
  128.  
  129.  
  130. Revision History:
  131. =================
  132.  
  133.  1.00  -  From Mark Cracknell's original specification
  134.  
  135.  1.01  -  Allows wildcards and /F syntax
  136.  
  137.  1.02  -  Internal rewrite. Can rename Read-Only files.
  138.  
  139.  1.03  -  General revision. /S syntax.
  140.