GENERAL INFORMATION         
*******************
04.02.97, Hanno Schwalm / RISC OS Forthmacs
support: schwalm@bre.winnet.de


StrongED SUPPORT
****************
As StrongED is my editor-of-choice i have done some work to improve
Forth programming on it.
There is a StrongED Forth mode file available that supports syntax
colouring as well as folding.
Another major point is the SEARCH application, giving the information
for the word under the cursor in another StrongED text window or as
an HTML document if a HTML browser is known to RISC OS.
You find everything in Forthmacs:risc_os.strong.Forth; just follow
the instructions at the beginning of that file.


HOW TO OUT MORE ABOUT FORTHMACS
*******************************
To get a list of Forthmacs words, type
     words

you get a list of all words available in the current vocabulary,
now you can do
     whatis words     
     whatis locals|
or whatever you like.

     whereis register
will tell you the vocabulary where you can find register.

To use the disassembler & decompiler use
     see words
     see swap



WORKING DISK TOOLS
******************
All tools in the current WorkDisc release can be selected by the
options menu in the 4th launcher.


DIRECTORY TREE INFORMATION
**************************
!4thmacs is the topmost directory in the RISC OS/Sun Forth/Forthmacs directory
tree. The overall structure is basically 2 levels.  First-level subdirectories
are operating-system or application specific, and second-level subdirectories
are CPU-specific.  Thus we have  unix/  which contains files specific to the
Unix operating system, and  unix/m68k  which is specific to the 680x0
processor family, when running under the Unix operating system.  At any
level, SCCS subdirectories may appear.  Some subdirectories may not be
present in all distributions.

                        Subdirectories:

        Miscellaneous:

README          This file
doc             Documentation


        Operating-system Specific Directories:

unix            For the Unix operating system; actually for Sun OS currently
cwrapper        For interfacing Forth to an operating system using C for
                        the I/O
stand           For Forth running as a "standalone" diagnostic application
                        using the Sun Boot PROM "ROMvec" I/O services.
                        This directory also contains some stuff that is
                        applicable for any version where the processor is
                        running in privileged mode, but not necessarily
                        specific to the "ROMvec" I/O environment.
sun             Utility routines specific to the Sun CPU architecture
                        e.g. access to the Sun MMU
risc_os         For RISC OS operating system


        Application Specific Directories (OS-independent)

kernel          The Forthmacs kernel
extend          Extensions compiled on the kernel to make a pleasant
                        Forth development environment
lib             Forth programs and subroutines which are not normally
                        resident in the default Forth dictionary; loadable
devices         Device drivers for UARTs, disk interface chips, etc.
meta            The metacompiler.  Used to cross-compile a new Forth kernel



RESERVED EXCEPTION# USED BY FORTHMACS
*************************************
        0-255 ANS defined
      256-299 portable Forthmacs kernel
      300-339 extend.*
      340-459 extend.arm.*
      340-459 extend.sun.*
      340-459 extend.68k.*
      400-449 lib.*
      500-599 meta/target compiler
      600-699 RiscOS
      700-799 Atari OS
      800-899 OS9 
      900-999 SUN OS, Solaris
      -1099   Window environment - portable part
      -1999   Reserved 
      -2999   Reserved for Forthmacs applications
      3000 -  free to be used by user applications

