home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / LANGUAGS / PASCAL / AUTOC23A.LBR / AUTOPAS.DZC / AUTOPAS.DOC
Text File  |  2000-06-30  |  9KB  |  236 lines
  1.                            AUTOPA╙ 2.1
  2.                            -----------
  3.                         updateΣ 01-18-84
  4.  
  5. AUTOPA╙ i≤ ß specia∞ prograφ designeΣ t∩ kee≡ tracδ oµ .PA╙ file≤ ì
  6. anΣá automaticall∙ compilσ ONL┘ thosσ file≤ tha⌠ yo⌡ havσá editeΣ ì
  7. sincσá thσ las⌠ timσ yo⌡ compileΣ them«á  Thi≤ i≤ quitσ hand∙ fo≥ ì
  8. project≤á involvinτ man∙ modules¼á sincσ i⌠ relieve≤ yo⌡á oµá thσ ì
  9. tasδá oµá keepinτá tracδá oµ whicΦ file≤á yo⌡á havσá updateΣá anΣ ì
  10. assemblinτ theφ one-by-one.
  11.  
  12. Therσ arσ threσ program≤ useΣ witΦ thi≤ function.
  13.  
  14.      AUTOPA╙        automaticall∙ compilσ .PA╙ files
  15.      SETOF╞         disablσ ß filσ (turε i⌠ off)
  16.      SETO╬          enablσ ß filσ (turε i⌠ on)
  17.  
  18. SETO╬ allow≤ yo⌡ t∩ overridσ thσ previou≤ SETOFF¼á t∩ turε oε thσ ì
  19. filσ withou⌠ havinτ t∩ edi⌠ it«  Normall∙ thσ filσ wil∞ bσ turneΣ ì
  20. oε jus⌠ b∙ editinτ it.
  21.  
  22. HO╫ T╧ US┼ AUTOPAS
  23. ------------------
  24.  
  25.      Usσ oµ thσ AUTOPA╙ prograφ i≤ simple«á  Jus⌠ typσ iε AUTOPA╙ ì
  26. anΣ i⌠ wil∞ d∩ thσ rest«á  Yo⌡ als∩ havσ thσ optioε oµ specifyinτ ì
  27. whicΦ drivσ thσ sourcσ (.PAS⌐ file≤ arσ on¼á anΣ specifyinτ whicΦ ì
  28. drivσá yo⌡á wan⌠ thσ relocatablσ (.ERL⌐ file≤á on«á  Iµá yo⌡á arσ ì
  29. runninτá CP/M½ (CP/═ 3.░ o≥ greater)¼á yo⌡ mus⌠ havσ thσá prograφ ì
  30. SUBMIT.CO═á present«á  AUTOPA╙ expect≤ MTPLUS.CO═ anΣá SETOFF.CO═ ì
  31. (anΣá SUBMIT.CO═á unde≥ CP/M+⌐ t∩ bσ oε thσ drivσ yo⌡ arσá loggeΣ ì
  32. into.
  33.      ┴ .PA╙ filσ ha≤ tw∩ possiblσ conditions╗ i⌠ i≤ eithe≥ SE╘ O╬ ì
  34. (enableΣ fo≥ assembling)¼ o≥ SE╘ OF╞ (disabled)«  Notσ tha⌠ thesσ ì
  35. condition≤ wil∞ NO╘ affec⌠ thσ norma∞ operatioε oµ MTPLUS¼ o≥ an∙ ì
  36. othe≥á prograφá either«áá  Al∞á i⌠á affect≤á i≤á whethe≥á AUTOPA╙ ì
  37. recognize≤ i⌠ o≥ not«  ┴ filσ tha⌠ ha≤ neve≥ beeε SE╘ beforσ wil∞ ì
  38. alway≤ bσ SE╘ ON«á  Tha⌠ i≤ thσ defaul⌠ condition«á  Thσ onl∙ wa∙ ì
  39. t∩ ge⌠ ß filσ SE╘ OF╞ i≤ witΦ thσ SETOF╞ program¼ o≥ witΦ AUTOPA╙ ì
  40. whicΦ use≤ SETOFF«á  T∩ ge⌠ ß filσ SE╘ O╬ yo⌡ ma∙ edi⌠ i⌠ o≥á usσ ì
  41. thσá SETO╬ program«á  Iµ yo⌡ cop∙ ß filσ usinτ PIP¼á thσ ne≈ cop∙ ì
  42. wil∞ bσ SE╘ ON«  
  43.      Wheε yo⌡ invokσ AUTOPA╙ i⌠ look≤ a⌠ al∞ oµ thσ .PA╙ file≤ oε ì
  44. thσ disδ anΣ determine≤ whethe≥ the∙ arσ SE╘ O╬ o≥ SE╘á OFF«á  Iµ ì
  45. thσá filσá i≤á SE╘á O╬ i⌠ wil∞ bσ addeΣ t∩ ßá lis⌠á oµá file≤á t∩ ì
  46. compile«á  Iµá i⌠á doe≤ no⌠ finΣ an∙ .PA╙ file≤ SE╘ ON¼á i⌠á wil∞ ì
  47. prin⌠ thσ messagσ NON┼ FOUN─ anΣ exi⌠ witΦ n∩ effect«  Iµ an∙ arσ ì
  48. found¼á the∙ wil∞ bσ addeΣ t∩ thσ $$$.SU┬ filσ oε drivσ A:«  Thi≤ ì
  49. i≤ simila≥ t∩ usinτ SUBMIT¼á a≤ thσ systeφ wil∞ theε executσá thσ ì
  50. ne≈á command≤ a≤ thougΦ the∙ werσ createΣ b∙ SUBMIT«á  EacΦá filσ ì
  51. wil∞ bσ compileΣ anΣ theε SE╘ OFF¼ onσ a⌠ ß time«  Fo≥ CP/M+¼ thσ ì
  52. SUBMI╘ facilit∙ work≤ differently¼ s∩ AUTOPA╙ put≤ thσ filσ name≤ ì
  53. int∩á ß filσ calleΣ AUTOTEMP.SU┬ anΣ chain≤ t∩ SUBMI╘ wheε i⌠á i≤ ì
  54. done.
  55.  
  56.      T∩ summarize;
  57.           1⌐   Edi⌠ whicheve≥ file≤ yo⌡ neeΣ to.
  58.           2⌐   Executσ AUTOPAS.
  59.           3⌐   Fo≥ eacΦ SE╘ O╬ .PA╙ filσ - 
  60.                a⌐   Thσ filσ i≤ compiled.
  61.                b⌐   Thσ filσ i≤ SE╘ OFF.
  62.           4⌐   Finished.
  63.  
  64. OPTIONS
  65. -------
  66.  
  67.                               AUTOPA╙ s: $o
  68.                                  ▐    ^  ^^
  69.                                  ⁿ    |  ||
  70.           AUTOPA╙ command--------½    |  ||
  71.                  -options-            |  ||
  72.      1⌐   Locatioε oµ sourcσ files----+  ||
  73.      2)   $ or # for MTPLUS options------+|
  74.           MTPLUS options go here----------+
  75.  
  76.      1)   Locatioε oµ sourcσ files«á  Thi≤ optioε specifie≤ whicΦ ì
  77. áááááááááádisδ drivσ contain≤ thσ .PA╙ file≤ yo⌡ wisΦ t∩ compile«  ì
  78. ááááááááááIµá no⌠á included¼á i⌠á default≤ t∩ thσ drivσá yo⌡á arσ ì
  79. áááááááááácurrentl∙ loggeΣ into«á  Thi≤ optioε ma∙ bσ followeΣ b∙ ì
  80. ááááááááááß coloε anΣ spaces if you wish.
  81.  
  82.      2)   MTPLU╙á require≤á ß ñ o≥ ú t∩á delimi⌠á options«á  Jus⌠ ì
  83. áááááááááádeclarσá theφá herσá thσ wa∙ yo⌡á woulΣá wheεá invokinτ ì
  84. ááááááááááMTPLU╙ normally«á  AUTOPA╙ wil∞ pu⌠ these option≤á int∩ ì
  85. ááááááááááever∙ MTPLU╙ command.
  86.  
  87.      Note: AUTOPAS may be imbedded in a SUBMIT file.
  88.  
  89. EXAMPLES
  90. --------
  91.  
  92.      The files TEST.PAS and MUNG.PAS are on drive A:.
  93.  
  94. A>AUTOPAS                     <---- you type this in,
  95. Auto MTPLUS version 2.1             the rest is automatic
  96.  
  97. A>MTPLUS TEST.PAS             <---- i⌠ founΣ TEST.PAS
  98.  
  99. <compilation messages>
  100.  
  101. A>SETOFF TEST.PAS             <---- now, disable it
  102. TEST.PAS                      <---- show which file it sets
  103.  
  104. A>MTPLUS MUNG.PAS             <---- it found MUNG.PAS
  105.  
  106. <compilation messages>
  107.  
  108. A>SETOFF MUNG.PAS             <---- disable it, it has been
  109. MUNG.PAS                            compiled.  Remember, this
  110.                                     happens automatically.
  111. A>
  112.  
  113.      Now¼ supposσ yo⌡ ruε AUTOPAS again¼ witΦ n∩ editinτ between:
  114.  
  115. A>AUTOPAS                     <---- you type this in
  116. Auto MTPLUS version 2.1
  117. NONE FOUND.
  118.  
  119. A>
  120.  
  121.      The∙ havσ al∞ beeε disabled¼ anΣ nonσ havσ beeε editeΣ sincσ ì
  122. thσ las⌠ timσ yo⌡ compileΣ usinτ AUTOPAS«
  123.  
  124.  
  125.      No≈ edi⌠ MUNG.PAS anΣ ruε AUTOPAS again:
  126.  
  127.      (edit session goes here!)
  128.  
  129. A>AUTOPAS                     <---- you type this in again
  130. Auto MTPLUS version 2.1
  131.  
  132. A>MTPLUS MUNG.PAS             <---- it found MUNG.PAS
  133.  
  134. <compilation messages>
  135.  
  136. A>SETOFF MUNG.PAS             <---- disable it, it has been
  137. MUNG.PAS                            compiled.
  138. A>
  139.  
  140.      ...anΣ that'≤ all¼á sincσ yo⌡ didn'⌠ se⌠ TEST.PA╙ oεá again¼ ì
  141. eithe≥ witΦ SETO╬ o≥ b∙ editinτ it.
  142.      Thσá usσ oµ SETO╬ anΣ SETOF╞ i≤ ver∙ simple«á  Al∞ yo⌡ d∩ i≤ ì
  143. typσ iε thσ commanΣ witΦ thσ namσ oµ thσ filσ yo⌡ wan⌠á set¼á anΣ ì
  144. SETO╬ o≥ SETOF╞ wil∞ d∩ thσ rest.
  145.  
  146. A>SETON MUNG.PAS              <---- you type this in
  147. MUNG.PAS
  148.  
  149. A>AUTOPAS                     <---- you type this in, too
  150. Auto MTPLUS version 2.1
  151.  
  152. A>MTPLUS MUNG.PAS             <---- it found MUNG.PAS
  153.  
  154. <compilation messages>
  155.  
  156. A>SETOFF MUNG.PAS             <---- disable it, it has been
  157. MUNG.PAS                            compiled.
  158.  
  159. A>
  160.  
  161.      ...just like when you edited it.
  162.  
  163.      Now let us suppose those files are on drive B:.
  164.  
  165. A>AUTOPAS B                   <---- you type this in
  166. Auto MTPLUS version 2.1
  167.  
  168. A>MTPLUS B:TEST.PAS           <---- i⌠ founΣ TEST.PAS
  169.  
  170. <compilation messages>
  171.  
  172. A>SETOFF B:TEST.PAS           <---- now, disable it
  173. TEST.PAS                      <---- show which file it sets
  174.                                     (the drive isn't shown)
  175. A>MTPLUS B:MUNG.PAS           <---- it found MUNG.PAS
  176.  
  177. <compilation messages>
  178.  
  179. A>SETOFF B:MUNG.PAS           <---- disable it
  180. MUNG.PAS
  181.  
  182. A>
  183.  
  184.      Perhap≤á yo⌡á woulΣá likσá ß listinτ fo≥ eacΦá filσá oεá thσ ì
  185. printer:
  186.  
  187. A>AUTOPAS B: $PP              <---- specify source on B:,
  188. Auto MTPLUS version 2.1             route .PRN file to the
  189.                                     printer
  190. A>MTPLUS B:MUNG.PAS $PP       <---- it found MUNG.PAS
  191.  
  192. <compilation messages>
  193.  
  194. A>SETOFF B:MUNG.PAS           <---- disable it, it has been
  195. MUNG.PAS                            compiled.
  196.  
  197. A>
  198.  
  199.  
  200.  
  201. HOW IT WORKS
  202. ------------
  203.  
  204.      File≤ createΣ whilσ runninτ unde≥ CP/═ normall∙ havσ thσ f1º ì
  205. attributσ turneΣ off«  CP/═ anΣ mos⌠ application≤ program≤ d∩ no⌠ ì
  206. kno≈á anythinτ abou⌠ thi≤ attributσ bit¼á anΣ s∩ the∙ ignorσá it«  ì
  207. Editor≤ likσ WORDSTA╥ whicΦ creatσ ß ne≈ filσ ever∙ timσ yo⌡ edi⌠ ì
  208. wil∞ no⌠ se⌠ thi≤ attribute¼á s∩ ever∙ timσ yo⌡ edi⌠ ß file¼á thσ ì
  209. ne≈á cop∙ wil∞ havσ thσ attributσ bi⌠ turneΣ off«á  ╔ havσá takeε ì
  210. advantagσ oµ thi≤ fact¼á anΣ useΣ i⌠ a≤ aε indicatioε tha⌠ ß filσ ì
  211. ha≤á beeε edited«á  Thi≤ conditioε correspond≤ t∩ wha⌠ ╔ cal∞ SE╘ ì
  212. ON¼á tha⌠ is¼ enableΣ fo≥ automatiπ assembling«  AUTOPA╙ look≤ oε ì
  213. thσá specifieΣ disδ fo≥ al∞ .PA╙ file≤ tha⌠ arσ se⌠á on«á  Iµá i⌠ ì
  214. find≤ any¼á i⌠ create≤ ß $$$.SU┬ filσ (or¼ iµ onσ alread∙ exists¼ ì
  215. open≤á i⌠ fo≥ updating⌐ anΣ put≤ thσ namσ oµ eacΦ se⌠ oε filσá iε ì
  216. it«  Wheε i⌠ i≤ finisheΣ findinτ al∞ thσ files¼ i⌠ close≤ $$$.SU┬ ì
  217. anΣá return≤á t∩ CP/M«á  Theε CP/═ execute≤ thσá file¼á whicΦá i⌠ ì
  218. think≤á wa≤ madσ b∙ SUBMIT«á  EacΦ filσ i≤ compileΣ iε turn¼á anΣ ì
  219. theε se⌠ ofµ b∙ executinτ SETOFF.COM«á  Neithe≥ SETOFF¼ SETO╬ no≥ ì
  220. AUTOPA╙ i≤ affecteΣ b∙ an∙ attributσ bit≤ othe≥ thaε f1'¼á no≥ d∩ ì
  221. the∙ affec⌠ them.
  222.      Unde≥ CP/M½ thσ SUBMI╘ facilit∙ work≤ differently«á  T∩ makσ ì
  223. AUTOPA╙á worδ witΦ CP/M½ ╔ decideΣ t∩ creatσ ß norma∞á .SU┬á filσ ì
  224. (calleΣ AUTOTEMP.SUB⌐ witΦ thσ statement≤ t∩ bσ executed¼ anΣ ER┴ ì
  225. AUTOTEMP.SU┬á a⌠ thσ end¼á anΣ theε chaiε t∩ SUBMIT.CO═ witΦá thσ ì
  226. filσ namσ AUTOTEM╨ iε thσ systeφ filσ contro∞ blocδ a⌠ 05CH«  Yo⌡ ì
  227. mus⌠ havσ SUBMIT.CO═ oε you≥ defaul⌠ drive«á  Iµ yo⌡ havσ renameΣ ì
  228. SUBMIT.CO═ anΣ yo⌡ canno⌠ re-compilσ AUTOPAS.PAS¼ theε usσ DD╘ o≥ ì
  229. SI─ t∩ finΣ thσ strinτ 'SUBMIT.COMº withiε AUTOPAS.COM«á  Yo⌡ ma∙ ì
  230. changσ i⌠ t∩ whateve≥ yo⌡ like╗á notice¼á however¼á tha⌠ thσ bytσ ì
  231. previou≤á t∩á thσ firs⌠ bytσ iε thσ strinτ i≤ ß lengtΦá bytσá anΣ ì
  232. shoulΣ bσ changeΣ t∩ match.
  233.  
  234.                                    - Jeffrey J. Nonken
  235.                                      Santa Ana, Ca.
  236.