Document revision date: 30 March 2001

Key

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.
      

Key

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
      

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
      

Key

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
      

Key

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
      

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

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.

Key

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.

Key

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

Key

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

Same as the SAVE EXTENDED EVE command.

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

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

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

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
      

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
      

	privacy and legal statement
6021PRO_008.HTML