Document revision date: 30 March 2001

## Extensible Versatile Editor Reference Manual

Previous | Contents | Index

## RESET

### Key

EVE Default: | GOLD-Select
EDT Keypad: | GOLD-PERIOD
WPS Keypad: | GOLD-PERIOD

### Format

> RESET

### Description

> The RESET command cancels any of the following and sets the direction of the buffer to FORWARD:
> - Highlighting of a selection or found range
> - A press of the GOLD key or a press of a GOLD-number sequence for a repeat count (with the EDT or WPS keypad)
> - An incomplete or recalled command line or a $CHOICES$ buffer display when you type an ambiguous command
> - Any of the following SHOW commands, thus returning you to the buffer you were working in:

>   > SHOW
>   > SHOW DEFAULTS BUFFER
>   > SHOW SUMMARY
>   > SHOW WILDCARDS

> RESET does not reset the terminal or redraw the screen. Instead, use the REFRESH command (Ctrl/W) to redraw the screen.

> Note GOLD-Select 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.

#### Related Commands

> BOX SELECT
> FIND
> FORWARD
> SELECT
> WILDCARD FIND

### Example

> In the following example, you select text and then use RESET to cancel the selection:

    Command: SELECT
               .
               .
               .
    Command: RESET
    Selection canceled.

## 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

> RESTORE BOX SELECTION
> RESTORE CHARACTER
> RESTORE LINE
> RESTORE SELECTION
> RESTORE SENTENCE
> RESTORE WORD

### 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

> RESTORE SELECTION
> SET BOX PAD
> SET BOX SELECT
> SET PENDING DELETE

### 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

> CHANGE MODE
> DELETE
> ERASE CHARACTER

### 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

> RESTORE
> RESTORE CHARACTER
> RESTORE SENTENCE
> RESTORE WORD

### 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 BOX SELECTION
> SET BOX SELECT
> SET PENDING DELETE

## 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

> DO
> SET WRAP
> SHOW BUFFERS

## 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

> CHANGE DIRECTION
> FORWARD

## 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
> SAVE EXTENDED TPU
> SAVE SYSTEM ATTRIBUTES

## 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 ATTRIBUTES
> SAVE EXTENDED TPU
> SET BACKUP CONTROL STRING
> SET DEFAULT SECTION FILE
> SET FILE BACKUP
> SET SECTION FILE PROMPTING

## 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 ATTRIBUTES
> SAVE EXTENDED EVE
> SET BACKUP CONTROL STRING
> SET DEFAULT SECTION FILE
> SET FILE BACKUP
> SET SECTION FILE PROMPTING

## 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

> DELETE BUFFER
> EXIT
> SAVE FILE AS
> SET BACKUP CONTROL STRING
> SET FILE BACKUP
> SHOW
> WRITE FILE

### 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

> DELETE BUFFER
> EXIT
> SAVE FILE
> SET BACKUP CONTROL STRING
> SET FILE BACKUP
> SHOW
> WRITE FILE

### 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

Previous | Next | Contents | Index

| privacy and legal statement |
6021PRO_008.HTML