![[OpenVMS documentation]](../../images/openvms_doc_banner_top.gif)
|
![[Site home]](../../images/buttons/bn_site_home_off.gif)
![[Send comments]](../../images/buttons/bn_comments_off.gif)
![[Help with this site]](../../images/buttons/bn_site_help_off.gif)
![[How to order documentation]](../../images/buttons/bn_order_docs_off.gif)
![[OpenVMS site]](../../images/buttons/bn_openvms_off.gif)
![[Compaq site]](../../images/buttons/bn_compaq_off.gif)
|
| Updated: 11 December 1998 |
|
|
|
|
| Updated: 11 December 1998 |
Extensible Versatile Editor Reference Manual
| Previous | Contents | Index |
| EVE Default: | GOLD-Insert Here |
| WPS Keypad: |
GOLD-PF3
GOLD-PF4 |
RESTORE
The RESTORE command inserts at your current position what you last erased with most ERASE commands or similar EDT or WPS keys. (It is the same as using RESTORE LINE, RESTORE SENTENCE, or RESTORE WORD, depending on what you last erased.) RESTORE inserts the text whether the buffer is in insert or overstrike mode. Existing text is pushed to the right or down. Depending on the amount of text restored and where you are on the line, your text might go past the right margin or even partly out of view. Use FILL commands, if necessary, to reformat (rewrap) your text.
Note
GOLD-Insert Here is a "sleeper" key, meaning that EVE defines this 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.Depending on the version of WPS you prefer, you might want to redefine GOLD-PF3 and GOLD-PF4 as RESTORE WORD and RESTORE CHARACTER, respectively.
The following commands erase a word and then insert it:
Command: ERASE WORD
.
.
.
Command: RESTORE
|
RESTORE BOX SELECTION
The RESTORE BOX SELECTION command puts back the box you last erased with a pending delete operation, usually overwriting existing text. RESTORE BOX SELECTION is useful if you inadvertently erased a selection. You can also use the pending delete feature as another way to cut and paste text.Restoring a box is similar to BOX PASTE, which usually overwrites existing text. If SET BOX NOPAD is in effect, the effects of RESTORE BOX SELECTION depend on the mode of the buffer you are editing, as follows:
Settings Effects with RESTORE BOX SELECTION SET BOX NOPAD Restoring a box depends on the mode of the buffer. In insert mode, the box pushes existing text to the right; in overstrike mode, it overwrites existing text. SET BOX PAD
(default)Restoring a box overwrites existing text regardless of the mode of the buffer. If SET BOX SELECT is in effect, RESTORE SELECTION is the same as RESTORE BOX SELECTION.
For more information about pending delete, see the description of the SET PENDING DELETE command or read the online help topic on Pending Delete.
In the following example, you enable pending delete, select a box of text, erase the selection, and then put back the erased text:
Command: SET PENDING DELETE
Command: BOX SELECT
.
.
.
Command: DELETE
Command: RESTORE BOX SELECTION
|
| EDT Keypad: | GOLD-COMMA |
RESTORE CHARACTER
The RESTORE CHARACTER command puts back at your current position what you last erased with DELETE, ERASE CHARACTER, or similar EDT or WPS keys. RESTORE CHARACTER is sensitive to the mode of the buffer (shown in the status line). In insert mode, the restored character is inserted at the current position. In overstrike mode, the restored character replaces the current character.
The following commands erase a character and then insert it:
Command: ERASE CHARACTER
.
.
.
Command: RESTORE CHARACTER
|
| EDT Keypad: | GOLD-PF4 |
RESTORE LINE
The RESTORE LINE command inserts at your current position what you last erased with ERASE LINE, ERASE START OF LINE, or similar EDT or WPS keys. RESTORE LINE inserts text whether the buffer is in insert or overstrike mode. Existing text is pushed to the right or down. Depending on the amount of text restored and where you are on the line, your text might go past the right margin or even partly out of view. Use FILL commands, if necessary, to reformat (rewrap) your text.
The following commands erase a line and then insert it:
Command: ERASE LINE
.
.
.
Command: RESTORE LINE
|
RESTORE SELECTION
The RESTORE SELECTION command inserts at your current position what you last erased with a pending delete operation. RESTORE SELECTION is useful if you inadvertently erased a selection. You can also use the pending delete feature as another way to cut and paste text.By default, the restored text is inserted whether the buffer is in insert or overstrike mode. Existing text is pushed to the right or down. Depending on the amount of text restored and where you are on the line, your text might go past the right margin or even partly out of view. Use FILL commands, if necessary, to reformat (rewrap) your text.
If SET BOX SELECT is in effect, then RESTORE SELECTION is the same as RESTORE BOX SELECTION, usually overwriting existing text.
For more information about pending delete, see the description of the SET PENDING DELETE command or read the online help topic on Pending Delete.
RESTORE SENTENCE
The RESTORE SENTENCE command inserts at your current position what you last erased with the WPS Delete Beginning Sentence key (GOLD-F13 or GOLD-Ctrl/J). RESTORE SENTENCE inserts text whether the buffer is in insert or overstrike mode. Existing text is pushed to the right or down. Depending on the amount of text restored and where you are on the line, your text might go past the right margin or even partly out of view. Use FILL commands, if necessary, to reformat (rewrap) your text.The WPS keypad does not define a key for RESTORE SENTENCE. Therefore, if you use the WPS keypad, you may want to define a key for RESTORE SENTENCE.
| EVE Default: | GOLD-F13 (except with WPS keypad) |
| EDT Keypad: | GOLD-MINUS |
RESTORE WORD
The RESTORE WORD command inserts at your current position what you last erased with ERASE PREVIOUS WORD, ERASE WORD, or similar EDT or WPS keys. RESTORE WORD inserts text whether the buffer is in insert or overstrike mode. Existing text is pushed forward. Depending on the length of the restored text and where you are on the line, your text might go past the right margin or even partly out of view. Use FILL commands, if necessary, to reformat (rewrap) your text.EVE defines the GOLD-F13 key sequence but does not define a default GOLD key. The definition is enabled when you use the SET GOLD KEY or SET KEYPAD EDT command, unless you have otherwise defined it yourself. SET KEYPAD WPS defines GOLD-F13 as the Delete Beginning Sentence key.
| EVE Default: |
RETURN or Ctrl/M
ENTER |
| VT100 Keypad: | RETURN or Ctrl/M |
| EDT Keypad: | ENTER |
RETURN
The RETURN command inserts a carriage return at your current position to start a new line of text, or terminates an EVE command or a response to a prompt. The cursor and any existing text to the right move down to start a new line at the current left margin of the buffer.In terminating a command or response to a prompt, you can have the cursor anywhere on the command line. Generally, if an EVE command prompts for required information, such as a file name, search string, or other parameter, pressing Return at the prompt without typing anything cancels the operation. In some cases, pressing Return indicates a default choice.
In the Buffer List, pressing Return lets you put a buffer into the current window without having to type the buffer name. Use the SHOW BUFFERS command to list the buffers you created, then put the cursor on the name of the buffer that you want to view and press Return.
Because EVE defines the Enter key as Return (except with the VT100 or WPS keypad), pressing Enter also does the same thing.
You cannot define the Return key or Ctrl/M. You can redefine Enter.
| EDT Keypad: | KP5 |
| WPS Keypad: | KP1 (WPS Backup) |
REVERSE
The REVERSE command sets the direction of the current buffer to reverse (left and up). The direction of the buffer is shown in the status line. It affects commands like FIND and MOVE BY LINE and some EDT and WPS keys.Direction is a buffer-specific setting; you can have one buffer set to forward and another buffer set to reverse. For buffers you create, the default direction is forward (right and down). For editing EVE command lines, the default direction is reverse, independent of the direction of your text buffers.
If you press a key defined as FIND or WILDCARD FIND, or if you type either command and let EVE prompt you for the search string, you can terminate the response by pressing a direction-setting key to begin searching in that direction. For example, with the EDT keypad, you can press KP5 for reverse. If you terminate the response by pressing the Return key, the search starts in the current direction of the buffer, as shown in the status line.
The WPS Backup key (KP1) sets the direction to reverse and moves the cursor one character or column to the left.
Same as the SAVE EXTENDED EVE command.
SAVE ATTRIBUTES
The SAVE ATTRIBUTES command saves global settings and other customizations in a section file or DECTPU command file for future editing sessions.If you save in a section file, EVE saves attributes, key definitions, compiled procedures, menu entries, and other extensions. The section file is in binary form so that it is executed quickly at startup. In effect, the section file is your own customized version of EVE.
If you save in a DECTPU command file, EVE saves attributes and menu entries by generating a specially marked block of DECTPU statements. EVE then creates a new command file or updates an existing command file.
You can set a default section file or DECTPU command file so that when you save attributes, EVE creates or updates that file without your having to specify the file each time. The following table shows the effects of SAVE ATTRIBUTES depending on whether you set a default section file and whether section file prompting is enabled or disabled:
Section File Settings Effects with SAVE ATTRIBUTES SET DEFAULT SECTION FILE
SET SECTION FILE PROMPTINGAsks whether to save in a section file. If you respond YES, EVE saves in your default section file. SET DEFAULT SECTION FILE
SET NOSECTION FILE PROMPTINGSaves in your default section file without prompting. SET NODEFAULT SECTION FILE
SET SECTION FILE PROMPTINGDefault settings---EVE asks whether to save in a section file. If you respond YES, EVE asks for the name of the section file. SET NODEFAULT SECTION FILE
SET NOSECTION FILE PROMPTINGAsks whether to save in a command file without prompting about a section file. These effects apply whether you use the SAVE ATTRIBUTES command or save attributes as part of exiting or quitting. For more information, read the online help topic on Attributes.
In DECwindows, you can choose Save Attributes from the Option menu. The dialog box includes a list of the current settings and includes buttons for saving in a section file or command file.
SAVE EXTENDED EVE section-file
section-file
The section file you want to create. The default file type is .TPU$SECTION. You can use logical names in the file specification, but you cannot use wildcards. For example, you can use SYS$LOGIN or other logical names to specify the device or directory where you want the section file created. By default, the section file is created in your current directory. If you do not specify a file, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.
The SAVE EXTENDED EVE command creates a section file you specify, saving your current key definitions, other extensions, and attributes for future editing sessions.You can also create a section file by using SAVE ATTRIBUTES or SAVE SYSTEM ATTRIBUTES or by saving attributes as part of exiting or quitting.
SAVE EXTENDED TPU section-file
section-file
The section file you want to create. The default file type is .TPU$SECTION. You can use logical names in the file specification, but you cannot use wildcards. For example, you can use SYS$LOGIN or other logical names to specify the device or directory where you want the section file created. By default, the section file is created in your current directory. If you do not specify a file, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.
The SAVE EXTENDED TPU command creates a section file you specify, saving your current key definitions, other extensions, and attributes for future editing sessions.You can also create a section file by using SAVE ATTRIBUTES or SAVE SYSTEM ATTRIBUTES or by saving attributes as part of exiting or quitting.
SAVE FILE
The SAVE FILE command saves (writes out) the current buffer, without ending the editing session. SAVE FILE is similar to WRITE FILE, except you do not specify an output file on the command line. Instead, SAVE FILE uses the output file specification associated with the buffer. This is the same as the file specified when you invoked EVE or when you used the GET FILE, OPEN, or OPEN SELECTED command.If there is no output file associated with the buffer, EVE prompts you to enter an output file name (for example, if you invoked EVE without specifying a file, or if you created the buffer with the BUFFER or NEW command, or if you are saving an EVE system buffer). In such a case, specifying an output file does not change the buffer name but does associate that file with the buffer for later SAVE FILE or WRITE FILE commands or for exiting (except with system buffers).
To check the output file specification of the buffer, use the SHOW command.
The following commands open a file called MEMO.TXT and then save your edits in a new version of that file:
Command: OPEn MEMO.TXt
38 lines read from file DISK$1:[USER]MEMO.TXT;1
.
.
.
Command: SAVE FILE
45 lines written to file DISK$1:[USER]MEMO.TXT;2
|
SAVE FILE AS output-file
output-file
The output file you want to create for saving the contents of the current buffer. If you do not specify a file, EVE prompts for one. Pressing the Return key or the Do key at the prompt without specifying a file writes the buffer to the output file associated with that buffer, if there is one (same as with the SAVE FILE or WRITE FILE command).
The SAVE FILE AS command saves (writes out) the current buffer to the file you specify, without ending the editing session. SAVE FILE AS is similar to SAVE FILE or WRITE FILE, except that it requires an output file specification. You can save your edits in a file with a different name from the input file.Specifying an output file does not change the buffer name but does associate that file with the buffer for later SAVE FILE or WRITE FILE commands or for exiting (except with system buffers). If you specify only the device and directory, EVE uses the same file name and file type associated with the buffer to write the output file to that device or directory.
To check the output file specification of the buffer, use the SHOW command.
The following commands open a file called ROUGH.DAT and then save your edits in a file called FINAL.TXT:
Command: OPEN ROUGH.DAT
.
.
.
Command: SAVE FILE AS FINAL.TXT
38 lines written to DISK$1:[USER]FINAL.TXT;1
|
SAVE SYSTEM ATTRIBUTES
The SAVE SYSTEM ATTRIBUTES command saves the EVE default attribute settings and menu entries in a section file or DECTPU command file for future editing sessions. With SAVE SYSTEM ATTRIBUTES, you can restore standard EVE settings and menu entries. It does not change any settings currently in effect; it saves only the EVE defaults. The following table shows the effects of SAVE SYSTEM ATTRIBUTES depending on whether you set a default section file and whether section file prompting is enabled or disabled:
Section File Settings Effects with SAVE SYSTEM ATTRIBUTES SET DEFAULT SECTION FILE
SET SECTION FILE PROMPTINGAsks whether to save in a section file. If you respond YES, EVE saves in your default section file. SET DEFAULT SECTION FILE
SET NOSECTION FILE PROMPTINGSaves in your default section file without prompting. SET NODEFAULT SECTION FILE
SET SECTION FILE PROMPTINGDefault settings---asks whether to save in a section file. If you respond YES, EVE asks for the name of the section file. SET NODEFAULT SECTION FILE
SET NOSECTION FILE PROMPTINGAsks whether to save in a command file without prompting about a section file. For more information, read the online help topic on Attributes.
| Previous | Next | Contents | Index |
|
|
![[OpenVMS documentation]](../../images/openvms_doc_banner_bottom.gif) |
|
Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal |
6021PRO_008.HTML
|