[OpenVMS documentation]
[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
Updated: 11 December 1998

Extensible Versatile Editor Reference Manual

Previous Contents Index

QUOTE

Key

EVE Default: Ctrl/V

Format

QUOTE

Description

The QUOTE command enters a control code or other character you specify by a key press. You can quote a character either as part of a command string or to enter the character as text in the buffer. QUOTE is sensitive to the mode of the buffer (shown in the status line). In insert mode, the quoted character is inserted at the current position. In overstrike mode, the quoted character replaces the current character. Some control codes appear as a backwards question mark.

You can quote a control code or other character when you enter a string for the FIND or REPLACE commands. Similarly, if you used the TPU DEFINE_KEY built-in procedure to define a typing key (letter, number, or punctuation mark) or a control key, you can use QUOTE to enter the character or control code normally bound to that key.

Another use of QUOTE is to pass a Ctrl/Z to an OpenVMS subprocess created with the DCL command so that you can terminate that subprocess. For more information, see the description of the DCL command.

You cannot quote the following control codes or keys on OpenVMS systems because they are processed by the OpenVMS terminal driver:

Related Commands

Example

The following example inserts an escape character in the buffer: 

Command: QUOTE
Press the key to be added: Ctrl/[

RECALL

Key

EVE Default: Ctrl/B

Format

RECALL

Description

The RECALL command recalls a previous EVE command, which you can edit (if necessary) and execute again. Do not type the command RECALL. If you type RECALL, that command itself is recalled. Instead, use Ctrl/B or a key you have defined as RECALL.

To cancel the recalled command, erase the command line (for example, by pressing Ctrl/U) or press a key defined as RESET (such as GOLD Select).

When an EVE command prompts for additional information, such as a file name, search string, or other parameter, you can press Ctrl/B to scroll through the $PROMPTS$ buffer to recall your previous responses to command prompts. For more information, read the online help topic on Prompts and Responses.

RECOVER

Same as the RECOVER BUFFER command.

RECOVER BUFFER

Format

RECOVER BUFFER

Parameter

buffer-name

The name of the buffer you want to recover. If you specify a buffer that already exists (the MAIN buffer), EVE first deletes the buffer (prompting you to confirm the deletion, if the buffer was modified) before doing the recovery.

journal-name

The name of the journal file for the buffer you want to recover. The journal file name is the name of the buffer or file you were editing with the file type .TPU$JOURNAL. For example, if you were editing a file named MEMO.TXT, the journal file for that buffer is MEMO_TXT.TPU$JOURNAL.

Description

The RECOVER BUFFER command recovers a text buffer after a system failure by using the journal file for the buffer. Recovery with a buffer-change journal file restores only your text; it does not restore settings, key definitions, or the contents of system buffers (such as the INSERT HERE buffer) before the system failure.

If the journal file is available, EVE shows the following information and asks if you want to recover that buffer:

If you want to recover the buffer, press the Return key; otherwise, type NO and press Return.

You can recover buffers from different editing sessions. If you are unsure of the names of the journal files available, specify the asterisk wildcard (*), as follows: 


Command: RECOVER BUFFER *

EVE then displays the $CHOICES$ buffer, listing the buffer-change journal files so you can choose the one you want. For more information, read the online help topic on the Choices Buffer.

To recover all your buffers---that is, each buffer for which there is a journal file---use the RECOVER BUFFER ALL command.

Related Commands

RECOVER BUFFER ALL

Format

RECOVER BUFFER ALL

Description

The RECOVER BUFFER ALL command recovers all your text buffers, one at a time, by using the journal files for the buffers. You can recover buffers from different editing sessions. RECOVER BUFFER ALL is the same as repeating RECOVER BUFFER except you do not have to specify buffer names or journal file names.

For each text buffer, EVE displays information such as the buffer name, the files associated with the buffer, and the time and date the journal file was created. EVE prompts you to choose one of the following:
YES Recovers the buffer and then asks you whether to recover the next buffer, if there is one. This is the default response; you can press Return.
NO Skips this recovery. If there is another buffer to recover, EVE asks you about the other buffer.
QUIT Cancels the recovery. EVE does not recover the buffer and does not continue recovery operations.

Note
The RECOVER BUFFER ALL command is not the same as the RECOVER BUFFER * command. If you use the asterisk wildcard (*), EVE displays the $CHOICES$ buffer, listing the buffer-change journal files so that you can choose the one you want.

Related Commands

REFRESH

Key

EVE Default: Ctrl/W

Format

REFRESH

Description

The REFRESH command refreshes (repaints) the screen, to remove extraneous characters that may appear on the screen. REFRESH also clears the message window at the bottom of the EVE screen layout. However, all the messages are still listed in the message buffer. To view the message buffer, use the following command: 


Command: BUFFER MESSAGES
To return to the buffer you were editing, use the BUFFER command and specify the name of the buffer you want to edit, or use the SHOW BUFFERS command and select the buffer from the list. For more information about the message buffer, read the online help topic on the Message Buffer.

REFRESH does not cancel a selection or found range. Use the RESET command to cancel highlighting.

REMEMBER

Key

EVE Default: Ctrl/R
VT100 Keypad: Ctrl/R
WPS Keypad: GOLD-` (WPS Halt)

Format

REMEMBER

Description

The REMEMBER command ends ("remembers") a learn sequence and prompts you to press the key to be defined for the sequence. (See the description of the LEARN command.) Do not type the REMEMBER command. If you type REMEMBER, that command itself is remembered as part of the learn sequence. Instead, use Ctrl/R or a key you have defined as REMEMBER. Do not define a key you have used in the sequence being remembered. You can press any of the following keys: To cancel the definition, press the Return key or Ctrl/M, which cannot be redefined.

REMOVE

Key

EVE Default: REMOVE
VT100 Keypad : KP8
EDT Keypad: KP6

Format

REMOVE

Description

The REMOVE command removes a box or range, which you can insert elsewhere (same as the CUT command).

With a box selection, or if SET BOX SELECT is in effect, REMOVE is the same as BOX CUT, usually padding the area with spaces to keep the column alignment of text to the right of the box. Thus, you do not need to redefine keys to cut a box. For more information, see the description of the BOX CUT command or read the online help topic on Ranges and Boxes.

The removed text is stored either in the INSERT HERE buffer in EVE or in the DECwindows clipboard, depending on your setting, and replaces in that storage area whatever you previously removed or copied. The default is NOCLIPBOARD, which uses the INSERT HERE buffer. For more information, see the description of the SET CLIPBOARD command.

If you use REMOVE in an unmodifiable buffer, EVE does the STORE TEXT or BOX COPY command instead, copying the highlighted text without removing it.

In the Buffer List, REMOVE deletes a buffer without your having to type the buffer name. See the description of the DELETE BUFFER or SHOW BUFFERS command.

The WPS keypad redefines the Remove key on the minikeypad as WPS Cut, which lets you use WPS-style alternate paste buffers or the INSERT HERE buffer, but does not use the clipboard.

Related Commands

REPEAT

Format

REPEAT integer

[string]

Parameters

integer

The number of times you want the next operation repeated. Must be greater than 1. 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.

string

The command you want repeated the specified number of times.

Description

The REPEAT command repeats the next command or keystroke as often as you specify, without your having to retype it. You can specify the command to repeat in the optional second parameter.

You can repeat an arrow key or a cursor-movement command, or you can repeat a typing key (such as the dash) or an editing operation (such as an ERASE command).

You can use one REPEAT command to multiply the effects of another REPEAT command. If you use two REPEAT commands in a row, EVE multiplies the repeat counts.

If you are using the EDT or WPS keypad, you can specify repeat counts by using GOLD-number sequences.

You cannot use GOLD-number sequences to repeat the following keys (use the REPEAT command to repeat the key):

Specify the command to repeat when using the REPEAT command in initialization files. This prevents your having to press the key or enter the command to repeat.

Related Commands

Examples

In the following example, EVE repeats the ERASE WORD command five times. It erases the current word and the next four.
#1 

Command: REPEAT 5
Will repeat next command 5 times.
Command: ERASE WORD

In the next example, EVE moves eight pages in the current direction. EVE multiplies the repeat counts and specifies the command that it will repeat.

#2 

Command: REPEAT 2 REPEAT 4 MOVE BY PAGE
Will repeat 8 times the command:
Command: MOVE BY PAGE

REPLACE

Key

WPS Keypad: GOLD-;
GOLD-:

Format

REPLACE

Parameters

old-string

The text you want to replace. If the string is more than one word, put it in quotation marks or let EVE prompt you for the string. Use all lowercase to search for any occurrence; use mixed case or all uppercase to search for an exact match. If you do not specify an old string, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.

new-string

The text you want to replace the old string. If the string is more than one word, put it in quotation marks or let EVE prompt you for the string. If you do not specify a new string---if you press Return at the prompt---REPLACE deletes the old string without substituting any text.

Description

The REPLACE command replaces one text string with another; that is, EVE searches for the old string you specify and replaces it with the new string you specify. REPLACE searches for the old string first in the current direction of the buffer and, if necessary, in the opposite direction. If the old string is found in the opposite direction, EVE asks if you want to change the direction of the search and go there. If you want to go there, press Return. If you do not want to go there, type NO and press Return.

If the old string is found, EVE puts the cursor at the beginning of the string, highlights the found text, and asks you for one of the following choices. You need only type the first letter of the response (and press Return).
YES Replaces this occurrence of the old string and then searches for the next occurrence. This is the default; simply press the Return key.
NO Skips this occurrence and then searches for the next occurrence. If there is no occurrence in the current direction, the search automatically continues in the other direction.
ALL Replaces all the occurrences, starting with this one, without moving the cursor to each successively found occurrence. After finishing in the current direction, EVE searches in the other direction; if there is an occurrence in the other direction, EVE prompts you whether to continue the replacements.
LAST Replaces this occurrence and stops here.
QUIT Skips this occurrence and stops here. (You can also press Ctrl/Z.)
With YES or ALL, if the search covers the buffer more than once, EVE asks if you want to continue (so you can avoid replacing a string again when the old and new strings are similar).

When the operation is finished, EVE tells you how many replacements were made.

By default, REPLACE is case sensitive. If the old string is all lowercase, EVE searches for any occurrence, regardless of its case in the buffer (much like the FIND command). If the new string is also all lowercase, EVE tries to match the case appropriately for each replacement, as follows:

The following table shows how EVE uses the case of the strings:
Old String New String Highlights Replacements
butter margarine butter
Butter
BUTTER
BUtteR 		margarine
Margarine
MARGARINE
margarine
Butter margarine Butter margarine
butter Margarine butter
Butter
BUTTER
BUtteR 		Margarine
Margarine
Margarine
Margarine
Butter Margarine Butter Margarine

To make the search case-exact, use SET FIND CASE EXACT (when you want to replace lowercase occurrences only).

The old string becomes the search string for the next FIND. Thus, after you replace butter with margarine, the FIND NEXT command searches for butter.

To replace phrases, put the strings in quotation marks or let EVE prompt you for them.

To replace lines or blocks of text, rather than individual words or short phrases, you can use any of the following keys:

Related Commands

Examples

The following example replaces computer with VAX. Because the old string is lowercase, EVE finds any occurrence, but because the new string has uppercase letters, the replacement is exact (in this example, all uppercase).
#1 

Command: REPLACE computer VAX

In the following example, because the old and new strings contain uppercase letters, the search and replacement are case exact:

#2 

Command: REPLACE "Samuel L. Clemens" "Mark Twain"

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:

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

Example

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

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

Previous Next Contents Index

[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
[OpenVMS documentation]

Copyright © Compaq Computer Corporation 1998. All rights reserved.

Legal
6021PRO_007.HTML