home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / f / mvpforth.lbr / MVPFORTH.DZC / MVPFORTH.DOC
Encoding:
Text File  |  1993-10-26  |  7.4 KB  |  155 lines
  1.              DOCUMENT FILE FOR THE MVP-FORTH PACKAGE
  2.  
  3.      Thi≤á packagσá contain≤ thσ followinτ majo≥ file≤á oεá threσ 
  4.      single-density disks:
  5.  
  6.      MVPFORTH.ASM á  Thσ sourcσ filσ fo≥ thσ public-domaiε FORTH-
  7.                      7╣ááá versioεáá oµáá thσáá FORT╚áá language¼
  8.                      implemented b∙ Dr. Gleε B« Haydon«áThi≤ filσ 
  9.                      will assemble with ASM.COM.
  10.  
  11.      AUTOST.CO═      Thσ assembleΣ versioε oµ MVP-FORTH¼áwitΦ thσ 
  12.                      utilit∙áá anΣá edito≥á screen≤á loadeΣá (seσ 
  13.                      below).
  14.  
  15.      ASMFZ80.DO├á   Thσ  documentatioε  filσ fo≥á thσá assembler.
  16.                     ╔ havσ deletedeΣ ß fe≈ line≤ oµ thσá origina∞ 
  17.                     .DO├ filσ ¿ originall∙  writteε  b∙   Michae∞ 
  18.                     M«á Rubenstein¼ a≤ wa≤ thσ assembler⌐ fo≥ usσ 
  19.                     in this package.
  20.  
  21.     SDFORTH.SCR     Contains the  utility, editor, and  assembler
  22.                     (ASMFZ80⌐á screen≤á fo≥á usσ iεá thσá single-
  23.                     densit∙á format«á Follo≈ thσ instruction≤á iε 
  24.                     SDFORTH.DOC.
  25.  
  26.     SDFORTH.DO├á    Contain≤á instruction≤ oε  ho≈á t∩á implemen⌠ 
  27.                     MVP-FORTH on single-density disks.
  28.  
  29.     DDFORTH.SC╥áá   Contain≤áá thσ á samσá FORT╚áá screen≤áá tha⌠ 
  30.                     SDFORTH.SC╥á does«á   AlthougΦ thi≤á filσá i≤ 
  31.                     locateΣá oεá ß single-densit∙á disk¼á ╔á havσ 
  32.                     arrangeΣá thσá screen≤ s∩ tha⌠ the∙á wil∞á bσ 
  33.                     usablσ iε thσ double-densit∙ format«á  Follo≈ 
  34.                     the instruction≤ iε DDFORTH.DOC.
  35.  
  36.     DDFORTH.DO├á    Contain≤á instruction≤ oε  ho≈á t∩á implemen⌠ 
  37.                     MVP-FORTH on double-density disks.
  38.  
  39.  
  40.  
  41.  
  42.                   SOME NOTES CONCERNING FORTH: 
  43.  
  44. (1)    ╔á havσá pu⌠á togethe≥á ß packagσá tha⌠á botΦá single- anΣ 
  45.        double-densit∙á Osbornσá user≤ caε use╗á herσá arσá ßá fe≈ 
  46.        suggestion≤á t∩ hel≡ thσ use≥ ge⌠ thσ maximuφ benefi⌠ froφ 
  47.        it:
  48.      
  49.    (A⌐ Documentatioε concerninτ usagσ oµ thσ "wordsó containeΣ iε 
  50.        thσá sourcσ filσ (MVPFORTH.ASM⌐ i≤ availablσ iε thσá book¼ 
  51.        "All About FORTH", by Glen B. Haydon.  This book currently       
  52.        (6/83⌐á cost≤á $20¼á anΣ i≤ availablσ froφá Mountaiεá Vie≈
  53.        Pres≤áá █á (415⌐á 961-410│á ]«áá   Thi≤á i≤á ßá worthwhilσ 
  54.        purchase for those who want to use MVP-FORTH.
  55.  
  56. è
  57.  
  58.    (B) An excellent way to learn how to use FORTH would be to buy
  59.        thσá book¼á "Startinτ FORTH"¼á b∙ Le∩ Brodie«á  Thisá booδ 
  60.        cost≤á $1╢á (sof⌠á cover⌐ anΣ i≤ availablσá a⌠á man∙á booδ 
  61.        stores¼á a≤ wel∞ a≤ througΦ Mountaiε Vie≈ Press«   Chapte≥ 
  62.        three [ titled, "THE EDITOR (AND STAFF)"]  explains how to 
  63.        use the editor provided in this package.
  64.  
  65.    (C⌐áFo≥ á anyonσá interesteΣá iεá learninτá FORTH¼á Thσá FORT╚
  66.        INTERES╘ GROU╨ (FIG⌐ ha≤ aε excellen⌠ publication¼á "FORT╚
  67.        DIMENSIONS", and all back issues are available in reprint.
  68.        Membershi≡á iε FI╟ ¿ includinτ ╢ issue≤ oµá "FORT╚á DIMEN-
  69.        SIONS"⌐á i≤ $1╡ annuall∙ █ P.O«á Bo° 110╡  Saε Carlos¼á C┴ 
  70.        9407░  (415⌐ 962-8653].
  71.  
  72.    (D⌐áTherσá i≤á ßá FORT╚á compute≥á bulletiεá boarΣá (ßá tree-
  73.        structured "Communitree" bulletin board), (415) 538-3580.
  74.  
  75. (2)    Notes on the utility screens (SD:135-144,DD:247-256)
  76.  
  77.    (A⌐ Thσ "CAS┼ STATEMENTó (SD:136,DD:248⌐ i≤ b∙ Dr«á Charle≤ E«
  78.        Eake≥á (froφ FORT╚ DIMENSION╙ II/3¼á p37)«á   Iµ an∙á CAS┼ 
  79.        statemen⌠á (borroweΣá froφ Pascal¼á ╔á believe⌐á ha≤á beeε 
  80.        accepted as "standard", this one has.
  81.  
  82.    (B⌐áThσ CHECKSU═ screeε (SD:140,DD:252⌐ i≤  b∙ Klaxoεá Surali≤ 
  83.        anΣ Le∩ Brodiσ (froφ FORT╚ DIMENSION╙ IV/3¼á p15)«  ╔ havσ 
  84.        useΣá thi≤á utilit∙ t∩ verif∙ thσ accurac∙ oµ al∞á oµá thσ
  85.        screen≤á containeΣ iε thi≤ packagσ [no≈ yo⌡ kno≈ wha⌠á thσ 
  86.        notation¼á "CR├ VE╥ ╜ xxxxxó (locateΣ oε eacΦ screen)¼á i≤ 
  87.        useΣá for]«á   T∩ verif∙ thσ accurac∙ oµ thσ you≥ screens¼ 
  88.        firs⌠ lis⌠ thσ screeε (e.g.¼á 14╡ LIS╘ <CR╛ )¼á theεá typσ 
  89.        VE╥á <CR╛ (noticσ tha⌠ MVP-FORT╚ use≤ upper-casσá letters¼ 
  90.        althougΦá comment≤á ma∙ bσ typσ lower-case)«á   Iεá ßá fe≈ 
  91.        second≤á ßá numbe≥á wil∞ appear¼á whicΦ shoulΣá matcΦá thσ 
  92.        numbe≥ oε thσ screen«á   Comment≤ encloseΣ iεá parenthese≤ 
  93.        arσ no⌠ counted in the checksum¼ s∩ an∙ differences within   
  94.        parenthese≤ won'⌠ register«á  --╛ NOTE║á <CR╛ i≤ shorthanΣ 
  95.        for "press the return key." 
  96.  
  97.    (C⌐áThσ SAVE-FORT╚ screeε (SD:138,DD:250⌐ i≤ useΣ t∩ savσ  al∞ 
  98.        oµá thσá compileΣ "wordsó t∩ ßá CP/═á .CO═á  file«á   Typσ 
  99.        SAVE-FORTH <CR> to use.   
  100.  
  101.    (D⌐ Thσ firs⌠ screeε (SD:135,DD:247⌐ i≤ ß loaΣ screen¼ useΣ t∩ 
  102.        loaΣá al∞ oµ thσ utilities«á   Notσ tha⌠ thσ worΣá "THRU"¼ 
  103.        useΣá oεá al∞á oµ thσ loaΣ screens¼á i≤á defineΣá oεá thi≤ 
  104.        screen«á   T∩  loaΣ (compile⌐  an∙ screen¼ typσ thσ numbe≥ 
  105.        oµá thσá screená( whicΦ put≤ i⌠ oε thσá FORT╚á computatioε 
  106.        stack) then  type LOAD <CR>. 
  107.  
  108.  
  109.  
  110.  
  111. è
  112. (3)    A Note on the Editor: (SD:145-163,DD:257-275)
  113.        
  114.        Iεá FORTH¼á "word≤"  caε eithe≥ bσ executeΣ directl∙á froφ 
  115.        thσ keyboard¼á o≥ storeΣ oε disδ t∩ bσ executeΣ later«  Aε 
  116.        edito≥ i≤ useΣ t∩ writσ t∩ disk«á  Thi≤ edito≥ wa≤ writteε 
  117.        b∙ S.H«á Danie∞ (froφ FORT╚ DIMENSION╙ III/3¼ p80)¼ anΣ i≤ 
  118.        functionall∙á identica∞ t∩ thσ polyFORT╚ (FORTH,Inc⌐á edi-
  119.        tor«á   A≤á noteΣá earlier¼á instruction≤ fo≥ it≤ usσá arσ 
  120.        containeΣ iε chapte≥ │ oµ "Starting FORTH".
  121.  
  122.  
  123. (4)    A note on ASMFZ80, the assembler: (SD:165-194,DD:277-306)
  124.  
  125.        Iε FORTH¼  aεá assemble≥ i≤ useΣ t∩ definσ "wordsó iεá thσ 
  126.        machinσá languagσá oµá thσ CPU«á   Thi≤á give≤á thσá FORT╚ 
  127.        programme≥á thσá abilit∙ t∩ writσá program≤á tha⌠á executσ 
  128.        faste≥ thaε thosσ writteε entirel∙ iε high-leve∞á code╗á ß 
  129.        possiblσá disadvantagσ oµ defininτ word≤ iε low-leve∞ codσ 
  130.        is that machine  code is  not transportable between CPU's. 
  131.        HigΦáá leve∞áá FORT╚áá generall∙á execute≤áá faste≥áá thaε 
  132.        interpreteΣá BASIC¼á anΣá slowe≥ thaεá assembl∙á language«  
  133.        ASMFZ8░ (froφ thσ RCP═ network⌐ wa≤ writteε b∙ Michae∞á M« 
  134.        Rubenstein«  Thi≤ assemble≥ wa≤ writteε iε fig-FORT╚ word≤ 
  135.        useΣá b∙ thσ earlie≥ versioε oµ SOFTWAR┼ WORK╙ FORT╚á (thσ 
  136.        FORT╚ distributeΣ b∙ Osborne)╗á ╔ modifieΣ i⌠ t∩ worδ witΦ 
  137.        MVP-FORTH¼á anΣá i⌠ seem≤ t∩ worδ likσ thσ original«á  Seσ 
  138.        ASMFZ80.DO├á fo≥ usagσ instructions«á ╔ lef⌠ ou⌠ thσá las⌠ 
  139.        screeε oµ thσ origina∞ assemble≥ (called║ PURG┼ ASSEMBLER⌐ 
  140.        becausσá ╔ couldn'⌠ ge⌠ i⌠ t∩á work«á  Incidentally¼á witΦ 
  141.        MVP-FORT╚ái⌠ i≤ possiblσ t∩ writσ "wordsó int∩ thσá sourcσ 
  142.        codσ witΦ Wordsta≥ -- theε assemblσ it.
  143.  
  144. (5)    A few notes on MVP-FORTH:
  145.  
  146.    (A) The CP/M printer toggle (^P) works from within FORTH.
  147.  
  148.    (B) All of the special function keys (SFK) are operational.
  149.  
  150.    (C⌐áWhenever possible, leavσ FORTH  b∙á typinτá "BYEó á -- 
  151.        otherwise¼á change≤á madσá t∩ thσ las⌠ onσ o≥ tw∩á screen≤ 
  152.        might not get written to disk.
  153.  
  154.                                           
  155.  
  156.                                                     J.E. Crowell
  157.                                                     San Jose, CA