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


RESTORE

Key

EVE Default: GOLD-Insert Here
WPS Keypad: GOLD-PF3
GOLD-PF4

Format

RESTORE


Description

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.

Related Commands


Example

The following commands erase a word and then insert it:

Command: ERASE WORD
           .
           .
           .
Command: RESTORE
      


RESTORE BOX SELECTION


Format

RESTORE BOX SELECTION


Description

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.

Related Commands


Example

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
      


RESTORE CHARACTER

Key

EDT Keypad: GOLD-COMMA

Format

RESTORE CHARACTER


Description

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.

Related Commands


Example

The following commands erase a character and then insert it:

Command: ERASE CHARACTER
           .
           .
           .
Command: RESTORE CHARACTER
      


RESTORE LINE

Key

EDT Keypad: GOLD-PF4

Format

RESTORE LINE


Description

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.

Related Commands


Example

The following commands erase a line and then insert it:

Command: ERASE LINE
           .
           .
           .
Command: RESTORE LINE
      


RESTORE SELECTION


Format

RESTORE SELECTION


Description

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.

Related Commands


RESTORE SENTENCE


Format

RESTORE SENTENCE


Description

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.


RESTORE WORD

Key

EVE Default: GOLD-F13 (except with WPS keypad)
EDT Keypad: GOLD-MINUS

Format

RESTORE WORD


Description

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.


RETURN

Key

EVE Default: RETURN or Ctrl/M
ENTER
VT100 Keypad: RETURN or Ctrl/M
EDT Keypad: ENTER

Format

RETURN


Description

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.

Related Commands


REVERSE

Key

EDT Keypad: KP5
WPS Keypad: KP1 (WPS Backup)

Format

REVERSE


Description

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.

Related Commands


SAVE

Same as the SAVE EXTENDED EVE command.

SAVE ATTRIBUTES


Format

SAVE ATTRIBUTES


Description

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 PROMPTING
Asks 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 PROMPTING
Saves in your default section file without prompting.
SET NODEFAULT SECTION FILE
SET SECTION FILE PROMPTING
Default 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 PROMPTING
Asks 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.

Related Commands


SAVE EXTENDED EVE


Format

SAVE EXTENDED EVE section-file


Parameter

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.

Description

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.

Related Commands


SAVE EXTENDED TPU


Format

SAVE EXTENDED TPU section-file


Parameter

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.

Description

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.

Related Commands


SAVE FILE


Format

SAVE FILE


Description

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.

Related Commands


Example

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


Format

SAVE FILE AS output-file


Parameter

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).

Description

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.

Related Commands


Example

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


Format

SAVE SYSTEM ATTRIBUTES


Description

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 PROMPTING
Asks 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 PROMPTING
Saves in your default section file without prompting.
SET NODEFAULT SECTION FILE
SET SECTION FILE PROMPTING
Default 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 PROMPTING
Asks whether to save in a command file without prompting about a section file.

For more information, read the online help topic on Attributes.

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_008.HTML