.spr 0 .flags bold .literal .end list .c;^*The EVE__and__EDT TPU Interface .c;Version 23-Apr-1987 .skip 12 .literal Written by : Scott E. Smith For: Telex Computer Products 3301 Terminal Drive Raleigh, NC 27604 Submitted by: Scott E. Smith Sperry Marine Inc. Charlottesville, VA 22906 (804) 973-0186 .end literal .title ^*The EVE__and__EDT TPU Interface .layout 2,2 .chapter ^*Introduction to the EVE__and__EDT TPU Interface\* .lm 7 .rm 67 .p This document describes EVE__and__EDT TPU Interface, an extension to the EVE TPU Interface. The interface is designed to ease the transition of users from EDT to EVE by providing an 'EDT style' editing keypad to access EVE commands. This serves two purposes, .list .le;To provide a short-hand notation for EVE commands that would otherwise have to be entered on the command line. .le;To reduce the frustration associated with learning a new key pad. With the EVE__and__EDT Interface, the same sequence of key strokes will produce the same (or very similar) results whether you are using EDT or EVE. .end list .style headers 3,0 .hl 1 Differences between EVE__and__EDT and EDT It is important to note that ^*the EVE__and__EDT Interface is not a strict EDT emulator\*. The interface does not try to be EDT, instead it binds EVE commands to the keypad in the same location that EDT binds similar commands. Therefore, you will notice some slight differences between the behavior of EVE and EDT (such as cursor placement when ERASing and RESTORing entities) but the advantages of EVE -- multiple windows, speed, etc. -- should make it easy to live with the differences. Note also that ^*no EDT line mode and nokeypad mode commands are supported by EVE__and__EDT\*. This means that you will have to learn a new set of line mode commands (some commands will be familiar -- DEFINE KEY, EXIT, FILL, HELP, INCLUDE, QUIT -- but the format may not be exactly the same). Also EDT initialization files are not supported by EVE. .hl 1 Initialization files Those who use an EDT initialization file to define keys should not worry, with EVE it is an easy matter to interactively define keys and then save those key definitions in a section file (see Section 3.8, ^*Defining Keys\* in the ^&Guide to Text Processing on VAX/VMS\&). That section file can then be specified as a TPU initialization file in one of two ways: .list .le;by issuing the EVE/SECTION#=#section__file__spec (or EDIT/TPU/SECTION#=#section__file__spec) command. For example: .blank .rm+10 $#EVE/SECTION=DISK$TOOLS:[SMITH]MYEVE.TPU$SECTION##file__name .rm-10 .le;by assigning the full file spec of your section file to the logical name TPUSECINI and then issuing the EVE (or EDIT/TPU) command. For example: .blank $#ASSIGN##DISK$TOOLS:[SMITH]MYEVE.TPU$SECTION##TPUSECINI .break $#EVE file__name .blank This is the preferred method because it allows you to use your section file when using EVE inside other utilities such as MAIL. .end list .hl 1 Accessing EVE__and__EDT To access the EVE__and__EDT TPU Interface use the predefined system wide EVE command (or EDIT/TPU) to start your edit session. The keypad will come up in the default EVE configuration. To reconfigure your terminal to the EVE__and__EDT keypad, press the DO key and enter the EDT KEYPAD command. .p If you would like your edit sessions to come up with the keypad configured for EVE__and__EDT you can do one of two things: .list .le;Access EVE, issue an "EDT KEYPAD" command to configure the keypad, issue a "SAVE EXTENDED TPU" command to create a section file, and use the new section file to initialize your EVE sessions. (See section 1.2 above.) .le;Create a TPU command file (default file extension '.TPU') with one line, "^*EVE__EDT__KEYPAD;\*", and use it to initialize your edit section using one of the following methods: .list .le;issue an EVE/COMMAND=command__file__name command For example: .blank $#EVE/COMMAND=DISK$TOOLS:[SMITH]MYEVE.TPU##file__name .le;name your command file TPUINI.TPU and it will be used by EVE as an initialization file as long as it is in your default directory .le;assign the full file spec of your command file to the logical name TPUINI and eve will use the file as an initialization command file. For example: .blank $#ASSIGN##DISK$TOOLS:[SMITH]MYEVE.TPU##TPUINI .end list .end list The first method of using a section file to initialize your EVE section is faster than using a command file; using a command file will take up less disk space than using a section file. .chapter ^*The EVE__and__EDT Keypad\* .lit +--------+--------+--------+--------+ +--------+--------+--------+--------+ | UP | DOWN | LEFT | RIGHT | | | | FNDNXT |ERASE L | | ^ | | | <---- | ----> | | GOLD | HELP | | | | | | v | | | | | | FIND |RESTOR L| |PREV SCR|NEXT SCR|SH LEFT |SH RIGHT| +--------+--------+--------+--------+ +--------+--------+--------+--------+ | PAGE | SCREEN | APPEND |ERASE W | DELETE - Delete character | | | | | BACKSPACE - Start Of Line | DO | FILL |REP RANG|RESTOR W| GOLD/P - Change Mode +--------+--------+--------+--------+ CTRL/A - Compute Left Margin |FORWARD |REVERSE | REMOVE |ERASE C | CTRL/B - Recall | | | | | CTRL/D - Decrease Left Margin | BOTTOM | TOP | INSERT |RESTOR C| CTRL/E - Increase Left Margin +--------+--------+--------+--------+ CTRL/K - Define Key |MOV WORD| EOL |MOV CHAR| | CTRL/R - Remember | | | | RETURN | CTRL/U - Erase To Start Of Line |CHNGCASE|ERAS EOL| SPECINS| | CTRL/V - Quote +--------+--------+--------+ | CTRL/W - Refresh | LINE | SELECT | | CTRL/Z - Exit | | | SUBS | Use the Do key to enter | OPEN LINE | RESET | | advanced commands. +-----------------+--------+--------+ .end lit .ps 63 .chapter ^*EVE__and__EDT Commands\* .lm 7 All EVE line mode and keypad commands are available in EVE__and__EDT and can be entered on the command line (accessed via the DO key). EVE__and__EDT introduces several new line commands and keypad commands which are described below. All new commands are built from EVE procedures and will therefore display 'EVE style' behaviour. .hl 1 EVE__and__EDT line commands This section describes the EVE__and__EDT line commands that are not available in the default EVE TPU interface. .b 2 .i-2 DEFAULT KEYPAD .P The DEFAULT KEYPAD command reconfigures the terminal's application keypad to the default EVE configuration. Any key definition set by the user with the DEFINE KEY command will not be modified. .b 2 .i-2 EDT KEYPAD .P The EDT KEYPAD command reconfigures the terminal's application keypad to the EVE__and__EDT configuration. Any key definition set by the user with the DEFINE KEY command will not be modified. .b 2 .i-2 SUBSTITUTE##"old string"##"new string"##[keyword] .p This command replaces an old string, or text, with a new string, or text. .lm+15 .blank .i-15 "old#string"#-#Is the string to be replaced. If you do not include this parameter on the command line then EVE will prompt you for the text. If you enter the text in all lowercase letters, EVE__and__EDT will replace any occurrence of the text whether it is in lowercase, uppercase, or a combination of the two. If the text is entered in all uppercase letters or a combination of uppercase and lowercase letters, EVE__and__EDT will only replace occurrences of the string that have the same combination of lowercase and uppercase letters. .blank .i-15 "new#string"#-#Is the text to be inserted in the place of the old string. This parameter may be null and will be prompted for only if the old string parameter is also null. .blank .i-15 keyword######-#Is an optional parameter that specifies the range of text over which the substitution is to take place. Valid keywords are: .lm+11 .blank .i-11 "all"####-#Make the substitution for all occurrences of the old string in the buffer and return the cursor to its starting position. .blank .i-11 "rest"###-#Make the substitution for all occurrences of the old string between the current cursor position and the end of the buffer in the current direction. The cursor is returned to its starting position. .blank .i-11 "select"#-#Make the substitution for all occurrences of the old string in the current select range and return the cursor to its starting position. .blank .lm-11 If you do not enter a range parameter then the SUBSTITUTE command replaces only the next occurrence (in the current direction) of the old string. .lm-15 .hl 1 EVE__and__EDT keypad commands This section describes all the commands associated with the EVE__and__EDT keypad. Most of these commands are EVE line commands that have been bound to a key. A few of these commands were written for the EVE__and__EDT interface and are not available in the default EVE TPU interface. All new commands start with the string 'EDT '. .page .i-2 BOTTOM .p BOTTOM moves the cursor to the end of the current buffer. .p The BOTTOM (GOLD/KP4) key invokes this command. .b 2 .i-2 CHANGE MODE .p CHANGE MODE changes the current mode of the buffer. The current mode is displayed on the status line at the bottom of the window and may be either Insert or Overstrike. .p In Insert mode, typed characters are inserted to the left of the current position. In Overstrike mode, typing a character replaces the character at the current position. The DELETE key in Overstrike mode replaces the character before the current cursor position with a space. .p The INSERT/OVERSTRIKE (GOLD/P) key invokes this command. .b 2 .i-2 DEFINE KEY .p Tells EVE that you want to be able to issue a command by pressing a single key. EVE will prompt you for the the command and the key that you want to use to .p The DEFINE KEY (CTRL/K) key invokes this command. .b 2 .i-2 DELETE .p Deletes the character preceding the cursor. In Insert mode the rest of the the line moves left one space to close up the space. In Overstrike mode, the character preceding the cursor is replaced by a space and the rest of the line remains in the same place on the screen. .p When the cursor is at the start of a line, the Return at the end of the previous line is deleted. The text on the current line is moved to the right of the text in the line above. .ps 58 .p On VT200 series terminals, the