User's Guide to EVEPlus


                                      None










          Revision/Update Information:       A-15 - DECUS Edition


               This document describes a series of extensions  to
               the   EVE   Editor   called  EVEPlus.   There  are
               instructions on installing, customizing, and using
               the EVEPlus editor.


          Operating System and Version:      VAX/VMS V4.2


          Software Version:                  E1.0



     The information in this document is subject to change without notice
     and should not be construed as a commitment by Digital Equipment
     Corporation.  Digital Equipment Corporation assumes no responsibility
     for any errors that may appear in this document.

     No responsibility is assumed for the use or reliability of software on
     equipment that is not supplied by Digital Equipment Corporation or its
     affiliated companies.



              Copyright (c) 1985 by Digital Equipment Corporation
                              All Rights Reserved.











     The following are trademarks of Digital Equipment Corporation:

             DEC                DIBOL              RSX
             DEC/CMS            EduSystem          UNIBUS
             DEC/MMS            IAS                VAX
             DECnet             MASSBUS            VMS
             DECsystem-10       PDP                VT
             DECSYSTEM-20       PDT
             DECUS              RSTS
             DECwriter




















                                  ii



                                   CONTENTS

                PREFACE


CHAPTER 1       EVEPLUS COMMANDS

        1.1     DESCRIBE KEY . . . . . . . . . . . . . . . . . . . 1-1
        1.2     DESTROY BUFFER . . . . . . . . . . . . . . . . . . 1-1
        1.3     DISPLAY CHARACTER  . . . . . . . . . . . . . . . . 1-2
        1.4     ELIMINATE TABS . . . . . . . . . . . . . . . . . . 1-3
        1.5     FIX CRLFS  . . . . . . . . . . . . . . . . . . . . 1-3
        1.6     LIST BUFFERS . . . . . . . . . . . . . . . . . . . 1-4
        1.7     LIST COMMANDS  . . . . . . . . . . . . . . . . . . 1-5
        1.8     LOAD . . . . . . . . . . . . . . . . . . . . . . . 1-5
        1.9     NUMBER LINES . . . . . . . . . . . . . . . . . . . 1-6
        1.10    PRINT BUFFER . . . . . . . . . . . . . . . . . . . 1-7
        1.11    PRINT FF . . . . . . . . . . . . . . . . . . . . . 1-7
        1.12    PRINT FILE . . . . . . . . . . . . . . . . . . . . 1-8
        1.13    PRINT RANGE  . . . . . . . . . . . . . . . . . . . 1-8
        1.14    PRINT SCREEN . . . . . . . . . . . . . . . . . . . 1-9
        1.15    RELEASE BUFFERS  . . . . . . . . . . . . . . . . . 1-9
        1.16    SEARCH . . . . . . . . . . . . . . . . . . . . .  1-10
        1.17    SET EAG WINDOW KEYS  . . . . . . . . . . . . . .  1-11
        1.18    SET EDT KEYPAD . . . . . . . . . . . . . . . . .  1-12
        1.19    SET FLASHING . . . . . . . . . . . . . . . . . .  1-15
        1.20    SET MAPPING  . . . . . . . . . . . . . . . . . .  1-15
        1.21    SET MATCHING . . . . . . . . . . . . . . . . . .  1-16
        1.22    SET RECTANGULAR  . . . . . . . . . . . . . . . .  1-17
        1.23    SET VMS LINE EDITING . . . . . . . . . . . . . .  1-19
        1.24    SET WRITE  . . . . . . . . . . . . . . . . . . .  1-19
        1.25    SORT BUFFER  . . . . . . . . . . . . . . . . . .  1-20
        1.26    STATUS LINE  . . . . . . . . . . . . . . . . . .  1-21
        1.27    TRIM BUFFER  . . . . . . . . . . . . . . . . . .  1-21
        1.28    WHAT LINE  . . . . . . . . . . . . . . . . . . .  1-22


CHAPTER 2       BUILDING EVEPLUS

        2.1     SUGGESTIONS FOR WRITING YOUR OWN EVEPLUS INCLUDE 
                FILES  . . . . . . . . . . . . . . . . . . . . . . 2-2













                                    iii




      











                                    PREFACE






     INTENDED AUDIENCE

     This book is intended for users of the EVE text editor who wish to
     have additional capabilities beyond what EVE itself provides.



     CONVENTIONS USED IN THIS DOCUMENT


          Convention          Meaning

          <CTRL/x>            The phrase CTRL/x indicates that you must
                              press the key labeled CTRL while you
                              simultaneously press another key.

          [option]            Square brackets indicated that the enclosed
                              item is optional. (Square brackets are not,
                              however, optional in the syntax of a
                              directory name in a file specification).

          {abc|def}           Braces indicate that you must choose one of
                              the enclosed items.



     ASSOCIATED DOCUMENTS


     The reader is presumed to be familiar with the EVE text editor
     described in "VAX EVE User's Guide".



                                    iv












                                 CHAPTER 1

                             EVEPLUS COMMANDS



   1.1  DESCRIBE KEY

   This command requests a key and then returns a one-line description of
   the key (if one exists).

   Format

        DESCRIBE KEY


   Steps

   1.  Press <Do>.

   2.  Enter the DESCRIBE KEY command.

   3.  Press <Return>.

   4.  The editor will ask you to press the key that you wish described.

   5.  A one-line description of the key is displayed in the message
       window.




   1.2  DESTROY BUFFER

   This command will destroy the contents of a buffer, and the buffer
   itself.  If the buffer you are destroying has been modified or is a
   system buffer, you will be asked to confirm the operation.

   The DESTROY BUFFER command is useful when you no longer wish to have a
   buffer in your editing session.





                                    1-1
EVEPLUS COMMANDS
DESTROY BUFFER


   Format

        DESTROY BUFFER buffer-name


   Steps

   1.  Press <Do>.

   2.  Enter the DESTROY BUFFER command followed by a buffer name.

   3.  Press <Return>.

   4.  The buffer (and its contents) are deleted from the EVE editing
       session.  If the buffer was mapped to a visible window, another
       buffer is substituted.




   1.3  DISPLAY CHARACTER

   When the EVE editor cannot display a character (e.g., a control
   character) it substitutes a reverse question mark in its place.  This
   command will interpret the character the cursor is on, and produce a
   readable version.  Information about the character includes its octal,
   decimal, and hexidecimal values.

   Format

        DISPLAY CHARACTER


   Steps

   1.  Press <Do>.

   2.  Enter the DISPLAY CHARACTER command.

   3.  Press <Return>.

   4.  The interpretation of the character is displayed in the message
       window.










                                    1-2
                                                           EVEPLUS COMMANDS
                                                             ELIMINATE TABS


   1.4  ELIMINATE TABS

   This command will remove tabs from your file and substitute the proper
   number of spaces to keep the appearance of the document the same.

   Format

        ELIMINATE TABS


   Steps

   1.  Press <Do>.

   2.  Enter the ELIMINATE TABS command.

   3.  Press <Return>.

   4.  Starting at the current cursor position, all tabs are removed from
       the buffer and replaced by spaces.




   1.5  FIX CRLFS

   This command removes carriage returns and linefeeds from buffers (e.g.,
   if you are reading a file generated by Runoff).

                                     NOTE

           The RMS file characteristics are NOT changed by this
           command.  You may have to issue a CONVERT command to
           convert the file from "no carriage_control" to one with
           "carriage_return carriage_control"

   Format

        FIX CRLFs


   Steps

   1.  Press <Do>.

   2.  Enter the FIX CRLFS command.

   3.  Press <Return>.

   4.  All carriage-return linefeed sequences are removed.



                                    1-3
EVEPLUS COMMANDS
LIST BUFFERS


   1.6  LIST BUFFERS

   This command will produce a list of buffers currently in use.  If you
   specify ALL buffers, then both system and user buffers are listed,
   otherwise only user buffers are listed.  The LIST ALL BUFFERS command
   produces the following display:

         Buffer name            Lines  Attributes

          $LOCAL$INI$             4                      System
          CHOICES                 0  Modified  No-write  System
          COMMANDS                5  Modified  No-write  System
          DCL                     0            No-write  System
          HELP                    0            No-write  System
          INSERT HERE             0            No-write  System
          LIST BUFFER            12  Modified  No-write  System
          MAIL_20E00748.TMP      17  Modified
          MESSAGES               11  Modified  No-write  System
          PROMPTS                 0            No-write  System
          SHOW                    0            No-write  System

   After you issue the command, the Select and Remove keys change their
   function (see table below).  When you leave the buffer containing the
   buffer listing (e.g., via the BUFFER, GET FILE, or GOTO commands) the
   keys are restored to their original function.


        Function Key Operation
             <Select>        Performs a BUFFER command for the buffer
                       listed in the current line.

             <Remove>        Performs a DESTROY BUFFER command for the
                       buffer listed in the current line.

   Format

        LIST [ALL] BUFFERS


   Steps

   1.  Press <Do>.

   2.  Enter the LIST BUFFERS command.

   3.  Press <Return>.

   4.  The screen now has a list of the buffers that have been created
       during the current editing session.




                                    1-4
                                                           EVEPLUS COMMANDS
                                                              LIST COMMANDS


   1.7  LIST COMMANDS

   Lists all the EVE (and EVEPlus) commands in alphabetical order.  If
   there are a large number of commands, the LIST COMMANDS command will not
   be instantaneous.

   Format

        LIST COMMANDS


   Steps

   1.  Press <Do>.

   2.  Enter the LIST COMMANDS command.

   3.  Press <Return>.

   4.  A sorted list of the currently available commands will be displayed.

   5.  Press <Do> to return to your original edit session.




   1.8  LOAD

   This commands provides a means to "mass load" TPU buffers based on a
   wild-card file specification.  Each file matching the wild-card
   specification will be loaded into a buffer with the same name as the
   file.

                                     NOTE

           This command does NOT support, and will NOT load
           multiple versions a the same file.
















                                    1-5
EVEPLUS COMMANDS
LOAD


   Format

        LOAD file_spec


   Steps

   1.  Press <Do>

   2.  Enter the LOAD command followed by any VMS file specification,
       including wild-card (e.g.  LOAD *.com).

   3.  Press <Return>.  Each file matching the input specification, will be
       loaded into a unique TPU buffer with same name as the file.  Use the
       LIST BUFFER command (described above) or the SET MAPPING command
       (described below) to move easily between the file/buffers during the
       edit session.




   1.9  NUMBER LINES

   This command will insert line numbers at the beginning of each line of
   the current editing buffer (a 6-digit number followed by 2 spaces).

                                   Warning

           This command modifies your buffer and there is no
           EVEPlus procedure to remove the line numbers that this
           command inserts into the buffer.


   Format

        NUMBER LINES


   Steps

   1.  Press <Do>.

   2.  Enter the NUMBER LINES command.

   3.  Press <Return>.

   4.  The buffer is modified with line numbers.






                                    1-6
                                                           EVEPLUS COMMANDS
                                                               PRINT BUFFER


   1.10  PRINT BUFFER

   Sends the contents of the current editing buffer to a designated printer
   queue (default is SYS$PRINT).  Embedded control characters are
   translated to a readable form (e.g., the BEL character will be printed
   as <BEL>).

   Format

        PRINT BUFFER


   Steps

   1.  Press <Do>.

   2.  Enter the PRINT BUFFER command.

   3.  Press <Return>.

   4.  A request for a PRINT command will appear.  You can enter any
       "special" printing command (e.g.  PRINT/QUEUE=LETTER/NOTIFY,
       PRINT/DELETE/COPIES=n, etc.).  Simply pressing <Return> will result
       in a PRINT command being issued.




   1.11  PRINT FF

   Prints a form feed on a printer attached to the user's terminal.  This
   will cause the printer to place the paper at the top of a page.

   Format

        PRINT FF

   Steps

   1.  Press <Do>.

   2.  Enter the PRINT FF command.

   3.  Press <Return>.









                                    1-7
EVEPLUS COMMANDS
PRINT FILE


   1.12  PRINT FILE

   Prints the specified file on a printer attached to the user's terminal.

                                     NOTE

           The attached printer should be capable of recognizing
           and understanding ANSI control characters (i.e.  escape
           sequences).


   Format

        PRINT FILE [filename]


   Steps

   1.  Press <Do>.

   2.  Enter the PRINT FILE command followed by a file specification.

   3.  Press <Return>.




   1.13  PRINT RANGE

   Prints the the contents of the current select range on a printer
   attached to the user's terminal.  If there is no select range active
   when you issue the command, the contents of the entire current buffer
   are printed.

   Format

        PRINT RANGE
















                                    1-8
                                                           EVEPLUS COMMANDS
                                                                PRINT RANGE


   Steps

   1.  Position cursor to the one end of the range of text you want
       printed.

   2.  Press <Select>.

   3.  Position cursor to the other end of the range of text you want
       printed.

   4.  Press <Do>.

   5.  Enter the PRINT RANGE command.

   6.  Press <Return>.




   1.14  PRINT SCREEN

   Prints the contents of the current screen on a printer attached to the
   user's terminal.

   Format

        PRINT SCREEN


   Steps

   1.  Press <Do>.

   2.  Enter the PRINT SCREEN command.

   3.  Press <Return>.




   1.15  RELEASE BUFFERS

   This command will write out all writable, modified user buffers and
   delete all remaining buffers for the session.  This command is useful if
   you run EVE as a "kept" editor and wish to "clean house".

   Format

     RELEASE BUFFERS




                                    1-9
EVEPLUS COMMANDS
RELEASE BUFFERS


   Steps

   1.  Press <Do>.

   2.  Enter the RELEASE BUFFERS command.

   3.  Press <Return>.

   4.  You will be positioned in the MESSAGES buffer.  From here you can
       enter commands to bring in new files, etc.




   1.16  SEARCH

   This command is an enhanced version of the default searching mechanism
   built into the Eve editor.  The SEARCH command allows wild-carded
   searches.

        Meta     Operation/Matches

        *        Multi-character wildcard, do not cross record boundaries

        %        Single-character wildcard

        #        Multi-character wildcard, cross record boundaries

        \        Quote next character

        ^        Next character is a control character

   Format

        SEARCH [search-pattern]


   Steps

   1.  Press <Do>.

   2.  Enter the SEARCH command followed by the string or pattern you wish
       to locate in the current buffer.

   3.  Press <Return>.

   4.  You are positioned in your buffer to a string that matches.






                                   1-10
                                                           EVEPLUS COMMANDS
                                                        SET EAG WINDOW KEYS


   1.17  SET EAG WINDOW KEYS

   This command establishes an alternate windowing environment to the one
   supplied by the Eve editor.  Features of EAG windowing are:

    o  Quick or continuous display of all non-system buffer names.

    o  Swift, two-keystroke access to (a maximum of) 9 editing buffers.

    o  Function keys for reading and writing files.


   If you enable the EAG window environment, you get the following keypad
   assignments:

        Keystroke Sequence       Operation

        <Gold> n                 n = 1 to 9 is  equivalent  to  the  EVE
                                 BUFFER  command  for  that buffer. n = 0
                                 displays buffers.

        <Enter>                  Get a file and map to a buffer.

        <Gold> <Enter>           Write  file  associated  with  current
                                 buffer.

        <Gold> <KP,>             Write a named file.

        <KP3>                    Other window.

        <Gold> <KP3>             Toggle between 1 and 2 windows.

        <Gold> <_^_>             Scroll message window up one line.

        <Gold> <_V_>             Scroll message window down one line.

        <Gold> -->               Shift current window to the right.

        <Gold> <--               Shift current window to the left.

   The symbol <Gold> in the above table refers to your current "shift" key.
   This is established with the SET SHIFT KEY command.

   A subsetted version of the EAG windowing keys is available via the SET
   MAPPING command.








                                   1-11
EVEPLUS COMMANDS
SET EAG WINDOW KEYS


   Format

        SET [NO]EAG WINDOW KEYS


   Steps

   1.  Press <Do>.

   2.  Enter the SET EAG WINDOW KEYS command.

   3.  Press <Return>.




   1.18  SET EDT KEYPAD

   This command will define the VT100 or VT200 numeric keypad to emulate
   the EDT editor VT100 keypad definitions.  No existing key definitions
   are retained.

   If you elect to include this option in you EVE_PLUS customization file,
   the EDT keypad will "automatically" be defined.

   EDT_KEYPAD

   The keys defined are:

       <PF1>           The GOLD key blank 1.indent -16
                       <PF2>           Retains the EVE keypad definitions
                       (NOT EDT help)

       <PF3>           FIND NEXT (occurance of string).

       <GOLD PF3>      FIND (string).  This command is identical the EVE's
                       FIND command.

       <PF4>           DELETE LINE

       <GOLD PF4>      UNDELETE LINE

       <KP0>           LINE, Move to beginning of next line if the current
                       direction is Forward, or to the previous line if the
                       direction is Reverse.

       <GOLD KP0>      OPEN_LINE

       <KP1>           WORD, Moves the cursor to the beginning of the next
                       word in the current direction (Forward or Reverse).

       <GOLD KP1>      CHANGE CASE

                                   1-12
                                                           EVEPLUS COMMANDS
                                                             SET EDT KEYPAD


       <KP2>           EOL, Moves to the end of the current if in the
                       Forward direction, or to the end of the previous
                       line if in the Reverse direction.

       <GOLD KP2>      DELETE to EOL

       <KP3>           CHAR, Moves the cursor to the next character in the
                       current direction (Forward or Reverse).

       <GOLD KP3>      SPECINS - "Special Insert"

       <KP4>           FOREWARD, Set direction Forward

       <GOLD KP4>      BOTTOM, go to "bottom" of file.

       <KP5>           REVERSE, Set direction Reverse

       <GOLD KP5>      TOP, go to "top" of file.

       <KP6>           CUT

       <GOLD KP6>      PASTE

       <KP7>           PAGE, moves the cursor to the next page boundary
                       (Form Feed character) in the current direction
                       (Forward or Reverse).

       <GOLD KP7>      COMMAND, the EVE "DO" command.

       <KP8>           SECTION, moves the cursor to the next "section"
                       (essentially 1 screen of data) in the current
                       direction (Forward or Reverse).

       <GOLD KP8>      FILL

       <KP9>           Not defined

       <PERIOD>        SELECT

       <GOLD PERIOD>   RESET

       <MINUS>         DELETE WORD, Contrary to EDT, this key will delete
                       the entire word which contains the cursor (any
                       blanks and tabs are considered leading blanks and
                       are deleted with the following word).

       <GOLD MINUS>    UNDELETE WORD






                                   1-13
EVEPLUS COMMANDS
SET EDT KEYPAD


       <COMMA>         DELETE CHARACTER

       <GOLD COMMA>    UNDELETE CHARACTER

       <ENTER>         Same as RETURN key (in EVE) or ENTER key (in EDT).

       <GOLD ENTER>    REPLACE, or Substitute string.

       <UP ARROW>      MOVE cursor to previous line.  In the EVE editor,
                       the cursor is allowed to go anywhere on the screen,
                       even where no characters have been entered.

       <DOWN ARROW>    MOVE cursor to next line (See <UP ARROW> for more
                       description).

       <RIGHT ARROW>

       <LEFT ARROW>

       <DELETE KEY>

       <CONTROL K>     DEFINE KEY, Uses EVE's Define Key command.

   Format

        SET EDT KEYPAD


   Steps

   1.  Press <Do>.

   2.  Enter the SET EDT KEYPAD command.

   3.  Press <Return>.  You may series a messages flashing through your
       MESSAGE window (at bottom of screen).  These messages are indicating
       that existing key definitions are being modified.
















                                   1-14
                                                           EVEPLUS COMMANDS
                                                               SET FLASHING


   1.19  SET FLASHING

   This command locates corresponding characters in a buffer and "flashes"
   them whenever you type the character given in the command.  The line
   with the matching character is displayed in the message window.

   For example, this command can be used to make the editor display which
   "(" matches which ")" in a program with the command SET FLASHING ).

   The following characters can be used to flash their corresponding
   character:

   ) } > ' "

   Format

        SET [NO]FLASHING characters-to-match


   Steps

   1.  Press <Do>.

   2.  Enter the SET FLASHING command followed by one or more characters
       that are to be matched.

   3.  Press <Return>.




   1.20  SET MAPPING

   This command provides a subset of the features supplied by the SET EAG
   WINDOWS command.  In particular, the SET MAPPING command provides the
   two-keystroke access to (a maximum of) 9 editing buffers.

   The following keypad assignments are made with the SET MAPPING command:

        Keystroke Sequence       Operation

        <Gold> n                 n = 1 to 9 is  equivalent  to  the  EVE
                                 BUFFER command for that buffer.

        <Gold> 0                 Displays the user buffer list.

   The symbol <Gold> in the above table refers to your current "shift" key.
   This is established with the SET SHIFT KEY command.





                                   1-15
EVEPLUS COMMANDS
SET MAPPING


   Format

        SET [NO]MAPPING


   Steps

   1.  Press <Do>.

   2.  Enter the SET MAPPING command.

   3.  Press <Return>.




   1.21  SET MATCHING

   This command will automatically insert a corresponding character into a
   buffer.  For example, if you type a "(", a matching ")" is also placed
   in the buffer.  The cursor is positioned so that the next character
   typed will be between the matched characters.

   The following characters will generate a corresponding match character:
   ( { <  ` ' "

   Format

        SET [NO]MATCHING characters-to-match


   Steps

   1.  Press <Do>.

   2.  Enter the SET MATCHING command followed by the character(s) you wish
       to have matched during this editing session.

   3.  Press <Return>.














                                   1-16
                                                           EVEPLUS COMMANDS
                                                            SET RECTANGULAR


   1.22  SET RECTANGULAR

   This command turns rectangular cut-and-paste on or off.  When the SET
   RECTANGULAR command is issued, the SELECT, REMOVE, and INSERT HERE keys
   are redefined to perform rectangular cut and paste operations.

   Rectangles are formed by positioning the cursor to where the upper-left
   corner of the rectangle will be and pressing <Select>.  Then move the
   cursor to where the lower-right corner should be.  Press <Remove>.

   Rectangular pasting is accomplished (after cutting a rectangle) by
   positioning the cursor to where the upper-lefthand corner is to appear
   and pressing <Insert Here>.

   The rectangular mode also lets you draw boxes very easily.  After
   forming a rectangle, press <Do> and enter the command:  DRAW BOX
   followed by <Return> .  A box (formed with ASCII characters) will
   surround the imaginary rectangle you have formed.  If you plan on
   drawing a lot of boxes, you might consider binding the DRAW BOX command
   to a key.

   Format

        SET [NO]RECTANGULAR


   Steps

   1.  Press <Do>.

   2.  Enter the SET RECTANGULAR command.

   3.  Press <Return>.


   The above command sequence works "best" on VT200 class terminals.  If
   you do not have access to this class terminal.  You can use the
   following "EVE" commands.
        RECTANGULAR SELECT       -  Marks start of a rectangle
        RECTANGULAR REMOVE       -  Removes rectangular area
        RECTANGULAR INSERT HERE  -  Puts rectangular area












                                   1-17
EVEPLUS COMMANDS
SET RECTANGULAR


   Format

        RECTANGULAR {SELECT | REMOVE | INSERT HERE}


   Steps

   1.  Put the cursor at ANY ONE of the corners of the desired rectangle.

   2.  Press <Do>.

   3.  Enter the RECTANGULAR SELECT command.

   4.  Press <Enter>.

   5.  Move the cursor to the diagonally opposite corner of the desired
       rectangle.

   6.  Press <Do>.

   7.  Enter the RECTANGULAR REMOVE command

   8.  Press <Enter>.  The defined rectangle will be removed, leaving a
       "hole".

   9.  Move the cursor to the desired "NEW" location of the removed
       rectangle.

  10.  Press <Do>.

  11.  Enter the RECTANGULAR INSERT HERE command.

  12.  Press <Enter>.  The cursor position will be considered the upper
       left corner of the rectangle, and previously removed text will
       OVERLAY any existing text.


















                                   1-18
                                                           EVEPLUS COMMANDS
                                                       SET VMS LINE EDITING


   1.23  SET VMS LINE EDITING

   This command sets up the keyboard to act as VMS does for line-editing.
   You can reverse this condition by using the SET NO VMS LINE EDITING.
   The keys that this command changes are described in the table below:


        Function Key   New Operation

        <BS>            Move cursor to start of line.

        <F12>           Move cursor to start of line.

        <CTRL/H>        Move cursor to start of line.

        <CTRL/A>        Toggle between Insert and Overstrike mode.

        <CTRL/D>        Move cursor left 1 position.

        <CTRL/F>        Move cursor right 1 position.

   Format

        SET [NO]VMS LINE EDITING


   Steps

   1.  Press <Do>.

   2.  Enter the SET VMS LINE EDITING command.

   3.  Press <Return>.

   4.  The editor is now set to use VMS line editing keys.




   1.24  SET WRITE

   When EVE creates a buffer, it normally considers it writable.
   Sometimes, it is convenient to mark the buffer as non-writable.  This
   command lets you change current buffer's writable status.  If you set
   the buffer to "No Write" EVE will not automatically write out the buffer
   when you exit the editing session even if you modify it.  The status
   line will indicate buffers that have been marked NO WRITE (by bolding
   and underlining) when the buffer is mapped to a window.





                                   1-19
EVEPLUS COMMANDS
SET WRITE


   Format

        SET [NO]WRITE


   Steps

   1.  Press <Do>.

   2.  Enter the SET WRITE command.

   3.  Press <Return>.

   4.  The current buffer will be considered writable or read-only,
       depending on your choice.




   1.25  SORT BUFFER

   This command sorts the contents of the named buffer, line by line.  The
   sort algorithm is implemented entirely in TPU.

   Format

        SORT BUFFER buffer-name


   Steps

   1.  Press <Do>.

   2.  Enter the SORT BUFFER command followed by the buffer name to sort.

   3.  Press <Return>.

















                                   1-20
                                                           EVEPLUS COMMANDS
                                                                STATUS LINE


   1.26  STATUS LINE

   This command allows you to toggle the presence of the EVE status line.
   This command is useful if you are making slides with EVE.

   Format

        STATUS LINE {On|Off}


   Steps

   1.  Press <Do>.

   2.  Enter the STATUS LINE command.

   3.  Press <Return>.




   1.27  TRIM BUFFER

   This command will remove all trailing whitespace (spaces/tabs) from each
   line in the current editing buffer.

   Format

        TRIM BUFFER

   Steps

   1.  Press <Do>.

   2.  Enter the TRIM BUFFER command.

   3.  Press <Return>.

   4.  All lines with trailing spaces are trimmed.














                                   1-21
EVEPLUS COMMANDS
WHAT LINE


   1.28  WHAT LINE

   This command will display where you are (line number) in the current
   buffer.  Line number, total, and percentage is displayed.

   Format

        WHAT LINE

   Steps

   1.  Press <Do>.

   2.  Enter the WHAT LINE command.

   3.  Press <Return>.

   4.  The message window displays what line you are on.



































                                   1-22












                                 CHAPTER 2

                             BUILDING EVEPLUS



     EVEPlus is a set of TPU procedures and conventions which make it easy
     to build customized, powerful extensions to the TPU EVE interface.  It
     does this by creating a custom TPU section file based on EVE.

     The heart of the system is a TPU source file, called
     EVEPLUS_BUILD.COM, which processes your own set of commands and custom
     features to produce the section file.  It follows your directions on
     the inclusion of other TPU source files into your section file.  This
     file and the other EVEPlus files can be found in the directory pointed
     to by the logical TPU$EVEPLUS.

     In addition to EVEPLUS_BUILD.COM, the kit contains a "template" file
     called EVEPLUS_INPUT.TPU, which you should copy to a local
     sub-directory and edit to create your own set of customization
     commands.  Other files TPU$EVEPLUS implement the various additional
     functions of EVEPlus.  These source files are what you can "include"
     from your "eveplus_include" commands which form the major part of your
     customization input file.  You should be able to use the features
     these files provide without any edits to them.

     When you have read and edited the "template" file to suit your
     preferences, you will have your own customization input file which you
     may then use to create your custom TPU section file.  The following
     commands will create the section file:















                                    2-1
BUILDING EVEPLUS



          $ @TPU$EVEPLUS:BUILD_EVEPLUS

     This command will issue two prompts:

          EVEPLUS input file:
               At this prompt enter your EVEPLUS "custom control file"
               (i.e.  your editted EVEPLUS_INPUT.TPU).

                                           NOTE

                   This file does NOT NEED to be named
                   EVEPLUS_INPUT.TPU, but can be anything meaningful to
                   you.


          TPU Section file:
               At this prompt enter your desired TPU section file.  This
               file will Default to the file EVEPLUS.GBL in your current
               default directory.

     Once you have built your EVEPlus section file, you can make it your
     default TPU editor with the following commands to your LOGIN.COM file:

          $ DEFINE TPUSECINI <your TPU/EVE sub-directory>EVEPLUS.GBL
          $ EVE == "EDIT/TPU"  ! Optional



     2.1  SUGGESTIONS FOR WRITING YOUR OWN EVEPLUS INCLUDE FILES

     The following example is a an outline of the format of a typical
     EVEPlus include file and a set of suggestions:





















                                    2-2
                                                           BUILDING EVEPLUS
                     SUGGESTIONS FOR WRITING YOUR OWN EVEPLUS INCLUDE FILES


     Example 2-1:  Sample EVEPlus Template File


          ! Title of file, author, etc.

          ! An abstract suitable for the casual user to understand what the
          ! file is doing and/or pointing to further documentation or
          ! associated files.  If you make your extensions available to
          ! others, they can use this abstract to figure out if they want to
          ! use your file and how to use it.

          ! Edit History

          procedure EVE_new_eve_command ! See EVE Users' guide for conventions

          ! Implement new functions as EVE commands.  Let the users make key
          ! definitions of their own choice if they wish.  This means your
          ! file is less likely to need editing for most people to use it.

          ! Check the current set of EVE commands which are implemented in the
          ! EVEPlus kit.  Be sure that your commands don't conflict with those
          ! commands already written, or with current EVE commands.
             .
             .
             .
          endprocedure



          procedure EVE_SET_feature  ! Enable your custom feature
             .
             .
             .
          endprocedure



          procedure EVE_SET_NOfeature ! Disable your custom feature

          ! The use of the EVE_SET and EVE_SETNO prefixes means that users can
          ! enable and disable your feature by typing 'set feature' or 'set
          ! nofeature' respectively. This is handy for section files which
          ! provide 'modes' of operation which you might want to enable and
          ! then later disable.

          ! Example: Rectangular cut and paste.

          ! If your include file must define keys for the user, write a
          ! procedure pair like this to turn those definitions on and off,
          ! saving and restoring the user's keys which your feature uses.
          ! For full preservation of the user's keypad, use the EVEPlus shift
          ! key function to save and restore the users shift key:

                                    2-3
BUILDING EVEPLUS
SUGGESTIONS FOR WRITING YOUR OWN EVEPLUS INCLUDE FILES


          ! During save of user's keys:

          ! current_shift_key := EVEPLUS_SET_SHIFT_KEY ( your_new_shift_key );

          ! During restore of user's keys:

          ! EVEPLUS_SET_SHIFT_KEY ( users_shift_key );

          ! EVEPlus supplies a pair of procedures for saving and restoring
          ! keys. The save routine allows the writer of an EVEPlus format file
          ! to:
          !
          !     Define keys to be used in an EVEPlus function and restore the
          !     users' previous definitions upon exit from that function.
          !
          !     Provide the user of an EVEPlus file with a means of
          !     reassigning functions to keys, or totally disabling the
          !     EVEPlus file writer's keys without resorting to editing the
          !     EVEPlus file.
          !
          ! Format for the save routine is similar to the TPU define key
          ! builtin format to facilitate conversion of source files:
          !
          ! EVEplus_key({string|program|buffer|range}, key, 'comment', 'keyname');
          !
          ! The extra parameter in the EVEplus_key call is the name of a key
          ! which the user of the EVEPlus procedure may define to override the
          ! key parameter in the call should the user desire a different key
          ! to be assigned the specified function. The user may issue an
          ! assignment statement assigning any key to the keyname to redirect
          ! the key.  The user may also assign ctrl_y_key to the keyname,
          ! which has the effect of no key definition at all.
          !
          ! The extra parameter should be enclosed in quotes when passed to
          ! EVEplus_key.
          !
          ! The companion to EVEplus_key is EVEplus_restore_key, which takes a
          ! single parameter identical to the last parameter of EVEplus_key:
          !
          ! EVEplus_restore_key ( 'keyname' );
          !
          ! This restores whatever the previous definition and comment string
          ! was to whatever key (default or user re-defined) was assigned the
          ! EVEPlus function.
          !
          ! The EVEplus_ key/restore_key pair is useful for EVEPlus files
          ! which implement functions which are pretty much useless without
          ! binding keys somewhere.
          !
          ! The EVEplus_ key/restore_key is not recommended for files where
          ! key bindings aren't necessary, or the choice of a key is entirely
          ! arbitrary.  An example of this type of file would be 'list
          ! commands', where the EVE command line implementation is enough for
                                    2-4
                                                           BUILDING EVEPLUS
                     SUGGESTIONS FOR WRITING YOUR OWN EVEPLUS INCLUDE FILES


          ! most people, and there is no obvious logical place to put the key.
          !
             .
             .
             .
          endprocedure



          procedure PREFIX_procedure_called_internally

          ! Prefix your procedures with your own prefix.
             .
             .
             .
          endprocedure



          procedure TPU$LOCAL_INIT   ! Your initialization logic goes here

          ! Put all the initialization logic in a procedure with this exact
          ! name. EVEPlus will look for a procedure with this name during
          ! section file build and will gather all such logic from each
          ! include file.  When it writes out the custom section file it will
          ! place all the initialization logic from all files into one
          ! intialization procedure which is executed as a standard part of
          ! EVE startup.

          ! NOTE: Be sure that both the procedure and endprocedure statements
          ! start in column 1.  If they don't start in column 1, EVEPlus won't
          ! find them.
             .
             .
             .
          endprocedure



          ! Executable statements go here.  Since these statements are NOT
          ! executed each time your custom section file starts up, don't put
          ! any initialization logic here.  The ONLY thing we can think of
          ! which you might want to put here is:

          !     A single invocation of TPU$LOCAL_INIT, so that if someone
          !     reads your file into a buffer and executes the buffer, your
          !     file will initialize properly.

          ! Any key definitions should NOT be done here, as you then make it
          ! impossible for people to use your code with their own key
          ! definitions; they'll have to go in and change your code.


                                    2-5