home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / program / language / forth / !FORTH / User < prev   
Encoding:
Text File  |  1989-11-08  |  5.7 KB  |  154 lines
  1.  
  2.                        USER GUIDE OF THE !FORTH SYSTEM
  3.                        ===============================
  4.  
  5.  
  6.    For the time being just some notes so that you can use it  more easily.
  7.  
  8.                                              
  9.  
  10.                               GETTING STARTED
  11.                               ---------------
  12.    !FORTH is a normal aplication and can be double clicked to start as usual.
  13. !FORTH will install itself on the Iconbar, when on the Iconbar it is fully
  14. active, i.e. it will execute programs dragged onto it. Clicking on the !FORTH
  15. icon on the Iconbar will open the initial !FORTH window.
  16.  
  17.    !FORTH is a character based program, the initial window emulates an 80 by
  18. 25 screen. This window (and others that may be defined) can be resized and
  19. moved as normal, other windows can be moved on top of them, screen output 
  20. behaving properly. (i.e. not overwriting the top window, but see the Bug
  21. list). The !FORTH system emulates some of the VDU commands, specifically,
  22. those affecting the printer, and clearing the screen.
  23.  
  24.    !FORTH has only been tested in the following modes: 12, 15, 16. It is
  25. usable with a monochrone monitor, and works best in mode 16 (of those I have
  26. tested). 
  27.  
  28.    !FORTH can be multi-tasked, this can be shown by running Prog2 in one
  29. !FORTH window while other windows run !CLOCK, !USAGE, etc. Two or more !FORTH
  30. tasks can be run at the same time duble click on the !FORTH icon again to get
  31. two or more !FORTH icons on the iconbar. Then open the forth windows and run
  32. the Prog2 in them.
  33.  
  34.  
  35.  
  36.                           CREATING PROGRAMS
  37.                           -----------------
  38.  
  39.     Programs can be entered interactively, using the keyboard. Long programs
  40. and those which need to be edited, should be entered using !EDIT or any other
  41. text editor which produces ASCII files. Save the program to disc from the
  42. editor, then drag the file onto the !FORTH window, or drag the save box from
  43. !EDIT to the !FORTH window. It will then execute the file just as if it had
  44. been entered manually.
  45.  
  46.     There is no editor defined within the !FORTH environment, this is for a
  47. number of reasons, including:
  48.   1. I Haven't had time.
  49.   2. Using !EDIT works perfectly well.
  50.   3. It is not posible to work back from the compiled code to the definition.
  51.   4. The interactive session is not logged.
  52.  
  53.     However if anyone would like to write an editor (working in a separate
  54. window), I would like to here from them.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                        HOW TO USE TEXT WINDOWS
  61.                        -----------------------
  62.  
  63.    In version 1.2 multiple text windows can be defined. Entering the
  64. following creates a text window 60 characters across and 10 down called
  65. AWindow:
  66.  
  67. What Next> 60 10 NEWTXTWIND AWindow
  68.  
  69.    This window can be opened by:
  70.  
  71. What Next> AWindow OPENTEXTWIND
  72.  
  73.    A window will appear at the bottom of the screen which can be moved
  74. resized, as usual. The window will be created clear of text to write text
  75. into the window it is necessary to change the output window:
  76.  
  77. What Next> AWindow SETTXTWIND
  78.  
  79.    The new window will now accept normal text output and so the FORTH session
  80. will continue in this new window. To get back to the original window use:
  81.  
  82. What Next> FORTHTXTWIND SETTXTWIND
  83.  
  84.    NOTE: it is possible to lose the text output window (by clicking on the
  85. CLOSE WINDOW icon), if this happens click on the !FORTH icon on the menu bar
  86. and this will open the FORTHTXTWIND window and set the output window to it.
  87.  
  88.    Windows can also be closed and deleted by using CLOSETXTWIND and
  89. DELTXTWIND respectively. After a window has been deleted it should not be
  90. refered to again. Windows can be closed and then opened again multiple times.
  91.  
  92.    Windows can have their titles changed by TITLETXTWIND - does not currently
  93. work!
  94.  
  95.    Window positions can not be changed under program control at the moment.
  96.  
  97.  
  98.  
  99.                          VDU Commands Recognised
  100.                          -----------------------
  101.  
  102.    The !FORTH text windows emulate a subset of the Acorn VDU commands, it is
  103. not possible to set colours or to use graphics. Defining a text window and
  104. moving the text cursor are not currently supported, however you can use the
  105. predefined word TAB to move the text cursor.
  106.  
  107.    The following codes are supported (text windows):
  108.  
  109.    VDU code      meaning
  110.       0          Does nothing
  111.       1          Sends next character to printer only.
  112.       2          Enables printer
  113.       3          Disables printer
  114.       6          Enables VDU drivers
  115.       7          Generates bell sound
  116.       8          Moves cursor back one character
  117.       9          Moves cursor on one character
  118.       10         Moves cursor down one line
  119.       11         Moves cursor up one line
  120.       12         Clears text area
  121.       13         Moves cursor to start of current line
  122.       21         Disables VDU drivers
  123.       27         Does nothing
  124.       30         Homes text cursor
  125.  
  126.    The following commands are not supported but make no difference (text
  127. windows):
  128.  
  129.       4          Writes text at text cursor
  130.       20         Restores default logical colours
  131.       26         Restores default windows
  132.  
  133.    The following commands are not supported in this release but may be in
  134. future ones (text windows):
  135.  
  136.       28         Defines text window
  137.       31         Moves cursor
  138.  
  139.    The following commands are not supported (text windows):
  140.  
  141.       5          Writes text at graphics cursor
  142.       14         Turns page mode on
  143.       15         Turns page mode off
  144.       16         Clears graphics area
  145.       17         Defines text colour
  146.       18         Defines graphics colour
  147.       19         Defines logical colour
  148.       22         Selects screen mode
  149.       23         Multi-purpose command
  150.       24         Defines graphics window
  151.       25         PLOT
  152.       29         Defines graphics origin
  153.  
  154.