home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / PYGMY.ZIP / README.PYG < prev    next >
Encoding:
Text File  |  1989-08-28  |  4.5 KB  |  106 lines
  1.    Pygmy - a cmFORTH-like Forth by Frank Sergeant     - 28 Aug 89
  2.  
  3.    Welcome to Pygmy.  The documentation is in block files that will be
  4. opened automatically when you bring up Pygmy.
  5.  
  6.    Pygmy includes
  7.          1. a fast screen oriented block editor
  8.          2. an 8088/8086 assembler
  9.          3. full source code
  10.          4. full meta-compiler
  11.          5. up to 15 files open & accessible at one time
  12.          6. default set of files opened automatically
  13.          7. FOR/NEXT, PUSH, POP, \, COMPILER vocabulary and
  14.             other cmFORTH improvements
  15.          8. Direct screen writes for speed for monochrome (tested)
  16.             & color & Compaq (not tested).
  17.          9. vectored I/O  ( EMIT, KEY, KEY?, CR )
  18.         10. documentation and help files
  19.         11. a *Starting Forth* compatibility file for people new
  20.             to Forth
  21.  
  22. WHAT IS PYGMY?
  23.  
  24.    Pygmy is a lean fast Forth for the IBM PC/XT.  It is based on
  25. Charles Moore's cmFORTH for the NOVIX Forth chip.  I have made many
  26. changes to allow it to run on a PC and other changes as well.
  27.  
  28.    cmFORTH was designed to run on a NOVIX connected by a serial line to
  29. a host terminal or computer that would supply editing and file storage
  30. services.  Therefore, cmFORTH does not include an editor.  Also, no
  31. assembler is needed because the NOVIX's assembly language is Forth
  32. (more or less).
  33.  
  34.    Pygmy does include an editor & assembler.  Still it only takes up
  35. about 12K bytes with the assembler and about 9K bytes without the
  36. assembler.  It comes with its complete source code, including a
  37. meta-compiler, so that it can recompile itself.  The meta-compiler can
  38. also be used for target compiling custom applications.  In this case
  39. you can eliminate the parts (such as the editor & assembler & various
  40. utilities, etc.) that the final application will not need.
  41.  
  42.    Pygmy is direct threaded with top of stack kept in a register.  It
  43. has (in my opinion) quite a comfortable screen oriented block editor.
  44. You can move quickly from screen to screen with the PgDn & PgUp keys.
  45.  
  46.    Pygmy allows you to have 15 files open at one time.  These are all
  47. accessible "simultaneously" at different screen numbers (none of the
  48. OPEN/FROM as used in F83).  Your default files are opened automatically
  49. and the defaults can be changed, of course, and additional files can be
  50. opened. .FILES shows you the defaults and the documentation shows
  51. examples of how to reset them.
  52.  
  53.  
  54. HOW TO RUN THE PROGRAM
  55.  
  56.    If Pygmy is distributed in an ARC file, unarc it.  Assuming the files are now
  57. on a floppy in drive A, if you are going to run from a floppy, make a backup
  58. copy first.  If you are going to run from a hard disk, set up a directory and
  59. copy all of the files to that directory as in the following example.
  60.            C:\>md pyg
  61.            C:\>cd pyg
  62.            C:\PYG\>copy a:*.*
  63.  
  64.     Then bring up Pygmy by typing
  65.            C:\PYG\>pygmy          ( if you have a monochrome monitor)
  66.         or
  67.            C:\PYG\>pygmyc         ( if you have a color monitor)
  68.  
  69.  
  70.    Once you see Pygmy's greeting you can browse through the
  71. documentation by typing     601 EDIT    (end all commands or lines
  72. by pressing <Enter>).  Then just start browsing with the
  73. PgDn & PgUp keys.  To get out of the editor press Esc and to get back
  74. in where you left off, type   ED
  75.  
  76.    To browse other files, press Esc to get out of the editor and then
  77. type    n EDIT    where n is the screen you want to start looking
  78. at.  To see what files have been opened automatically, get out
  79. of the editor and type   .FILES 
  80.  
  81.  
  82. IF YOU HAVE TROUBLE USING PYGMY WITH YOUR MONITOR:
  83.  
  84.    If you do not have the complete set of files, ignore the open errors
  85. and do the best you can.  If you only have PYGMY.COM  or PYGMYC.COM and
  86. it is not the right one for your monitor, you can modify it "in the
  87. dark," so to speak.  First make sure Pygmy is running, even though no
  88. output is getting to the screen.  Do this by typing    BYE  followed by
  89. pressing Enter ('BYE' must be in upper case).  If Pygmy returns you to
  90. DOS, then it is working fine.  Bring Pygmy up again and type
  91.  
  92.      HEX   B000  VID  !  <Enter>
  93.            03B4  CRTC !  <Enter> to work with a monochrome monitor
  94.  or
  95.      HEX   B800  VID  !
  96.            03D4  CRTC !  <Enter> to work with a color monitor or a
  97.                                  Compaq
  98.  
  99. COMPLAINTS & ERROR REPORTS
  100.  
  101.    I can be reached as F.SERGEANT on GEnie or via the postal service
  102. as         Frank Sergeant
  103.            809 W. San Antonio St.
  104.            San Marcos, Texas  78666.
  105.  
  106.