home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / f / forthmac / !Forthmacs / risc_os / readme < prev    next >
Encoding:
Text File  |  1997-04-19  |  3.7 KB  |  110 lines
  1. GENERAL INFORMATION         
  2. *******************
  3. 04.02.97, Hanno Schwalm / RISC OS Forthmacs support schwalm@bre.winnet.de
  4.  
  5.  
  6. StrongED SUPPORT
  7. ****************
  8. As StrongED is my editor-of-choice i have done some work to improve
  9. Forth programming on it.
  10. There is a StrongED Forth mode file available that supports syntax
  11. colouring as well as folding.
  12. Another major point is the SEARCH application, giving the information
  13. for the word under the cursor in another StrongED text window or as
  14. an HTML document if a HTML browser is known to RISC OS.
  15. You find everything in Forthmacs:risc_os.strong.Forth; just follow
  16. the instructions at the beginning of that file.
  17.  
  18.  
  19. HOW TO OUT MORE ABOUT FORTHMACS
  20. *******************************
  21. To get a list of Forthmacs words, type
  22.      words
  23.  
  24. To get a list of all words available; now you can do
  25.      whatis words     
  26.      whatis locals|
  27. or whatever you like.
  28.  
  29.      whereis register
  30. will tell you the vocabulary where you can find register.
  31.  
  32. To use the disassembler & decompiler use
  33.      see words
  34.      see swap
  35.  
  36.  
  37.  
  38. WORKING DISK TOOLS
  39. ******************
  40. All tools in the current WorkDisc release can be selected by the
  41. options menu in the 4th launcher.
  42.  
  43.  
  44. DIRECTORY TREE INFORMATION
  45. **************************
  46. !4thmacs is the topmost directory in the RISC OS/Sun Forth/Forthmacs directory tree.
  47. The overall structure is basically 2 levels.  First-level subdirectories
  48. are operating-system or application specific, and second-level subdirectories
  49. are CPU-specific.  Thus we have  unix/  which contains files specific to the
  50. Unix operating system, and  unix/m68k  which is specific to the 680x0
  51. processor family, when running under the Unix operating system.  At any
  52. level, SCCS subdirectories may appear.  Some subdirectories may not be
  53. present in all distributions.
  54.  
  55.                         Subdirectories:
  56.  
  57.         Miscellaneous:
  58.  
  59. README          This file
  60. doc             Documentation
  61.  
  62.  
  63.         Operating-system Specific Directories:
  64.  
  65. unix            For the Unix operating system; actually for Sun OS currently
  66. cwrapper        For interfacing Forth to an operating system using C for
  67.                         the I/O
  68. stand           For Forth running as a "standalone" diagnostic application
  69.                         using the Sun Boot PROM "ROMvec" I/O services.
  70.                         This directory also contains some stuff that is
  71.                         applicable for any version where the processor is
  72.                         running in privileged mode, but not necessarily
  73.                         specific to the "ROMvec" I/O environment.
  74. sun             Utility routines specific to the Sun CPU architecture
  75.                         e.g. access to the Sun MMU
  76. risc_os         For RISC OS operating system
  77.  
  78.  
  79.         Application Specific Directories (OS-independent)
  80.  
  81. kernel          The Forthmacs kernel
  82. extend          Extensions compiled on the kernel to make a pleasant
  83.                         Forth development environment
  84. lib             Forth programs and subroutines which are not normally
  85.                         resident in the default Forth dictionary; loadable
  86. devices         Device drivers for UARTs, disk interface chips, etc.
  87. meta            The metacompiler.  Used to cross-compile a new Forth kernel
  88.  
  89.  
  90.  
  91. RESERVED EXCEPTION# USED BY FORTHMACS
  92. *************************************
  93.         0-255 ANS defined
  94.       256-299 portable Forthmacs kernel
  95.       300-339 extend.*
  96.       340-459 extend.arm.*
  97.       340-459 extend.sun.*
  98.       340-459 extend.68k.*
  99.       400-449 lib.*
  100.       500-599 meta/target compiler
  101.       600-699 RiscOS
  102.       700-799 Atari OS
  103.       800-899 OS9 
  104.       900-999 SUN OS, Solaris
  105.       -1099   Window environment - portable part
  106.       -1999   Reserved 
  107.       -2999   Reserved for Forthmacs applications
  108.       3000 -  free to be used by user applications
  109.  
  110.