home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / FORTH / FORTH.ZIP / FORTHDOC.2 < prev    next >
Encoding:
Text File  |  1985-06-18  |  8.1 KB  |  223 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.         MVPFORTH.DOC    15 Oct 1983     R. S. White     Marion,IA.
  9.  
  10.         This is a FORTH-79 implementation of the FORTH language
  11. done by Glen B. Haydon with most of the old fig-FORTH words also
  12. defined.  It has been very generously placed in the public domain
  13. by Mr. Haydon in the spirit of the original FORTH INTEREST GROUP's
  14. 1978 dissemination of working versions of the language.
  15.  
  16.         The purpose of this short piece of documentation is to
  17. steer users to the appropiate references on this language
  18. implementation and to make some quick notes about my intial
  19. experences with MVP-FORTH version 1.0305.02.
  20.  
  21.  
  22. 1. References & Tutorials
  23.  
  24.         A. ALL ABOUT FORTH
  25.            An Annotated Glossary
  26.            
  27.            by Glen B. Haydon
  28.  
  29.            Second Edition
  30.  
  31.            Mountain View Press, Inc.
  32.            P.O. Box 4656
  33.            Mountain View, CA 94040
  34.            (415)961-4103
  35.  
  36.            Order direct from the publisher for approx $25.
  37.            They will take phone in orders and charge to
  38.            M.C., VISA or COD for approx $5 extra.
  39.  
  40.            This is the definitive glossary and definition of
  41.            MVP-FORTH with references to any differences between
  42.            it and FORTH-79, fig-FORTH and the FORTH described
  43.            in STARTING FORTH.  The FORTH-79 STANDARD and FORTH-79
  44.            HANDY REFERENCE is included in this book.  It is not
  45.            a tutorial!
  46.  
  47.  
  48.         B. STARTING FORTH
  49.  
  50.            An Introduction to the FORTH
  51.            Language and Operating System
  52.            for Beginners and Professionals
  53.  
  54.            by Leo Brodie,  FORTH, Inc.
  55.  
  56.            Prentice-Hall, Inc.
  57.            Englewood Cliffs, NJ 07632
  58.  
  59.            Availible at most bookstores, ie DALTON's
  60.            for approx $15.95.
  61.  
  62.            This is an outstanding tutorial book that
  63.            even people who never have any intention to
  64.            learn FORTH give good reviews. (and read through)
  65.            Better yet it appears that Glen Haydon took pains
  66.            to make his implementation of FORTH capable of
  67.            operating like the FORTH described in BRODIE's
  68.            book whenever possible.  In particular, the line
  69.            editor included in the MVPFORTH.COM binary image
  70.            complies with the EDITOR described in STARTING
  71.            FORTH.  The exceptions to STARTING FORTH are
  72.            pointed out by ALL ABOUT FORTH.  These differences
  73.            mainly occur when one is messing around with
  74.            ticking name field addresses ( NFA )'s and stuff
  75.            which is not normal FORTH application programming
  76.            practice and is discouraged by the FORTH-79 STANDARD.
  77.  
  78.                 It is possible to do a lot with MVP-FORTH
  79.            and just use STARTING FORTH without buying ALL 
  80.            ABOUT FORTH until one feels comfortable with the
  81.            language and wants to get down to the nitty-gritty
  82.            details and write/include decompliers, MSDOS screen
  83.            files, etc.
  84.  
  85.  
  86.         C. FORTH DIMENSIONS, Vol III  No. 3
  87.  
  88.                 Availible from the FORTH Interest Group
  89.            P.O. Box 1105,  San Carlos, CA 94070 by purchasing
  90.            all 6 backissues of Vol III for $15 postpaid.
  91.  
  92.                 This issue has an article which provided the
  93.            EDITOR that Glen Haydon implemented in MVP-FORTH.
  94.  
  95.            
  96.  
  97. 2. other FORTH information sources of note ( not inclusive )
  98.  
  99.         A. Join FIG  ( FORTH Interest Group ) and get current
  100.            issues of FORTH DIMENSIONS.  This bimonthly magazine
  101.            follows the further refinement of the FORTH language
  102.            standards, has many useful articles about programming
  103.            techniques/tools and seems to be a lively forum about
  104.            FORTH issues in general.  Dues are $15 a year. 
  105.  
  106.         B. August 1980 issue of BYTE magazine.  This FORTH theme
  107.            issue served as the inspiration for many of us FORTH
  108.            latecomers.
  109.  
  110.         C. Dr. Dobb's Journal. Especially the annual FORTH issues
  111.            every September.
  112.  
  113.  
  114. 3. Startup experiences
  115.  
  116.         I downloaded MVPFORTH.ASM and MVPFORTH.COM (as MVPCOMND.COM)
  117. using an XMODEM protocol from Gene Plantz's RBBS Chicago bulletin
  118. board.  My display flipped to 40 column colored text mode when I invoked
  119. the binary file ( it was in 80 col b&w mode ).  However normal simple
  120. FORTH commands and math seemed to work fine.  I discovered a control-P,
  121. not a control-prtsc toggled the printer echo on and off.  Just like the
  122. CP/M-80 versions of FORTH I have used.  
  123.  
  124.         The next step was to do a VLIST with the printer echo on and
  125. see what I got.  Hooray!  An EDITOR, a 8088 ASSEMBLER, double number
  126. extensions, fig-FORTH and FORTH-79 equivalences, and the normal misc
  127. extensions like TRIAD, INDEX, etc.  The VOCABULARY worked like the
  128. FORTH-79 STANDARD with only the EDITOR or the ASSEMBLER being present
  129. when invoked in addition to the FORTH vocabulary.
  130.  
  131.         A quick glance at the EDITOR words led me to think it worked
  132. like the fig line editor.  I put a couple of new formated disks in
  133. my drives:
  134.  
  135.                 20 LIST                 got a bunch of + signs.  OK
  136.  
  137.                 20 CLEAR 20 LIST        nice 16 * 64 numbered blank screen
  138.  
  139.                 L                       unknown. LIST did not invoke
  140.                                         the EDITOR vocabulary automatically
  141.  
  142.                 EDITOR L                worked.  got an EDITOR screen display
  143.  
  144.                 0 P line 0              seemed to work
  145.  
  146.                 1 P line 1
  147.  
  148.                 L                       the second " line 1 " was displayed
  149.                                         on the first line. not working
  150.  
  151.                 EMPTY-BUFFERS           giving up. I put the original DOS
  152.                                         disk with MVPFORTH.COM back in drive A
  153.  
  154.                 BYE                     returned to MSDOS OK
  155.  
  156. I thought I could not do anything till I got ALL ABOUT FORTH in the mail
  157. from Mountain View Press.  The EDITOR seemed to be a line editor like the
  158. fig version I was familar with, but at first glance seemed to be broken.
  159.  
  160.         The MVPFORTH.ASM kernal source was assembled error free at work
  161. using the Microsoft MASM assembler.  It has very few comments but at least
  162. I had a good cross-referenced assembler output listing to figure out the
  163. actions of the FORTH words.
  164.  
  165.         Then I had a recollection about a different kind of FORTH line
  166. editor described in STARTING FORTH.  Those commands work!  Now I thought
  167. it worthwhile to pour over the assembly source and figure out what was
  168. flipping my USI Multidisplay video adapter to 40 columns.  The PAGE
  169. command vectored to <PAGE> which did an INT 10H bios rom video call with
  170. 0 in the AL register and 0 in the AH register.  That will do it.  I had
  171. to do that INT call with 2 in the AL register.  Here is the code that
  172. will fix the 40 column problem for those of you who use cheaper 15.75 kHz
  173. composite B&W monitors or expensive RGB monitors with the color graphics
  174. adapter:
  175.                 DECIMAL
  176.  
  177.                 : <PAGEW>  2 0 0 0 16 INTCALL DROP ;
  178.  
  179.                 FIND <PAGEW> 'PAGE !    ( save new code version in PAGE
  180.                                           vector )
  181.  
  182.                 FREEZE                  ( now can't FORGET what was just
  183.                                           done )
  184.  
  185.                 SAVE-FORTH              ( saves memory image of MVPFORTH
  186.                                           on MSDOS disk A: as COMMAND.COM )
  187.  
  188.  
  189.  
  190. and here is a quickie that will blank all 160 blocks on a 5.25"
  191. single-sided disk (8 sectors per track) which is what MVPFORTH
  192. defaults to:
  193.  
  194.                 DECIMAL
  195.                 : IDISK  160 0 DO I CLEAR LOOP ;
  196.  
  197. The CONFIGURE word will let you declare your drives to be double-sided
  198. and give you blocks 0 to 359 availible instead of 0 to 159.  Try it,
  199. its menu driven.
  200.  
  201.  
  202.  
  203.         Naturally after doing the above I finally got my hands on a 
  204. borrowed copy of ALL ABOUT FORTH and verified that what I had just done
  205. was ok.  That's like reading the instructions after putting the child's
  206. bike together.
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220. 
  221.  
  222. e
  223. was o