[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


EXTEND TPU


Format

EXTEND TPU


Parameters

procedure

The DECTPU procedure you want to compile. The procedure must be in the current buffer, and the PROCEDURE and ENDPROCEDURE statements must be in column 1 (leftmost column). You can abbreviate the procedure name but you cannot use wildcards; the name is not case sensitive. If more than one name matches your request, EVE shows a list of the matching names ($CHOICES$ buffer) so you can choose the one you want. If you do not specify a procedure, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.

*

Asterisk wildcard, specifying that you want to compile all the procedures in the buffer. This is the same as using the EXTEND ALL command.

Description

The EXTEND TPU command compiles one or more DECTPU procedures to extend EVE. This command is the same as the EXTEND EVE command. EXTEND commands do not execute procedures. To execute a compiled procedure, use the EVE command TPU followed by the name of the procedure. To save compiled procedures for future editing sessions, use the SAVE EXTENDED EVE command to create a section file.

Compiler messages appear in the message window (the bottom line of the EVE screen layout). To view all the compiler messages, use the following command to put the messages buffer into the current window:


Command: BUFFER MESSAGES

For more information, read the online help topic on Message Buffer.

Related Commands


Example

The following command compiles a procedure named USER_PROC:

Command: EXTEND TPU USER_PROC
EVE extended by: USER_PROC
      


FILL

Key

EDT Keypad: GOLD-KP8
WPS Keypad: GOLD-KP5

Format

FILL


Description

The FILL command reformats (rewraps) a box, a range, or the current paragraph, so that the maximum number of words fits on a line. Use FILL commands to rewrap text after making some change in the buffer, such as inserting new text or changing the margins.

If there is a selection or found range, FILL is the same as FILL RANGE. If there is no selection or found range, FILL is the same as FILL PARAGRAPH.

Paragraph boundaries are any of the following:

You can use FILL with a select range, found range, or box. In filling a paragraph or a standard linear range, FILL uses the current left and right margins of the buffer. In filling a box, FILL uses the limits of the box, ignoring the margins of the buffer, so you can reformat a part of a table without affecting adjacent text.

FILL deletes tabs and spaces at the beginning and end of the paragraph or range and also at the start of each line in the paragraph or range, but does not affect other tabs and spaces within the text. Filling a range or box keeps blank lines and page breaks as paragraph boundaries, which is useful if you select several paragraphs or the entire buffer for reformatting. Also, filling a box converts tab characters in the box to spaces.

If the current paragraph indent is set other than 0 (which is the default), you cannot fill a range that does not begin at the beginning of a paragraph. See the description of the SET PARAGRAPH INDENT command.

The SET FILL TAGS command lets FILL reformat lines that start with a DSR command or a VAX DOCUMENT tag. The default setting is SET FILL NOTAGS, which does not let you fill those lines.

Related Commands


FILL PARAGRAPH


Format

FILL PARAGRAPH


Description

The FILL PARAGRAPH command reformats (rewraps) the current paragraph so that the maximum number of words fits on a line according to the margins of the buffer. Use FILL commands to rewrap text after making some change in the buffer, such as inserting new text or changing the margins.

For more information, see the description of the FILL command.

Related Commands


FILL RANGE


Format

FILL RANGE


Description

The FILL RANGE command reformats (rewraps) a box or range so that the maximum number of words fits on a line. Use FILL commands to rewrap text after making some change in the buffer, such as inserting new text or changing the margins.

You can use FILL RANGE with a select range, found range, or box. For example, you can use BOX SELECT and FILL RANGE to reformat a part of a table without affecting the adjacent text. For more information, see the description of the FILL command.

Related Commands


FIND

Key

EVE Default: FIND
VT100 Keypad: PF1
EDT Keypad: GOLD-PF3
WPS Keypad: GOLD-, (on keyboard)

Format

FIND search-string


Parameter

search-string

The text you want to find. By default, if you enter the string in all lowercase, EVE searches for any occurrence regardless of case; if you enter it in uppercase or mixed case, EVE searches for an exact match. The search is also sensitive to diacritical marks, such as accents, in the search string. If you do not specify a search string, EVE prompts for one. Pressing the Find key without typing anything causes EVE to search for the previous string, if any; pressing the Return key without typing anything cancels the operation.

Description

The FIND command searches the current buffer for the text string you specify (or for one already entered). FIND searches the buffer first in the current direction. If no occurrence is found in that direction, the search automatically changes direction. If the string is found in the other direction, EVE asks if you want go there. To change the direction of the search, press Return. To end the search and stay where you are, type NO and press Return. If the string is not found, the cursor does not move.

If the string is found, EVE puts the cursor at the beginning of the string and highlights the found text. You can edit the found text by using any command or key that works on a range or box, as listed in Table 2-5. If SET BOX SELECT is in effect, the editing operation uses the start and end of the found range as diagonally opposite corners of a box. To cancel the highlighting, move the cursor off the found range or use the RESET command.


Table 2-5 EVE Commands and Keys for Editing a Found Range
EVE Commands: BOX COPY
BOX CUT
CAPITALIZE WORD
CONVERT TABS
FILL or FILL RANGE
FIND NEXT
FIND SELECTED
LOWERCASE WORD
OPEN SELECTED
REMOVE or CUT
STORE TEXT or COPY
UPPERCASE WORD
EDT Keys: Append (KP9)
ChngCase (KP1)
FndNxt (PF3)
EDT Replace (GOLD-KP9)
Subs (GOLD-ENTER)
WPS Keys: Continue Search (GOLD-.)
Continue Search/Select (GOLD-/ or GOLD-?)
Lowercase (GOLD-KP3)
Uppercase (KP3)
WPS Copy (GOLD-MINUS)
WPS Cut (MINUS or REMOVE)
WPS Replace (GOLD-' or GOLD-")

Pressing Find twice searches for the last string you entered with the FIND, FIND SELECTED, REPLACE, or WILDCARD FIND command---the same as the FIND NEXT command. If you press Find only once and then press Return without typing anything, EVE does not execute the FIND command.

In typing the FIND command, if you want to search for the word next or the word selected, put it in quotation marks or let EVE prompt you for the search string. This is to avoid ambiguity with the FIND NEXT and FIND SELECTED commands.

If you press a key defined as FIND, or if you type the 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 to begin the search in reverse direction (left and up). If you terminate the response by pressing Return, the search starts in the current direction of the buffer, as shown in the status line.

Related Commands


Example

To search for the word digital, finding any occurrence regardless of its case, use the following command:

Command: FIND digital
      

EVE would find any of the following occurrences:


FIND NEXT

Key

EDT Keypad: PF3 (FndNxt)
WPS Keypad: GOLD-. (on keyboard)
DECwindows Function Keys: SHIFT/FIND

Format

FIND NEXT


Description

The FIND NEXT command searches the current buffer for another occurrence of a string already entered with the FIND, FIND SELECTED, REPLACE, or WILDCARD FIND command. FIND NEXT begins the search in the direction of your last FIND or WILDCARD FIND. If you changed the direction of the buffer, the search begins in the direction of the buffer.

If there is no occurrence in the current direction, FIND NEXT automatically searches in the opposite direction. If an occurrence is found, EVE asks if you want go there. Press Return for YES, or type NO and press Return.

If the string is found, EVE puts the cursor at the beginning of the string and highlights the found text. You can edit the found text by using any command or key that works on a range or box, for example, BOX CUT, COPY, FILL, REMOVE, or UPPERCASE WORD (see Table 2-5). If SET BOX SELECT is in effect, the editing operation uses the start and end of the found range as diagonally opposite corners of a box. To cancel the highlighting, move the cursor off the found range or use the RESET command.

Related Commands


FIND SELECTED


Format

FIND SELECTED


Description

The FIND SELECTED command searches the current buffer for the text string you have selected, rather than for a typed string. This command is useful to find a lengthy mixed-case string (such as a book title or a person's name) without having to type it exactly.

If there is no occurrence in the current direction, FIND SELECTED automatically searches in the opposite direction. If an occurrence is then found, EVE asks if you want go there. Press Return for YES, or type NO and press Return.

If the string is found, EVE puts the cursor at the beginning of the string and highlights the found text. You can edit the found text by using any command or key that works on a range or box, for example, BOX CUT, COPY, FILL, REMOVE, or UPPERCASE WORD (see Table 2-5). If SET BOX SELECT is in effect, the editing operation uses the start and end of the found range as diagonally opposite corners of a box. To cancel the highlighting, move the cursor off the found range or use the RESET command.

To find another occurrence of the same string, use the FIND NEXT command or press the Find key twice.

If there is a found range and no selection, FIND SELECTED is the same as FIND NEXT. If there is neither a found range nor a selection, FIND SELECTED displays an error message.

Related Commands


FORWARD

Key

EDT Keypad: KP4
WPS Keypad: KP0 (WPS Advance)

Format

FORWARD


Description

The FORWARD command sets the direction of the current buffer to forward (right and down). 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 KP4 for forward or 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 following commands or keys also set the direction to forward:

Related Commands


GET

Same as the GET FILE command.

GET FILE


Format

GET FILE input_filespec


Parameter

input_filespec

The file you want to edit or create. You can use logical names and you can use wildcards in the file specification. If more than one file matches your request, EVE shows a list of the matching files so you can choose the one you want. You can edit several files in an editing session, but can specify only one file at a time. 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 GET FILE command puts the file you specify into the current EVE window, creating a new buffer if necessary (same as the GET and OPEN commands). With GET FILE, you can create or edit another file in the same session. If you specify an existing file, EVE copies it into a new buffer in the current window. If the file does not exist, EVE creates a new empty buffer that uses the file name and file type as the buffer name.

If you specify a file you have already read into the editing session---that is, a file for which there is already a buffer---EVE returns to your last location in the buffer for that file, if the buffer still exists.

If you use a search list or wildcard directory (such as [...]) to specify a file, EVE gets the first matching file found---without displaying the $CHOICES$ buffer.

New buffers have the same margins and other settings as an EVE system buffer named $DEFAULTS$.

Related Commands


GET WILDCARDED FILES


Format

GET WILDCARDED FILES wildcarded_filespec


Parameter

wildcarded_filespec

The file you want to edit or create. You can use logical names and you can use wildcards in the file specification. If more than one file matches your request, EVE reads all the matching files simultaneously. 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 GET WILDCARDED FILES command creates a buffer for each file specified. GET WILDCARDED FILES is similar to GET FILE, except that multiple files are read in simultaneously. Thus, you can quickly open a series of related files. The command leaves you in the last buffer that matches the wildcard file specification.

If there are no files matching your request (that is, if the files you specify do not exist), GET WILDCARDED FILES does not create a new buffer whether you specified wildcards or not. (This is unlike the GET FILE, OPEN, or OPEN SELECTED commands, each of which creates a buffer whether the specified file exists or not.)

EVE checks each file to see if it is already open. If the file is not already open, EVE creates a buffer that uses the file name and file type for the buffer name. EVE then copies the file into the new buffer. The new buffer has the same margins and other settings as the $DEFAULTS$ buffer (read the online help topic on Defaults). If the file is already open, EVE does not create a buffer, and the margins and other settings of that buffer apply.

In opening two or more files, EVE puts the buffer for the last file that matches the wildcard into the current window. If that file is already open, EVE puts the cursor at your last position in that buffer. If the buffer is newly created, EVE puts the cursor at the top of the buffer.

If there is already a buffer with the same name as the file you specify but not associated with the file, EVE asks for a different buffer name to use before creating the buffer. You may get multiple prompts for new buffer names from a single GET WILDCARDED FILES command.

Related Commands


GLOBAL REPLACE


Format

GLOBAL REPLACE


Description

The GLOBAL REPLACE command searches the current buffer for a specified string and replaces it with another string. GLOBAL REPLACE is a variant of EVE's REPLACE command. The GLOBAL REPLACE command replaces all occurrences of the old string with a new string without prompting. This is similar to using the REPLACE command, and replying with ALL to the prompt. For more information, see the description of the REPLACE command.

Use this command only if you are sure you want all occurrences of the old string changed to a new string.

Related Commands


Example

The following command changes all occurrences of bird to flamingo:

Command: GLOBAL REPLACE bird flamingo
      


GO TO


Format

GO TO marker


Parameter

marker

The marker you want to go to, as previously specified with the MARK command. You can abbreviate the marker name, but you cannot use wildcards (for example, an asterisk is treated as a character in the marker name). Marker names are not case sensitive. If more than one name matches your request, EVE shows a list of the matching names so you can choose the one you want. If you do not specify a marker, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.

Description

The GO TO command moves the cursor to the position you specify, as previously labeled with the MARK command. Using MARK and GO TO makes it easier to move through a large buffer or to move between buffers. If you specify a marker in a buffer other than the current buffer, EVE puts that buffer into the current window. If you are using two windows, EVE puts the buffer into the other window.

Markers are not saved from session to session. To find out marker names in a buffer, use the SHOW command.


Example

The following commands mark the current position as INTRO SEC, and later move the cursor to that position:

Command: MARK INTRO SEC
           .
           .
           .
Command: GO TO INTRO SEC
Going to mark: INTRO SEC
      


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