Updated: 11 December 1998

Extensible Versatile Editor Reference Manual

Key

Format

START OF LINE

Description

The START OF LINE command moves the cursor to the start of the current line (unless already there). The start of the line is the leftmost character on the line up to the left margin when the line was created. You can move left of the left margin if the left margin is greater than 1 and if SET CURSOR FREE is in effect. See the description of the MOVE LEFT command.

When entering a command, you can press a key defined as START OF LINE to move to the start of the line you are typing or have recalled.

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

The EDT keypad defines F12 and Ctrl/H (or Backspace) slightly differently.

Related Commands

• END OF LINE
• MOVE BY LINE
• MOVE LEFT

Key

Format

STORE TEXT

Description

The STORE TEXT command copies a range or box without removing it so you can insert it elsewhere. This is similar to the COPY command.

With a box selection, or if SET BOX SELECT is in effect, STORE TEXT is the same as BOX COPY. Thus, you do not need to redefine keys to COPY a box. For more information, see the description of the BOX COPY command or read the online help topic on Ranges and Boxes.

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

Note GOLD-Remove 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 COPY
• BOX PASTE
• INSERT HERE
• REMOVE
• SET BOX SELECT
• SET CLIPBOARD

Key

Format

TAB

Description

The TAB command inserts a tab character at the current position, unless you set the tab mode to insert spaces or to move to the next tab stop without inserting anything (see the description of the SET TABS command).

To set tab stops for the buffer, use the SET TABS AT or SET TABS EVERY command. The default tab stops are every 8 (that is, columns 9, 17, 25, 33, and so on). To find out the tab stops of the current buffer, use the SHOW command.

Redefining either the Tab key or Ctrl/I affects the other as well. If you have defined Tab or Ctrl/I, or if you have set the tab mode to spaces or movement, you can use the QUOTE command to insert a tab character. For more information, see the description of the QUOTE command.

Tab stops (the distances or size of tab characters) are not stored in the output file. Therefore, in printing or typing the file, tab-aligned text may not appear the same as during editing, depending on the tab stops set for the printer or display device. You may want to use the CONVERT TABS command to convert tab characters to spaces so that tab-aligned text will have the same alignment regardless of the display device or printer. For more information, see the description of the CONVERT TABS command.

Related Commands

• CONVERT TABS
• SET TABS
• SHOW

Key

Format

TOP

Description

The TOP command moves the cursor to the top of the current buffer, unless it is already there. The top of the buffer is the upper left corner (row 1, column 1).

With the WPS keypad, GOLD T continues a WPS case change.

Note GOLD-<uparrow symbol> 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 the key yourself.

Related Commands

• BOTTOM
• PREVIOUS SCREEN

Format

TPU tpu-statement

Parameter

tpu-statement

The DECTPU statement you want to execute, including any required parameters or arguments. You cannot abbreviate the procedure name or statement, and you cannot use wildcards. If you do not specify a procedure or statement, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.

Description

The TPU command executes the DECTPU procedure or statement you specify. You can execute a DECTPU built-in procedure or a procedure you have compiled. To get help on DECTPU built-in procedures, use the command HELP TPU. EVE then displays help on the TPU command and switches to the TPUHELP library so you can get help on built-in procedures, such as COPY_TEXT and GET_INFO. To return to help on the EVE editor, type EVE.

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

Related Commands

• EXTEND ALL
• EXTEND EVE
• EXTEND THIS
• HELP TPU

Examples

To list all the available procedures, including both DECTPU built-in procedures and any user-compiled procedures, use the following command:

Command: TPU SHOW (PROCEDURES)
      

To execute the COPY_TEXT built-in procedure to insert the current date, use the following command:

Command: TPU COPY_TEXT (FAO ('!11%D', 0))
      

Format

TWO WINDOWS

Description

The TWO WINDOWS command splits the current EVE window into two smaller windows so you can view different buffers at the same time or different parts of the same buffer (same as the SPLIT WINDOW 2 command). The cursor appears in the bottom window. Each window has its own status line and displays the buffer you are currently editing.

To put a different buffer into the window, use one of the following commands:

• BUFFER
• GET FILE or OPEN
• NEW
• NEXT BUFFER or PREVIOUS BUFFER
• OPEN SELECTED
• SHOW BUFFERS or SHOW SYSTEM BUFFERS

For more information about using multiple windows in EVE, read the online help topic on Windows.

You can repeat the TWO WINDOWS command to continue splitting windows. The maximum number of windows in EVE depends on the size and type of terminal you are using. With a 21-line main window (as on a VT220 terminal), you can have 11 windows, each displaying one line of text.

Related Commands

• DELETE WINDOW
• ENLARGE WINDOW
• NEXT WINDOW
• ONE WINDOW
• PREVIOUS WINDOW
• SHRINK WINDOW
• SPLIT WINDOW

Example

The following commands split the current window into two windows, and then put a buffer named ROUGH.DAT into the bottom window:

Command: TWO WINDOWS
Command: BUFFER ROUGH.DAT
      

Format

UNDEFINE KEY keyname

Parameter

keyname

The key you want to undefine. If you do not specify a key name, EVE prompts you to press the key to be undefined. Pressing the Return key or Ctrl/M at the prompt cancels the operation because those keys cannot be undefined. For information about key names and nondefinable keys, read the online help topic on Names For Keys.

Description

The UNDEFINE KEY command cancels the current definition of a key, if it was defined with either the DEFINE KEY or the LEARN command. UNDEFINE KEY does not cancel definitions done with a SET KEYPAD, SET GOLD KEY, or SET FUNCTION KEYS DECWINDOWS command. If the key you specify was previously defined with one of these commands, its previous definition is restored, if the setting is still in effect.

You cannot undefine a key defined as DO unless there is another key defined as DO, and you cannot undefine or redefine the Return key or Ctrl/M.

Related Commands

• HELP KEYPAD
• HELP KEYS
• SHOW KEY

Example

In the following example, you set the EDT keypad, then redefine KP9 as CENTER LINE, overriding its EDT definition. The UNDEFINE KEY command then cancels that definition, restoring its EDT definition (Append).

Command: SET KEYPAD EDT
Command: DEFINE KEY= KP9 CENTER LINE
Command: UNDEFINE KEY KP9
      

Format

UNDEFINE MENU ENTRY menu item

Parameters

menu

The pull-down or pop-up menu from which the entry is to be removed. Valid Motif menu names are as follows:

• Option Pulldown
• View Pulldown
• Edit Pulldown
• File Pulldown
• Format Pulldown
• Help Pulldown
• Noselect Popup
• Search Pulldown
• Select Popup

item

The menu item to be removed from the pull-down or pop-up menu. Most EVE menu items are the same EVE commands.

Description

The UNDEFINE MENU ENTRY command removes a menu item from a pull-down or pop-up menu in DECwindows. You can use UNDEFINE MENU ENTRY only with the DECwindows interface. You can save menu definitions for future editing sessions in your section file or command file.

Related Commands

• DEFINE MENU ENTRY
• SAVE ATTRIBUTES
• SAVE EXTENDED EVE
• SAVE SYSTEM ATTRIBUTES

Example

The following command removes CENTER LINE from the pop-up menu that is displayed with MB2 when there is no selection:

Command: UNDEFINE MENU ENTRY "Noselect" "Center Line"
      

Format

UPPERCASE WORD

Description

The UPPERCASE WORD command makes letters uppercase in a range, box, or single word.

You can use UPPERCASE WORD with a select range, found range, or box. With a select range or found range, UPPERCASE WORD works on each word in the range, starting with the first character of the range and ending at the end of the range.

If there is no selection or found range, UPPERCASE WORD works on the current word. If you are between words, it works on the next word on the line.

Related Commands

• CAPITALIZE WORD
• LOWERCASE WORD

Example

The following commands find the next occurrence of a search string you have already specified, and then make all the letters of the found text uppercase:

Command: FIND NEXT
Command: UPPERCASE WORD
      

Format

WHAT LINE

Description

The WHAT LINE command shows the current line number, total number of lines in the buffer, and percentage of that position in the buffer. WHAT LINE is useful if you want to know whether to insert a page break or to find out how many lines are in the buffer. The output from WHAT LINE appears in the message window at the bottom of the EVE screen layout.

To go to a particular line by number, use the LINE command.

Related Commands

• LINE
• MOVE BY LINE
• SHOW

Example

The following example shows the output from the WHAT LINE command:

Command: WHAT LINE
You are on line 35 of 45 (78%).
      

Key

Format

WILDCARD FIND search-pattern

Parameter

search-pattern

The pattern of text you want to find, when the command uses wildcards, literal text, or both. WILDCARD FIND follows the same rules as the FIND command for case sensitivity and white space, unless specified otherwise by a wildcard. If you do not specify a string, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.

You may not find some search patterns for the following reasons:

• They are too large
• Because of the combination of wildcards used
• The search pattern involves ranges of characters

Description

The WILDCARD FIND command uses wildcard, literal text, or both, to search for a pattern of text. The default is SET WILDCARD VMS. WILDCARD FIND follows the same rules for direction as FIND. 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.

Note GOLD-Find 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

• CHANGE DIRECTION
• FIND NEXT
• RESET
• SET FIND CASE EXACT
• SET FIND WHITESPACE
• SET WILDCARD VMS
• SHOW WILDCARDS

Examples

To search for B or b followed by any single character and a T or t on the same line, use the following command:

Command: WILDCARD FIND b%t
      

To search for B or b followed by any number of characters and a T or t on the same line, use the following command:

Command: WILDCARD FIND b*t
      

Key

Format

WRITE FILE [output-filespec]

Parameter

output-filespec

The output file you want to create for saving the contents of the current buffer. If you do not specify a file, EVE uses the file associated with the buffer. If there is no file associated with the buffer, EVE prompts you to type a file name. In such a case, pressing the Return key or the Do key at the prompt without specifying a file cancels the operation.

Description

The WRITE FILE command writes out the current buffer to the file you specify or to the output file associated with the buffer.

If you do not specify a file on the command line, WRITE FILE uses the output file associated with the buffer---same as with the SAVE FILE command. This is the same as the file specified when you invoked EVE or when you used the GET FILE, OPEN, or OPEN SELECTED command. For example, the following commands let you edit the file called MEMO.TXT and then write out your edits as a new version of that file:

Command: GET FILE MEMO.TXT 38 lines read from file DISK$1:[USER]MEMO.TXT;1 . . . Command: WRITE FILE 45 lines written to DISK$1:[USER]MEMO.TXT;2

If there is no file associated with the buffer, WRITE FILE prompts you to type a file name. The following are cases when there is no file associated with the buffer:

• If you invoked EVE without specifying a file
• If you created the buffer with the BUFFER or NEW command
• If you are writing out an EVE system buffer

You can specify a file on the command line to write the buffer to that file instead of whatever file is associated with the buffer---same as with the SAVE FILE AS command. You can save your edits under a different file name instead of producing a new version of the file you are editing. For example, the following commands let you edit a file called ROUGH.DAT and then write out your edits as a file called FINAL.DAT, rather than as a new version of ROUGH.DAT:

Command: GET FILE ROUGH.DAT . . . Command: WRITE FILE FINAL.TXT 71 lines written to DISK$1:[USER]FINAL.TXT;1

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
• QUIT
• SAVE FILE
• SAVE FILE AS

Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal

6021PRO_015.HTML