1 APLTPU_KEYPAD The following keys have been defined in addition to the EDT emulator keys: CTRL/B - Toggle one/two windows GOLD S - Convert tabs/spaces GOLD CTRL/B - Open a reference file GOLD T - Convert non-printable chars GOLD UP - Move to top window GOLD U - Convert case upper/lower GOLD DOWN - Move to bottom window GOLD E - Trim spaces/tabs line end GOLD W - Adjust window sizes GOLD C - Center a line of text GOLD M - Save current position GOLD X - Toggle word definition GOLD G - Go to saved position GOLD B - Toggle box SELECT/CUT/PASTE GOLD L - Go to specified line GOLD O - Toggle overstrike/insert GOLD Q - Display line/column GOLD Y - Toggle graphics display GOLD F - Toggle margin support CTRL/K - Start learn sequence GOLD < - Set left margin CTRL/R - End learn sequence GOLD > - Set right margin GOLD I - Initialization commands GOLD TAB - Set tab size GOLD $ - Issue DCL commands GOLD Z - Display message buffer GOLD J - Selected substitution GOLD R - Display a "ruler" CTRL/V - Enter control character GOLD V - Display TPU version 1 EDT_KEYPAD [mlqqqqqqqqwqqqqqqqqwqqqqqqqqwqqqqqqqqk lqqqqqqqqwqqqqqqqqwqqqqqqqqwqqqqqqqqk x ^ x DOWN x x x x[7m [mx x FNDNXT x DEL L x x x x x x <qqqq x qqqq> x x[7m GOLD [mx HELP x x x x x x x x LEFT x RIGHT x x[7m [mx x[7m FIND [mx[7m UND L [mx x UP x v x x x tqqqqqqqqnqqqqqqqqnqqqqqqqqnqqqqqqqqu mqqqqqqqqvqqqqqqqqvqqqqqqqqvqqqqqqqqj x PAGE x SECT x APPEND x DEL W x DELETE Delete character x x x x x LINEFEED Delete to beginning of word x[7m COMMAND[mx[7m FILL [mx[7m REPLACE[mx[7m UND W [mx BACKSPACE Backup to beginning of line tqqqqqqqqnqqqqqqqqnqqqqqqqqnqqqqqqqqu CTRL/A Compute tab level x ADVANCEx BACKUP x CUT x DEL C x CTRL/D Decrease tab level x x x x x CTRL/E Increase tab level x[7m BOTTOM [mx[7m TOP [mx[7m PASTE [mx[7m UND C [mx CTRL/K Define key tqqqqqqqqnqqqqqqqqnqqqqqqqqnqqqqqqqqu CTRL/R Refresh Screen x WORD x EOL x CHAR x x CTRL/T Adjust tabs x x x x ENTER x CTRL/U Delete to beginning of line x[7mCHNGCASE[mx[7m DEL EOL[mx[7m SPECINS[mx x CTRL/W Refresh screen tqqqqqqqqvqqqqqqqqnqqqqqqqqu x CTRL/Z Exit to line mode x LINE x SELECT x x x x x[7m SUBS [mx x[7m OPEN LINE [mx[7m RESET [mx x mqqqqqqqqqqqqqqqqqvqqqqqqqqvqqqqqqqqj 1 APLTPU Schlumberger Extended EDT Emulator The Schlumberger Extended EDT Emulator provides additional functions to the DEC EDT Emulator for VAXTPU. 2 CTRL_B +----------+----------+ | | | | CTRL | B | | | | +----------+----------+ The Control/B key toggles between one and two windows. If two windows are being used, then Control/B will return the display to using one window. If one window is being used, Control/B will cause two windows to be used, with both windows mapped to the main buffer. 2 CTRL_K +----------+----------+ | | | | CTRL | K | | | | +----------+----------+ The Control/K key will start a learn sequence for a key. You will be prompted for the key to define. 2 CTRL_R +----------+----------+ | | | | CTRL | R | | | | +----------+----------+ The Control/R key will complete a learn sequence for a key. 2 CTRL_V +----------+----------+ | | | | CTRL | V | | | | +----------+----------+ The Control/V key will place the next character, including control characters at the current cursor position. This provides, for example, a convienent way to enter escape sequences by typing CTRL/V <ESC> (CTRL/V CTRL/[ on VT220). 2 GOLD_B +----------+ +----------+ | | | | | GOLD | + | B | | | | | +----------+ +----------+ The GOLD_B key toggles between BOX mode and Normal mode for the CUT (Remove), PASTE (Insert here), and SELECT keys. 2 GOLD_CTRL_B +----------+ +----------+----------+ | | | | | | GOLD | + | CTRL | B | | | | | | +----------+ +----------+----------+ The GOLD Control/B key causes two windows to be used, and will read a file into the top (reference) window. GOLD Control/B will prompt for the file to read into the ref- erence window. 2 GOLD_C +----------+ +----------+ | | | | | GOLD | + | C | | | | | +----------+ +----------+ The GOLD_C key will center the text on the current line. 2 GOLD_DOWN +----------+ +----------+ | | | | | GOLD | + | v | | | | | +----------+ +----------+ The GOLD_v (GOLD DOWN_ARROW) key will move the cursor from the top window to the bottom window when two windows are used. 2 GOLD_E +----------+ +----------+ | | | | | GOLD | + | E | | | | | +----------+ +----------+ The GOLD_E key will trim spaces and tabs from every line in the current buffer. 2 GOLD_F +----------+ +----------+ | | | | | GOLD | + | F | | | | | +----------+ +----------+ The GOLD_F key toggles margin support ON/OFF. If margin support is enabled, then the space, tab, return, and fill keys will cause text to be formatted within the margins specified by the GOLD_< and GOLD_> keys (columns 1 and 75 by default). 2 GOLD_G +----------+ +----------+ | | | | | GOLD | + | G | | | | | +----------+ +----------+ The GOLD_G key moves the cursor to the position previously saved with a GOLD_M key. GOLD_G can't move between buffers and/or windows. Eight different positions can be specified to the GOLD_G key by using the EDT repeat count facility. To specify position 2 for example, you would use the key sequence: GOLD 2 GOLD G If a repeat count is not specified, then position 1 is used. 2 GOLD_I +----------+ +----------+ | | | | | GOLD | + | I | | | | | +----------+ +----------+ The GOLD_I key allows APLTPU initialization commands to be entered interactively. For a complete description of the available commands, see the help for Init_File. 2 GOLD_J +----------+ +----------+ | | | | | GOLD | + | J | | | | | +----------+ +----------+ The GOLD_J key substitutes one string for another in the select range. GOLD_J will prompt for the two strings, and uses the responses from the last GOLD_J invocation as the defaults. 2 GOLD_L +----------+ +----------+ | | | | | GOLD | + | L | | | | | +----------+ +----------+ The GOLD_L key will prompt for a line to move the cursor to. 2 GOLD_M +----------+ +----------+ | | | | | GOLD | + | M | | | | | +----------+ +----------+ The GOLD_M key saves (marks) the current cursor position. The GOLD_G key can then be used to move the cursor back to this position. Eight different positions can be specified to the GOLD_M key by using the EDT repeat count facility. To specify position 2 for example, you would use the key sequence: GOLD 2 GOLD M If a repeat count is not specified, then position 1 is used. 2 GOLD_O +----------+ +----------+ | | | | | GOLD | + | O | | | | | +----------+ +----------+ The GOLD_O key toggles between insert and overstrike modes for the current buffer. 2 GOLD_Q +----------+ +----------+ | | | | | GOLD | + | Q | | | | | +----------+ +----------+ The GOLD_Q key is used to display the current line number along with the total number of lines in the buffer and the current cursor column position. 2 GOLD_R +----------+ +----------+ | | | | | GOLD | + | R | | | | | +----------+ +----------+ The GOLD_R key will display a ruler in the message area. 2 GOLD_S +----------+ +----------+ | | | | | GOLD | + | S | | | | | +----------+ +----------+ The GOLD_S key is used for conversion between spaces and tabs. GOLD_S will prompt for Space to tab conversion or Tab to space conversion. The default is S to convert spaces to tabs. 2 GOLD_T +----------+ +----------+ | | | | | GOLD | + | T | | | | | +----------+ +----------+ The GOLD_T key is used to display non-printable characters. GOLD_T prompts for one of three options: 1) DISPLAY_ONE will display the hex, decimal, and octal equivalents of the character, along with a printable representation of the character in the message area. 2) ON will convert all of the non-printable characters to a printable equivalent. This will change the contents of the buffer. 3) OFF will convert all of the printable equivalents of the non-printable characters back into ASCII characters. The contents of the buffer will be changed. The default option is DISPLAY_ONE. 2 GOLD_U +----------+ +----------+ | | | | | GOLD | + | U | | | | | +----------+ +----------+ The GOLD_U key is used to set the case of selected text to be all upper or all lower case. GOLD_U will prompt for Upper or Lower case. You should enter either U or L. The default case is lower case. 2 GOLD_UP +----------+ +----------+ | | | | | GOLD | + | ^ | | | | | +----------+ +----------+ The GOLD_^ (GOLD UP_ARROW) key will move the cursor from the bottom window to the top window when two windows are used. 2 GOLD_V +----------+ +----------+ | | | | | GOLD | + | V | | | | | +----------+ +----------+ The current version of VAXTPU and of the Schlumberger Extended EDT Emulator is displayed using the GOLD V keys. 2 GOLD_W +----------+ +----------+ | | | | | GOLD | + | W | | | | | +----------+ +----------+ The GOLD_W key is used to adjust the size of the windows when two windows are used. GOLD_W prompts for the number of lines to adjust the windows by. A positive number will increase the size of the main window by 4 lines and decrease the size of the reference window by 4 lines. 2 GOLD_X +----------+ +----------+ | | | | | GOLD | + | X | | | | | +----------+ +----------+ The definition of a word can be toggled between whitespace, non-alphanumeric characters, and if defined, a user specified word definition. For information on user specified word definitions, see help on Init_files. The default setting is for words to be defined as non-alphanumerics. 2 GOLD_Y +----------+ +----------+ | | | | | GOLD | + | Y | | | | | +----------+ +----------+ The GOLD_Y key will toggle the translation of escape sequences. This key should be used carefully, because the cursor position may not necessarily correspond with the true position in the text buffer. Also, escape sequences sent to the terminal may interfere with those normally sent by the screen manager. Use this key at your own risk. 2 GOLD_Z +----------+ +----------+ | | | | | GOLD | + | Z | | | | | +----------+ +----------+ Displays the contents of the message buffer. Carriage returns and line feeds are processed to allow system shutdown and other messages to be read. 2 GOLD_$ +----------+ +----------+ | | | | | GOLD | + | $ | | | | | +----------+ +----------+ The GOLD_$ creates a subprocess to execute DCL commands, and displays the output from the commands in the top window of a split screen display. Information in the DCL buffer can be edited. The following restrictions apply: - This command can not be used in a CAPTIVE account or if your subprocess quota is exhausted. - You do not see any prompts from utilites - Only utilities which support input/output to a mailbox may be used. Utilities such as PHONE or TPU which take full control of the screen will not work properly. 2 GOLD_< +----------+ +----------+ | | | | | GOLD | + | < | | | | | +----------+ +----------+ The GOLD_< key sets the left margin to be used when margin support is enabled. 2 GOLD_> +----------+ +----------+ | | | | | GOLD | + | > | | | | | +----------+ +----------+ The GOLD_< key sets the right margin to be used when margin support is enabled. 2 GOLD_TAB +----------+ +----------+ | | | | | GOLD | + | TAB | | | | | +----------+ +----------+ The GOLD_TAB key prompts for a new spacing between tab stops. If a spacing of 0 is specified, the TAB key reverts to normal EDT TAB functionality. 2 Box_Cut_Paste +----------+ +----------+ | | | | | GOLD | + | B | | | | | +----------+ +----------+ The GOLD_B key will toggle the definition of the CUT (Remove), PASTE (Insert here), and SELECT keys between the normal EDT mode and box mode. In box mode, the select key will create a marker for one corner of an imaginary box on the screen. The opposite corner is def- ined by the position of the cursor. The box defined by the mar- ker and the cursor is used by the CUT key. In box mode, all of the text which is inside the box will be CUT out, and replaced by spaces. For a PASTE, the box in the paste buffer will overlay any text when in it pasted in. The cursor is used to mark the upper left corner of a PASTE box. EXAMPLE: ................ ....M........... BOX SELECTED ................ M - Marker BEFORE CUT: ...........C.... C - Cursor ................ ................ ....C .... AFTER CUT: .... .... C - Cursor .... .... ................ ................ .... .... AFTER CUT .... .... C - Cursor BEFORE PASTE .... .... ......C......... ................ .... .... AFTER PASTE .... .... C - Cursor .... .... ......C......... ........ ........ 2 Center_Line +----------+ +----------+ | | | | | GOLD | + | C | | | | | +----------+ +----------+ The GOLD_C key will center the text on the current line. 2 DCL +----------+ +----------+ | | | | | GOLD | + | $ | | | | | +----------+ +----------+ The GOLD_$ creates a subprocess to execute DCL commands, and displays the output from the commands in the top window of a split screen display. Information in the DCL buffer can be edited. The following restrictions apply: - This command can not be used in a CAPTIVE account or if your subprocess quota is exhausted. - You do not see any prompts from utilites - Only utilities which support input/output to a mailbox may be used. Utilities such as PHONE or TPU which take full control of the screen will not work properly. 2 Enter_CTRL_Char +----------+----------+ | | | | CTRL | V | | | | +----------+----------+ The Control/V key will place the next character, including control characters at the current cursor position. This provides, for example, a convienent way to enter escape sequences by typing CTRL/V <ESC> (CTRL/V CTRL/[ on VT220). 2 Graphics/Escape_Seq +----------+ +----------+ | | | | | GOLD | + | Y | | | | | +----------+ +----------+ The GOLD_Y key will toggle the translation of escape sequences. This key should be used carefully, because the cursor position may not necessarily correspond with the true position in the text buffer. Also, escape sequences sent to the terminal may interfere with those normally sent by the screen manager. Use this key at your own risk. 2 Goto_Line +----------+ +----------+ | | | | | GOLD | + | L | | | | | +----------+ +----------+ The GOLD_L key will prompt for a line to move the cursor to. 2 Init_File The Schlumberger EDT Emulator (APLTPU) can be customized to suit your needs with initialization files. Two types of initialization files may be used, COMMAND files containing VAXTPU commands, and INITIALIZATION files containing APLTPU commands. 3 COMMAND_files Command files contain VAXTPU commands and are documented in the VAX Text Processing Utility Manual in the VMS documentation set. The search sequence for command files is: 1) None if /NOCOMMAND is specified in the TPU command line 2) Any file specified by /COMMAND in the TPU command line 3) Under VMS V4.x, the logical name TPUINI is used next Under VMS V5.x, the logical name TPU$COMMAND is used next 4) Under VMS V4.x, the file TPUINI.TPU in the current directory Under VMS V5.x, the file TPU$COMMAND.TPU in the current directory 3 INITIALIZATION_files Initialization files contain Schlumberger EDT Emulator (APLTPU) commands to allow you to change the default setting of APLTPU options. APLTPU commands can be abbreviated to the shortest unique command. 4 File_names The search sequence for initialization files is: 1) (VMS V5.x) None if /NOINIT is specified in the TPU command line 2) (VMS V5.X) Any file specified by /INIT in the TPU command line 3) The logical name APLTPU$INIT.APLTPU 4) The file APLTPU$INIT.APLTPU in the current directory 5) The file APLTPU$INIT.APLTPU in your login directory, SYS$LOGIN: 4 Comments ! Comment Lines in an APLTPU$INIT file beginning with "!" are treated as comments and ignored. 4 Continuation APLTPU commands may be continued to another line by ending them with a "-". 4 ENABLE_BOX {ENABLE|DISBALE} BOX The ENABLE/DISABLE BOX command performs the same function as the GOLD B command and changes the SELECT/CUT/PASTE keys to work in either BOX mode or the normal EDT mode. See GOLD_B for more information. 4 ENABLE_DISPLAY {ENABLE|DISBALE} DISPLAY option The ENABLE/DISABLE DISPLAY commands affect the display from APLTPU commands. Currently, the only supported option is {ENABLE|DISBALE} DISPLAY DEFAULT_FILENAME which affects the display of a default file name for the GOLD CTRL/B key. GOLD CTRL/B will still use a default file name of the last file specified to GOLD CTRL/B, but won't show the default file name in the prompt when disabled. 4 ENABLE_MARGIN {ENABLE|DISBALE} MARGIN The ENABLE/DISABLE MARGIN command performs the same function as the GOLD F key and enables margin support, causing text to stay within the bounds specified by either SET LEFT_MARGIN and SET RIGHT_MARGIN or by the GOLD_< and GOLD_> keys. 4 HELP HELP HELP may be entered as an interactive initialization command to obtain help on initialization commands. It is ignored in APLTPU$INIT files. 4 MESSAGE MESSAGE message The message command will display the specified message in the message window. 4 SET_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 SET_DCL SET DCL {ERASE|NOERASE} Controls whether the DCL command erases the DCL buffer between DCL commands. 4 SET_INSERT SET INSERT Sets the MAIN buffer to be in insert mode whereby text is inserted at the cursor position as it is entered. 4 SET_LEFT_MARGIN SET LEFT_MARGIN n The SET LEFT_MARGIN command performs the same function as the GOLD_< key and sets the left margin to column n if margin support is enabled (GOLD_F or ENABLE MARGINS) 4 SET_OVERSTRIKE SET OVERSTRIKE Sets the MAIN buffer to be in overstrike mode whereby text is replaced at the cursor position as it is entered. 4 SET_QUIET SET QUIET The SET QUIET command will turn off command verification until a SET VERIFY command is issued. This will eliminate some of the messages from APLTPU commands. 4 SET_RIGHT_MARGIN SET RIGHT_MARGIN n The SET RIGHT_MARGIN command performs the same function as the GOLD_> key and sets the right margin to column n if margin support is enabled (GOLD_F or ENABLE MARGINS) 4 SET_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 SET_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 SET_TAB SET TAB EDT number SET TAB EDT is equivelent to EDT line mode SET TAB command to set the tab value for tabbing functions. SET TAB EVERY number The SET TAB EVERY will change the "size" of the tab key to be every "number" spaces. 4 SET_VERIFY SET VERIFY The SET VERIFY command will turn on command verification previously turned off by SET QUIET. 4 SET_WORD SET WORD {EDT|NON-ALPHANUMERIC|"user specified"} The SET WORD command performs the same operation as the GOLD_X key and changes word delimiters to be whitespace (EDT), non-alphanumeric characters (NON-ALPHANUMERIC), or any user specified delimeters. 4 SET_WRAP SET WRAP number Determines the column (when margin support is disabled) at which text will be wrapped when in keypad mode. It is also the right margin used by the FILL command. If a SET WRAP number is not issued, then the FILL command uses the window size. 4 TPU TPU command Executes the specified VAXTPU command. 2 Input_File The Schlumberger EDT Emulator (APLTPU) is invoked as follows: $ TPU filename [,filename [,...]] The filename can contain wildcards. Note that the symbols TPU and TPUR should be defined as follows: $ TPU :== @SYS$LIBRARY:APLTPU $ TPUR :== @SYS$LIBRARY:APLTPUR TPUR will edit files /READ_ONLY, and will not use a journal file. 3 /CONFIRM The /CONFIRM switch causes APLTPU to confirm for each file to be edited, whether or not the file should actually be edited. You can answer Yes, No, or Quit. The default is not to edit the file. Quit will cause APLTPU to stop searching for files. Example: $ TPU *.COM/CONFIRM Edit file SYS$SYSDEVICE:[USER]BINREAD.COM;4 [Y/N/Q]? Edit file SYS$SYSDEVICE:[USER]LOGIN.COM;132 [Y/N/Q]? Edit file SYS$SYSDEVICE:[USER]SEARCH.COM;1 [Y/N/Q]? Q $ 2 Insert/Overstrike +----------+ +----------+ | | | | | GOLD | + | O | | | | | +----------+ +----------+ The GOLD_O key toggles between insert and overstrike modes for the current buffer. 2 Learn The Schlumberger EDT Emulator can "learn" a function. This is similar to the define key feature of EDT. A learn sequence is started by using the CTRL/K key. You will be prompted for a key to define. After you hit the key to be defined, all of the keystrokes you enter will be remembered unitl a CTRL/R is entered. The next time that you use the newly defined key, the keystrokes for the key will be performed again. Note that if the definition includes any keys which prompt for input, the answer you provided in learn mode is used. CTRL/K - Begin learn sequence CTRL/R - End learn sequence 2 Line/Column +----------+ +----------+ | | | | | GOLD | + | Q | | | | | +----------+ +----------+ The GOLD_Q key is used to display the current line number along with the total number of lines in the buffer and the current cursor column position. 2 Margins +----------+ +----------+ | | | | | GOLD | + | F | | | | | +----------+ +----------+ The GOLD_F key toggles margin support ON/OFF. If margin support is enabled, then the space, tab, return, and fill keys will cause text to be formatted within the margins specified by the GOLD_< and GOLD_> keys (columns 1 and 75 by default). 2 Messages +----------+ +----------+ | | | | | GOLD | + | Z | | | | | +----------+ +----------+ Displays the contents of the message buffer. Carriage returns and line feeds are processed to allow system shutdown and other messages to be read. 2 Ruler +----------+ +----------+ | | | | | GOLD | + | R | | | | | +----------+ +----------+ The GOLD_R key will display a ruler in the message area. 2 Save/Goto_Position The current cursor position can be saved and restored using the GOLD_M and GOLD_G keys. The GOLD_M key marks the current pos- ition, and GOLD_G goes back to a marked position. 2 Selected_Substitution +----------+ +----------+ | | | | | GOLD | + | J | | | | | +----------+ +----------+ The GOLD_J key substitutes one string for another in the select range. GOLD_J will prompt for the two strings, and uses the responses from the last GOLD_J invocation as the defaults. 2 Space_Tab_Conversion +----------+ +----------+ | | | | | GOLD | + | S | | | | | +----------+ +----------+ The GOLD_S key is used for conversion between spaces and tabs. GOLD_S will prompt for Space to tab conversion or Tab to space conversion. The default is S to convert spaces to tabs. 2 TAB_stops +----------+ +----------+ | | | | | GOLD | + | TAB | | | | | +----------+ +----------+ The GOLD_TAB key prompts for a new spacing between tab stops. If a spacing of 0 is specified, the TAB key reverts to normal EDT TAB functionality. 2 Translate_CTRL_Chars +----------+ +----------+ | | | | | GOLD | + | T | | | | | +----------+ +----------+ The GOLD_T key is used to display non-printable characters. GOLD_T prompts for one of three options: 1) DISPLAY_ONE will display the hex, decimal, and octal equivalents of the character, along with a printable representation of the character in the message area. 2) ON will convert all of the non-printable characters to a printable equivalent. This will change the contents of the buffer. 3) OFF will convert all of the printable equivalents of the non-printable characters back into ASCII characters. The contents of the buffer will be changed. The default option is DISPLAY_ONE. 2 Trim_Buffer +----------+ +----------+ | | | | | GOLD | + | E | | | | | +----------+ +----------+ The GOLD_E key will trim spaces and tabs from every line in the current buffer. 2 Upper_Lower_Case +----------+ +----------+ | | | | | GOLD | + | U | | | | | +----------+ +----------+ The GOLD_U key is used to set the case of selected text to be all upper or all lower case. GOLD_U will prompt for Upper or Lower case. You should enter either U or L. The default case is lower case. 2 Version +----------+ +----------+ | | | | | GOLD | + | V | | | | | +----------+ +----------+ The current version of VAXTPU and of the Schlumberger Extended EDT Emulator is displayed using the GOLD V keys. 2 Windows The Schlumberger Extended EDT Emulator allows editting in either one or two windows. When two windows are used, the bottom window is mapped to the main buffer with the file that is being edited, and the top window mapped either to a reference file or to the main buffer. All editing operations are allowed in both windows. The following keys are used to manipulate windows: CTRL/B - Toggle between one and two windows GOLD CTRL/B - Open a reference file in top window GOLD UP - Move to top window GOLD DOWN - Move to bottom window GOLD W - Adjust the relative size of the windows 2 Word_Definition +----------+ +----------+ | | | | | GOLD | + | X | | | | | +----------+ +----------+ The definition of a word can be toggled between whitespace, non-alphanumeric characters, and if defined, a user specified word definition. For information on user specified word definitions, see help on Init_files. The default setting is for words to be defined as non-alphanumerics. 1 EDT_EMULATOR 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. 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: 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 2 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. 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 CHAR Keypad 3 Moves the cursor one character in the current direction. 3 CHNGCASE GOLD Keypad 1 Changes the case of all the letters in the select range, or the case of the current letter. 3 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. 3 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. 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 CTRL_D CTRL/D (Decrease Tab Level) Reduces the current tab level count by one. 3 CTRL_E CTRL/E (Increase Tab Level) Increases the current tab level count by one. 3 CTRL_F CTRL/F Erases the window that displays HELP or SHOW text, and returns the cursor to MAIN_WINDOW. 3 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. 3 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. 3 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. 3 CTRL_K CTRL/K Prompts for the VAXTPU define key command. 3 CTRL_L CTRL/L Inserts a form feed character into the text. 3 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. 3 CTRL_R CTRL/R (Refresh Screen) Refreshes the screen. 3 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'. 3 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. 3 CTRL_W CTRL/W (Refresh Screen) Refreshes the screen. 3 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. 3 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 (*). 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 DO DO key on VT200 Sends a command or search string to the editor for processing. 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 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 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 LINE Keypad 0 Moves the cursor to the beginning of the next line in the current editing direction. 3 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. 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. 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 MAIN_WINDOW 8 columns to the left. Has no effect on the text. 3 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. 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 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 Keypad 1 Moves the cursor to the beginning of the next word in the current direction. 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 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. 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. 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 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] 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. 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 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 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 Keypad 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 EDTSECINI.TPU (the EDT 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 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 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. 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) 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')