1 EDTP
 The EDT-PLUS Keypad Emulator is an interactive text editor that
 demonstrates the versatility and extensibility of the VAXTPU
 programming language.  This editor emulates the keypad functions, 
 some of the line mode commands of the EDT editor, and has several
 of the enhancements included in the Extended_EVEPlus (EVE) editor.
 The purpose of the EDT-PLUS Keypad Emulator is to provide you
 with a familiar editing interface.  It is hoped that you will use
 this editor as you have used EDT with some of the nice features of
 EVE.

2 HELP
 To use help from the CTRL/Z, '*' prompt, type HELP followed by a
 line_mode_command.  If the cursor is positioned after the 'Topic?'
 prompt then type:

    EDTP               - to get a list of EDT_EMULATOR topics

    EDTP LINE          - to get a list of line mode commands

    EDTP KEY           - to get a list of keypad commands

    EDTP VAXTPU_EQU    - to get help on VAXTPU syntax for missing
                         line mode commands

2 KEYPAD_FUNCTIONS

3 ADVANCE

 Keypad 4

 Sets the editing direction to forward; that is, toward the bottom
 of the buffer.

3 APPEND

 Keypad 9

 Deletes the select range from the current buffer; appends it to
 the PASTE_BUFFER, just after the present contents of the
 PASTE_BUFFER.

3 BACKSPACE

 CTRL/H

 Moves the cursor to the beginning of the current line or the
 previous line, depending on the editing direction.

3 BACKUP

 Keypad 5

 Sets the editing direction to reverse; that is, toward the top of
 the buffer.

3 BOTTOM

 GOLD Keypad 4

 Moves the cursor to the end of the current buffer.

3 CHNGCASE

 GOLD Keypad 1

 Changes the case of all the letters in the select range, or the
 case of the current letter.

3 TPU_COMMAND

 GOLD DO

 Enables you to enter one or a sequence of VAXTPU built-in
 procedures or user-written procedures for execution.  Type the
 procedure name in response to the 'TPU Command:' prompt.

3 CTRL_C
 CTRL/C

 Aborts the current VAXTPU operation.  CTRL/C is useful for
 stopping searches and the reading and writing of files.  You
 should exit from the editor after using CTRL/C and start a new
 session for any further edits.  It may not be possible to recover
 text changes made after a CTRL/C.

3 BACKSPACE
 CTRL/H

 BACKSPACE

 Moves the cursor to the beginning of the current line.  If the
 cursor is already at the beginning of the line, entering CTRL/H
 moves the cursor to the beginning of the previous line.

3 TAB
 CTRL/I

 TAB

 Moves the text that is to the right of the cursor (including the
 cursor character) to the right to the nearest preset VAXTPU tab
 stop.

3 DEFINE_KEY
 CTRL/K

 Prompts for the VAXTPU define key command.

3 RETURN
 CTRL/M

 RETURN

 Causes a new line to be inserted at the current cursor position.
 The cursor moves to the beginning of the new line.

3 REFRESH
 CTRL/W (Refresh Screen)

 Refreshes the screen.

3 DEL_BEG_LINE
 CTRL/U (Delete to Beginning of Line)

 Deletes text from the current cursor position to the beginning of
 the line.  The deleted text replaces the contents of the DELETE
 LINE buffer.

3 ABORT
 CTRL/Y

 Aborts the current editing session.  The current edits are saved
 in a journal file.  If you pressed this key sequence by accident
 you can resume your editing session by typing "CONTINUE" at the
 DCL prompt.

3 LINE_MODE
 CTRL/Z (Exit to Line Mode)

 Shifts from keypad mode to the EDT Emulator command line mode.
 Places the cursor at the EDT Emulator command line mode prompt
 (*).

 Gold Keypad 7  or  DO (Single Line Mode)

 Requests a single line to execute by EDT line mode command 
 interpreter.

 To exit (return to screen mode) type CONTINUE followed by a RETURN.
3 CUT

 Keypad 6

 Deletes the select range and places it in the PASTE_BUFFER.  The
 previous contents of the PASTE_BUFFER, if any, are deleted.

3 DEL_C
 DEL C (delete character)

 Keypad COMMA

 Deletes the character that the cursor is on.

3 DEL_EOL
 DEL EOL (delete to end of line)

 Gold Keypad 2

 Deletes text from the current cursor position to the end of the
 line.  Does not delete the line terminator.

3 DELETE

 DELETE key on VT100, <X] key on VT200

 Deletes the character to the left of the current cursor position.

3 DEL_L
 DEL L (delete line)

 Keypad PF4

 Deletes text from the current cursor position to the beginning of
 the next line, deleting the line terminator.

3 DEL_W
 DEL W (delete word)

 Keypad MINUS

 Deletes characters from the current cursor position to the
 beginning of the next word.

3 DOWN_ARROW

 Moves the cursor down to the position on the following line that
 corresponds to the current cursor position.

3 ENTER

 Sends a command or search string to the editor for processing.
 Completes the CTRL/K key definition process.

3 EOL

 Keypad 2  or  Ctrl-E

 Moves the cursor to the next line terminator in the current
 editing direction.

3 FILL

 GOLD Keypad 8

 Reformats the text in the select range so that as many whole words
 as possible are included within the current buffer's margin
 settings.

 If SET WRAP is in effect, the left margin is one, and the right
 margin is the value established through SET WRAP.  If SET WRAP is
 not in effect, then the text is wrapped between column one and the
 width of the current window.

3 FIND

 Gold Keypad PF3

 Searches in the current direction for the string that you type
 when the EDT Keypad Emulator displays the 'Search for:' prompt.

3 FNDNXT

 Keypad PF3

 Locates the next occurrence of the current search string in the
 current direction.

3 GOLD / SHIFT

 Keypad PF1

 Accesses alternate keypad functions.

3 HELP

 Keypad PF2

 PF2 provides information on the keypad layout.  Gold Keypad PF2
 provides information on keypad editing and VAXTPU features in
 general.  Request information after the "Topic:  " prompt.

3 LEFT_ARROW

 Moves the cursor one character to the left.

3 BY_LINE

 Keypad 0

 Moves the cursor to the beginning of the next line in the current
 editing direction.

3 OPEN_LINE

 Gold Keypad 0

 Causes a new line to be inserted at the current cursor position.
 The cursor does not move.

3 PAGE

 Keypad 7

 Moves the cursor to the next EDT Keypad Emulator page boundary in
 the current direction.

3 PASTE

 Gold Keypad 6

 Inserts the contents of the PASTE_BUFFER just before the cursor.

3 REPLACE

 Gold Keypad 9

 Deletes the selected range and replaces it with the contents of
 the PASTE_BUFFER.

3 RESET

 Gold Keypad PERIOD

 Cancels the select range and sets the current buffer's direction
 to forward.  Also clears the PROMPT_AREA.

3 RETURN

 Inserts a line terminator in the text.  The cursor moves to the
 beginning of the new line.  Under program word delimmiters return
 will also automatically indent to the level indicated by the 
 previous line.

3 RIGHT_ARROW

 Moves the cursor one character to the right.

3 SECT

 Keypad 8

 Moves the cursor 16 lines in the current direction.

3 SELECT

 Keypad PERIOD

 Marks one end of a select range.  When you move the cursor again,
 the characters that the cursor passes over become the select
 range.

3 SHIFT_LEFT

 Gold left arrow

 Shifts the screen image of the current window 25 columns to the left.
 Has no effect on the text.

3 SHIFT_RIGHT

 Gold right arrow

 Shifts the screen image of the current window 25 columns to the right
 if the text has already been shifted to the left.  Has no effect
 on the text.

3 SPECINS

 Gold Keypad 3

 Allows you to insert any character from the DEC Multinational
 Character Set into your text by first entering GOLD, then the
 decimal equivalent value for that character, followed by GOLD
 SPECINS.

3 SUBS (substitute)

 Gold Keypad ENTER

 Replaces the next occurrence of the current search string in your
 text with the contents of the PASTE_BUFFER.

3 TAB

 CTRL/I  or TAB key

 Moves the text that is to the right of the cursor (including the
 cursor character) to the right to the nearest preset tab stop.

3 TOP

 Gold Keypad 5

 Moves the cursor to the beginning of the current buffer.

3 UND_C
 UND C (undelete character)

 Gold Keypad COMMA

 Inserts the contents of the delete character buffer to the left of
 the cursor.

3 UND_L
 UND L (undelete line)

 Gold Keypad PF4

 Inserts the contents of the delete line buffer to the left of the
 cursor.

3 UND_W
 UND W (undelete word)

 Gold Keypad MINUS

 Inserts the contents of the delete word buffer to the left of the
 cursor.

3 UP_ARROW

 Moves the cursor up to the position on the previous line that
 corresponds to the current cursor position.

3 VAXTPU_HELP

 Gold Keypad PF2

 Provides information on keypad editing and VAXTPU features in
 general.  Request information after the "Topic:  " prompt.

3 WORD_Forward

 Keypad 1

 Moves the cursor to the beginning of the next word.

3 WORD_Reverse

 Keypad 3

 Moves the cursor to the beginning of the previous word.

3 INSERT_OVERSTRIKE_MODES

 F11

 Switches from insert mode to overstrike mode, or from overstrike
 mode to insert mode.

3 INCLUDE_FILE

 GOLD I

 Includes specified file at current cursor location.

3 WRITE_BUFFER

 GOLD O

 Writes out specified buffer out to the specified file.

3 QUIT

 F20

 QUIT the editor.  Do not save files.

3 WINDOWS

 GOLD F19

 The user can specify 1 or 2 windows for editing on the screen.  A buffer
 will be requested for the second window.  Use GOLD Y to change between
 windows (See change windows).

3 EXIT

 F10

 Exits saving file under name specified at session start.

3 CHANGE_WINDOWS

 F19

 Changes between windows if in two window mode.

3 FILE_EXIT

 GOLD CTRL/Z

 Exits requesting the name for the file to be stored.

3 LEARN_START

 GOLD [

 Starts the "learning" of keystrokes for up to 5 user-defined keys.
 "Learning" ends when user presses GOLD ] (See LEARN_END).  Only
 one LEARN can be defined at a time.  During a LEARN the user continues
 to work in the buffer as always, but all keystrokes are memorized and
 will be associated with the key specified by the user.

3 LEARN_END

 GOLD ]

 Ends the LEARN started by GOLD [ (see LEARN_START).

3 Column_Cut_or_Paste

  Cut or Paste sections specified by columns.  Also Known as
  rectangular cut and paste.  Set by pressing GOLD DO followed by
  EDTP$set_rectangular.

  Cut   - SELECT upper left corner, REMOVE when positioned to lower
          right corner.  Area CUT is portions of lines
          between upper left corner and lower right corner of select
          region.

  Paste - INSERT HERE at upper left corner.  Lines are pasted from specified
          buffer to succeeding lines starting at column where cursor is
          located.

3 No help available

 No help is available on that key.  The key that you pressed is
 either not assigned to a command or there has been no help text
 included for that key.

2 LINE_MODE_COMMANDS 

 The EDTP Emulator provided for VAXTPU emulates only a few of the
 line mode commands offered by EDT.  To enter several of the line
 mode commands, press CTRL/Z.  The asterisk prompt (*) appears at
 the lower left margin of your screen.  Enter the EDT Keypad
 Emulator line mode command followed by RETURN. To reenter keypad
 mode, type the letter C, for Change, followed by RETURN.  The
 cursor returns to its former location in the text. 

 To enter only one of line mode commands, press GOLD Keypad 7.

 You can extend or enhance the EDT Keypad Emulator's line mode
 commands by using the VAXTPU programming language.  See the VAX
 Text Processing Utility Reference Manual for more information on
 customizing the VAXTPU EDT Keypad Emulator editing interface.

3 CHANGE

 C

 Shifts the EDT Keypad Emulator to keypad mode, and returns the
 cursor to its former location in the text.

3 EXIT
 EXIT [/SAVE] [file-spec]

 Ends the EDT Keypad Emulator session, saving a copy of the
 MAIN_BUFFER text in an external file.  A new version of an
 existing file is created only if the file is modified.

4 /SAVE

 The /SAVE command line qualifier tells the EDT Keypad Emulator to
 save the journal file.  Whenever you use /SAVE, you must type a
 slash before it to signal the emulator that the following letters
 refer to a qualifier, and not a command word or string.  The /SAVE
 qualifier must be placed before the file name in this command.

3 FILL

 F

 Fills and justifies the paragraph that the cursor is located in.
 Justification takes place within the bounds of the current margin
 settings.

3 INCLUDE

 INCLUDE file-spec [=buffer]

 Copies the specified file into the current EDT Keypad Emulator
 session, at the current cursor position.  If you supply a buffer
 specification, it becomes the new current buffer.

3 QUIT
 QUIT [/SAVE]

 Ends your editing session without saving a copy of your editing
 work.  The EDT Keypad Emulator prompts you with the message:
 'Buffer modifications will not be saved, continue quitting (Y or
 N)?' only if you modified the text.  You respond with a Y or N.
4 /SAVE

 The /SAVE command line qualifier tells the EDT Keypad Emulator to
 save the journal file.  Whenever you use /SAVE, you must type a
 slash before it to signal the emulator that the following letters
 refer to a qualifier, and not a command word or string.  The /SAVE
 qualifier is the last element in the command line.

3 SUBSTITUTE

 SUB /old_string/new_string/ [WHOLE] [/QUERY]

 Replaces old_string with new_string.  If you supply no location
 specifiers, the substitution takes place at the first occurrence
 of "old_string" on the current line.  If you specify WHOLE, then
 the substitution is made throughout the current buffer.  If you 
 specify /QUERY then you will be prompted as to whther a string 
 should be replaced in any line.

3 WRITE

 WRITE file-spec [select|whole]

 Puts a copy of the entire current buffer or select range into the
 specified file.  Unlike EXIT, this command does not end the
 current editing session.  The SELECT option allows you to copy a
 selected region of text into the specified file.  When finished
 copying the text, the select range is reset.

3 SET

 SET commands allow you to customize your editing session.

4 ARROWS

 SET ARROWS [EDT or EVE]

 Controls the action of the arrow keys.  When set to EDT the cursor
 keys will act the same as in the EDT editor.  When set to EVE the
 cursor keys will act the same as in the EVE editor.

4 BUFFER

 SET BUFFER buffer_name

 Allows user to switch from one buffer to another.

4 CURSOR

 SET CURSOR top:bottom

 Controls scrolling of the screen relative to the distance of the
 cursor from the screen top and the screen bottom.  Values for the
 top and bottom can range from 0 to 21.  Default:  SET CURSOR 7:14.

4 FORWARD

 SET FORWARD

 Sets the direction of travel/search to FORWARD.

4 MARGINS

 SET MARGINS left,right

 The margin settings are only used by the FILL command.  Default: 1,80

4 NOWRAP

 SET NOWRAP

 Cancels the wrapping feature. (DEFAULT)

4 REVERSE

 SET REVERSE

 Sets the direction of travel/search to REVERSE.

4 SCREEN

 SET SCREEN width

 Sets the maximum number of characters that VAXTPU displays on a
 line of text.  The possible widths for VT100 terminals with
 advanced video option (AVO) are 80 and 132.  The width for VT100
 terminals without AVO is 80.  The possible widths for VT200
 terminals are 80 and 132.  Default:  set by operating system.

4 SEARCH
 SET SEARCH {GENERAL|EXACT}

 If EXACT, then the case of the characters must be the same.

 SET SEARCH {BEGIN|END}

 If END, then the current position will become the character
 following the located string; otherwise it will be the first
 character of the located string (default).

4 TAB

 SET TAB number

 Sets the tab value for various tabbing functions.

4 WRAP

 SET WRAP number

 Determines after which character VAXTPU wraps text being inserted
 in keypad mode.  It is also the right margin used in the FILL
 command.  If a SET WRAP number is not indicated, then the FILL
 command uses the current window size as the right margin.

3 SHOW

 SHOW commands tell which SET commands are in effect.

4 BUFFER

 Lists all buffers currently in use during your EDT Emulator
 session.  Also lists the number of lines in each buffer and the
 file name.  An equal sign (=) indicates the current buffer.

4 CURSOR

 Shows where scrolling of the screen relative to the distance of
 the cursor from the screen top and the screen bottom occurs.
 Values for the top and bottom can range from 0 to 21.  Default:
 SET CURSOR 7:14.

4 SCREEN

 Shows the maximum number of characters that VAXTPU displays on a
 line of text.  The possible widths for VT100 terminals with
 advanced video option (AVO) are 80 and 132.  The width for VT100
 terminals without AVO is 80.  The possible widths for VT200
 terminals are 80 and 132.  Default:  set by operating system.

4 SEARCH

 Shows how VAXTPU performs searches.  Default:  SET SEARCH GENERAL,
 SET SEARCH BEGIN.

4 VERSION

 Displays the current VAXTPU version number and the current version
 number of EDTPSECINI.TPU (the EDT-Plus Keypad Emulator section file).

4 WRAP

 Shows after which character VAXTPU wraps text being inserted in
 keypad mode.  It is also the right margin used in the FILL
 command.  If a SET WRAP number is not indicated, then the fill
 command uses the current window size as the right margin.

3 SPAWN

 Spawns a DCL subprocess.

3 TRIM

 Trims trailing whitespace from each record of the current buffer.

3 TYPE

 TYPE ALL 'string_to_search_for'

 Searches for the user specified string and copies each record that the
 string occurs in to the MESSAGE buffer.

3 Command_line_specifiers

4 buffer

 The name of a VAXTPU buffer.  Use the equal sign (=) immediately
 before the buffer name (for example, =MAIN).  If the buffer does
 not exist, VAXTPU creates one.  The EDT Keypad Emulator moves to
 the named buffer, except in the case of the WRITE command.

4 file-specification

 The specification for an external file.  It can include a
 directory specification.  With INCLUDE, it tells the EDT Keypad
 Emulator which file to copy into your editing session.  With EXIT
 and WRITE, it tells the EDT Keypad Emulator which file to create
 to hold text from your editing session.  If you include directory
 information, the directory must exist and you must have access to
 it.

4 select

 A selected region of text.  The selected text is copied into a
 file that is specified in the WRITE command.

4 whole

 The entire buffer is used.  With WRITE, it tells VAXTPU to write
 out the entire buffer (default).  With the SUBSTITUTE command, it
 tells VAXTPU to search the entire buffer.

3 Missing_commands

 Although the EDT Keypad Emulator provides only a few of the most
 frequently used line mode commands, missing commands can be
 executed by using VAXTPU built-ins from the Gold U command line.
 To get a list of the VAXTPU syntax for the missing EDT line mode
 commands, ask for help on EDT_EMULATOR VAXTPU_EQUIVALENTS.

2 VAXTPU_EQUIVALENTS
    The following table gives a quick view of how to enter VAXTPU
    procedure names after the "TPU Command:" prompt to emulate EDT
    line mode commands if you are using the EDT Keypad Emulator.


 EDT                            VAXTPU
 ---                            ------
 CLEAR temp                     DELETE(temp_buffer)

 COPY =main TO =paste           POSITION(paste_buffer)
                                COPY_TEXT(main_buffer)
  
 DEFINE KEY                     DEFINE_KEY("READ_FILE(  
  control N as                     READ_LINE('File name:'))"
  "EXT INCLUDE ?'File name: '."    ,CTRL_N_KEY)

 DELETE =main                   ERASE(main_buffer)

 FIND =my_buffer  or            buffer_name := CREATE_BUFFER('my_buffer')
   =my_buffer                   MAP(main_window,buffer_name)

 INSERT;character_string        COPY_TEXT('character_string')

 SET CURSOR 7:14                SET (SCROLLING,current_window,ON,6,7,0)

 SHL                            SHIFT(current_window,8)

 SHR                            SHIFT(current_window,-8)

 SHOW SCREEN                    SHOW(windows)

 WRITE foo.bar                  WRITE_FILE(main_buffer,'foo.bar')

2 Initialization

  EDT-Plus allows the use to specify commands to be executed at 
 the beginning of an editting session by having them stored in 
 specified files.  These files are SYS$LOGIN:EDTP_MAININI.TPU 
 and EDTPINI.TPU.

3 EDTP_MAININI

 The EDTP_MAININI.TPU file is placed in the directory 
 specified by the logical name SYS$LOGIN and is read and the 
 commands executed every time the user invokes the EDT-Plus 
 editor.  The commands stored in this file are the commands the 
 user wants executed at the beginning of every editing session.  

 If you have several accounts and wish to use only one
 initilization file for all the accounts, place your EDTP_MAININI.TPU
 file on a directory accessable to all of your accounts and define the
 logical EDTPMAININI to be the full name of the file
 (e.g. ASSIGN DUA0:[ADMDIR]EDTP_MAININI.TPU EDTPMAININI).

3 EDTPINI

 The EDTPINI.TPU file is located in the current default 
 directory and should contain commands specific to the editing 
 done in the directory.

3 Initial Tabs

 The user can specify the tab using either of the EDT standard 
 tabs or the EDTP special tabs.

3 CHAR_Key

 If you like to have keypad key 3 set to move character and 
 keypad key 1 set to move word with each folowing the direction 
 specified by keypad keys 4 (Advance) and 5 (Reverse) then 
 include the following commands in your initialization file.

 DEFINE_KEY('EDTP$move_word',KP1,'move_word');
 DEFINE_KEY(
 'IF current_direction=forward THEN MOVE_HORIZONTAL(1) ELSE '+
 'MOVE_HORIZONTAL(-1) ENDIF',KP3,'Move_Character');

3 Page_size

 This line will set what the size of a page used for  paginating
 (See KEYPAD Paginate).   EDTP starts with this value at 59.

 EDTP$Page_size := 59;
