VAXTPU EDT_EMULATOR — MicroVMS 4.6
The EDT Keypad Emulator is an interactive text editor that demonstrates the versatility and extensibility of the VAXTPU programming language. This editor emulates the keypad functions and some of the line mode commands of the EDT Version 3 text editor. The purpose of the EDT 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, but then go on to enhance the editor with the further powerful capabilities of the VAXTPU language.
Additional information available:
HELPKEYPAD_FUNCTIONSLINE_MODE_COMMANDSVAXTPU_EQUIVALENTS
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:
EDT - to get a list of EDT_EMULATOR topics
EDT LINE - to get a list of line mode commands
EDT KEY - to get a list of keypad commands
EDT VAXTPU_EQU - to get help on VAXTPU syntax for missing
line mode commands
VAXTPU - to get help on the VAXTPU language
KEYPAD_FUNCTIONS
One major difference between EDT and the VAXTPU EDT Keypad Emulator is the use of GOLD Keypad 7 (PF1 and KP7). This command places you into VAXTPU command line mode. Here you can enter VAXTPU commands or programs. To use the emulated subset of EDT line mode commands you must use CTRL/Z and enter the commands at the asterisk (*) prompt.
Additional information available:
ADVANCEAPPENDBACKSPACEBACKUPBOTTOMCHAR
CHNGCASECOMMANDCTRL_ACTRL_CCTRL_DCTRL_ECTRL_F
CTRL_HCTRL_ICTRL_JCTRL_KCTRL_LCTRL_MCTRL_R
CTRL_TCTRL_UCTRL_WCTRL_YCTRL_ZCUTDEL_C
DEL_EOLDELETEDEL_LDEL_WDODOWN_ARROW
ENTEREOLFILLFINDFNDNXTGOLDHELP
LEFT_ARROWLINELINEFEEDOPEN_LINEPAGE
PASTEREPLACERESETRETURNRIGHT_ARROWSECT
SELECTSHIFT_LEFTSHIFT_RIGHTSPECINSTAB
TOPUND_CUND_LUND_WUP_ARROWVAXTPU_HELP
WORD
SUBS (substitute)No help available
ADVANCE
Keypad 4 Sets the editing direction to forward; that is, toward the bottom of the buffer.
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.
BACKSPACE
CTRL/H Moves the cursor to the beginning of the current line or the previous line, depending on the editing direction.
BACKUP
Keypad 5 Sets the editing direction to reverse; that is, toward the top of the buffer.
BOTTOM
GOLD Keypad 4 Moves the cursor to the end of the current buffer.
CHAR
Keypad 3 Moves the cursor one character in the current direction.
CHNGCASE
GOLD Keypad 1 Changes the case of all the letters in the select range, or the case of the current letter.
COMMAND
GOLD Keypad 7 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.
CTRL_A
CTRL/A (Compute Tab Level) Resets the tab indentation level to the current cursor position, if that position is a multiple of the current SET TAB value.
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.
CTRL_D
CTRL/D (Decrease Tab Level) Reduces the current tab level count by one.
CTRL_E
CTRL/E (Increase Tab Level) Increases the current tab level count by one.
CTRL_F
CTRL/F Erases the window that displays HELP or SHOW text, and returns the cursor to MAIN_WINDOW.
CTRL_H
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.
CTRL_I
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.
CTRL_J
CTRL/J LINEFEED Deletes characters from the current cursor position to the beginning of the word that the cursor is in. If the cursor is at the beginning of a word, the previous word is deleted.
CTRL_K
CTRL/K Prompts for the VAXTPU define key command.
CTRL_L
CTRL/L Inserts a form feed character into the text.
CTRL_M
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.
CTRL_R
CTRL/R (Refresh Screen) Refreshes the screen.
CTRL_T
CTRL/T (Tab Adjust) Indents each line in the select range. Note that this key will only work if you have used the DCL command 'SET NOCONTROL=T'.
CTRL_U
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.
CTRL_W
CTRL/W (Refresh Screen) Refreshes the screen.
CTRL_Y
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.
CTRL_Z
CTRL/Z (Exit to Line Mode) Shifts from keypad mode to the EDT Keypad Emulator command line mode. Places the cursor at the EDT Keypad Emulator command line mode prompt (*).
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.
DEL_C
DEL C (delete character) Keypad COMMA Deletes the character that the cursor is on.
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.
DELETE
DELETE key on VT100, <X] key on VT200 Deletes the character to the left of the current cursor position.
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.
DEL_W
DEL W (delete word) Keypad MINUS Deletes characters from the current cursor position to the beginning of the next word.
DO
DO key on VT200 Sends a command or search string to the editor for processing.
DOWN_ARROW
Moves the cursor down to the position on the following line that corresponds to the current cursor position.
ENTER
Sends a command or search string to the editor for processing. Completes the CTRL/K key definition process.
EOL
Keypad 2 Moves the cursor to the next line terminator in the current editing direction.
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.
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.
FNDNXT
Keypad PF3 Locates the next occurrence of the current search string in the current direction.
GOLD
Keypad PF1 Accesses alternate keypad functions.
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.
LEFT_ARROW
Moves the cursor one character to the left.
LINE
Keypad 0 Moves the cursor to the beginning of the next line in the current editing direction.
LINEFEED
CTRL/J Deletes characters from the current cursor position to the beginning of the word that the cursor is in. If the cursor is at the beginning of a word, the previous word is deleted.
OPEN_LINE
Gold Keypad 0 Causes a new line to be inserted at the current cursor position. The cursor does not move.
PAGE
Keypad 7 Moves the cursor to the next EDT Keypad Emulator page boundary in the current direction.
PASTE
Gold Keypad 6 Inserts the contents of the PASTE_BUFFER just before the cursor.
REPLACE
Gold Keypad 9 Deletes the selected range and replaces it with the contents of the PASTE_BUFFER.
RESET
Gold Keypad PERIOD Cancels the select range and sets the current buffer's direction to forward. Also clears the PROMPT_AREA.
RETURN
Inserts a line terminator in the text. The cursor moves to the beginning of the new line.
RIGHT_ARROW
Moves the cursor one character to the right.
SECT
Keypad 8 Moves the cursor 16 lines in the current direction.
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.
SHIFT_LEFT
Gold left arrow Shifts the screen image of the MAIN_WINDOW 8 columns to the left. Has no effect on the text.
SHIFT_RIGHT
Gold right arrow Shifts the screen image of the MAIN_WINDOW 8 columns to the right if the text has already been shifted to the left. Has no effect on the text.
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.
SUBS (substitute)
Gold Keypad ENTER Replaces the next occurrence of the current search string in your text with the contents of the PASTE_BUFFER.
TAB
CTRL/I Moves the text that is to the right of the cursor (including the cursor character) to the right to the nearest preset tab stop.
TOP
Gold Keypad 5 Moves the cursor to the beginning of the current buffer.
UND_C
UND C (undelete character) Gold Keypad COMMA Inserts the contents of the delete character buffer to the left of the cursor.
UND_L
UND L (undelete line) Gold Keypad PF4 Inserts the contents of the delete line buffer to the left of the cursor.
UND_W
UND W (undelete word) Gold Keypad MINUS Inserts the contents of the delete word buffer to the left of the cursor.
UP_ARROW
Moves the cursor up to the position on the previous line that corresponds to the current cursor position.
VAXTPU_HELP
Gold Keypad PF2 Provides information on keypad editing and VAXTPU features in general. Request information after the "Topic: " prompt.
WORD
Keypad 1 Moves the cursor to the beginning of the next word in the current direction.
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.
LINE_MODE_COMMANDS
The EDT Keypad Emulator provided with VAXTPU emulates only a few of the line mode commands offered by EDT. To enter one 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. 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.
Additional information available:
CHANGEEXITINCLUDEQUITSUBSTITUTEWRITE
SETSHOW
Command line specifiersMissing commands
CHANGE
C Shifts the EDT Keypad Emulator to keypad mode, and returns the cursor to its former location in the text.
EXIT
EXIT [/SAVE] [file-spec] Ends the EDT Keypad Emulator session, saving a copy of the MAIN_BUFFER text in an external file.
Additional information available:
/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.
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.
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.
Additional information available:
/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.
SUBSTITUTE
SUB /old_string/new_string/ [WHOLE] 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.
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.
SET
SET commands allow you to customize your editing session.
Additional information available:
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.
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.
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).
TAB
SET TAB number Sets the tab value for various tabbing functions.
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.
SHOW
SHOW commands tell which SET commands are in effect.
Additional information available:
BUFFERCURSORSCREENSEARCHVERSIONWRAP
BUFFER
Lists all buffers currently in use during your EDT Keypad Emulator session. Also lists the number of lines in each buffer and the file name. An equal sign (=) indicates the current buffer.
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.
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.
SEARCH
Shows how VAXTPU performs searches. Default: SET SEARCH GENERAL, SET SEARCH BEGIN.
VERSION
Displays the current VAXTPU version number and the current version number of EDTSECINI.TPU (the EDT Keypad Emulator section file).
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.
Command line specifiers
Additional information available:
bufferfile-specificationselectwhole
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.
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.
select
A selected region of text. The selected text is copied into a file that is specified in the WRITE command.
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.
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 KP7 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.
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)
EXIT EXIT
FILL =main FILL(main_buffer,' ',r_margin,l_margin)
FIND =my_buffer or buffer_name := CREATE_BUFFER('my_buffer')
=my_buffer MAP(main_window,buffer_name)
INCLUDE foo.bar READ_FILE('foo.bar')
INSERT;character_string COPY_TEXT('character_string')
QUIT QUIT
SET SCREEN 132 SET(WIDTH,main_window,132)
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(screen)
SHOW(windows)
SHOW version SHOW(summary)
SHOW buffer SHOW(buffers)
WRITE foo.bar WRITE_FILE(main_buffer,'foo.bar')