home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / datestmp / ds-util1.lbr / -READ.MZ / -READ.ME
Text File  |  1988-04-04  |  7KB  |  174 lines
  1. -READ.ME
  2.  
  3. DS-UTIL1.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. PPIP.COM and SETD22.COM have their doc
  25. files included separately. Anyone who wishes to add to or expand on 
  26. this doc file should feel free to do so.
  27.  
  28.                     Howard Schwartz
  29.                                 St. Louis KUG
  30.                     April 3, 1988                                      
  31.  
  32. --SAP
  33.  
  34. Included are two versions of SAP (Sort-and Pack) that work with 
  35. DateStamper, SAP54 and SAP 60.  SAP is a member of a family of programs 
  36. that sort and pack the directory so that when you type CP/M's DIR command, 
  37. it willdisplay the directory sorted in alphabetical order.
  38.  
  39. The difference between SAP54 and SAP60 and other such programs in the 
  40. public domainis that after SAP54 sorts the directory, it then sorts the 
  41. !!!TIME&.DATfile.  This way the directory entries still match their time 
  42. and date information in the !!!TIME&.DAT file.  
  43.  
  44. To use SAP54, type SAP54<CR> and then specify which drive you want to have
  45. sorted -- that is all there is to it.
  46.  
  47. The difference between SAP54 and SAP60 is that SAP54 lists any existing
  48. 0 length files and asks if you wish to delete them. SAP60 simply sorts
  49. these files along with the rest. Note that both versions of SAP sort
  50. all user areas on an individual drive.
  51.  
  52.  
  53. -- TOUCH
  54.  
  55. Usage: TOUCH FILENAME.TYP<CR>
  56.  
  57. Touch updates the modified date field in the !!!TIME&.DAT file for the
  58. filename given by the user.  It does NOT take wildcards.  If you want to
  59. set the modified dates (or any of the other date fields) for several files,
  60. you should use the 'D' option in DATSWEEP instead.
  61.  
  62.  
  63. -- APPEND
  64.  
  65. Usage: APPEND filename.typ filename.typ filename.typ destination file.
  66.  
  67. This program is similar to using PIP to concatenate files, but there are
  68. some differences that you should bear in mind:
  69.  
  70. 1. The file that you are appending TO is placed at the END of the command
  71. line (note the example above).  
  72.  
  73. 2. It is not an interactive program -- it only accepts arguments on the
  74. command line.  Typing APPEND<CR> will display APPEND's built-in help
  75. screen.  
  76.  
  77. 3. APPEND does not support ambiguous filenames (filenames with wildcards in
  78. them).
  79.  
  80. 4. APPEND places the time and date that the appending was done between each
  81. filename (thus letting you know when you combined the various files)
  82.  
  83.  
  84. --SDD
  85.  
  86. SDD is Plu*Perfect's public domain reworking of the famous SD.COM
  87. program that sorts a directory. SDD shows the time and date a file
  88. was created, last accessed and modified. The most recent version
  89. of SDD.COM is SDD301.COM, which works with Bridger Mitchell's
  90. fine DOSDISK program. This latest version is included here.
  91.  
  92.  
  93. --LBREXT26
  94.  
  95. This program extracts files from a library (including the use of
  96. wildcards) and retains the date and time stamp.
  97.  
  98.  
  99. --TESTCLK
  100.  
  101. Tests for the presence of a working clock and shows the day, month,
  102. year, hour, minute and second.
  103.  
  104.  
  105. --MAKE 
  106.  
  107. MAKE is a utility inspired by the Unix(tm) command of the same
  108. name.  MAKE helps maintain programs that are constructed from
  109. many files.  MAKE processes a "makefile", a file which describes
  110. how to build a program from its source files, and produces a
  111. script file containing the commands necessary to recompile the
  112. program.
  113.  
  114. MAKE is especially useful for keeping a complex, evolving program
  115. up to date as its components are revised.  MAKE can automatically
  116. execute the script to create an updated COM file when one or more
  117. of its components is changed.  Using DateStamper's automatic file
  118. datestamping, MAKE causes only those files that depend on the
  119. more recent file to be recreated (compiled/assembled/linked or
  120. whatever).
  121.  
  122. MAKE includes options to list the steps it would follow in order
  123. to rebuild the program, to assume that all files are obsolete and
  124. recompile everything, and to automatically invoke a batch
  125. processor to run the command script that does the rebuilding.
  126.  
  127. A makefile is a list of dependencies.  A dependency consists of
  128. a root name, a colon, and zero or more names of dependent files.
  129. For instance, in:
  130.  
  131.     make.com : #H make.crl file.crl macro.crl osdate.crl
  132.     parsedir.crl token.crl alloc.crl makelib.crl 
  133.  
  134.  
  135. the file 'make.com' depends on 9 other files (including the one
  136. specified by the macro #H).
  137.  
  138. Any number of 'method' lines may follow a dependency.  Method lines
  139. begin with an ascii tab.  When a file is to be recompiled, MAKE
  140. copies these method lines (minus the tab) to the script file.
  141. For example, in:
  142.  
  143.     make.com : #H make.crl file.crl macro.crl osdate.crl
  144.     parsedir.crl token.crl alloc.crl makelib.crl 
  145.         clink make file macro osdate parsedir
  146. token alloc -f makelib -n
  147.  
  148. the two lines following the dependency make up the method for
  149. re-linking the file 'make.com'.
  150.  
  151. Other features include macro capability and pre- and post-processing
  152. macros.
  153.  
  154. Requirements:
  155.     CP/M 2.2(tm)
  156.     DateStamper(tm)
  157.  
  158. Source code:
  159.     bds-c v 1.50a and ASM/CSM
  160.  
  161.  
  162. Be careful: this MAKE is NOT compatible with Unix(tm) MAKE!  The
  163. program name conflicts with an older CP/M program with the same
  164. name that changes the user number of a (set of) files.  You may
  165. want to rename that program MAKEUSER.
  166.  
  167.  
  168. Authors:
  169.         Neil Maron - CP/M version
  170.     Landon Dyer - original MSDOS version
  171.     Bridger Mitchell - DateStamper assistance
  172. Authors:
  173.         Neil Maron - CP/M version
  174.     Landon Dyer - original MSDOS versi