home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / datestmp / dsutil.lbr / SETD22.DZC / SETD22.DOC
Text File  |  1988-08-29  |  4KB  |  103 lines
  1.  
  2.  
  3.  
  4.                 SETD 2.2
  5.             A Library Date-Stamping Utility
  6.             Copyright 1988, Brent B. Powers
  7.  
  8.  
  9. COPYRIGHT NOTICE: I have  not  released,  nor  do  I  intend  to 
  10. release,  this  program  to the public domain.  However, you are 
  11. free to use this program in any way you deem, provided no fee is 
  12. attached   to   its  distribution  or  transfer,  and  any  such 
  13. distribution includes this documentation file in  its  entirety.  
  14. This  explicitly  bars  selling  this program on a disk, with or 
  15. without other programs on the disk, and charging for  the  disk, 
  16. nor  may this program be downloaded from a BBS which charges for 
  17. access.  Although purveyors of such services have every right to 
  18. operate  in  such  a manner, I personally feel it is contrary to 
  19. the spirit which has  allowed  CP/M  to  survive  for  9  years.  
  20. Furthermore,  if  anyone is going to make money from this modest 
  21. utility, it ought to be me.
  22.  
  23.  
  24.     That said, this program is actually intended as a  companion 
  25. to  Steven Greenberg's LDIR-B.  It allows the individual members 
  26. of a library to be dated, separately or in common, in  a  manner 
  27. that LDIR-B can detect.
  28.  
  29.     Usage  is  simple,  and  a  short  summary  of  usage can be 
  30. obtained by simply  running  the  program  with  no  parameters.  
  31. However, that will not give a full list of options.
  32.  
  33.     The basic form of the command is
  34.    
  35. SETD LIBRARY[.EXT] [[A]MM/DD/YY|[E]DD/MM/YY] [member] [/[O|U]]
  36.     
  37.     LIBRARY  is  required, and indicates the name of the library 
  38. to be updated.  The extension is optional and of no consequence; 
  39. SETD assumes an extension of .LBR.  Wildcards are not allowed.
  40.  
  41.     The date may or  may  not  be  optional,  depending  on  the 
  42. installation   (which  see).   The  program  is  distributed  in 
  43. American date mode (i.e., MM/DD/YY), however, a one  byte  patch 
  44. to  the  program  will result in a default of European date mode 
  45. (i.e., DD/MM/YY).  If American dates are the default, a European 
  46. date  may  be  entered  by prefacing it with an E; similarly, if 
  47. European dates are the default, an American date may be  entered 
  48. by prefacing it with an A.
  49.  
  50.     The membername is optional, and specifies which  members  of 
  51. the library to update. Wildcards are permitted.  No entry at all 
  52. is equivalent to *.*.
  53.  
  54.     In the program's default distribution, it  will  only  alter 
  55. library  members  which  are  not  already  dated.   This may be 
  56. circumvented by giving the /O parameter (for  Overwrite),  which 
  57. will  cause  all  matching members to be updated, whether or not 
  58. they have been previously dated.  If patched so that /O  is  the 
  59. default,  /U  (Update)  will  cause  only  undated members to be 
  60. updated.
  61.  
  62.     Those with an operating system that supports a  re-execution 
  63. command  (e.g.  GO) will be pleased to know that SETD.COM may be 
  64. reexecuted at will.
  65.  
  66. INSTALLATION:    If your computer does not have a clock, there 
  67. are only two patches which you need worry about.  These are:
  68.  
  69.     103H:    EUROMODE:   Zero (default)  for  American  style 
  70.                 dates, 0FFH for European style dates.
  71.  
  72.     104H:    OVERWRMODE: Zero (default) for overwrite only by 
  73.                 /O,  0FFH  for  overwrite  mode   as 
  74.                 default.
  75.  
  76.  
  77.     If your computer does have a clock, you may code  a  routine 
  78. to  access  the clock.  If this is done, the date on the command 
  79. line becomes optional.  If a date is entered, it  will  override 
  80. the  system  date.  For details of where this routine should go, 
  81. and what it should do, please see SETDCPM3.ASM.
  82.  
  83.  
  84. ACKNOWLEDGEMENTS:    Irv Hoff asked me  to  do  the  original 
  85. version  of this program, which was simply a translation of C.B. 
  86. Falconer's  LSETDATE.   We  must  always  acknowledge  Gary   P. 
  87. Novosielski  for originating the LBR structure.  Finally, thanks 
  88. to Steven Greenberg for LDIR-B.
  89.  
  90.                     Brent B. Powers
  91.                     10 Feb, 1988
  92.  
  93. Versions:    Version 2.2 has additional bug fixes, thanks  to 
  94. Steven  Greenberg's  assistance.   Verson 2.1 had a problem with 
  95. the cpm3 overlay file fixed (actually, it just disappeared), and 
  96. also  a  problem  with  small  libraries  (less than 4 members).  
  97. Version 2.0 was the original assembly language version,  recoded 
  98. from   the   TurboPascal  version,  in  turn  recoded  from  the 
  99. TurboModula-2 version, which was, finally, a translation of C.B. 
  100. Falconer's  LSETDATE,  with  a  slightly  different date-parsing 
  101. algorithm.
  102.  
  103.