home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / FFA.ZIP / INTRO.SEQ < prev    next >
Encoding:
Text File  |  1988-01-11  |  6.8 KB  |  180 lines
  1. For the experienced user, here are some quick hints on how to get started
  2. in FF quickly;
  3. To open and edit an existing file:              SED <filename> <enter>
  4. To leave the editor and save changes:           ESC
  5. To leave the editor and discard changes:        Shift-ESC
  6. To create and edit a new filename:              SED <newfilename> <enter>
  7. To load a file:                                 FLOAD <filename> <enter>
  8. To load a file already open:                    OK <enter>
  9. To edit a file already open:                    ED <enter>
  10. To open a file:                                 OPEN <filename> <enter>
  11. To view a words source:                         VIEW <word> <enter>
  12. To edit a viewed words source:                  ED <enter>
  13. To scan through an open file:                   N <enter> and B <enter>
  14. To relist the last screen displayed:            L <enter>
  15. To see all words containing a string:           WORDS <substring> <enter>
  16. To de-compile a dictionary word to the screen:  SEE <wordname> <enter>
  17.  
  18.                                         ** Type N <enter> for more Help **
  19. Example;        WORDS H <enter>
  20.  
  21.   Will print all words in dictionary containing "H".
  22.  
  23. --[ FORTH ]--
  24.         OPEN            $HOPEN          HOPEN
  25.  
  26. Example;        VIEW HOPEN <enter>
  27.  
  28.   Will display the source code for HOPEN.
  29.  
  30. Example;        ED <enter>
  31.  
  32.   Will enter the editor on the source for HOPEN.
  33.  
  34.         ** Type N <enter> for more Help, or B <enter> to backup **
  35.  
  36. Example;        ESC             ( while in the editor )
  37.  
  38.   Will leave the editor saving any changes, so don't make any! Use
  39. Shift-ESC to leave without saving changes.
  40.  
  41. Example;        FLOAD VIEW <enter>
  42.  
  43.   Will load the entire file VIEW.SEQ.
  44.  
  45. Example;        SED VIEW <enter>
  46.  
  47.   Will enter the editor on file VIEW.SEQ. The extension .SEQ is used
  48. if no extension is specified.
  49.  
  50.         ** Type N <enter> for more Help, or B <enter> to backup **
  51.  
  52. Example;        OK <enter>
  53.  
  54.   Will compile the currently open file. This is the same as FLOAD but
  55. works on the most recently edited or viewed file.
  56.  
  57. Example;        SEE HEX <enter>
  58.  
  59. Displays;       : HEX
  60.                         16 BASE ! ;
  61.  
  62.   Allows you to see the source for a ":" definition without having the
  63. source file available on disk.
  64.  
  65.         ** Type N <enter> for more Help, or B <enter> to backup **
  66.  
  67.   You have been using N and B to move around in this INTRODUCTION file,
  68. in addition you can use:
  69.  
  70.                 <n1> LIST <enter>       \ Lists 16 lines starting at <n1>.
  71.                 <n1> LOAD <enter>       \ Start loading file at <n1>.
  72.                 LISTING <enter>         \ Print out the current file.
  73.                 SED <newfile> <enter>   \ Create the file <newfile> if it
  74.                                         \ does not already exist.
  75.                 WORDS *.* <enter>       \ list ALL words in ALL vocabularies.
  76.                                         \ This is a special case, not general.
  77.                 WORDS CODE.*            \ List all CODE words.
  78.                                         \ The other special case.
  79.                 INDEX <enter>           \ display first line of all .SEQ
  80.                                         \ files in current directory.
  81.  
  82.         ** Type N <enter> for more Help, or B <enter> to backup **
  83.  
  84.   There is a considerable amount of documentation provided on disk to
  85. assist you in discovering FF.  If you have not already made printouts
  86. of all of these files, here is a command to print all of the .TXT
  87. files in the current directory:
  88.  
  89.                 FPRINT *.TXT <enter>
  90.  
  91.   Be sure your printer is ready for printing, and have at least 75 sheets
  92. of paper available to complete the job.
  93.  
  94.  
  95.         The next section of INTRO will tell you about some of the
  96.         features of FF.
  97.  
  98.         ** Type N <enter> for more Help, or B <enter> to backup **
  99.  
  100.   FF is a Forth derived from many sources. Henry Laxen, and Micheal Perry
  101. being the original developers. My name is Tom Zimmer, I along with
  102. Robert L. Smith, Charles Curley, and Jerry Modrow put together this Forth.
  103.  
  104.   FF is a Direct Threaded Code Forth. That is it contains CODE in the
  105. CODE field rather than pointing to CODE. DTC gives a noticable boost
  106. in performance, which was needed to counteract the next enhancement.
  107.  
  108.   FF keeps the BODYs or LIST portion of ":" (colon) definitions in a
  109. seperate segment. This substantially increases the space available for
  110. your program. There is a penalty to pay in performance, with an extra
  111. level of indirection required in NEST.
  112.  
  113.  
  114.         ** Type N <enter> for more Help, or B <enter> to backup **
  115.  
  116.   FF has a PREFIX assembler. CODE definitions are coded with a syntax
  117. similar to MASM, in the form " MOV AX, BX ".  We have found this syntax
  118. to be much more readable to "traditional" programmers than the standard
  119. F83 assembler.  To reduce the pain to current F83 users, the assembler
  120. supports the old F83 assembler syntax as well. Just use the word
  121. POSTFIX to select Postfix assembler syntax, and then use PREFIX to
  122. switch back to the Prefix syntax.
  123.  
  124.   FF supports full pathnames and file handles. Filenames may be up to
  125. 63 characters in length including path.
  126.  
  127.   All source is in sequential files. No blocks in this system. The
  128. original F83 BLOCK system is available as a load-on if needed.
  129.  
  130.         ** Type N <enter> for more Help, or B <enter> to backup **
  131.  
  132.  
  133.   An 8086 family disassembler is provided. The disassembler was
  134. written by Charles Curley, and includes 8087 support added by Robert
  135. L. Smith.
  136.  
  137.  
  138.   The compiler itself has been substantially optimized, with almost
  139. all of WORD being in CODE. The system currently uses 32 threads, which
  140. is just at the point of diminishing return for a 1000 word vocabulary.
  141. With the 8 vocabularies this system has, only about 512 bytes of CODE
  142. space is used for the Vocabulary HEAD pointers.
  143.  
  144.  
  145.  
  146.         ** Type N <enter> for more Help, or B <enter> to backup **
  147.  
  148.   A help file is provided with each source file, these can be used
  149. like F83 shadow screens were used, that is to hold comments about the
  150. words in the source file. The word VIEW accesses the .SEQ file, and
  151. the word HELP accesses the .HLP file. As much or as little text can
  152. be placed in the help file for each word compiled.
  153.  
  154.   Many utilities are included. An enhanced DEBUGger allows nesting
  155. and unnesting of ":" definitions.
  156.  
  157.   Several powerful file words have been included. FLOOK allows searching
  158. through one or many files for a particular character sequence. FPRINT
  159. allows you to make formatted listings of one, all, or a set of Forth
  160. source files. INDEX displays the first line of a set of files.
  161.  
  162.         ** Type N <enter> for more Help, or B <enter> to backup **
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.                        END OF INTRO FILE
  172.  
  173.  
  174.  
  175.  
  176. ******* This is the last screen of help, Type B <enter> to backup ********
  177.  
  178.  
  179. The End. Stop Now. or press B to backup.
  180.