Document revision date: 19 July 1999

Key

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:

• Ctrl/C Ctrl/T
• Ctrl/O Ctrl/X
• Ctrl/Q Ctrl/Y
• Ctrl/S F6 on VT300- and VT200-series terminals

Related Commands

• INSERT MODE
• OVERSTRIKE MODE

Example

The following example inserts an escape character in the buffer:

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

Key

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.

Same as the RECOVER BUFFER command.

Format

RECOVER BUFFER {buffer-name |journal-name}

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:

• Name of the buffer
• Original input file for the buffer, if any
• Output file for the buffer, if any
• Source file for recovery, if any
• Starting date and time of the editing session
• Journal file creation date and time

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
• SET JOURNALING

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

• RECOVER BUFFER
• SET JOURNALING

Key

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.

Key

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:

• Function key, such as PF4, KP7, or F20
• Control key, such as Ctrl/N
• GOLD key sequence, such as GOLD-KP7 or GOLD-A
• Shifted function key, such as Shift/F14 (DECwindows only)
• Alt key combination, such as Alt/Z (DECwindows only)
• Mouse button, such as MB3 click (DECwindows only)

To cancel the definition, press the Return key or Ctrl/M, which cannot be redefined.

Key

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

• BOX CUT
• INSERT HERE
• SET BOX PAD
• SET BOX SELECT
• SET CLIPBOARD
• STORE TEXT

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

• DELETE (<X|), which lets you erase the repeat count in case you mistyped the number
• EDT SpecIns (GOLD-KP3), which uses a GOLD-number sequence to specify the decimal value of the character to be inserted
• WPS Paste key (COMMA or GOLD-, on the keypad or Insert Here on the minikeypad), which uses GOLD-1 through GOLD-9 to specify an optional WPS-style alternate paste buffer

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

• DO
• RECALL
• RESET

Examples

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

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.

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

Key

Format

REPLACE {"old-string" ["new-string"]
old-string[new-string]}

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:

• A capitalized version of the old string (first letter uppercase, others lowercase) is replaced by a capitalized version of the new string.
• An all-uppercase version of the old string is replaced by an all-uppercase version of the new string.
• In cases other than the previous two, the old string is replaced by an all-lowercase version of the new string.

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:

• EDT Replace (GOLD-KP9)
• EDT Subs (GOLD-Enter)
• WPS Replace (GOLD-' or GOLD-")

Related Commands

• FIND
• FIND NEXT
• GLOBAL REPLACE
• SET FIND CASE EXACT
• WILDCARD FIND

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

Command: REPLACE computer VAX
      

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

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

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.
      

	privacy and legal statement
6021PRO_007.HTML