HP OpenVMS Systems Documentation

Format

DELETE WINDOW

Description

The DELETE WINDOW command deletes the current window, if you are using more than one window in EVE.

Deleting a window does not delete the buffer that was displayed in the window.

For more information about using multiple windows in EVE, read the online help topic on Windows.

Related Commands

DELETE BUFFER
ONE WINDOW
SHRINK WINDOW
SPLIT WINDOW

Key

Format

DO

Description

The DO command enters or terminates an EVE command that you type.

Pressing Do twice repeats the last command you entered. If you press Do and then press the Return key without typing a command, no command is executed.

If the command you type is ambiguous (if more than one command or parameter matches your abbreviation), EVE shows a list of the matching commands or parameters so you can choose the one you want. This list is called the $CHOICES$ buffer. For example, you use the following command to edit a file with the type .TXT:

Command: GET FILE *.TXT

If more than one file matches your request, EVE lists the matching files in a second window. For example, there may be two files, LETTER.TXT and MEMO.TXT. EVE recalls the command you typed and puts the cursor at the end of the command line. You then edit the command line, adding enough information so that the command is not ambiguous; for example, you can type L*.TXT or M*.TXT, and press Return to complete the command.

Alternatively, when the $CHOICES$ buffer appears, you can select a choice without having to type anything by doing one of the following:

• Press a key defined as NEXT WINDOW or PREVIOUS WINDOW to put the cursor into the $CHOICES$ buffer. Then move the cursor to the choice you want and press Do. EVE then uses that choice to complete the command.
• Put the cursor into the $CHOICES$ buffer. Move to the choice you want. Press Select to copy that choice onto the command line. Move back to the command window. If necessary, you can edit the command line. Press Return to execute the command.
• In DECwindows, use the mouse to point to the choice you want and click MB1 twice. The first click copies the choice onto the command line; the second click executes the command.

For information about editing EVE command lines, read the online help topic on Editing Command Lines.

Related Commands

RECALL
REPEAT
RETURN

Key

Format

END OF LINE

Description

The END OF LINE command moves the cursor to the end of the current line, unless it is already there. You can also use any key defined as END OF LINE (such as Ctrl/E) to move to the end of an EVE command line you are editing, much as in editing command lines at the DCL level.

EVE defines the GOLD--> key sequence but does not define a default GOLD key. The definition is enabled when you use the SET GOLD KEY, SET KEYPAD EDT, or SET KEYPAD WPS command, unless you have otherwise defined it yourself.

Related Commands

LINE
MOVE BY LINE
MOVE RIGHT
START OF LINE

Format

ENLARGE WINDOW integer

Parameter

integer

The number of screen lines you want to add to the current window. If you do not specify a number, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.

Description

The ENLARGE WINDOW command enlarges the current window by the number of lines you specify (if you are using more than one window in EVE). ENLARGE WINDOW adds lines to the bottom of the window, unless the window is the bottommost window. The maximum size of a window depends on the size and type of terminal you are using. The minimum size is one line for text, one line for the status line, and in DECwindows, one line for the horizontal scroll bar. If there is not enough room on the screen to enlarge the window as specified, EVE enlarges it as much as possible.

For more information about using multiple windows in EVE, read the online help topic on Windows.

Related Commands

DELETE WINDOW
ONE WINDOW
SHRINK WINDOW
SPLIT WINDOW
TWO WINDOWS

Example

The following commands form two windows and then enlarge the lower of the two windows by five lines:

Command: TWO WINDOWS
Command: ENLARGE WINDOW 5
      

Key

Format

ERASE CHARACTER

Description

The ERASE CHARACTER command erases the character that the cursor is on, or replaces it with a space, depending on the mode of the buffer. In insert mode, it erases the current character, making the rest of the line move left. In overstrike mode, it replaces the current character with a space; the rest of the line does not move.

If you are at the end of a line, ERASE CHARACTER erases only the carriage return for that line---regardless of the mode---causing the next line (if any) to move up. This is useful to join paragraphs for FILL commands.

To insert the character you erased, use the RESTORE CHARACTER command, which is also mode sensitive.

Related Commands

CHANGE MODE
DELETE
RESTORE CHARACTER

Key

Format

ERASE LINE

Description

The ERASE LINE command erases the current line, starting with the character that the cursor is on. If you are at the end of a line, ERASE LINE erases only the carriage return for that line; the next line (if any) moves up. This is useful to join paragraphs for FILL commands.

To insert the erased text, use the RESTORE LINE command.

Related Commands

ERASE START OF LINE
RESTORE
RESTORE LINE

Format

ERASE PREVIOUS WORD

Description

The ERASE PREVIOUS WORD command erases all of the previous word or all of the current word, depending on your cursor position. If you are between words or on the first character of a word, the previous word is erased (left of the cursor). In the middle of a word, all of that word is erased (same as the ERASE WORD command). For example, in the following line of text, what you erase depends on your cursor position:

What I tell you three times is true.

Table 2-4 shows the effects of ERASE PREVIOUS WORD in this example depending upon the cursor position.

Table 2-4 ERASE PREVIOUS WORD Command

Cursor Position	Effects
Start of line (the W in the word What)	Erases the carriage return for the previous line; the current line moves up. This is useful to join paragraphs for FILL.
Space or tab between tell and you	Erases all of the previous word ( tell) and the trailing spaces or tabs.
The t in the word three	Erases all of the previous word ( you) and the trailing spaces or tabs.
The i in the word times	Erases all of that word ( times) and the trailing spaces or tabs (same as ERASE WORD).

To insert the erased text, use the RESTORE WORD command.

If you are editing an EVE command line, any keys defined as ERASE WORD work like ERASE PREVIOUS WORD. Thus, you can use Ctrl/J for editing command lines much as at the DCL level. For more information about EVE command-line editing, read the online help topic on Editing Command Lines.

Related Commands

ERASE WORD
RESTORE
RESTORE WORD

Key

Format

ERASE START OF LINE

Description

The ERASE START OF LINE command erases the current line, starting with the character left of the cursor until the start of the line. If you are already at the start of a line, nothing is erased.

To insert the erased text, use the RESTORE LINE command.

You can also use Ctrl/U (or another key defined as ERASE START OF LINE) to erase all or part of an EVE command line you are editing or have recalled.

The EDT keypad redefines Ctrl/U as Delete Start Line, which is slightly different from the EVE definition.

Related Commands

ERASE LINE
RESTORE
RESTORE LINE

Example

The following commands move the cursor to the end of the current line and then erase the line, leaving the cursor at the start of a blank line:

Command: END OF LINE
Command: ERASE START OF LINE
      

Key

Format

ERASE WORD

Description

The ERASE WORD command erases all of the current word or, if you are between words, erases all of the next word.

For example, in the following line of text, what you erase depends on your cursor position:

What I tell you three times is true.

Cursor Positions	Effects of ERASE WORD
Anywhere on tell	Erases all of that word ( tell) and the trailing spaces or tabs.
White space between three and times	Erases all but the first white-space character and all of the next word times and the trailing spaces or tabs.
End of line	Erases the carriage return for the current line; the next line moves up. This is useful to join paragraphs for FILL.

To insert the erased text, use the RESTORE WORD command.

If you are editing an EVE command line, any keys defined as ERASE WORD work like ERASE PREVIOUS WORD. Thus, you can use Ctrl/J for editing command lines much as at the DCL level. For more information about EVE command-line editing, read the online help topic on Editing Command Lines.

The EDT or WPS keypad redefines F13, Ctrl/J, and linefeed as Delete Previous Word, which erases left of the cursor to the start of a word.

Related Commands

ERASE PREVIOUS WORD
RESTORE
RESTORE WORD

Key

Format

EXIT

Description

The EXIT command ends the editing session and produces a new file or a new version of an existing file. When you exit, EVE writes out (saves) the current buffer, unless you have made no edits or unless there are no changes since you previously wrote out the buffer during the session.

If there is no file specification for the buffer---that is, if you invoked EVE without specifying an input file or if you created the buffer with the BUFFER or NEW command---EVE asks you for one. Press the Return key at the prompt to discard the buffer and continue exiting.

If you have modified other buffers (for example, editing more than one file in the session), EVE asks if you want to write out those buffers. Respond YES or NO. If necessary, EVE prompts for any output file specifications.

If you have not modified any buffers, the EXIT and QUIT commands are the same and exiting does not produce a new file or new version of a file.

The output file for a buffer is usually the same as its input file---that is, the file specified when you invoked EVE or when you used the GET FILE, OPEN, or OPEN SELECTED command. If you wrote out the buffer with the WRITE FILE or SAVE FILE AS command and specified an output file, that file specification is used for writing out the buffer on exiting.

If you have changed attributes and not saved them, then on exiting, EVE prompts you as follows:

Command: SET CURSOR BOUND Command: SET FIND CASE EXACT Command: SET TABS VISIBLE . . . Command: EXIT Attributes were changed. Save them? [YES]

If you want to save the changes, press the Return key. EVE then does a SAVE ATTRIBUTES command before going on with the exit. If you do not want to save the changes, type NO and press Return. EVE then continues exiting.

To disable this prompting (to make exiting faster or simpler), use the SET NOEXIT ATTRIBUTE CHECK command. However, the setting does not apply to the current editing session, only to subsequent editing sessions that use the section file or command file in which you save the setting.

Related Commands

QUIT
SAVE ATTRIBUTES
SAVE FILE
SET BACKUP CONTROL STRING
SET EXIT ATTRIBUTE CHECK
SET FILE BACKUP
WRITE FILE

Format

EXTEND [{procedure |*}]

Parameters

procedure

The DECTPU procedure you want to compile. The procedure must be in the current buffer, and the PROCEDURE and ENDPROCEDURE statements must be in column 1 (leftmost column). You can abbreviate the procedure name but you cannot use wildcards; the name is not case sensitive. If more than one name matches your request, EVE shows a list of the matching names in the $CHOICES$ buffer so you can choose the one you want. If you do not specify a procedure, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.

*

Asterisk wildcard, specifying that you want to compile all the procedures in the buffer. This is the same as using the EXTEND ALL command.

Description

The EXTEND command compiles the DECTPU procedure the cursor is in, or compiles one or more DECTPU procedures to extend EVE. If you do not specify any parameter, EVE compiles the procedure the cursor is in. In this case, EXTEND is a synonym for the EXTEND THIS command. If you specify a parameter, EVE compiles the procedures you specify. In this case, EXTEND is the same as the EXTEND EVE command.

Related Commands

EXTEND ALL
EXTEND THIS
EXTEND TPU
SAVE EXTENDED EVE
TPU

Format

EXTEND ALL

Description

The EXTEND ALL command compiles all the DECTPU procedures in the current buffer. EXTEND ALL is the same as the EXTEND EVE * or EXTEND TPU * command. Compiler messages appear in the message window (the bottom line of the EVE screen layout). To view all the compiler messages, use the following command to put the messages buffer into the current window:

Command: BUFFER MESSAGES

For more information, read the online help topic on Message Buffer.

EXTEND commands do not execute procedures. To execute a compiled procedure, use the EVE command TPU followed by the name of the procedure. To save compiled procedures for future editing sessions, use the SAVE EXTENDED EVE command to create a section file.

Related Commands

EXTEND EVE
EXTEND THIS
EXTEND TPU
SAVE EXTENDED EVE
TPU

Format

EXTEND EVE {procedure |*}

Parameters

procedure

The DECTPU procedure you want to compile. The procedure must be in the current buffer, and the PROCEDURE and ENDPROCEDURE statements must be in column 1 (leftmost column). You can abbreviate the procedure name but you cannot use wildcards; the name is not case sensitive. If more than one name matches your request, EVE shows a list of the matching names ($CHOICES$ buffer) so you can choose the one you want. If you do not specify a procedure, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.

*

Asterisk wildcard, specifying that you want to compile all the procedures in the buffer. This is the same as using the EXTEND ALL command.

Description

The EXTEND EVE command compiles one or more DECTPU procedures to extend EVE (same as the EXTEND TPU command). EXTEND commands do not execute procedures. To execute a compiled procedure, use the EVE command TPU followed by the name of the procedure. To save compiled procedures for future editing sessions, use the SAVE EXTENDED EVE command to create a section file.

Compiler messages appear in the message window (the bottom line of the EVE screen layout). To view all the compiler messages, use the following command to put the messages buffer into the current window:

Command: BUFFER MESSAGES

For more information, read the online help topic on Message Buffer.

Related Commands

EXTEND ALL
EXTEND THIS
EXTEND TPU
SAVE EXTENDED EVE
TPU

Example

The following command compiles a procedure named USER_PROC:

Command: EXTEND EVE USER_PROC
EVE extended by: USER_PROC
      

Format

EXTEND THIS

Description

The EXTEND THIS command compiles the DECTPU procedure that the cursor is in and is the same as the EXTEND EVE command without having to type the procedure name. This is useful for compiling a procedure with a lengthy name or a name similar to other procedures, without having to type it exactly.

Compiler messages appear in the message window (the bottom line of the EVE screen layout). To view all the compiler messages, use the following command to put the messages buffer into the current window:

Command: BUFFER MESSAGES

For more information, read the online help topic on Message Buffer.

Related Commands

EXTEND ALL
EXTEND EVE
EXTEND TPU
SAVE EXTENDED EVE
TPU