Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

Extensible Versatile Editor Reference Manual


Previous Contents Index


DELETE WINDOW


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


DO

Key

EVE Default: DO
PF4
VT100 Keypad: PF4
EDT Keypad: GOLD-KP7
WPS Keypad: GOLD-[ (left bracket)

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:

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

Related Commands


END OF LINE

Key

EVE Default: Ctrl/E
GOLD-->
VT100 Keypad: Ctrl/E
GOLD-->
DECwindows Function Keys: SHIFT/F12

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


ENLARGE WINDOW


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


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
      


ERASE CHARACTER

Key

EDT Keypad: COMMA (Delete Character)
WPS Keypad: PF4 (Delete Character)
DECwindows Function Keys: SHIFT/< X|

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


ERASE LINE

Key

EDT Keypad: PF4 (Delete Line)

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 PREVIOUS WORD


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 START OF LINE

Key

EVE Default: Ctrl/U or Ctrl/< X|
VT100 Keypad: Ctrl/U or Ctrl/DELETE

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


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
      


ERASE WORD

Key

EVE Default: F13
Ctrl/J
VT100 Keypad: COMMA
Ctrl/J or LINEFEED

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


EXIT

Key

EVE Default: F10
Ctrl/Z
WPS Keypad: GOLD-F

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


EXTEND


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


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


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


Example

The following command compiles a procedure named USER_PROC:

Command: EXTEND EVE USER_PROC
EVE extended by: USER_PROC
      


EXTEND THIS


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


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6021PRO_003.HTML