home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol097 / purge.doc < prev    next >
Encoding:
Text File  |  1985-02-10  |  4.9 KB  |  196 lines
  1.                             PURGE.DOC
  2.  
  3. John S. Wilson
  4. Synapse Associates, Inc.,
  5. P.O. Box 410,
  6. Solomons, Maryland 20688
  7. (310) 326-4751
  8.  
  9.                          Command Syntax
  10.  
  11. PURGE d:filename.typ
  12.  
  13.  
  14.                            Background
  15.  
  16.      ╔ wrotσ PURG┼ a≤ ß utilit∙ fo≥ usσ witΦ Pascal/┌ anΣ othe≥ ì
  17. compilers«  I⌠ wil∞ erasσ thσ numerou≤ file≤ whicΦ arσ n∩ longe≥ ì
  18. needeΣ afte≥ ß successfu∞ compilation«  PURG┼ takes¼ a≤ aε ì
  19. argument¼ ß filσ namσ froφ thσ CP/═ commanΣ linσ anΣ attempt≤ t∩ ì
  20. deletσ certaiε pre-designateΣ file≤ whicΦ havσ thσ samσ roo⌠ namσ ì
  21. a≤ thσ argumen⌠ file«  PURG┼ check≤ t∩ seσ tha⌠ thσ argumen⌠ filσ ì
  22. exist≤ oε thσ nameΣ o≥ defaul⌠ disδ anΣ terminate≤ witΦ aε erro≥ ì
  23. messagσ bu⌠ n∩ othe≥ actioε iµ thi≤ filσ i≤ no⌠ found«  A≤ ì
  24. implieΣ b∙ thσ foregoing¼ ß drivσ designatioε i≤ optiona∞ bu⌠ i≤ ì
  25. accepteΣ anΣ honoreΣ iµ i⌠ supplied«  PURG┼ neve≥ erase≤ thσ CO═ ì
  26. filσ no≥ thσ PA╙ filσ containinτ thσ sourcσ code«  However¼ ì
  27. unles≤ instructeΣ no⌠ to¼ i⌠ wil∞ erasσ thσ SR├ file«  
  28.  
  29.  
  30.                           Files Erased
  31.  
  32. A.  File Extension Types Always Erased
  33.  
  34.      .HEX
  35.      .BAK
  36.      .TYP
  37.      .REL
  38.      .SYM
  39.      .CRF
  40.      .PRN
  41.      .LST
  42.  
  43. B.  File Extension Types Erased Conditionally
  44.  
  45.      .SRC
  46.  
  47. C.  File Extension Types Always Saved
  48.  
  49.      .PAS
  50.      .FOR
  51.      .ASM
  52.      .MAC
  53.      .COM
  54.      .COB  
  55.       etc.,è     
  56.      Iε actuality¼ al∞ filσ extensioε type≤ no⌠ nameΣ iε eithe≥ ì
  57. A« o≥ B« arσ neve≥ erased.
  58.  
  59.  
  60.               Erasing (and not erasing) .SRC files.
  61.  
  62.      ┴ filσ oµ typσ .SR├ ma∙ bσ saveΣ b∙ enterinτ .SR├ a≤ thσ ì
  63. file type iε thσ filσ namσ supplieΣ a≤ aε argumen⌠ t∩ thσ ì
  64. program«  Iµ thσ argumen⌠ filσ namσ doe≤ no⌠ havσ .SR├ a≤ it≤ ì
  65. typσ anΣ ß .SR├ filσ i≤ founΣ witΦ thσ samσ roo⌠ name¼ thσ .SR├ ì
  66. filσ wil∞ bσ deleted.
  67.  
  68. For example
  69.  
  70.                          PURGE NERD.SRC 
  71.  
  72. will NOT erase the file NERD.SRC but 
  73.                          
  74.                          PURGE NERD.PAS 
  75.  
  76. will erase NERD.SRC.
  77.  
  78.  
  79.                             Versions
  80.  
  81.      Thσ sourcσ codσ anΣ .CO═ filσ supplieΣ t∩ thσ Pascal/┌ ì
  82. User'≤ Grou≡ i≤ conditioneΣ t∩ ruε oε ß Heath-1╣ termina∞ anΣ t∩ ì
  83. d∩ ß warφ boo⌠ oε exi⌠ froφ thσ program«  Equatinτ (EQU⌐ thσ ì
  84. constan⌠ SETH1╣ t∩ ░ iε thσ sourcσ filσ anΣ reassemblinτ wil∞ ì
  85. forcσ ß conditiona∞ assembl∙ withou⌠ thσ specia∞ codσ fo≥ thσ ì
  86. HeatΦ terminal«  User≤ witΦ terminal≤ othe≥ thaε thσ H/Z19(89,90⌐ ì
  87. ma∙ codσ thei≥ terminal≤' screeε clear¼ reversσ vide∩ oε anΣ ofµ ì
  88. sequence≤ iε thσ threσ message≤ WIPEM¼ RVONM¼ anΣ RVOFF═ whicΦ ì
  89. arσ t∩ bσ founΣ nea≥ thσ enΣ oµ thσ sourcσ file«  
  90.  
  91.      Similarly¼ settinτ thσ constan⌠ SETWB╘ t∩ ░ anΣ reassemblinτ ì
  92. wil∞ forcσ thσ prograφ t∩ exi⌠ withou⌠ doinτ ß warφ boot«  Thσ ì
  93. warφ boo⌠ oε exi⌠ wa≤ includeΣ t∩ forcσ Intersystem≤ Cachσ Bio≤ ì
  94. t∩ writσ thσ tracδ buffe≥ bacδ t∩ disk«  
  95.  
  96.  
  97.                             Assembler
  98.  
  99.      PURG┼ wa≤ assembleΣ witΦ Microsoft'≤ Macro-8░ anΣ linkeΣ ì
  100. witΦ Link-8░ bu⌠ sincσ i⌠ contain≤ n∩ macro≤ o≥ othe≥ specializeΣ ì
  101. code¼ i⌠ ma∙ bσ assembleΣ witΦ an∙ assemble≥ capablσ oµ handlinτ ì
  102. Ziloτ Z8░ mnemonics«  I⌠ wa≤ no⌠ writteε iε 808░ mnemonic≤ oε thσ ì
  103. assumptioε tha⌠ user≤ oµ Pascal/· arσ goinτ t∩ havσ ß Z8░ CP╒ ì
  104. machine« 
  105.  
  106.  
  107.                        Operationa∞ Example
  108.  
  109.      Yo⌡ havσ successfull∙ compileΣ anΣ linkeΣ ß Pascal/┌ prograφ ìènameΣ FARKLE.PAS«  Thi≤ mean≤ that¼ a⌠ minimuφ yo⌡ havσ thσ ì
  110. followinτ file≤ oε ß disk:
  111.  
  112.      FARKLE.PAS
  113.      FARKLE.SRC
  114.      FARKLE.REL
  115.      FARKLE.COM
  116.  
  117. most likely also 
  118.      
  119.      FARKLE.BAK
  120.  
  121. anΣ possibl∙ also
  122.  
  123.      FARKLE.TYP
  124.      FARKLE.SYM
  125.  
  126. Entering
  127.  
  128.                          PURGE FARKLE.PAS
  129.  
  130. will delete all of the above except FARKLE.PAS and FARKLE.COM.
  131.  
  132.      Iµ yo⌡ arσ workinτ witΦ Intersystem≤ ASMB╠ t∩ develo≡ anì
  133. externa∞ routine fo≥ usσ witΦ Pascal/┌ anΣ thu≤ havσ a file typeΣ ì
  134. SR├ whicΦ yo⌡ wisΦ t∩ save¼ typσ iε 
  135.  
  136.                          PURGE SPARKLE.SRC
  137.  
  138. after you have loaded the relocatable into your private library.
  139.  
  140.  
  141.                       Ambiguous File Names
  142.  
  143.      ╔ haΣ no⌠ reall∙ planneΣ oε PURG┼ dealinτ witΦ ambiguou≤ ì
  144. filσ name≤ anΣ s∩ ╔ didn'⌠ makσ i⌠ smar⌠ enougΦ t∩ handlσ thi≤ ì
  145. situation«  PURG┼ wil∞ usuall∙ worδ properl∙ oε thσ filσ type≤ ì
  146. fo≥ onσ oµ thσ matchinτ filσ name≤ bu⌠ no⌠ ac⌠ oε an∙ othe≥ ì
  147. matchinτ file«  ì
  148.  
  149.      Thσ prograφ doe≤ handlσ ambiguou≤ filσ extension≤ properl∙ ì
  150. so that a user may enter
  151.  
  152.                          PURGE FARKLE.*
  153. instead of
  154.  
  155.                          PURGE FARKLE.PAS
  156.  
  157. and get the same results.
  158.  
  159.  
  160.                          Erro≥ Recovery
  161.  
  162.      Oµ course¼ onσ caε alway≤ usσ thσ prograφ UNER┴, whicΦ i≤ ì
  163. submitteΣ t∩ thσ user'≤ grou≡ alonτ witΦ PURGE¼ t∩ recove≥ (un-ìèdelete⌐ an∙ file≤ whicΦ arσ PURGE'eΣ iε error.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.