home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / forth / compiler / eforth / read.me < prev   
Text File  |  1990-07-29  |  4KB  |  90 lines
  1. *********************************************************************
  2. eForth is a simple Forth model which can be easily ported to a wide
  3. range of CPU's.  It is best put into ROM and communicate to the
  4. outside through a serial RS232 line.  Files can be downloaded through
  5. the serial line also.  This eForth Model includes an implementation
  6. on IBM-PC.  The assembly source code is designed so that one can use
  7. MASM to assemble object code for any target CPU.  Only 29 words are
  8. coded in machine instructions, which can be easily modified to run
  9. on a target CPU other than 8086.  The eForth Model and the IBM-PC
  10. implementation is in the public domain to encourage interested
  11. programmers to port this model to different CPU's.
  12.  
  13.                                                 C. H. Ting
  14. *********************************************************************
  15.  
  16.                                                 July 29, 1990
  17.  
  18. Dear eForth Beta Tester:
  19.  
  20. This is the eForth Model which I promised to give you for evaluation
  21. and implementation.  Bill Muench and I labored quite intensively
  22. over the last four weeks chasing bugs, discussing many implementation
  23. and stylistic issues and experimenting various approaches and
  24. solutions.  We barely made the releasing date, July 28, at the FORML
  25. session of the Silicon Valley FIG chapter meeting.  As thing usually
  26. go, after I printed the documentation, Bill found it was necessary to
  27. overhaul the system for good reasons.  When we arrived at the SVFIG
  28. meeting, the documentation showed a phase delay from the code to be
  29. formally released.  Sounds very familiar.  Did I tell the same story
  30. somewhere else?
  31.  
  32. The solution is that we are including two versions of EFORTH.ASM on
  33. this diskette.  EFORTH.ASM is the new version that you should use
  34. to implement eForth on the CPU of your choice.  EFORTH.OLD contains
  35. the source code which generates the assembly listing as printed
  36. in the 'eForth Implementation Guide'.  EFORTH.ASM has much improved
  37. style and a set of new macros to assemble the headers.  It also
  38. fixed a bug in $," to aligned a compiled string to cell boundary.
  39. The order of words is also changed slightly to highlight the machine
  40. dependent I/O words.
  41.  
  42. The files on this diskette are:
  43.  
  44. EFORTH.ASM      The source code of eForth for IBM-PC 8086.
  45. EFORTH.SRC      The Forth source of eForth Model.
  46. EFORTH.GLO      The glossary of words in eForth.
  47. EFORTH.COM      The executable object of IBM-PC eForth.
  48. READ.ME         This file.
  49.  
  50. The assembly commands are:
  51.  
  52. >MASM EFORTH;
  53. >LINK EFORTH;
  54. >EXE2BIN EFORTH EFORTH.COM
  55. >EFORTH
  56.  
  57. The manual undoubtly needs much improvement.  As we start porting
  58. eForth to other CPU's, we will discover more problems which need
  59. explanation, especially to the first time Forth users, who are the
  60. intended audience of the eForth Model.  Your feedback will be
  61. greatly appreciated.
  62.  
  63. As machine dependency is consolidated into 29 code words, moving
  64. eForth to other CPU's will be much less of a chore comparing to other
  65. Forth models.  I am expecting that an implementation could be
  66. completed within 4 weeks, assuming that you are familiar with the
  67. instruction set of the target CPU and its enviornment.  I am especially
  68. interested in how long a student, upper level college or graduate,
  69. needs to implement it.  If you are teaching microprocessor in a
  70. school, please consider this model as a class assignment and
  71. monitor the reactions from the students.
  72.  
  73. Please send me your implementation as soon as possible.  Please
  74. let me know of any deficiency in this model also.  This project
  75. could significantly broaden the user base of Forth.  We really
  76. hope that it will help Forth reclaim its glory as the language
  77. of choice for embedded systems.
  78.  
  79. Thank you for your interests and encouragements in this project.
  80. I hope to hear from you soon.
  81.  
  82.                                         C. H. Ting
  83.                                         156 14th Avenue
  84.                                         San Mateo, CA 94402
  85.                                         (415) 571-7639
  86.  
  87. P.S. If you get this file from BBS, send me $15 for the manual
  88. 'eForth Implementation Guide' if you need it.
  89.  
  90.