home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / forth / fifth.arc / README.DOC < prev    next >
Text File  |  1986-03-02  |  3KB  |  64 lines

  1. Fifth is being offered as freeware, and is subject to the usual licensing
  2. procedures for such software.  This means that you are free to evaluate
  3. Fifth and to make Fifth available to others, but you can not sell it or
  4. at the stroke of twelve you will turn into Bill the Cat (tm?).
  5.  
  6. If you find Fifth useful, sends us 20 Beautiful American Dollars.
  7. $10 more gets you a 100+ page typeset manual. (Out of USA $15)
  8. Another $10 puts you on our mailing list.  We mail out programming tips,
  9. bug lists, and user comments at random intervals.
  10.  
  11. Feel Free to Call US!  Sorry no collect calls though...
  12.  
  13. CLICK Software   (409) 693-8853
  14. P.O. Box 10162
  15. College Station, Texas. 77840
  16.  
  17. P.S.  Fifth is being designed for the modern programmer.  What do YOU want
  18. to see in a programming environment?  Please send suggestions, ideas, etc
  19. to the above address.
  20.  
  21.  
  22. Fifth is an interactive program development environment. It supports
  23. FORTH as a base language. Multitasking and Software Virtual Memory
  24. (Source, object and data items larger than memory) on a 68000
  25. based version is in the works.
  26.  
  27. Fifth supports a concept of compile-by-demand, if an attempt to execute an
  28. uncompiled word is made, the word is compiled before execution.  Exiting
  29. the editor will also compile the word being edited, thus in most cases the
  30. programmer does not have to specify a compile stage.  The compiler is
  31. roughly 5 times faster than Turbo 3.0, and in most cases only the text
  32. being edited needs compiling, so the compile stage is usually invisible.
  33.  
  34. Fifth uses MSDOS files instead of screens & blocks.  Fifth uses 32 bit
  35. arithmetic, real numbers, automatic 8087 support, direct instead of threaded
  36. code, access to all of memory and a more interesting scoping scheme than
  37. FORTH's straight up global scoping.
  38.  
  39. Fifth includes two interesting commands:  HELP and DIR.  The HELP command
  40. provides on-line documentation for the calling parameters to the primitives
  41. in the system.  HELP requires you to have a file called FIFTH.HLP accessable.
  42. (The path searched is specified by HELPFILE under HELP.) A program, BLD.FIV,
  43. is provided so that users may extend the FIFTH.HLP file as they wish.
  44.  
  45. The DIR command invokes a menu-driven dictionary editor.  Using the arrow
  46. keys, the dictionary (which is a tree-like structure) may be traversed and
  47. modified.  Shift-left & right arrow will rearrange words on the same level,
  48. page-up and down will move words from level to level.  Play with it until
  49. it becomes familiar, it is the most often used feature of the system.  From
  50. the DIR command source files may be loaded and saved, compilations forced,
  51. etc.
  52.  
  53. To load and execute TOWERS.FIV, execute FIFTHIBM (or FIFTHTI) from DOS.
  54. At the FIFTHIBM> prompt type DIR<return>. Type 'L' (for Load), then the
  55. file name - TOWERS.FIV<return>. The TOWERS.FIV program will load. At the
  56. FIFTHIBM> prompt type 5 HANOI<return>. The number of disks in the tower may
  57. be altered from 1 to 12. Press any key (except space) to stop the program.
  58. Use the DIR command to inspect the program.
  59.  
  60. The WINDOW.FIV program needs to be run under EMULATE on the TI PC. TI users
  61. will need to change the MACHINE flag in the FRAC.FIV program to fully utilize
  62. the TI graphics resolution.
  63.  
  64.