home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 144.lha / do.doc < prev    next >
Text File  |  1986-11-21  |  2KB  |  112 lines
  1.               COPYRIGHT 1988 by Steve Collins
  2.  
  3. This is the Documentaion for DO  rev 1.1 
  4.  
  5.  
  6. DO was written to avoid having to fool around with MAKEfiles for
  7.  
  8. simple one-file C programs, but it has a wide variety of other potential
  9.  
  10. uses.  DO reads a special-format C comment (see below)
  11.  
  12. and EXECUTES as if it were an AmigaDos batch file.  The comment can 
  13.  
  14. contain those compiler and linker commands that you spend so much time
  15.  
  16. typing:
  17.  
  18.  
  19. cc -n hello 
  20. ln -g hello -lc -lm
  21.  
  22.  
  23. This allows you to put compiler options, linker options and libraries 
  24.  
  25. right in the sourcefile (where they belong).  But that's not all.
  26.  
  27. The comment can contain any valid AmigaDOS batchfile command, so you
  28.  
  29. could do somthing like:
  30.  
  31.  
  32.  
  33. echo "Go get some sleep while I print and compile this for you..."
  34. type hello.c to PRT:        
  35. cc -n hello.c
  36. ln -g hello.o -lc
  37. copy hello to df0:test
  38. say "Get back in here! I am done compiling your stupid code!"
  39.  
  40.  
  41. DO should work with MANX, LATTICE or ANY other C compiler.
  42.  
  43.  
  44. DO reads a 'C' sourcefile and looks for the first multi-line comment  
  45. in this format:
  46.  
  47.  
  48.  
  49.  
  50.  
  51. /*DO:                (DO ignores anything you put here)
  52.  
  53. echo "this is a test"
  54. echo "of the DO utility"
  55.  
  56. */                   (DO ignores this too but your C compiler will not...)
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73. The "/*DO:" and "*/ must start in the first column and DO ignores anything
  74.  
  75. else on the line with them. All the normal AmigaDos batchfile syntax
  76.  
  77. applies to the lines in between. You perform DO on files by typing:
  78.  
  79.  
  80. DO file1 file2...
  81.  
  82.  
  83. DO will then print out the comment that it is about to EXECUTE and
  84.  
  85. begin EXECUTEing. If just want to know what would happen without actually
  86.  
  87. EXECUTEing then type:
  88.  
  89.  
  90. DO file1 file2... -s 
  91.  
  92.  
  93. DO is SHAREWARE.
  94.  
  95. If you find you are using it on a regular basis, especially commercially, 
  96.  
  97. become a registered user ( $10.00 recomended ). Cheap licencing is 
  98.  
  99. available for bundling with other software.
  100.  
  101. Send suggestions for improvements, bug reports and words of encouragement
  102.  
  103. to:
  104.  
  105.                       Steve Collins
  106.                       Shark Works
  107.                       2369 W. 248 st.
  108.                       Lomita, CA 90717
  109.  
  110.                       Compuserve 74260,15
  111.                       UUCP: <backbone>!gryphon!pnet02!collins
  112.