home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / CLRUN.ZIP / CLRUN.DOC < prev    next >
Encoding:
Text File  |  1987-02-04  |  2.8 KB  |  62 lines
  1. CLrun  - Clipper developement system           Another Beggarware product
  2.  
  3. For anyone who has been developing complex, multi-prg systems, it is
  4. evident that much time can be wasted if clipper is invoked using the simple:
  5.  
  6. 'CLIPPER <filename>'
  7.  
  8. approach.  This method will compile the <filename> given, plus all .prgs
  9. referenced within this program, which is especially wasteful when only one
  10. program was actually changed.
  11.  
  12. Of course, each .prg can be compiled separately (with the -l option) into
  13. a separate .obj file, which is linked with all others at plink-time.  This
  14. requires a .lnk file with all .obj files needed and reduces developement
  15. time by a factor of whatever.  However, and this is where CLrun is handy,
  16. when many .prgs have been modified and compile time rolls around, how much
  17. time have YOU wasted trying to remember which files were modified?
  18.  
  19. One need only look at the date-time stamp for the .prg to find all modified
  20. .prgs, given a date-time prior to all revisions.  This is all CLrun does,
  21. basically, as shown below:
  22.  
  23. a)  CLrun is executed
  24. b)  generates a .dbf and copies all .prg files in the directory to it
  25. c)  restores a previosly stored date-time of its last use
  26. d)  file by file comparison of date-time stamps for compile requirements
  27. e)  compiles the files which were changed
  28. f)  stores new date-time stamp for next run
  29. g)  exits
  30.  
  31. NOTES: All .prgs in the directory, and only the default directory  are
  32.        scanned for changes, therefore a single directory should be used
  33.        (or change the source code for CLrun).
  34.  
  35.        A batch can be used to invoke CLrun and subsequently plink86 to
  36.        complete the process.
  37.  
  38.        The source code and support .obj files are included herein and
  39.        require compiling and plinking themselves.  PCL.bat is included
  40.        to compile and link CLrun.  CL.bat is included as a sample batch
  41.        to invoke CLrun and PLINK86 when needed (this sample uses SETRAM
  42.        as the ram disk, this must be changed or removed if other than
  43.        SETRAM is used - this speeds up the compiler load-time, but can
  44.        be removed if not enough ram is available)
  45.  
  46. Below are the files included and brief description of each:
  47.  
  48. Name             Description
  49. =========        =========================
  50. CL.BAT           sample batch routine to invoke CLrun and plink86
  51. CLRUN.LNK        .lnk file used by PCL.bat to plink86 CLrun
  52. CLRUN.OBJ        .obj CLrun ready to link, or
  53. CLRUN.PRG        .prg source code if revisions are needed
  54. EXTA.OBJ         assembler extension for CLrun
  55. EXTC.OBJ         c extension for CLrun
  56. PCL.BAT          batch to compile and plink CLrun
  57.  
  58. Finally, this setup was the result of a need I had, and hopefully will be
  59. handy for others in this predicament.  Don't send any money, I never do.
  60.  
  61. brad birth
  62.