home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / datestmp / dsutil.lbr / -READ.MZ / -READ.ME
Text File  |  1988-08-29  |  9KB  |  206 lines
  1. -READ.ME
  2.  
  3. DS-UTIL2.LBR
  4. PUBLIC DOMAIN DATESTAMPER UTILITIES
  5.  
  6. This library includes a variety of NON-ZCPR3 utilities that work with
  7. Datestamper. (Some of them also work with ZCPR3, but they are included
  8. here because they work with CP/M 2.2 or ZCPR1 or ZCPR2, among other
  9. operating systems. There are a large number of ZCPR3-specific utilties
  10. for Datestamper that are not included here.) These utilities were
  11. found scattered widely on various RCPMs, some in fairly obscure places.
  12. Putting them in one library is for the convenience of those who do
  13. not have the resources to hunt them down individually. All of these
  14. programs are in the public domain. Some of them were included on the
  15. Plu*Perfect public domain Datestamper Toolkit disk; others were not.
  16. The recent demise of the Plu*Perfect bulletin board makes the need
  17. for this library even more pressing. Some very large programs that
  18. have been adapted for Datestamper, such as MCAT and XCAT have not
  19. been included here but are available on the Datestamper Toolkit disk
  20. from Plu*Perfect. Those who write or discover additional public domain
  21. programs that work with Datestamper (of the non-ZCPR3 variety) are
  22. encouraged to add them to this library and change the version number
  23. appropriately. There follows brief doc files, as available, on some
  24. of the utilities included. SETD22.COM has its doc files included 
  25. separately. Anyone who wishes to add to or expand on this doc file or
  26. library should feel free to do so. Note that this library has been
  27. updated to include the latest version of PPIP set for non-ZCPR
  28. Datestamper, and two Turbo Pascal routines, DSCALL.INC and SDTIME.PRN.
  29. Note also that the author of ARK03.ARK has promised Datestamper
  30. compatibility in the forthcoming version.
  31.  
  32.                     Howard Schwartz
  33.                     August 8, 1988                                      
  34.  
  35. --SAP
  36.  
  37. Included are two versions of SAP (Sort-and Pack) that work with 
  38. DateStamper, SAP54 and SAP 60.  SAP is a member of a family of programs 
  39. that sort and pack the directory so that when you type CP/M's DIR command, 
  40. it willdisplay the directory sorted in alphabetical order.
  41.  
  42. The difference between SAP54 and SAP60 and other such programs in the 
  43. public domainis that after SAP54 sorts the directory, it then sorts the 
  44. !!!TIME&.DATfile.  This way the directory entries still match their time 
  45. and date information in the !!!TIME&.DAT file.  
  46.  
  47. To use SAP54, type SAP54<CR> and then specify which drive you want to have
  48. sorted -- that is all there is to it.
  49.  
  50. The difference between SAP54 and SAP60 is that SAP54 lists any existing
  51. 0 length files and asks if you wish to delete them. SAP60 simply sorts
  52. these files along with the rest. Note that both versions of SAP sort
  53. all user areas on an individual drive.
  54.  
  55.  
  56. -- TOUCH
  57.  
  58. Usage: TOUCH FILENAME.TYP<CR>
  59.  
  60. Touch updates the modified date field in the !!!TIME&.DAT file for the
  61. filename given by the user.  It does NOT take wildcards.  If you want to
  62. set the modified dates (or any of the other date fields) for several files,
  63. you should use the 'D' option in DATSWEEP instead.
  64.  
  65.  
  66. -- APPEND
  67.  
  68. Usage: APPEND filename.typ filename.typ filename.typ destination file.
  69.  
  70. This program is similar to using PIP to concatenate files, but there are
  71. some differences that you should bear in mind:
  72.  
  73. 1. The file that you are appending TO is placed at the END of the command
  74. line (note the example above).  
  75.  
  76. 2. It is not an interactive program -- it only accepts arguments on the
  77. command line.  Typing APPEND<CR> will display APPEND's built-in help
  78. screen.  
  79.  
  80. 3. APPEND does not support ambiguous filenames (filenames with wildcards in
  81. them).
  82.  
  83. 4. APPEND places the time and date that the appending was done between each
  84. filename (thus letting you know when you combined the various files)
  85.  
  86.  
  87. --SDD
  88.  
  89. SDD is Plu*Perfect's public domain reworking of the famous SD.COM
  90. program that sorts a directory. SDD shows the time and date a file
  91. was created, last accessed and modified. The most recent version
  92. of SDD.COM is SDD301.COM, which works with Bridger Mitchell's
  93. fine DOSDISK program. This latest version is included here.
  94.  
  95.  
  96. --LBREXT26
  97.  
  98. This program extracts files from a library (including the use of
  99. wildcards) and retains the date and time stamp.
  100.  
  101.  
  102. --TESTCLK
  103.  
  104. Tests for the presence of a working clock and shows the day, month,
  105. year, hour, minute and second.
  106.  
  107.  
  108. --MAKE 
  109.  
  110. MAKE is a utility inspired by the Unix(tm) command of the same
  111. name.  MAKE helps maintain programs that are constructed from
  112. many files.  MAKE processes a "makefile", a file which describes
  113. how to build a program from its source files, and produces a
  114. script file containing the commands necessary to recompile the
  115. program.
  116.  
  117. MAKE is especially useful for keeping a complex, evolving program
  118. up to date as its components are revised.  MAKE can automatically
  119. execute the script to create an updated COM file when one or more
  120. of its components is changed.  Using DateStamper's automatic file
  121. datestamping, MAKE causes only those files that depend on the
  122. more recent file to be recreated (compiled/assembled/linked or
  123. whatever).
  124.  
  125. MAKE includes options to list the steps it would follow in order
  126. to rebuild the program, to assume that all files are obsolete and
  127. recompile everything, and to automatically invoke a batch
  128. processor to run the command script that does the rebuilding.
  129.  
  130. A makefile is a list of dependencies.  A dependency consists of
  131. a root name, a colon, and zero or more names of dependent files.
  132. For instance, in:
  133.  
  134.     make.com : #H make.crl file.crl macro.crl osdate.crl
  135.     parsedir.crl token.crl alloc.crl makelib.crl 
  136.  
  137.  
  138. the file 'make.com' depends on 9 other files (including the one
  139. specified by the macro #H).
  140.  
  141. Any number of 'method' lines may follow a dependency.  Method lines
  142. begin with an ascii tab.  When a file is to be recompiled, MAKE
  143. copies these method lines (minus the tab) to the script file.
  144. For example, in:
  145.  
  146.     make.com : #H make.crl file.crl macro.crl osdate.crl
  147.     parsedir.crl token.crl alloc.crl makelib.crl 
  148.         clink make file macro osdate parsedir
  149. token alloc -f makelib -n
  150.  
  151. the two lines following the dependency make up the method for
  152. re-linking the file 'make.com'.
  153.  
  154. Other features include macro capability and pre- and post-processing
  155. macros.
  156.  
  157. Requirements:
  158.     CP/M 2.2(tm)
  159.     DateStamper(tm)
  160.  
  161. Source code:
  162.     bds-c v 1.50a and ASM/CSM
  163.  
  164.  
  165. Be careful: this MAKE is NOT compatible with Unix(tm) MAKE!  The
  166. program name conflicts with an older CP/M program with the same
  167. name that changes the user number of a (set of) files.  You may
  168. want to rename that program MAKEUSER.
  169.  
  170.  
  171. Authors:
  172.         Neil Maron - CP/M version
  173.     Landon Dyer - original MSDOS version
  174.     Bridger Mitchell - DateStamper assistance
  175.  
  176. --PPIP17DS.COM
  177.  
  178. This is a compiled version of PPIP173.COM with the DateStamper                 
  179. option turned on and the ZCPR option turned off. Verify is also                
  180. off. The PPIP173.LBR includes a compiled version with DateStamper              
  181. turned on along with ZCPR, which will only run on ZCPR3 and above              
  182. systems and a compiled version for generic CP/M with DateStamper               
  183. turned off. This is the one major missing version. Note that                   
  184. PPIP now includes the option to move a file, i.e. to erase the                 
  185. original copy after it has been copied. It is /M. For additional
  186. information, see PPIP173.LBR or PPIP18.LBR. The latter adds 
  187. only Z80DOS compatibility and is unchanged in regard to 
  188. Datestamper.                                                                               
  189.                                                                                
  190.                                                                                
  191.                                                                                
  192.                                                                                
  193.                                                                                
  194.                                                                                
  195.                                                                                
  196.                                                                                
  197.                                                                                
  198.                                                                                
  199.                                                                                
  200.                                                                                
  201.                                                                                
  202.                                                                                
  203.                                                                                
  204.                                                                                
  205.                                                                                
  206.