home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / forth / forthed.arc / FED.ASC < prev    next >
Encoding:
Text File  |  1987-09-09  |  11.6 KB  |  327 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         EDITOR                                       28Aug87 GmK
  8.  
  9.         The editor's primary purpose is to modify (edit) the contents of
  10.         a Forth screen.  It has a variety of functions available to
  11.         accomplish that task.  These functions can be divided into five
  12.         main categories:
  13.  
  14.              a. Cursor Movement (Up, Down, Left, Right, Home, End, Tab,
  15.                 etc.)
  16.              b. Character Modification (Insert, Delete, Type-over,
  17.                 Clear, etc.)
  18.              c. Line Handling (Line Insert, Delete, Save, Restore,
  19.                 Clear, etc.)
  20.              d. Screen Selection (Save, Undo, Abandon, Page-forward
  21.                 Page back, etc.)
  22.              e. String Processing (Find, Display/list, Replace, etc.)
  23.  
  24.         A secondary purpose of the Editor is screen management.  The
  25.         functions available to aid in managing screens are:
  26.  
  27.              Insert, Delete, Move, Copy, Exchange, and Import.
  28.  
  29.         The final purpose of the Editor is to scan the contents of
  30.         screens.  The functions available include:
  31.  
  32.              Page-up/down, Go to first/last/selected screen, and
  33.              Return to previous screen.
  34.  
  35.         The Editor may be entered in several ways, as described below.
  36.  
  37.              1. Type: EDIT <enter>
  38.  
  39.         This will place the Editor in it's "screen management" mode. In
  40.         this mode the Editor will read up to 60 contiguous screens from
  41.         the current storage media and place them into a RAM buffer. The
  42.         source and number of screens read will depend upon whether Forth
  43.         is in the Direct-Block or the File-Access mode and, if in the
  44.         File-Access mode whether a file is currently open.  In any case
  45.         the Editor will, if necessary, prompt for any input it requires.
  46.  
  47.         Once the screens are read into RAM, the Editor is ready to
  48.         manipulate the RAM resident copies of the selected screens.  A
  49.         help message across the bottom of the CRT indicates the
  50.         available screen-management functions.  A Help screen is also
  51.         available by pressing the F1 key.  This screen explains the
  52.         abbreviated Help messages and also indicates additional
  53.         functions that are available from the Editor command line.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.              2. Type: n DISP <enter>  (n is an optional screen number)
  74.  
  75.         This will place the Editor in the "scanning-mode".  In this mode
  76.         the Editor will bring into memory only screen n.  Again, a Help
  77.         message is displayed across the bottom of the CRT and the F1 key
  78.         will cause a Help screen to be displayed.
  79.  
  80.         Why are there two different modes available?  The EDIT mode is
  81.         most useful when a contiguous set of up to 60 screens is being
  82.         edited.  This mode provides a full set of screen manipulation
  83.         functions.  Screens may be moved, copied, exchanged, inserted,
  84.         deleted, and imported.  However, in exchange for this powerful
  85.         and flexible capability to manage screens, the screens must all
  86.         be within a contiguous set of no more than 60 screens.
  87.         (Applications requiring more than 60 screens can be sub-divided
  88.         into sets of up to 60 screens.)  The DISP mode allows complete
  89.         random access to all of the screens within a file of more than
  90.         60 screens (or to all of the screens on the selected media if
  91.         the Forth system is dealing with direct media access) but does
  92.         not support the full set of screen manipulation functions.  One
  93.         would choose the EDIT mode to update and manipulate many of a
  94.         contiguous set of up to 60 screens and would choose the DISP
  95.         mode to access a single screen or any of a large number of
  96.         widely separated screens.
  97.  
  98.         Both modes place the Editor in it's command state and display a
  99.         selected screen.  Another screen may be selected or the
  100.         displayed screen may be edited.  The screen editing functions
  101.         available are the same for either the EDIT or the DISP mode.
  102.  
  103.              3. Type: L <enter>
  104.  
  105.         This will return the Editor to the screen last edited. The
  106.         Editor will be in the same mode (EDIT or DISP) last used.
  107.  
  108.         To edit a screen from the Editor command line, simply press the
  109.         Home key.  This will move the cursor from the command line into
  110.         the displayed screen area and update the Help messages along the
  111.         bottom of the CRT.  (Pressing the F1 key will now display the
  112.         editing Help screen instead of the command Help screen.)  The
  113.         usual cursor movement and character Insert/Delete functions will
  114.         be available, as well as a set of three different, independent,
  115.         non-exclusive screen-to-screen line copy functions.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.         Each of these line copy functions has it's own buffer in which
  140.         to store captured lines and the contents of each of these
  141.         buffers are maintained across editing sessions.  Lines placed in
  142.         a buffer will remain in the buffer until the Forth system is
  143.         exited.  The same buffer contents may be used across multiple
  144.         editing sessions and between various files or media.  The
  145.         contents will only be lost if overwritten by the use of the
  146.         Forth RAM-Disk, by leaving Forth, or by turning the computer
  147.         power off. (Of course a crash will also wipe-out the contents of
  148.         the buffers, but does Forth ever crash?  Forget I asked!)
  149.  
  150.         The three line copy functions are:
  151.  
  152.         1. Lines Copy:
  153.  
  154.         Lines are selected and copied from a screen to the copy buffer
  155.         and may then be copied from the copy buffer to any selected
  156.         screen.  The copy remains in the copy buffer (until replaced by
  157.         selecting another set of lines to use) and may be copied from
  158.         the copy buffer to as many screens as desired.  The lines may be
  159.         copied anywhere on a screen that they will fit and will
  160.         overwrite the existing lines on the target screen.
  161.  
  162.         2. Lines Stack:
  163.  
  164.         Lines are either copied or moved (a move is a copy plus a
  165.         delete) from a screen to the stack buffer.  The captured lines
  166.         may then be placed on a different screen (or elsewhere on the
  167.         same screen).  Moving the lines from the stack buffer to a
  168.         screen will remove them from the stack buffer.
  169.  
  170.         3. Lines Barrel
  171.  
  172.         There are 16 positions available, in the barrel buffer, which
  173.         may be individually selected and copied to, from one or more
  174.         screens.  The contents of the barrel buffer may then be
  175.         nondestructively copied, individually or collectively to any
  176.         screen or set of screens.  Lines may be stored and accessed in
  177.         the barrel buffer in random order by rotating the barrel up or
  178.         down before use.
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.         Editing Commands
  206.  
  207.         Key       EDIT (Command line)           DISP (Command line)
  208.  
  209.         F1        Help                          Help
  210.         F2        Undo                          Undo
  211.         F3        Move a screen                 ---
  212.         F4        Move multiple screens         ---
  213.         F5        Copy a screen                 Copy a screen
  214.         F6        Copy multiple screens         Copy multiple screens
  215.         F7        Insert a blank screen         Insert a blank screen *
  216.         F8        Delete current screen         Delete current screen *
  217.         F9        Exchange a pair of screens    Exchange screen pair
  218.         F10       Import a screen               Import a screen *
  219.                                                 * If accessing files
  220.  
  221.         (The remaining command line functions are the same in both the
  222.         EDIT and the DISP modes.)
  223.  
  224.         PgUp      Goto preceding screen
  225.         PgDn      Goto following screen
  226.         ->        Goto screen n
  227.         <-        Goto previous screen
  228.         /\        Goto first screen
  229.         \/        Goto last screen
  230.  
  231.         S or^Home Toggle auto-stamp (time/date/initials) mode
  232.         N         Change initials for time/date/initials stamp
  233.  
  234.         ^PgUp     Select copy, barrel, or line stack buffer
  235.  
  236.         ^PgDn     Extend file by one screen (if at last screen)
  237.  
  238.         R or Del  Replace multiple occurrences of a string
  239.         F or Ins  Find a string
  240.         G or L    Goto next occurrence of a string
  241.         H         Highlight all occurrences of a string on the screen
  242.         J or End  Display or print all occurrences of a string
  243.  
  244.         C or <--  Compare two screens
  245.  
  246.         E or Esc  Save the edit buffer and exit the Editor
  247.         Q         Quit (undo all and exit)
  248.         W         Window (to Forth window, return to Editor with L)
  249.  
  250.         U         Change file
  251.         A         Change access method/interpret Forth word(s)
  252.  
  253.         D         Directory
  254.         I or Tab  Index of screens
  255.         P         Print screens
  256.  
  257.         B Backtab Beeping on/off (toggle)
  258.         X         eXpert (toggle help line on/off)
  259.  
  260.         Home      Edit the current screen
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.         Key       Editing function (in screen)
  272.  
  273.         F1        Help
  274.         F2        Undo all changes to current screen
  275.  
  276.                   Cut              Barrel               Stack
  277.  
  278.         F3        ---              Rotate barrel up     Push/delete
  279.         F4        ---              Rotate barrel down   Insert/pop
  280.         F5        Select or save   Copy to barrel       Copy to stack
  281.         F6        Copy to screen   Copy from barrel     Copy from stk
  282.  
  283.  
  284.         F7        Insert line from cursor
  285.         F8        Delete line from cursor
  286.         F9        Clear to end of line (from cursor)
  287.         F10       Clear to end of screen (- 4 characters) from cursor
  288.  
  289.         ^N        Insert blank line at line cursor is on
  290.         ^U        Erase all character on line containing cursor
  291.         ^Y        Delete line cursor is on
  292.         ^J        Join words from next line to line cursor is on
  293.  
  294.         Home      Cursor to home (top left corner of screen)
  295.         End       Cursor to end  (bottom right corner - 4 characters)
  296.         /\ or ^E  Cursor up one line (to home if at top line)
  297.         \/ or ^X  Cursor down one line (to end if at bottom line)
  298.         <- or ^S  Cursor left one character (wrap at line beginning)
  299.         -> or ^D  Cursor right one character (wrap at line end)
  300.         <-'or ^M  Cursor down one line and to line beginning
  301.  
  302.         ^<- or ^A Cursor left one word (wrap at line beginning)
  303.         ^-> or ^F Cursor right one word (wrap at line end)
  304.  
  305.         ->| or ^I Tab to next tab-stop (every 4 character positions)
  306.         |<- or ^O Back-tab to previous tab-atop
  307.  
  308.         Ins or ^V Toggle between character-insert and type-over modes
  309.         Del       Delete character at cursor
  310.         <-- or ^H Delete character to left (if Ins on, drag line)
  311.  
  312.         PgUp      Save current screen and go to preceding screen
  313.         PgDn      Save current screen and go to following screen
  314.         Esc       Save current screen and exit to command line
  315.         ^W        Exit to command line
  316.  
  317.         ^PgUp     Select cut, barrel, or line stack mode
  318.  
  319.         ^PgDn     Extend file by one screen (if at last screen)
  320.  
  321.         ^Home     Manual time/date/initial stamp current screen
  322.  
  323.         ^_        (Control-underline) Enter "Insert Control Char"
  324.                   mode (cursor will split to indicate mode).
  325.                   Allows inclusion of control characters in screen.
  326.                   Exit this mode by pressing the Ins key.
  327.