home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / asmutl / make-ds.lbr / MAKE.SQM / MAKE.SUM
Encoding:
Text File  |  1986-09-05  |  2.5 KB  |  70 lines

  1.           MAKE - for CP/M 2.2 with DateStamper
  2.  
  3. MAKE is a utility inspired by the Unix(tm) command of the same
  4. name.  MAKE helps maintain programs that are constructed from
  5. many files.  MAKE processes a "makefile", a file which describes
  6. how to build a program from its source files, and produces a
  7. script file containing the commands necessary to recompile the
  8. program.
  9.  
  10. MAKE is especially useful for keeping a complex, evolving program
  11. up to date as its components are revised.  MAKE can automatically
  12. execute the script to create an updated COM file when one or more
  13. of its components is changed.  Using DateStamper's automatic file
  14. datestamping, MAKE causes only those files that depend on the
  15. more recent file to be recreated (compiled/assembled/linked or
  16. whatever).
  17.  
  18. MAKE includes options to list the steps it would follow in order
  19. to rebuild the program, to assume that all files are obsolete and
  20. recompile everything, and to automatically invoke a batch
  21. processor to run the command script that does the rebuilding.
  22.  
  23. A makefile is a list of dependencies.  A dependency consists of
  24. a root name, a colon, and zero or more names of dependent files.
  25. For instance, in:
  26.  
  27.     make.com : #H make.crl file.crl macro.crl osdate.crl
  28.     parsedir.crl token.crl alloc.crl makelib.crl 
  29.  
  30.  
  31. the file 'make.com' depends on 9 other files (including the one
  32. specified by the macro #H).
  33.  
  34. Any number of 'method' lines may follow a dependency.  Method lines
  35. begin with an ascii tab.  When a file is to be recompiled, MAKE
  36. copies these method lines (minus the tab) to the script file.
  37. For example, in:
  38.  
  39.     make.com : #H make.crl file.crl macro.crl osdate.crl
  40.     parsedir.crl token.crl alloc.crl makelib.crl 
  41.         clink make file macro osdate parsedir
  42. token alloc -f makelib -n
  43.  
  44. the two lines following the dependency make up the method for
  45. re-linking the file 'make.com'.
  46.  
  47. Other features include macro capability and pre- and post-processing
  48. macros.
  49.  
  50. Requirements:
  51.     CP/M 2.2(tm)
  52.     DateStamper(tm)
  53.  
  54. Source code:
  55.     bds-c v 1.50a and ASM/CSM
  56.  
  57.  
  58. Be careful: this MAKE is NOT compatible with Unix(tm) MAKE!  The
  59. program name conflicts with an older CP/M program with the same
  60. name that changes the user number of a (set of) files.  You may
  61. want to rename that program MAKEUSER.
  62.  
  63.  
  64. Authors:
  65.         Neil Maron - CP/M version
  66.     Landon Dyer - original MSDOS version
  67.     Bridger Mitchell - DateStamper assistance
  68. f 'method' lines may follow a dependency.  Method lines
  69. begin with an ascii tab.  When a file is to be recompiled, MAKE
  70. c