home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / RiscOS / APP / DEVS / FORTH / WIMPFO.ZIP / !WimpForth / !Help next >
Text File  |  1996-03-21  |  5KB  |  120 lines
  1.  
  2.               Some Sort of Documentation on !WimpForth
  3.  
  4.     Here is the first release of !WimpForth you probably waited for
  5.     a long time. Its main purpose is to make it easier to write
  6.     Forth programs running under the Wimp of RISC OS. For now it
  7.     uses in its bootup sequence Version 3.10, but I haven't used
  8.     RISC OS 3 routines awfully lot, so that it should also run
  9.     if you change the number in the code.
  10.     
  11.     The Forth machine is VERY tough to the Win32Forth machine
  12.     designed by Andrew McKewan and Tom Zimmer. They both deserve
  13.     big thanks, since I reused so much code (and it was reusable!)
  14.     that you might call WimpForth a port of Win32Forth (originally
  15.     on ******* 95/NT).
  16.     
  17.     But nevertheless there are some differences. WimpForth has
  18.     an ARM assembler/disassembler and a full ARM machine code kernel.
  19.     For differences in machine design please have a look at the file
  20.     "DesignNote".
  21.     
  22.     Important features of WimpForth:
  23.     * As I copied the functionality from an ANS compliant system,
  24.       you should be able to compile ANS Forth programs on it.
  25.     * source level debugger, decompiler
  26.     * ARM assembler/disassembler
  27.     * object orientation like Yerk on the Macs teached the forthers
  28.     * window, icon, control, dialog, menu... classes to
  29.       make programming them as easy AND controllable as possible
  30.     * variable number of threads in vocabularies
  31.     * strong WORDS implementation
  32.     * easy invocation of CLI commands, time control, system variables
  33.     * local labels
  34.     * Wimp interface (yes, it's a real wimp program!)
  35.     * Drag&Drop Filer->Forth window will load forth files.
  36.     * reads normal text files with 16K buffer
  37.     
  38.     * AND FULL SOURCE INCLUDED - if you find bugs or features you
  39.       don't like, correct them in the source until they work as
  40.       you like, ***and report the error, please***
  41.       
  42.     Otherwise WimpForth will behave like other Forths, please refer
  43.     to standard literature ("Thinking Forth" - Leo Brodie) to learn
  44.     about the power of Forth.
  45.  
  46.     The first steps you could try anyway, are typing
  47.     "words",
  48.     "see interpret",
  49.     "1 2 +",
  50.     ".s",
  51.     "h.",
  52.     "vocs"
  53.     "order"
  54.     clicking MENU on the Forth Window and on the icon bar.
  55.     
  56.     For recompiling the whole system, run !WimpForth by double clicking
  57.     it from the filer and then start "F", which is a >130K executable
  58.     and includes the complete system. If that doesn't work, please
  59.     report to the email address below.
  60.     1) Now take the file "meta" from the filer and drop it on the
  61.     Forth window (or simply type "fload meta <return>"). Wait a few
  62.     seconds until the kernel is created, then quit WimpForth
  63.     by typing "bye" or selecting the Quit lines in the menus.
  64.     2) Then run the file "Xtend" which loads the file "extend" into the
  65.     just compiled kernel, and there you have your totally new system.
  66.     You may also take only the second step if you haven't done
  67.     anything to the kernel.
  68.    
  69.     For a little documentation on the words present in Wimp Forth,
  70.     watch out in the following files:
  71.     
  72.     fkernel   - holds the full source of the kernel
  73.     primutil  - some necessary utilities
  74.     dump      - a dump utility
  75.     dthread   - displays and counts threads and vocabularies
  76.     order     - implements wordlists and vocabularies
  77.     assert    - the assert wordset
  78.     primhash  - prepares class orientation
  79.     see       - a Forth decompiler
  80.     interpif  - makes conditional compiling possible
  81.     debug     - a Forth debugger
  82.     build     - experimental new defining word
  83.     words     - lists words in vocabularies, also good for searching
  84.     pasm      - ARM post-/prefix assembler
  85.     disarm    - ARM disassembler
  86.     utils     - bunch of utilities
  87.     args      - local labels
  88.     class     - object orientation
  89.     classdebug- to see/debug methods
  90.     colours   - wimp colour constants
  91.     icons     - icon classes
  92.     menus     - menu classes
  93.     windows   - window classes
  94.     controls  - dialog boxes... in classes
  95.     
  96.     extend    - loads them all together and adds the Wimp objects
  97.                 for WimpForth. Adaptable to have a CLI version.
  98.                 
  99.     config    - file gets loaded whenever WimpForth starts up
  100.     
  101.     ssort     - a simple Shell Sort routine, if you need it
  102.     winsee    - see words in windows
  103.     
  104.     That is all. I should notice that WimpForth comes 'as is', and
  105.     the authors cannot be made responsible for damage due to errors
  106.     in the program. You may make copies of WimpForth as often as
  107.     you like (SPREAD IT), but do not charge money for it. And
  108.     please, copy it completely whenever possible.
  109.     
  110.     If you find errors, uncovered cases, misfeatures etc.,
  111.     please report to
  112.     
  113.     laeuter@miaix550.mathematik.uni-leipzig.de
  114.     
  115.     or snail: Martin LΣuter
  116.               Endersstr. 38
  117.               04177 Leipzig
  118.               Fed. Rep. of Germany
  119.               
  120.     Happy Forthing!