Extensible Versatile Editor Reference Manual

Document revision date: 30 March 2001

Order Number: AA--PWCDD--TE

April 2001

This manual describes the commands for the Extensible Versatile Editor (EVE). It is for all EVE users.

Revision/Update Information: This manual supersedes the Extensible Versatile Editor Reference Manual Version 3.1 on OpenVMS Version 7.2.

Software Version: DECTPU Version 3.1 on OpenVMS Version 7.3

The content of this document has not changed since OpenVMS Version 7.1

Compaq Computer Corporation
Houston, Texas

Compaq, VAX, VMS, and the Compaq logo Registered in U.S. Patent and Trademark Office.

OpenVMS is a trademark of Compaq Information Technologies Group, L.P. in the United States and other countries.

Motif is a registered trademark of The Open Group.

PostScript is a registered trademark of Adobe Systems Incorporated.

All other product names mentioned herein may be trademarks of their respective companies.

Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.

ZK6021

The Compaq OpenVMS documentation set is available on CD-ROM.

Contents Index

Preface

Intended Audience

This manual is for all users of the Compaq Extensible Versatile Editor (EVE). You do not need programming experience. You should have some basic knowledge of OpenVMS files and directories. Knowledge of EDT and experience with Compaq DECwindows Motif for OpenVMS is helpful, but not required.

Document Structure

This manual consists of the following chapters and appendixes:

Chapter 1 describes the organization of the command information and lists all the EVE commands.
Chapter 2 provides the EVE command descriptions, including examples.
Appendix A describes how to use the command line qualifiers.
Appendix B describes the EVE default settings.
Appendix C describes the EVE and EDT command equivalents.
Appendix D describes modifying EVE or layering products on EVE.

Reader's Comments

Compaq welcomes your comments on this manual. Please send comments to either of the following addresses:

Internet openvmsdoc@compaq.com

Mail Compaq Computer Corporation
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698

How To Order Additional Documentation

Use the following World Wide Web address to order additional documentation:

http://www.openvms.compaq.com/

If you need help deciding which documentation best meets your needs, call 800-282-6672.

Conventions

The following conventions are used in this manual:

Ctrl/ x A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.

PF n PF n indicates that you press the key labeled PF n on the numeric keypad, where n is 1, 2, 3, or 4.

x A lowercase italic x indicates the generic use of a letter. For example, xxx indicates any combination of three alphabetic characters.

n A lowercase italic n indicates the generic use of a number. For example, 19 nn indicates a 4-digit number in which the last 2 digits are unknown.

PF1 x A sequence such as PF1 x indicates that you must first press and release the key labeled PF1 and then press and release another key or a pointing device button.

[Return] In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.)
In the HTML version of this document, this convention appears as brackets, rather than a box.

{ } In command format descriptions, braces indicate required elements; you must choose one of the options listed.

[ ] In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.)

[|] In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options.

( ) In command format descriptions, parentheses indicate that you must enclose the options in parentheses if you choose more than one.

" " Quotation marks enclose system messages that are specified in text.

... A horizontal ellipsis in examples indicates one of the following possibilities:

Additional optional arguments in a statement have been omitted.
The preceding item or items can be repeated one or more times.
Additional parameters, values, or other information can be entered.

.
.
. A vertical ellipsis indicates the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.

italic text Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type).

bold text This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason.
In the HTML version of this document, this convention appears as italic text.

UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.

lowercase In format descriptions, words in lowercase indicate parameters or arguments to be specified by the user.

Monospace text Monospace type indicates code examples and interactive screen displays.
In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example.

- A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.

numbers All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.

mouse The term mouse refers to any pointing device, such as a mouse, a puck, or a stylus.

MB1, MB2, MB3 MB1 indicates the left mouse button. MB2 indicates the middle mouse button. MB3 indicates the right mouse button. (Users can redefine the mouse buttons.)

nn nnn.nnn nn A space character separates digits in numerals with 5 or more digits. For example, 10 000 equals ten thousand.

n.nn A period in numerals signals the decimal point indicator. For example, 1.75 equals one and three-fourths.

Chapter 1
Introduction to the EVE Command Dictionary

This command dictionary describes each Extensible Versatile Editor (EVE) command. The descriptions are in alphabetical order and include any keys defined for the commands. Most of the information is available in the EVE online help also. EVE online help includes topics for all EVE commands, keys, and other features.

In some cases, there is a GOLD key sequence for a command. However, EVE does not have a default GOLD key. You set the GOLD key by using the SET GOLD KEY, SET KEYPAD EDT, or SET KEYPAD WPS command. Setting the GOLD key also enables several GOLD key sequences such as GOLD-<downarrow symbol> for BOTTOM (see Table 2-10 in the description of the SET GOLD KEY command). Some GOLD key sequences are not available on VT100-series terminals (for example, GOLD-Help and GOLD-Find); some shifted function keys require DECwindows.

Table 1-1 lists all the EVE commands, grouped by type (text editing, searches, formatting, and so on).

Table 1-1 List of EVE Commands
Text Editing

CHANGE MODE ERASE WORD RESTORE CHARACTER

COPY INSERT HERE RESTORE LINE

CUT INSERT MODE RESTORE SELECTION

DELETE OVERSTRIKE MODE RESTORE SENTENCE

ERASE CHARACTER PASTE RESTORE WORD

ERASE LINE QUOTE SELECT

ERASE PREVIOUS WORD REMOVE SELECT ALL

ERASE START OF LINE RESTORE STORE TEXT

Box Editing

BOX COPY BOX PASTE INSERT SET BOX NOPAD

BOX CUT BOX PASTE OVERSTRIKE SET BOX NOSELECT

BOX CUT INSERT BOX SELECT SET BOX PAD

BOX CUT OVERSTRIKE RESTORE BOX SELECTION SET BOX SELECT

BOX PASTE

Searches

FIND SET FIND CASE EXACT SET WILDCARD VMX

FIND NEXT SET FIND CASE NOEXACT SHOW WILDCARDS

FIND SELECTED SET FIND NOWHITESPACE SPELL

GLOBAL REPLACE SET FIND WHITESPACE WILDCARD FIND

REPLACE

Cursor Movement

BOTTOM MOVE BY WORD SET CURSOR FREE

CHANGE DIRECTION MOVE DOWN SET SCROLL JUMP

END OF LINE MOVE LEFT SET SCROLL MARGINS

FORWARD MOVE RIGHT SET SCROLL OFF

GO TO MOVE UP SET SCROLL ON

LINE NEXT SCREEN SET SCROLL SMOOTH

MARK PREVIOUS SCREEN START OF LINE

MOVE BY LINE REVERSE TOP

MOVE BY PAGE SET CURSOR BOUND WHAT LINE

General-Purpose Commands

ATTACH HELP RESET

DCL QUIT SHELL

DO RECALL SHOW

EXIT REPEAT SPAWN

Buffers and Files

BUFFER OPEN SET BUFFER

DELETE BUFFER OPEN SELECTED SET JOURNALING

GET PREVIOUS BUFFER SET JOURNALING ALL

GET FILE RECOVER SET NOJOURNALING

GET WILDCARDED FILES RECOVER BUFFER SET NOJOURNALING ALL

INCLUDE FILE RECOVER BUFFER ALL SHOW BUFFERS

NEW SAVE FILE SHOW SYSTEM BUFFERS

NEXT BUFFER SAVE FILE AS WRITE FILE

Windows and Display

DELETE WINDOW PREVIOUS WINDOW SHIFT RIGHT

ENLARGE WINDOW REFRESH SHRINK WINDOW

NEXT WINDOW SET WIDTH SPLIT WINDOW

ONE WINDOW SHIFT LEFT TWO WINDOWS

OTHER WINDOW

Formatting and Case Changes

CAPITALIZE WORD LOWERCASE WORD SET PARAGRAPH INDENT

CENTER LINE PAGINATE SET RIGHT MARGIN

CONVERT TABS RETURN SET TABS

FILL SET FILL NOTAGS SET WRAP

FILL PARAGRAPH SET FILL TAGS TAB

FILL RANGE SET LEFT MARGIN UPPERCASE WORD

INSERT PAGE BREAK SET NOWRAP

Key Definitions

DEFINE SET GOLD KEY SET KEYPAD VT100

DEFINE KEY SET KEYPAD EDT SET KEYPAD WPS

LEARN SET KEYPAD NOEDT SET NOGOLD KEY

REMEMBER SET KEYPAD NOWPS SHOW KEY

SET FUNCTION KEYS MOTIF SET KEYPAD NUMERIC UNDEFINE KEY

SET FUNCTION KEYS NOMOTIF

Customization

@ SAVE EXTENDED TPU SET NOPENDING DELETE

DEFINE MENU ENTRY SAVE SYSTEM ATTRIBTUES SET NOSECTION FILE PROMPTING

EXTEND SET CLIPBOARD SET PENDING DELETE

EXTEND ALL SET DEFAULT COMMAND FILE SET SECTION FILE PROMPTING

EXTEND EVE SET DEFAULT SECTION FILE SET SELECTION GRAB FOCUS

EXTEND THIS SET EXIT ATTRIBUTE CHECK SET SELECTION GRAB SELECTION

EXTEND TPU SET NOCLIPBOARD SHOW DEFAULTS BUFFER

SAVE SET NODEFAULT COMMAND FILE SHOW SUMMARY

SAVE ATTRIBUTES SET NODEFAULT SECTION FILE TPU

SAVE EXTENDED EVE SET NOEXIT ATTRIBUTE CHECK UNDEFINE MENU ENTRY

**Table 1-1 List of EVE Commands**
	Text Editing
CHANGE MODE	ERASE WORD	RESTORE CHARACTER
COPY	INSERT HERE	RESTORE LINE
CUT	INSERT MODE	RESTORE SELECTION
DELETE	OVERSTRIKE MODE	RESTORE SENTENCE
ERASE CHARACTER	PASTE	RESTORE WORD
ERASE LINE	QUOTE	SELECT
ERASE PREVIOUS WORD	REMOVE	SELECT ALL
ERASE START OF LINE	RESTORE	STORE TEXT
	Box Editing
BOX COPY	BOX PASTE INSERT	SET BOX NOPAD
BOX CUT	BOX PASTE OVERSTRIKE	SET BOX NOSELECT
BOX CUT INSERT	BOX SELECT	SET BOX PAD
BOX CUT OVERSTRIKE	RESTORE BOX SELECTION	SET BOX SELECT
BOX PASTE
	Searches
FIND	SET FIND CASE EXACT	SET WILDCARD VMX
FIND NEXT	SET FIND CASE NOEXACT	SHOW WILDCARDS
FIND SELECTED	SET FIND NOWHITESPACE	SPELL
GLOBAL REPLACE	SET FIND WHITESPACE	WILDCARD FIND
REPLACE
	Cursor Movement
BOTTOM	MOVE BY WORD	SET CURSOR FREE
CHANGE DIRECTION	MOVE DOWN	SET SCROLL JUMP
END OF LINE	MOVE LEFT	SET SCROLL MARGINS
FORWARD	MOVE RIGHT	SET SCROLL OFF
GO TO	MOVE UP	SET SCROLL ON
LINE	NEXT SCREEN	SET SCROLL SMOOTH
MARK	PREVIOUS SCREEN	START OF LINE
MOVE BY LINE	REVERSE	TOP
MOVE BY PAGE	SET CURSOR BOUND	WHAT LINE
	General-Purpose Commands
ATTACH	HELP	RESET
DCL	QUIT	SHELL
DO	RECALL	SHOW
EXIT	REPEAT	SPAWN
	Buffers and Files
BUFFER	OPEN	SET BUFFER
DELETE BUFFER	OPEN SELECTED	SET JOURNALING
GET	PREVIOUS BUFFER	SET JOURNALING ALL
GET FILE	RECOVER	SET NOJOURNALING
GET WILDCARDED FILES	RECOVER BUFFER	SET NOJOURNALING ALL
INCLUDE FILE	RECOVER BUFFER ALL	SHOW BUFFERS
NEW	SAVE FILE	SHOW SYSTEM BUFFERS
NEXT BUFFER	SAVE FILE AS	WRITE FILE
	Windows and Display
DELETE WINDOW	PREVIOUS WINDOW	SHIFT RIGHT
ENLARGE WINDOW	REFRESH	SHRINK WINDOW
NEXT WINDOW	SET WIDTH	SPLIT WINDOW
ONE WINDOW	SHIFT LEFT	TWO WINDOWS
OTHER WINDOW
	Formatting and Case Changes
CAPITALIZE WORD	LOWERCASE WORD	SET PARAGRAPH INDENT
CENTER LINE	PAGINATE	SET RIGHT MARGIN
CONVERT TABS	RETURN	SET TABS
FILL	SET FILL NOTAGS	SET WRAP
FILL PARAGRAPH	SET FILL TAGS	TAB
FILL RANGE	SET LEFT MARGIN	UPPERCASE WORD
INSERT PAGE BREAK	SET NOWRAP
	Key Definitions
DEFINE	SET GOLD KEY	SET KEYPAD VT100
DEFINE KEY	SET KEYPAD EDT	SET KEYPAD WPS
LEARN	SET KEYPAD NOEDT	SET NOGOLD KEY
REMEMBER	SET KEYPAD NOWPS	SHOW KEY
SET FUNCTION KEYS MOTIF	SET KEYPAD NUMERIC	UNDEFINE KEY
SET FUNCTION KEYS NOMOTIF
	Customization
@	SAVE EXTENDED TPU	SET NOPENDING DELETE
DEFINE MENU ENTRY	SAVE SYSTEM ATTRIBTUES	SET NOSECTION FILE PROMPTING
EXTEND	SET CLIPBOARD	SET PENDING DELETE
EXTEND ALL	SET DEFAULT COMMAND FILE	SET SECTION FILE PROMPTING
EXTEND EVE	SET DEFAULT SECTION FILE	SET SELECTION GRAB FOCUS
EXTEND THIS	SET EXIT ATTRIBUTE CHECK	SET SELECTION GRAB SELECTION
EXTEND TPU	SET NOCLIPBOARD	SHOW DEFAULTS BUFFER
SAVE	SET NODEFAULT COMMAND FILE	SHOW SUMMARY
SAVE ATTRIBUTES	SET NODEFAULT SECTION FILE	TPU
SAVE EXTENDED EVE	SET NOEXIT ATTRIBUTE CHECK	UNDEFINE MENU ENTRY

Contents

Index

privacy and legal statement

6021PRO.HTML

Internet	openvmsdoc@compaq.com
Mail	Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

Ctrl/ x	A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.
PF n	PF n indicates that you press the key labeled PF n on the numeric keypad, where n is 1, 2, 3, or 4.
x	A lowercase italic x indicates the generic use of a letter. For example, xxx indicates any combination of three alphabetic characters.
n	A lowercase italic n indicates the generic use of a number. For example, 19 nn indicates a 4-digit number in which the last 2 digits are unknown.
PF1 x	A sequence such as PF1 x indicates that you must first press and release the key labeled PF1 and then press and release another key or a pointing device button.
`[Return]`	In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.) In the HTML version of this document, this convention appears as brackets, rather than a box.
{ }	In command format descriptions, braces indicate required elements; you must choose one of the options listed.
[ ]	In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.)
[\|]	In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options.
( )	In command format descriptions, parentheses indicate that you must enclose the options in parentheses if you choose more than one.
" "	Quotation marks enclose system messages that are specified in text.
...	A horizontal ellipsis in examples indicates one of the following possibilities: Additional optional arguments in a statement have been omitted. The preceding item or items can be repeated one or more times. Additional parameters, values, or other information can be entered.
. . .	A vertical ellipsis indicates the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.
italic text	Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type).
bold text	This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason. In the HTML version of this document, this convention appears as italic text.
UPPERCASE TEXT	Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
lowercase	In format descriptions, words in lowercase indicate parameters or arguments to be specified by the user.
`Monospace text`	Monospace type indicates code examples and interactive screen displays. In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example.
-	A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.
numbers	All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.
mouse	The term mouse refers to any pointing device, such as a mouse, a puck, or a stylus.
MB1, MB2, MB3	MB1 indicates the left mouse button. MB2 indicates the middle mouse button. MB3 indicates the right mouse button. (Users can redefine the mouse buttons.)
`nn nnn.nnn nn`	A space character separates digits in numerals with 5 or more digits. For example, 10 000 equals ten thousand.
`n.nn`	A period in numerals signals the decimal point indicator. For example, 1.75 equals one and three-fourths.