home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / forthmacs / workdisc / !Forthmacs / readme < prev   
Encoding:
Text File  |  1996-02-16  |  7.9 KB  |  183 lines
  1. GENERAL INFORMATION         
  2. *******************
  3. Hanno Schwalm / RiscOS Forthmacs support support@4thware.winnet.de
  4.  
  5. ***** Directory structure 3.1/2.01 **************************************
  6. * all files Forthmacs:bin.loadxxx, Forthmacs:risc_os.loadxxx have been  *
  7. * removed to bin.load.xxx, rosc_os.load.xxx for better overviews        *
  8. * Each installed archive has an action/info file loaded once after      *
  9. * installation. The auto-install tools has been improved                * 
  10. *************************************************************************
  11.  
  12. ***** Dynamic memory handling 3.1/2.01 **********************************
  13. * The dynamic memory handling was done by RiscOS heap functions. This   *
  14. * has been replaced by an internal memory manager using a common space  *
  15. * for the dictionary and the heap.                                      *
  16. * No need for Forthmacs$heapsize any more!                              *
  17. *************************************************************************
  18.  
  19. ***** File interface 3.1/2.00 *******************************************
  20. * Sometimes the editor leaves a $a0 as a whitespace, unvisible for my   *
  21. * eyes. But until now SCANBL and SKIPBL, two of the 4 most important    *
  22. * text-scanning primitives were working incorrect in rare and nonvisible*
  23. * occasions.                                                            *
  24. *************************************************************************
  25.  
  26. ***** Auto 3.1/1.98 *****************************************************
  27. * auto files couldn't be updated with the 'installing' feature so far.  *
  28. * This was due to the auto file beeing open at that time.               *
  29. * To overcome this, the autofile is copied from risc_os.auto_copy       *
  30. * every time, RiscOS Forthmacs is !Booted.                              *
  31. * So when changing your autofile, BEWARE!                               *
  32. *                                                                       *
  33. * compile has been removed, now use postpone                            *
  34. *************************************************************************
  35.  
  36. ***** StrongED support **************************************************
  37. * There is now a StrongED Forth mode file available, the major point is *
  38. * the whatis application, giving the standard whatis info for the word  *
  39. * under the cursor.                                                     *
  40. * There are html help files available NOW                               *
  41. *************************************************************************
  42.  
  43.  
  44. ***** Arithmetics 3.1/1.90 **********************************************
  45. *  Arithmetics have been redesigned, ANS compliant 'scaling' words    *
  46. *  have double 64 intermediate results.                    *
  47. *  Also the number conversion words use doubles.            *
  48. *  The interpreter/compiler accept double numbers like 2.000        *
  49. *                                    *
  50. *  In many/most of these redefinitions the stack effect has changed.    *
  51. *  This has been done so after careful evaluation of pros and cons.    *
  52. *  All changes have been documented in the manual, a printed        *
  53. *  manual update is available to registered users for 15£ 35DM incl.    *
  54. *                                    *
  55. *  The 'compatible' mode defined by lib.compatible will NOT include    *
  56. *  these changes because sources could not be compatible at all.    *
  57. *  All future versions will rely on this, versions up to 1.83 will not    *
  58. *  be 'supported any more!                        *
  59. *                                    *
  60. *  You should notice that ALL words having non-ANS stack effects will   *
  61. *  be redefined and documented over the next months.            *
  62. *  There will be no significant Forth-83 market any longer, existing    *
  63. *  applications can still use the older versions. New developments will    *
  64. *  all use the ANS standard.                        *
  65. *                                    *
  66. *  For those who can't cope with ANS but need some of the new features    *
  67. *  I will do some special support on demand.                *
  68. *                                    *
  69. *  For more details see risc_os.versions or the manual.            *
  70. *************************************************************************
  71.  
  72.  
  73. **** Note for 3.0/1.8x *************************
  74.   Some kernel words have been removed to vocabulary SYSTEMS or HIDDEN.
  75.   As long as you didn't use any undocumented words this shouldn't matter,
  76.   BUT in case you did and the compiler mocks about not finding a word,
  77.   locate the word by WHERIS XXX and include the given vocabulary in your
  78.   search order list.
  79. ************************************************
  80.  
  81.  
  82. **** RiscPC / ARM6/7 ***************************
  83.   I have no direct hold on any of the new acorn machines. Forthmacs cpu
  84.   and RiscOS specific code has been written according to the ARM and
  85.   Acorn programming ideas and their programming manuals.
  86.   BUT ... you never know. I havn't heard about any problems referring
  87.   to the new machines yet, but I wouldn't be totally surprised.
  88.   So whenever you run into a bug/error let me know.
  89. *************************************************
  90.  
  91.  
  92. **** microEMACS support *************************
  93.   As the WIMP integration takes more time than I initially
  94.   thought, there is strong need for a better editor
  95.   support. Emacs Forth environment knows about the
  96.   whatis_doc and can extract information on demand.
  97.   included in 1.83d
  98. *************************************************
  99.  
  100.  
  101.  
  102.  
  103.  
  104. To get a list of Forthmacs words, type
  105.      words
  106.  
  107. To get a list of all words available; now you can do
  108.      whatis words     
  109.      whatis locals|
  110. or whatever you like.
  111.  
  112.      whereis register
  113. will tell you the vocabulary where you can find register.
  114.  
  115. To use the disassembler & decompiler use
  116.      see words
  117.      see swap
  118.  
  119.  
  120. Manual files are kept in Forthmacs:docs.ascii, a list of manual files
  121.      will be shown with:
  122.  ls Forthmacs:docs.ascii
  123.  
  124. To get information about Forthmacs, you might do:
  125.      more docs.ascii.copyright
  126.      more docs.ascii.convention
  127.      more readme
  128.      more !Help
  129.      more Forthmacs:docs.ascii.tutorial
  130.  
  131. WORKING DISK TOOLS
  132. ******************
  133.  
  134. 1) Forth level debugger    fload debugger
  135. 2) runtime profiler    fload profiler
  136. 3) The block interface    fload blocks
  137.  
  138. DIRECTORY TREE INFORMATION
  139. **************************
  140.  
  141. This is the topmost directory in the Sun Forth/Forthmacs directory tree.
  142. The overall structure is basically 2 levels.  First-level subdirectories
  143. are operating-system or application specific, and second-level subdirectories
  144. are CPU-specific.  Thus we have  unix/  which contains files specific to the
  145. Unix operating system, and  unix/m68k  which is specific to the 680x0
  146. processor family, when running under the Unix operating system.  At any
  147. level, SCCS subdirectories may appear.  Some subdirectories may not be
  148. present in all distributions.
  149.  
  150.                         Subdirectories:
  151.  
  152.         Miscellaneous:
  153.  
  154. README          This file
  155. doc             Documentation
  156.  
  157.  
  158.         Operating-system Specific Directories:
  159.  
  160. unix            For the Unix operating system; actually for Sun OS currently
  161. cwrapper        For interfacing Forth to an operating system using C for
  162.                         the I/O
  163. stand           For Forth running as a "standalone" diagnostic application
  164.                         using the Sun Boot PROM "ROMvec" I/O services.
  165.                         This directory also contains some stuff that is
  166.                         applicable for any version where the processor is
  167.                         running in privileged mode, but not necessarily
  168.                         specific to the "ROMvec" I/O environment.
  169. sun             Utility routines specific to the Sun CPU architecture
  170.                         e.g. access to the Sun MMU
  171. risc_os         For RiscOS operating system
  172.  
  173.  
  174.         Application Specific Directories (OS-independent)
  175.  
  176. kernel          The Forthmacs kernel
  177. extend          Extensions compiled on the kernel to make a pleasant
  178.                         Forth development environment
  179. lib             Forth programs and subroutines which are not normally
  180.                         resident in the default Forth dictionary; loadable
  181. devices         Device drivers for UARTs, disk interface chips, etc.
  182. meta            The metacompiler.  Used to cross-compile a new Forth kernel
  183.