EVE — VMS 5.1-B
Additional information available:
@ATTACHBOTTOMBUFFERCAPITALIZE_WORDCENTER_LINE
CHANGE_DIRECTIONCHANGE_MODECOPYCUTDCL
DEFINE_KEYDELETEDELETE_BUFFERDELETE_WINDOW
DOEND_OF_LINEENLARGE_WINDOWERASE_CHARACTER
ERASE_LINEERASE_PREVIOUS_WORDERASE_START_OF_LINE
ERASE_WORDEVEEVE_VT100EVE_VT200EXITEXTEND_ALL
EXTEND_EVEEXTEND_THISEXTEND_TPUFILL
FILL_PARAGRAPHFILL_RANGEFINDFIND_NEXT
FIND_SELECTEDFORWARDGET_FILEGO_TOHELPINCLUDE_FILE
INSERT_HEREINSERT_MODEINSERT_PAGE_BREAKLEARN
LINELOWERCASE_WORDMARKMOVE_BY_LINEMOVE_BY_PAGE
MOVE_BY_WORDMOVE_DOWNMOVE_LEFTMOVE_RIGHT
MOVE_UPNEWNEXT_BUFFERNEXT_SCREENNEXT_WINDOW
ONE_WINDOWOPENOPEN_SELECTEDOTHER_WINDOW
OVERSTRIKE_MODEPAGINATEPASTEPREVIOUS_SCREENPREVIOUS_WINDOW
QUITQUOTERECALLREFRESHREMEMBERREMOVE
REPEATREPLACERESETRESTORERESTORE_CHARACTER
RESTORE_LINERESTORE_SELECTIONRESTORE_SENTENCERESTORE_WORD
RETURNREVERSESAVE_EXTENDED_EVESAVE_EXTENDED_TPU
SAVE_FILESAVE_FILE_ASSELECTSELECT_ALLSET_BUFFER
SET_CLIPBOARDSET_CURSOR_BOUNDSET_CURSOR_FREESET_FIND_NOWHITESPACE
SET_FIND_WHITESPACESET_GOLD_KEYSET_KEYPAD_EDT
SET_KEYPAD_NOEDTSET_KEYPAD_NOWPSSET_KEYPAD_NUMERIC
SET_KEYPAD_VT100SET_KEYPAD_WPSSET_LEFT_MARGINSET_NOCLIPBOARD
SET_NOGOLD_KEYSET_NOPENDING_DELETESET_NOSHIFT_KEY
SET_NOWRAPSET_PARAGRAPH_INDENTSET_PENDING_DELETE
SET_RIGHT_MARGINSET_SCROLL_MARGINSSET_SHIFT_KEY
SET_TABSSET_WIDTHSET_WILDCARD_ULTRIXSET_WILDCARD_VMS
SET_WRAPSHIFT_LEFTSHIFT_RIGHTSHOWSHOW_BUFFERS
SHOW_DEFAULTS_BUFFERSHOW_KEYSHOW_SUMMARY
SHOW_SYSTEM_BUFFERSSHOW_WILDCARDSSHRINK_WINDOW
SPAWNSPELLSPLIT_WINDOWSTART_OF_LINESTORE_TEXT
TABTOPTWO_WINDOWSUNDEFINE_KEYUPPERCASE_WORD
WHAT_LINEWILDCARD_FINDWRITE_FILE
AbbreviatingAboutCanceling CommandsChoices BufferCommands
Command FilesControl KeysDECwindows DifferencesDefaultsDialog Boxes
Editing Command LinesEDT ConversionEDT DifferencesGold Keys
Initialization FilesJournal FilesKeysMail EditingMenusMessage Buffer
MouseNames for KeysNew FeaturesNew UserNot Implemented
Old Gold KeyPosition CursorProgramPrompts And Responses
Ruler KeysScroll BarsSection FilesSequenceStatus LineStuffTyping Keys
UnknownVT100 KeypadVT200 KeypadVT200 Mini Pad
WindowsWPS Differences
Abbreviating
Abbreviating
You can abbreviate EVE commands so long as they are unambiguous. If more
than one command matches what you type, EVE shows a list of matching
commands so you can choose the one you want.
Typically, you use the first letters of each command term or keyword;
sometimes you need only the beginning of the first term. For example:
Abbreviation Full command Abbreviation Full command
------------------------------- -------------------------------
E C ERASE CHARACTER RESE RESET
H K HELP KEYPAD REST RESTORE
H KEYS HELP KEYS R W RESTORE WORD
I B P INSERT PAGE BREAK S B SHOW BUFFERS
I H INSERT HERE S C B SET CURSOR BOUND
INC or I F INCLUDE FILE SH SHOW
QUI QUI S K SHOW KEY
QUO QUOTE S K E SET KEYPAD EDT
REPE REPEAT UN or U K UNDEFINE KEY
REPL REPLACE UP UPPERCASE WORD
Similarly, you can abbreviate the following:
o Buffer names for the BUFFER command
o Marker names for the GO TO command
o HELP topics
o Keyword parameters for SET BUFFER and SET TABS commands
o Keyword responses for FIND, DELETE BUFFER, REPLACE, and QUIT
o Procedure names for the EXTEND EVE command
You CANNOT abbreviate the following:
o Buffer names for the DELETE BUFFER command
o Key names for DEFINE KEY, SET GOLD KEY, SHOW KEY, and UNDEFINE KEY
o Procedure names and VAXTPU built-ins for the TPU command
File specifications, for commands such as OPEN, INCLUDE FILE, and WRITE
FILE, can use logical names and, generally, wildcards. If more than one
file matches your request, EVE shows a list of the matching files so you
can choose the one you want. See help on Choices Buffer.
SAVE is a synonym for SAVE EXTENDED EVE, which creates a section file to
save key definitions and other extensions. This avoids ambiguity with
SAVE FILE which saves (write out) your edits.
Hint: In writing initialization files, you should avoid very short
abbreviations, which may become ambiguous if new commands are added
to later versions of EVE.
Related topics:
CANCELING COMMANDS CHOICES BUFFER PROMPTS AND RESPONSES
About
About
© Digital Equipment Corporation. 1988. All Rights Reserved.
Related topics:
LIST OF TOPICS NEW FEATURES NEW USER
Canceling Commands
Canceling Commands
In typing any of the following commands, if EVE prompts you for more
information, you can cancel the operation by simply pressing RETURN:
@ LINE SET PARAGRAPH INDENT
DCL MARK SET RIGHT MARGIN
DEFINE KEY NEW SET SCROLL MARGINS
DELETE BUFFER OPEN SET TABS
DO REMEMBER SET WIDTH
ENLARGE WINDOW REPEAT SHIFT LEFT or RIGHT
EXTEND EVE SAVE EXTENDED EVE SHRINK WINDOW
FIND SET BUFFER TPU
GET FILE SET GOLD KEY UNDEFINE KEY
GO TO SET LEFT MARGIN WILDCARD FIND
INCLUDE FILE
REPLACE ..... if you do not specify an "old string" to be replaced
SAVE FILE ... if there is no file specification for the buffer
or WRITE FILE
o If you start a LEARN sequence and then decide you do NOT want it
remembered, follow these steps to cancel the definition:
1. Press CTRL/R to end the learn sequence.
2. When EVE prompts you to press the key you want to define,
press the RETURN key, which cannot be redefined.
o If you recall a command (such as by pressing CTRL/B) and do NOT want to
execute it, erase the command line (for example, by pressing CTRL/U) or
press a key defined as RESET.
o If you choose a command from a pull-down or pop-up menu, any prompts
usually appear in a dialog box. To cancel the operation, click MB1 on
CANCEL in the dialog box.
Note: CTRL/C may cancel a repeat operation, but its use is NOT
recommended, because CTRL/C is not recorded in the journal file.
If you use CTRL/C, you should immediately exit to save your work,
and then restart the editing session.
Related topics:
CHOICES BUFFER EDITING COMMAND LINES PROMPTS AND RESPONSES
RECALL RESET RETURN
Choices Buffer
Choices Buffer
The CHOICES buffer appears if you you type an ambiguous command. It lists
the possible matches so you can choose the one you want.
Example:
1. You type the following command to open a file with the type .TXT:
OPEN *.txt
If more than one file in your current (default) directory matches
your request, the Choices buffer appears in a second window,
listing the matching files. For example, there may be two files,
LETTER.TXT and MEMO.TXT.
2. Type your choice -- for example, type L*.TXT or M*.TXT -- and press
RETURN to complete the command.
Alternatively, you can select something from the Choices buffer in any of
the following ways:
o Using the mouse, point to the choice you want and click MB1 twice. The
first click copies the choice onto the command line; the second click
executes the command.
o Press a key defined as NEXT WINDOW or PREVIOUS WINDOW to put the cursor
in the Choices buffer. Then move the cursor to the choice you want to
use and press DO.
o Put the cursor in the Choices buffer. Then, press SELECT to copy the
choice onto the command line. Move back to the command window. If
necessary, use command-line editing. Press RETURN to execute the
command.
To cancel the Choices buffer -- and discard the command line -- use the
RESET command (press GOLD-SELECT or with the EDT or WPS keypad, press
GOLD-PERIOD on the keypad).
Related topics:
ABBREVIATING CANCELING COMMANDS EDITING COMMAND LINES
PROMPTS AND RESPONSES RESET
Commands
Commands (List of Topics)
For help on EVE topics, type the name of a topic and press RETURN.
~I~
o To exit from help and resume editing, press RETURN.
EDITING TEXT
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
SEARCHES
Find Set Find Nowhitespace Set Wildcard VMS
Find Next Set Find Whitespace Show Wildcards
Find Selected Set Wildcard Ultrix Wildcard Find
Replace
CURSOR MOVEMENT AND SCROLLING
Bottom Line Move Down Previous Screen
Change Direction Mark Move Left Reverse
End Of Line Move By Line Move Right Start Of Line
Forward Move By Page Move Up Top
Go To Move By Word Next Screen What Line
GENERAL-PURPOSE COMMANDS
Do Help Recall Repeat Return
Exit Quit Refresh Reset Show
FILES AND BUFFERS
Buffer New Open Selected Show Buffers
Delete Buffer Next Buffer Save File Show System Buffers
Get File Open Save File As Write File
Include File
WINDOWS AND DISPLAY
Delete Window One Window Set Width Shrink Window
Enlarge Window Other Window Shift Left Split Window
Next Window Previous Window Shift Right Two Windows
FORMAT AND CASE CHANGES
Capitalize Word Lowercase Word Set Right Margin
Center Line Paginate Set Tabs
Fill Set Left Margin Set Wrap
Fill Paragraph Set Nowrap Tab
Fill Range Set Paragraph Indent Uppercase Word
Insert Page Break
KEY DEFINITIONS
Define Key Set Keypad NoEDT Set Keypad WPS
Learn Set Keypad NoWPS Set Nogold Key
Remember Set Keypad Numeric Show Key
Set Gold Key Set Keypad VT100 Undefine Key
Set Keypad EDT
CUSTOMIZING AND ADVANCED FEATURES
@ Set Buffer Set Scroll Margins
Attach Set Clipboard Show Defaults Buffer
DCL Set Cursor Bound Show Summary
Extend All Set Cursor Free Spawn
Extend EVE Set Noclipboard Spell
Extend This Set Nopending Delete TPU
Save Extended EVE Set Pending Delete
INFORMATIONAL TOPICS
Abbreviating Gold Keys New User
About Initialization Files Position Cursor
Canceling Commands Journal Files Prompts And Responses
Choices Buffer Keypad (diagram) Ruler Keys
Command Files Keys (list) Scroll Bars
Control Keys List Of Topics Section Files
DECwindows Mail Editing Status Line
Defaults Menus Stuff
Dialog Boxes Message Buffer Typing Keys
Editing Command Lines Mouse Windows
EDT Conversion Names For Keys WPS Differences
EDT Differences New Features
Command Files
Command Files
A command file contains VAXTPU procedures and statements to customize or
extend EVE, or to create a special environment for building your own
VAXTPU application. The default file type for command files is .TPU.
Example:
The following example is a VAXTPU command file with a procedure for
swapping the current and previous characters, and binding this
procedure to a key:
+----------------------------------------------------------------+
| PROCEDURE user_swap_character |
| LOCAL swap_this; |
| swap_this := ERASE_CHARACTER (1); ! Erase current char |
| MOVE_HORIZONTAL (-1); ! Move back one char |
| COPY_TEXT (swap_this); ! Put in erased char |
| ENDPROCEDURE; |
| DEFINE_KEY ("user_swap_character", KEY_NAME ("s", SHIFT_KEY)); |
+----------------------------------------------------------------+
o Using a command file when you invoke VAXTPU compiles the procedures and
executes the statements in the command file, such as DEFINE_KEY
statements. For more information, see DCL help on EDIT/TPU/COMMAND or
see the VAX Text Processing Utility Manual.
o To use a command file during a session, follow the steps in this
example:
Command Purpose or Effects
---------------------------------------------------------------------
1. OPEN myeve.tpu Opens a command file called MYEVE.TPU.
2. TPU EXECUTE (CURRENT_BUFFER)
Compiles the entire buffer (that is, all the
procedures in the command file) and executes any
statements following the procedures.
3. TPU myproc Executes a compiled procedure called MYPROC.
o To save extensions and key definitions you want for all or most editing
sessions, use SAVE EXTENDED EVE to create a section file --
effectively, your own customized version of EVE. Because a section
file is in binary form, it is faster than running the command file for
each editing session. However, a section file usually does NOT save
editing preferences such as margins and tabs, so you many want to use a
VAXTPU command file or EVE initialization file for those settings.
Related topics:
EXTEND EVE INITIALIZATION FILES SECTION FILES TPU
Control Keys
Control Keys
Control keys combine holding down the CTRL key while you press another key
-- usually to execute a command or enter a control code.
o EVE defines the following control keys:
Key Definition Key Definition
---------------------------- ------------------------------
CTRL/A ... Change Mode CTRL/L ... Insert Page Break
CTRL/B ... Recall CTRL/M ... Return
CTRL/E ... End Of Line CTRL/R ... Remember
CTRL/H ... Start Of Line CTRL/U ... Erase Start Of Line
CTRL/I ... Tab CTRL/V ... Quote
CTRL/J ... Erase Word CTRL/W ... Refresh
CTRL/K ... Learn (with the CTRL/Z ... Exit
EDT or WPS keypad)
o When you edit a command line, EVE redefines CTRL/J as ERASE PREVIOUS
WORD, so as to emulate DCL command-line editing.
o Setting the EDT or WPS keypad defines or redefines some control keys.
For example, CTRL/H, CTRL/J, and CTRL/U are redefined to emulate their
EDT or WPS functions, which are slightly different from their EVE
definitions.
o You can define most control keys by using DEFINE KEY or LEARN commands.
In naming control keys, use a dash, slash, or underscore in the key
name. Some control keys cannot be defined unless you have set your
terminal accordingly (see help on TPU Nondefinable Keys):
CTRL/C CTRL/O CTRL/Q CTRL/S CTRL/T CTRL/X CTRL/Y
o CTRL/C may cancel an operation, but its use is NOT recommended, because
CTRL/C is not recorded in the journal file. If you use CTRL/C, you
should immediately exit, to save your work, and then restart the
editing session.
o To find out the definition of a key, use the SHOW KEY command.
For a list of key definitions, see help on Keys or press GOLD-HELP.
Related topics:
DEFINE KEY LEARN SHOW KEY UNDEFINE KEY
DECwindows Differences
DECwindows Differences
You can run EVE both on character-cell terminals, such as the VT330,
VT220, and VT100, and on DECwindows. Most commands and keypad functions
work the same in each environment. Here is a list of differences when you
run EVE on DECwindows:
o Journaling and recovery are NOT supported on DECwindows unless you
invoke EVE with the /DISPLAY=CHARACTER_CELL qualifier. Therefore, you
may want to save your edits frequently so that you are are less likely
to lose your work in case of a system failure.
o ATTACH, SPAWN, and SPELL commands are NOT supported unless you used
/DISPLAY=CHARACTER_CELL. However, if you run run several DECwindows
applications concurrently, using subprocceses may not be necessary.
o Menu items use a dialog box to prompt for additional information. If
you type a command or press a defined key, EVE prompts for any
additional information on the command line.
o You can enable the clipboard for copying, cutting, and pasting text, so
you can transfer text between EVE and other DECwindows applications.
The default setting is NOCLIPBOARD, which uses EVE's Insert Here
buffer. WPS keypad functions do NOT use clipboard, regardless of the
setting. See help on the SET CLIPBOARD command.
o You can toggle case-sensitivity for searches -- particularly useful to
find only lowercase strings -- as follows:
1. Choose Global Preferences in the Customize menu.
2. Click MB1 on the Set Find Case Exact toggle button.
Related topics:
DIALOG BOXES MENUS MOUSE NEW FEATURES
Defaults
Defaults
Global Settings Buffer Settings
(apply to EVE or to all buffers) (apply to the current buffer)
--------------------------------- ------------------------------
Clipboard ... NOCLIPBOARD Buffer status ....... WRITE
Cursor ...... FREE Direction ........... FORWARD
Find ........ NOWHITESPACE Left margin ......... 1
Gold key .... NOGOLD Mode ................ INSERT
Keypad ...... NUMERIC or VT100 Parargraph indent ... 0 (none)
Pending delete ... NOPENDING DELETE Right margin ........ 79
Tab modes ... INSERT and INVISIBLE Tab stops ........... EVERY 8
Width ....... 80 columns Wrapping ............ WRAP
Scroll margins ... 0 0
Wildcards ... VMS
o If there are settings you want for all or most editing sessions, put
the appropriate commands in an EVE initialization file. You can save
key definitions in a section file.
o At startup, commands in an initialization file for buffer settings
apply to a system buffer named $DEFAULTS$, so that each buffer you
create has the same settings as $DEFAULTS$.
o To check the default settings, use the SHOW DEFAULTS BUFFER command.
To set or change the defaults during an editing session, follow the
steps in this example:
Command Purpose or Effects
---------------------------------------------------------------------
1. SHOW DEFAULTS BUFFER Shows the settings of the $DEFAULTS$ buffer.
2. BUFFER $DEFAULTS$ Puts the $DEFAULTS$ buffer in the current
window. (The buffer itself is empty.)
3. SET RIGHT MARGIN 70 Sets the default right margin -- buffers you
create thereafter will have a right margin of
70.
o The default width depends on your terminal setting (usually 80
columns). The default right margin is one column less than the width.
The SET WIDTH command makes the right margin of the $DEFAULTS$ buffer
one column less than the width you specify, but does not affect the
margin of other, existing buffers.
o Using SET KEYPAD WPS automatically sets the cursor to BOUND.
WPS keypad functions do NOT use the DECwindows clipboard.
o For editing command lines, the default mode matches your terminal
setting, the direction is reverse, and the cursor is bound. For more
information, see help on Editing Command Lines.
Related topics:
EDT CONVERSION EDT DIFFERENCES INITIALIZATION FILES
SHOW SHOW DEFAULTS BUFFER WPS DIFFERENCES
Dialog Boxes
Dialog Boxes
On DECwindows, some menu items use a dialog box for you to type required
information or make further choices. For example:
o Open, Save File As, and Include in the File menu each use a dialog
box for specifying a file.
o Global Preferences and Buffer Preferences in the Customize menu each
use a dialog box so you can toggle or choose settings (by clicking
MB1).
Generally, dialog boxes contain OK and CANCEL buttons for you to confirm
your choice or cancel the operation.
In typing text in a dialog box, you can use the DELETE key (marked <X] on
the keyboard) to erase typing errors, but you cannot use EVE keys for
command line editing.
Dialog boxes do NOT appear for commands that you type or execute by
pressing function keys. Instead, EVE prompts you to type the information
on the command line. (See help on Prompts And Responses.)
Related topics:
MENUS MOUSE PROMPTS AND RESPONSES
Editing Command Lines
Editing Command Lines
You can use keys to edit EVE command lines much as at DCL. Generally,
keys for text editing or moving the cursor work the same way on the
command line as in a text buffer. However, the command line always uses
bound cursor motion and is initially set to reverse direction.
Key Effects
----------------------------------------------------------------------
CTRL/A or F14 (CHANGE MODE) Toggles insert and overstrike mode.
(or ENTER with The default mode of the command line matches your
VT100 keypad) terminal setting. If you change the mode of the
command line, the new mode mode stays in effect
for the rest of the editing session or until you
change it again.
CTRL/B (RECALL) Recalls the last command you typed.
CTRL/E or (END OF LINE) Moves the cursor to the end of the
GOLD-RIGHT arrow command line.
CTRL/H or (START OF LINE) Moves the cursor to the start of
GOLD-LEFT arrow the command line.
CTRL/J or F13 Erases the previous word or the current word,
(or COMMA with depending on the cursor position. For editing
VT100 keypad) command lines, keys defined as ERASE WORD work
like ERASE PREVIOUS WORD.
CTRL/U (ERASE START OF LINE) Erases characters left of
the cursor to the start of the command line.
CTRL/V (QUOTE) Lets you enter a control code or other
character, such as escape or form feed.
DELETE (DELETE) Deletes the character left of the cursor.
LEFT arrow and (MOVE LEFT and RIGHT) Moves the cursor a character
RIGHT arrow at a time. In editing command lines, the cursor is
bound; for editing text, the default is free cursor.
F11 (or PF3 (CHANGE DIRECTION) Toggles forward and reverse.
with VT100 The default direction of the command line is
keypad) reverse. If you change the direction of the
command line, the new direction stays in effect
for the rest of the editing session or until you
change it again.
F12 (or MINUS (MOVE BY LINE) Moves the cursor to the start or end
with VT100 of the command line, depending on the direction.
keypad)
GOLD-SELECT (RESET) Cancels an incomplete or recalled command.
(or GOLD-PERIOD
with EDT or WPS)
You can also edit command lines using EDT or WPS keypad functions such as
Delete Character, Delete Word, and Delete Line, and so on. Note that both
the EDT keypad and WPS keypad define CTRL/J and F13 as Delete Previous
Word, which is slightly different from EVE's definition of the keys.
Related topics:
ABBREVIATING CANCELING DO PROMPTS AND RESPONSES
QUOTE RECALL REPEAT RESET
EDT Conversion
EDT Conversion
If you are accustomed to EDT, you can customize EVE to work in similar
ways by using a section file or an initialization file (or both), or by
using VAXTPU procedures.
Typically, you save key definitions, learn sequences, and other extensions
in a section file (using SAVE EXTENDED EVE), and use an initialization
file to set editing values or private defaults, such as margins and tabs,
which are not saved in the section file. Here are some hints and
examples:
o Use the SET KEYPAD EDT command to enable the EDT-style keypad. Put the
command in an initialization file or save the keypad setting in a
section file. Most keypad functions work as in real EDT, although the
names may differ. See help on EDT Differences.
o Use DEFINE KEY commands to define other keys. Put the key definitions
in an initialization file or save them in a section file. For example:
In EDT In EVE
-------------------------------- ---------------------------------
DEF KEY gold b as "show buffer" DEFINE KEY= gold-b show buffers
DEF KEY gold l as "chglw." DEFINE KEY= gold-l lowercase word
DEF KEY gold u as "chguw." DEFINE KEY= gold-u uppercase word
DEF KEY gold 9 as "cutsr paste." DEFINE KEY= gold-kp9 store text
DEF KEY control n as "ext quit." DEFINE KEY= control/n quit
DEF KEY func 20 as "shr." DEFINE KEY= f20 shift right 8
DEF KEY gold 10 as "ext find=?.." DEFINE KEY= gold-pf2 buffer
Note the differences in some key names. For more information, see help
on Names For Keys.
o Put the SET CURSOR BOUND command in your initialization file, enabling
an EDT-style bound cursor, which follows the shape or flow of your
text. By default, EVE uses a free cursor, which you can move anywhere
in the buffer.
o Put the SET RIGHT MARGIN command in your initialization file to set a
wrap limit for entering text and for FILL commands. For example:
In EDT In EVE
----------- -------------------
SET WRAP 70 SET RIGHT MARGIN 70
(There is an EVE command SET WRAP which corresponds to the EDT command
SET NOTRUNCATE.)
o Put the SET SCROLL MARGINS command in your initialization file to set
distances for scrolling to begin automatically as you move the cursor
up or down. For example:
In EDT In EVE
--------------- ----------------------
SET CURSOR 5:15 SET SCROLL MARGINS 5 6
Note that EVE scroll margins are measured from the top and bottom
respectively, whereas in EDT, both are measured from the top. You can
specify numbers of lines or percentages of the screen size. Also, the
size of the EVE main window depends on the terminal screen. For
example, on a workstation, the main window may be longer than 21 lines.
o Use VAXTPU procedures in place of EDT macros. Create a buffer
containing the VAXTPU procedure and compile it with the EXTEND EVE
command, or put the procedure in a VAXTPU command file, and invoke EVE
with the /COMMAND qualifier. In either case, you can save the compiled
procedure in your section file. To execute a compiled procedure, use
the TPU command and the procedure name. For example:
EDT Macro VAXTPU Procedure
--------------------- ----------------------------
FIND=wid132 PROCEDURE widen
INSERT;SET SCREEN 132 EVE_SET_WIDTH (132);
INSERT;SET WRAP 120 EVE_SET_RIGHT_MARGIN (120);
FIND=main. ENDPROCEDURE;
In EDT In EVE
------------------- ----------------
DEFINE MACRO widen EXTEND EVE widen
WIDEN TPU widen
Alternatively, use the LEARN command to bind the relevant EVE commands
to a single key and then save the key definition in your section file.
Another method is to put the relevant commands in an EVE initialization
file which can be executed during a session by using the @ command.
Related topics:
COMMAND FILES DEFINE KEY EDT DIFFERENCES INITIALIZATION FILES
NAMES FOR KEYS NEW USER SECTION FILES SET KEYPAD EDT
EDT Differences
EDT Differences
SET KEYPAD EDT provides most of the keypad functions in EDT. It does NOT
fully implement or emulate EDT. Here is a list of differences between the
EDT keypad in EVE and real EDT. For hints on converting from EDT to EVE,
see help on EDT Conversion.
GOLD Keys
o Setting the EDT keypad makes PF1 the GOLD key unless you set another
key as GOLD. If you define keys that EDT ordinarily defines, such
as KP8, GOLD-KP8, or CTRL/U, your definitions override the EDT
definitions.
o GOLD-KP7 is defined as DO, for typing EVE commands. EVE does not
support EDT line-mode or "nokeypad" commands.
o GOLD-KP8 is defined as FILL, to reformat the current paragraph,
select range, or found range. If you want the key to fill only a
select range or found range, as in real EDT, redefine the key as
FILL RANGE.
Control Keys
o Setting the EDT keypad redefines CTRL/H, CTRL/J, and CTRL/U to
emulate EDT. (Their standard EVE definitions are slightly
different.) Also, the EDT keypad defines CTRL/K as LEARN.
o EVE defines some other control keys differently from EDT. For
example, CTRL/Z is defined as EXIT (ending the editing session), and
CTRL/R is defined as REMEMBER (ending a learn sequence). For more
information, see help on Control Keys.
o CTRL/C may cancel an operation, but its use is NOT recommended,
because CTRL/C is not recorded in the journal file. If you use
CTRL/C, you should immediately exit, to save your work, and then
restart the editing session.
Other Keys
o EVE defines the ENTER key as RETURN, to terminate a command or start
a new line. You can redefine the ENTER key, but not the RETURN key.
o Some EDT keypad definitions use the corresponding EVE commands,
which may have slightly different names but are usually functionally
identical to EDT.
o The EDT Word key (KP1) is defined as MOVE BY WORD, which uses
slightly different word boundaries. In EVE, a "word" includes the
trailing whitespace (spaces, tabs) until the next word separator
(typically, a printing character).
o EVE key names are usually the same as at DCL and therefore different
from EDT key names. See help on Names For Keys.
Help
The EDT keypad defines the PF2 key as HELP KEYPAD, which draws a
diagram of the current keypad functions, and defined GOLD-PF2 as HELP
KEYS, which lists all the current key definitions.
Insert Here Buffer and the Clipboard
The Append key (KP9), Replace key (GOLD-KP9), and Subs key (GOLD-ENTER)
use EVE's Insert Here buffer or the DECwindows clipboard, depending on
your setting. The default setting is NOCLIPBOARD, which uses the
Insert Here buffer. See help on the SET CLIPBOARD command.
Free and Bound Cursor
o By default EVE uses a free cursor, which you can move anywhere in
the buffer regardless of the shape of your text. To enable an EDT-
style bound cursor, use the SET CURSOR BOUND command.
o The EDT Character key (KP3) uses bound-cursor motion even if the
cursor is set to free.
Scroll Margins
To set distances for scrolling to begin automatically, use the SET
SCROLL MARGINS command. For example, SET SCROLL MARGINS 7 7 is the
equivalent of CURSOR 7:14 in real EDT. Note that in EVE, scroll
margins are measured from the top and the bottom respectively. The
default settings are 0 0 (scrolling begins when you move past the top
or bottom of the window).
Searches
Searches follow EVE rules for case sensitivity and direction. Because
EVE does not treat RETURN and ENTER differently, as EDT does, search
strings cannot contain a carriage return. However, you can use the
WILDCARD FIND command for these searches, or use the SET FIND
WHITESPACE command to enable searching across line breaks.
Exiting
Exiting from EVE creates a new file only if you have made changes to
the buffer (and not yet written it out). Quitting discards your edits,
but if you have made changes to the buffer, EVE asks you to confrim
that you want to quit.
Features NOT Implemented
o GOLD key equivalents for control keys. For example, GOLD-U and
GOLD-Z are not defined, although CTRL/U and CTRL/Z are defined.
o Keys for tab adjustments. To change tab stops, use the SET TABS
command or define a key for the WPS Ruler key (GOLD-R).
Related topics:
EDT CONVERSION SET KEYPAD NOEDT SET KEYPAD EDT
Gold Keys
Gold Keys
The GOLD key increases the possible key bindings for the numeric keypad,
function keys, control keys, and typing keys. You press GOLD and then
another key.
Example:
The following commands set PF1 as the GOLD key and define the
combination of GOLD and the letter C as the CENTER LINE command.
Typing C by itself still enters that character.
SET GOLD KEY pf1
DEFINE KEY= gold-c center line
o In naming GOLD key combinations, use a dash, slash, or underscore as a
delimiter -- for example, GOLD-PF2, GOLD-F20, GOLD-KP0.
o Using the SET GOLD KEY, SET KEYPAD EDT, or SET KEYPAD WPS command
automatically defines the following GOLD key combinations, unless you
have already defined them otherwise:
Key Definition
------------------------------------------------------------------
GOLD-F13 ........... Restore Word or WPS Delete Beginning Sentence
GOLD-HELP ......... Help Keys (list of definitions)
GOLD-FIND .......... Wildcard Find
GOLD-INSERT HERE ... Restore [Note: Both the EDT and WPS
GOLD-REMOVE ........ Store Text keypads define several other
GOLD-SELECT ........ Reset GOLD key combinations, and
GOLD-PREV SCREEN ... Previous Window also let you use GOLD-number
GOLD-NEXT SCREEN ... Next Window combinations for repeat counts
GOLD-UP arrow ...... Top and other purposes.]
GOLD-LEFT arrow .... Start Of Line
GOLD-DOWN arrow .... Bottom
GOLD-RIGHT arrow ... End Of Line
o Setting the EDT or WPS keypad makes PF1 the GOLD key, unless you have set
another key as GOLD. You can have only one key set as the the GOLD key.
Also, if you define keys that are otherwise defined by EDT or WPS (such as
GOLD-PF4) your definitions override the EDT or WPS definitions.
o To save key definitions for future sessions, put SET GOLD KEY and other key-
definition commands in an initialization file, or use the SAVE EXTENDED EVE
command to create a section file.
o To find out the definition of a key, use the SHOW KEY command.
For a list of key definitions, see help on Keys or press GOLD-HELP.
Related topics:
DEFINE KEY NAMES FOR KEYS SET GOLD KEY SHOW KEY TYPING KEYS
Initialization Files
Initialization Files
An initialization file contains EVE commands, typically to set editing
values or private defaults, such as margins and tabs. The default file
type is .EVE.
Example:
The following example is an EVE initialization file to set editing
preferences and define keys:
+--------------------------------+
| SET LEFT MARGIN 5 | Each command must be on a separate
| SET PARAGRAPH INDENT 4 | line -- no continuations. If a
| SET RIGHT MARGIN 70 | command is incomplete, EVE prompts
| SET SCROLL MARGINS 10% 10% | you for any required information
| SET TABS EVERY 5 | before continuing to execute the
| SET CURSOR BOUND | initialization file.
| SET CLIPBOARD |
| ! Key definitions | Comments must be on lines separate
| SET KEYPAD EDT | from commands and must begin with
| DEFINE KEY= F20 SHOW BUFFERS | an exclamation point (!).
| DEFINE KEY= GOLD-KP7 SPELL |
| DEFINE KEY= CTRL/P PAGINATE |
| DEFINE KEY= GOLD-C CENTER LINE |
| DEFINE KEY= F17 WPS GOLD-R |
+--------------------------------+ You cannot nest initialization files.
o To execute an initialization file when you invoke EVE, use the
/INITIALIZATION qualifier or define the logical name EVE$INIT
(especially if there is an initialization file you want to use for all
or most editing sessions). By default, EVE searches your current
(default) directory and SYS$LOGIN for a file called EVE$INIT.EVE. For
more information, see DCL help on EDIT/TPU/INITIALIZATION.
o At startup, commands in an initialization file for buffer settings,
such as margins and tab stops, apply to a system buffer named
$DEFAULTS$ so that each buffer you create has the same settings. See
help on Defaults.
o To execute an initialization file during a session, use the @ command
(at sign) and specify the file. (See help on @.) This is effectively
the same as typing the commands the file contains. Commands for buffer
settings apply to the current buffer.
o Key definitions in an initialization file supersede those in a section
file or VAXTPU command file. Typically, you save key definitions you
want for all or most editing sessions (such as if you always want the
EDT keypad), by creating a section file. Because a section file is in
binary form, it is faster than an initialization file.
o However, a section file usually does NOT save settings such as margins,
tabs, and other editing preferences, so you may want to use an
initialization file for those settings.
Related topics:
@ COMMAND FILES DEFAULTS SECTION FILES
Journal Files
Journal Files
A journal file records your edits so that if the system fails you can
recover your work.
Note: Journaling and recovery are NOT supported on DECwindows unless you
invoke EVE with the /DISPLAY=CHARACTER_CELL qualifier. Therefore,
you may want to save your edits frequently so that you are are less
likely to lose your work in case of a system failure.
o By default, when you invoke EVE, a journal file is created in your
current directory. Normally, the journal file is automatically deleted
when you exit or quit. However, if the system fails during your
editing session, the journal file is saved.
o To recover your edits after a system failure, invoke EVE again, by
reissuing the command you used to begin that editing session and adding
the /RECOVER qualifier, as in the following example:
1. $ EDIT/TPU memo.txt
Invokes EVE to create or edit a file called MEMO.TXT. If the
system fails during your editing session, the journal file is
saved -- in this case, the journal file is called MEMO.TJL.
2. $ EDIT/TPU memo.txt/RECOVER
Recovers your edits in a kind of "player piano fashion" up to
the point when the system failed. (The last few keystrokes or
operations may be lost.) You then resume editing. Any new edits
are journaled.
o By default, the journal file has the same name as the file you edit and
the file type .TJL. If you invoke EVE without specifying an input file
on the command line, the journal file is called TPU.TJL. To find out
the current journal file specification, use SHOW SUMMARY.
o Before recovering your edits, check that all relevant files and
terminal settings are the same as for the original, failed session.
Also, remember to reissue the same qualifiers as for the original
session (such as /START_POSITION), as well as adding /RECOVER.
o For more information on journaling and recovery, see DCL HELP on
EDIT/TPU/JOURNAL and /RECOVER.
Keys
<<Type a command or ? and then RETURN to get help on commands.>>
o For help on a particular key, press that key.
o For a keypad diagram, type KEYPAD and press RETURN.
o To exit from HELP, press RETURN.
o To show a key definition, use SHOW KEY.
Mail Editing
Mail Editing
You can make EVE the default editor for MAIL by using the SET EDITOR TPU
command in MAIL. You can also define logical names to specify your own
section file (TPU$SECTION) and initialization file (EVE$INIT).
Steps:
1. To invoke EVE within MAIL, use the following MAIL command:
MAIL> SET EDITOR TPU
Thus, SEND/EDIT, REPLY/EDIT, and similar commands in MAIL invoke
VAXTPU, running the standard EVE section file. Your choice of
editor is stored in the MAIL user profile along with your personal
name, mail directory, and other settings.
2. Define TPU$SECTION to specify a section file of your own. For
example, the following DCL command defines TPU$SECTION as a section
file called MYSEC.TPU$SECTION in your top-level (or login)
directory:
$ DEFINE TPU$SECTION sys$login:mysec
Thus, VAXTPU runs your section file instead of standard EVE,
whether in MAIL or at the DCL level. You may want to put the
definition in your LOGIN.COM file.
3. Define EVE$INIT to specify your EVE initialization file. For
example, the DCL following command defines EVE$INIT as an
initialization file called MYINI.EVE in your top-level (or login)
directory:
$ DEFINE EVE$INIT sys$login:myini
This is useful if you have created an EVE initialization file to
set margins, tabs, and other editing values, or to define keys.
You may want to put the definition in your LOGIN.COM file.
For more information about EVE and VAXTPU logical names, see DCL help on
EDIT/TPU LOGICALS, or see the VAX Text Processing Utility Manual.
Related topics:
INITIALIZATION FILES SECTION FILES
Menus
Menus
Using DECwindows menus, you can do editing operations with the mouse,
instead of having to type commands or press defined keys.
Steps:
To use a pull-down menu, do the following:
1. Point to the name of a menu in the menu bar.
Press and hold MB1 to display the menu.
2. Drag the mouse to the item you want and release MB1.
To use a pop-up menu, do the following:
1. Press and hold MB2 to display the pop-up menu.
2. Drag the mouse to the item you want and release MB2.
o EVE has two different pop-up menus depending on whether you have
selected text. If you have selected text, the pop-up menu contains
items like Fill Range, Copy, and Cut. If you have not selected text,
it contains items like Fill Paragraph, Center Line, and Paste.
o Some menu items are submenus listing two or more commands to choose
from, for example, Change Case in the Format menu and Restore in the
Edit menu.
o If you choose a menu item that requires additional information, a
dialog box appears so you can type the information, such as a file
specification or search string.
o Some menu items use a dialog box so you can choose settings or
preferences, for example, Buffer Preferences in the Customize menu.
o The status line is also a kind of menu. Clicking MB1 on the buffer
name puts your next buffer in the window for that status line (same as
the NEXT BUFFER command); clicking MB1 on one of the other fields of
the status line toggles that setting (for example, to change from
insert to overstrike mode).
Related topics:
DIALOG BOXES MOUSE SCROLL BARS STATUS LINE
Message Buffer
Message Buffer
The message window at the bottom of the screen shows one message line at a
time, such as status messages from EVE commands or broadcast messages,
such as MAIL. Messages received during your editing session are stored in
a system buffer named MESSAGES.
o To view the entire Messages buffer, use the following command:
BUFFER MESSAGES
o You can scroll through this buffer to check your messages. Also, you
can edit or write out the Messages buffer the same as any text buffer
-- for example, to send the exact text of an error message to your
system manager or to save compiler messages.
o Using multiple windows, you can put the Messages buffer in one window
while you compile procedures in another window. Follow the steps in
this example:
Command Purpose or Effect
---------------------------------------------------------------------
1. TWO WINDOWS Splits the current EVE window into two smaller
windows, each displaying the same buffer.
2. BUFFER MESSAGES Puts the Messages buffer in the new window. Then
PREVIOUS WINDOW puts the cursor in the previous window which
contains the buffer you were working in.
3. EXTEND ALL Compiles all the procedures in the current buffer.
Compiler messages appear in the other window.
For more information on using multiple windows, see help on Windows.
Related topics:
BUFFER DELETE BUFFER SHOW BUFFERS SHOW SYSTEM BUFFERS
Mouse
Mouse
The mouse is an additional input device attached to your terminal or
computer. On DECwindows, the mouse lets you perform editing operations
without having to type commands or press defined keys.
o Use MB1 to choose pull-down menus, select text, use scroll bars, and
change the input focus.
o Use MB2 to display a pop-up menu with commands for the current context
or state of the editor. See help on Menus.
o Use MB3 to transfer ("stuff") a select range from another DECwindows
application into EVE. See help on Stuff.
Note: You cannot define mouse buttons as you can define keys, because mouse
buttons depend upon the location of the pointer on the screen.
Related topics:
POSITION CURSOR MENUS SCROLL BARS SELECT STATUS LINE STUFF
Names for Keys
Names for Keys
You can type key names for the commands DEFINE KEY, SET GOLD KEY, SHOW
KEY, and UNDEFINE KEY -- for example, when putting these commands in an
initialization file.
o EVE key names are usually the same as the marking on the keys. Here is
a list of some exceptions or special cases:
Key Name Marking Key Name Location
------------------------ ----------------------------
F15 ...... Help UP .......... up arrow
F16 ...... Do LEFT ........ left arrow
E1 ....... Find DOWN ........ down arrow
E2 ....... Insert Here RIGHT ....... right arrow
E3 ....... Remove KP0---KP9 ... numeric keypad
E4 ....... Select MINUS ....... numeric keypad
E5 ....... Prev Screen COMMA ....... numeric keypad
E6 ....... Next Screen PERIOD ...... numeric keypad
DELETE ... <X] or Delete ENTER ....... numeric keypad
TAB ...... Tab
o In naming control keys or GOLD key combinations, use a dash, slash, or
underscore as a delimiter -- for example, CTRL/D and GOLD-KP8.
o You cannot define mouse buttons as you can define keys, because mouse
buttons depend upon the location of the pointer on the screen.
o Some keys, such as RETURN and F1 through F6, cannot be defined.
For more information, see help on TPU Nondefinable Keys.
o For a list of all key definitions, see help on Keys or press GOLD-HELP.
For a keypad diagram, see help on Keypad or press HELP.
Related topics:
CONTROL KEYS DEFINE KEY GOLD KEYS KEYPAD KEYS
TYPING KEYS SET GOLD KEY SHOW KEY UNDEFINE KEY
New Features
New Features
Here is a list of the new features in this version of EVE. For detailed
information, see help on the relevant commands or other topics.
Choices Buffer
You can now put the cursor in the Choices buffer and select the choice
you want without having to edit or retype the command line. For more
information, see help on Choices Buffer.
Clipboard Operations
The following commands and EDT keypad functions use EVE's Insert Here
buffer or the DECwindows clipboard, depending on your setting:
COPY or STORE TEXT EDT Append key (KP9)
CUT or REMOVE EDT Replace key (GOLD-KP9)
PASTE or INSERT HERE EDT Subs key (GOLD-ENTER)
The default setting is NOCLIPBOARD, which uses the Insert Here buffer.
To enable the clipboard, use the SET CLIPBOARD command. This lets you
transfer text between EVE and other DECwindows applications.
Note: WPS keypad functions do NOT use the clipboard, regardless of the
setting.
Default Key Definitions
Setting the GOLD key -- by itself or by setting the EDT or WPS keypad
-- automatically defines GOLD-NEXT SCREEN and GOLD-PREV SCREEN as NEXT
WINDOW and PREVIOUS WINDOW respectively, unless you have already
defined them otherwise. For more information on default GOLD key
combinations, see help on Gold Keys.
The PF4 key is defined as DO in both standard EVE keypads (Numeric and
VT100). It is redefined when you set the EDT or WPS keypad.
Dialog Boxes
If you choose a command from a pull-down or pop-up menu, instead of
typing the command or pressing a defined key, EVE uses a dialog box for
entering any required information, such as a file specification or
other parameter. For more information, see help on Dialog Boxes.
Find Case Exact
On DECwindows, you can toggle case sensitivity for FIND and similar
commands and keypad functions. This is particularly useful to find or
replace lowercase strings only.
1. Choose Global Preferences in the Customize menu.
2. Click MB1 on the Set Find Case Exact toggle button.
Mouse Buttons
o Use MB1 for to choose pull-down menus, select text, use the scroll
bar, and change the input focus.
o Use MB2 to display a pop-up menu with commands for the current
context or state of the editor. See help on Menus.
o Use MB3 to transfer ("stuff") a select range from another DECwindows
application into EVE. See help on Stuff.
You cannot define mouse buttons as you can define keys, because mouse
buttons depend upon the location of the pointer on the screen.
Scroll Bars
EVE provides vertical and horizontal scroll bars the same as other
DECwindows applications. For more information, see help on Scroll Bars.
Select Ranges
If you select text by using the SELECT command or SELECT key, moving
the cursor extends or shrinks the select range. If you select text by
using mouse clicks (for example, clicking MB1 three times to select the
current line), moving the cursor off the select range cancels the
selection. A select range in EVE becomes the DECwindows primary
selection. For more information, see help on SELECT.
Status Line
The status line is both an informational display about the current
window or buffer, and a menu:
o Clicking MB1 on the buffer name in the status line puts your next
buffer in the curernt window. See help on the NEXT BUFFER command.
o Clicking MB1 on the other fields in the status line toggles the
settings -- for example, to change from insert mode to overstrike.
See help on Status Line.
Stuff
On DECwindows, you can MB3 to transfer (or "stuff") a select range from
another application into the current EVE buffer, or conversely. For
more information, see help on Stuff.
FIND NEXT and FIND SELECTED Commands
FIND NEXT searches for another occurrence of a string already entered
with FIND, REPLACE, or WILDCARD FIND -- same as pressing the FIND key
twice. FIND SELECTED searches for the currently selected text, rather
than for a typed string. If you are typing the FIND command and want
to search for the word "next" or "selected," put the string in quotes
or let EVE prompt you for the string.
NEXT BUFFER and NEW Commands
NEXT BUFFER puts your next buffer in the current EVE window, returning
the cursor to your last position in that buffer.
NEW creates a buffer named MAIN; if a buffer named MAIN already exists,
EVE asks for the name of the buffer to create.
OPEN and OPEN SELECTED Commands
OPEN puts a file you specify into the current EVE window (same as the
GET FILE command). OPEN SELECTED uses the name of a file you have
selected, rather than a typed file name. The select range can be in
EVE or in another DECwindows application running concurrently.
PAGINATE Command
Inserts a "soft" page break for a 54-line page. A soft page break is a
form feed followed by the null character (appearing as a small FFNL).
Soft page breaks are erased or relocated by subsequent PAGINATE
commands. A "hard" page break is a form feed only, done with the
INSERT PAGE BREAK command (CTRL/L key).
SAVE FILE and SAVE FILE AS Commands
Same as the WRITE FILE command: SAVE FILE uses the output file
associated with the current buffer or if necessary, prompts you for for
a file specification. SAVE FILE AS always prompts for a file
specification. Note that SAVE by itself is a synonym for the SAVE
EXTENDED EVE command, to create a section file.
SELECT ALL Command
Selects all of the current buffer, regardless of your position (same as
clicking MB1 five times). Pending delete is disabled when you use
SELECT ALL, so that the buffer will not be accidentally erased.
SET BUFFER Command
Sets the editing status of the current buffer, as shown in the status
line -- READ_ONLY or WRITE, and MODIFIABLE or UNMODIFABLE. Typically,
you set a buffer to read-only or unmodifiable or both to protect
against accidentally changing data you want to view but keep intact.
By default, buffers you create are set to write and modifiable.
SET PARAGRAPH INDENT Command
Sets the number of columns or spaces to indent the first line of
paragraphs that you create or fill. The value is relative to the left
margin of the buffer. A negative value produces "hanging" paragraphs
(first line left of the left margin), which is useful to format lists.
The default setting is 0 (no indent).
SET PENDING DELETE and RESTORE SELECTION Commands
If you use SET PENDING DELETE and then select text, typing new text or
using DELETE erases the select range. The default setting is NOPENDING
DELETE. To reinsert what you deleted, use RESTORE SELECTION.
DECwindows Restrictions
Journaling and recovery, and the ATTACH, SPAWN, and SPELL commands are
NOT supported on DECwindows, unless you invoke EVE with the /DISPLAY=
CHARACTER_CELL qualifier.
Obsolete Commands
The SET SHIFT KEY and SET NOSHIFT KEY commands are now obsolete.
Instead, use the SET GOLD KEY and SET NOGOLD KEY commands respectively.
Related topics:
DECWINDOWS EDT CONVERSION EDT DIFFERENCES LIST OF TOPICS
MOUSE MENUS STATUS LINE WPS DIFFERENCES
New User
New User
EVE (for Extensible VAX Editor) is a general-purpose text editor, based on
the VAX Text Processing Utility (VAXTPU). You use EVE to create and text
files. You can edit more than one file in a session.
There are three ways to execute EVE commands:
Menus On DECwindows, EVE has pull-down and pop-up menus for most
of the common editing operations. Use MB1 to choose
commands in pull-down menus and to select text. Use MB2 for
a pop-up menu. See help on Menus.
Commands To type a command, press the DO key. If necessary, EVE
prompts you for more information, such as file
specifications or other parameters. For a list of EVE
commands, see help on List Of Topics.
Keys EVE defines some keys by default and lets you define keys
yourself, including learn sequences to bind several commands
or keystrokes to a single key, and GOLD key combinations.
You can use SET KEYPAD commands to set an EDT- or WPS-style
keypad.
Related topics:
COMMANDS DECWINDOWS EDT CONVERSION GOLD KEYS HELP
KEYPAD KEYS MENUS MOUSE NEW FEATURES
Not Implemented
Feature Not Implemented Sorry... That command or topic is NOT implemented in EVE. +--------------------------------------------------------------------+ | For a list of EVE commands and other topics, type a question mark. | | | | For help on VAXTPU built-ins, see help on TPU. | | | | For a keypad diagram, press HELP. (With VT100 keypad, press PF2.) | | | | For a list of defined keys, see help on Keys or press GOLD-HELP. | | | | To exit from HELP and resume editing, press RETURN. | +--------------------------------------------------------------------+
Old Gold Key
Pressed Old GOLD Key The key you pressed is normally the GOLD key for the current keypad, but you have set another key as the GOLD key. For example, PF1 is normally the GOLD key for the EDT and WPS keypads, but you may have set F20 as the GOLD key and not otherwise defined PF1. To restore the GOLD key to the default for the current keypad, use the SET NOGOLD KEY command. +-------------------------------------------------------------------+ | For a keypad diagram, press HELP. (With VT100 keypad, press PF2.) | | | | For a list of defined keys, see help on Keys or press GOLD-HELP. | | | | To exit from HELP and resume editing, press RETURN. | +-------------------------------------------------------------------+
Position Cursor
Position Cursor
You can use the mouse to change the position of the cursor (input focus).
This is useful for moving a large distance or from one window to another
when you use multiple windows.
Steps:
1. Point where you want to put the cursor (input focus).
2. Click MB1 -- that is, press and release the mouse button.
EVE then puts the cursor where you are pointing and cancels any select
range or highlighting of found text (from FIND or WILDCARD FIND).
Related topics:
MOUSE WINDOWS
Program
VAXTPU Program Key The key you pressed is defined to execute a VAXTPU program. A VAXTPU program can comprise several statements or procedures. Therefore, there is no HELP topic for that key. Use the SHOW KEY command to find out the statements bound to the key. +-------------------------------------------------------------------+ | For a keypad diagram, press HELP. (With VT100 keypad, press PF2.) | | | | For a list of defined keys, see help on Keys or press GOLD-HELP. | | | | To exit from HELP and resume editing, press RETURN. | +-------------------------------------------------------------------+
Prompts And Responses
Prompts and Responses
If a command or defined key requires more information, such as a file
specification, buffer name, or other parameter, EVE prompts you to type
the required information on the command line.
(Menu items that require additional information use a dialog box.)
For example, if you type the INCLUDE FILE command or if you press a key
defined for that command, EVE prompts you, "File to include:" and you can
do one of the following:
o Type the required information (in this case, the file
specification) and press RETURN to complete the command.
o Simply press RETURN to cancel the operation.
o Press CTRL/B or the up arrow key to recall your previous
responses -- that is, scrolling the prompts buffer ($PROMPTS$).
Scrolling through the prompts buffer is useful to review what you did
earlier in the session -- for example, to check previous search strings
for FIND or REPLACE, numbers for SET RIGHT MARGIN, command strings for
DEFINE KEY, and so on.
Related topics:
CANCELING COMMANDS CHOICES BUFFER MESSAGE BUFFER RECALL
Ruler Keys
Ruler Keys
The WPS Ruler key (GOLD-R) lets you set or change margins, paragraph
indent, and tab stops by moving the cursor in the ruler and pressing the
following keys:
Key Effect with Ruler
----------------------------------------------------------------------
I or i Sets paragraph indent at cursor position in the ruler.
L or l Sets left margin at cursor position in the ruler.
P or P Same as I or i.
R or r Sets right margin at cursor position in the ruler.
S or s Saves ruler settings, prompting for ruler number (0--9).
T or t Sets or cancels tab stop at cursor position in the ruler.
W or w Sets wrap point at cursor position in the ruler.
SPACE Cancels a P, I, or W at cursor position in the ruler.
1234567890 Recalls the ruler of that number.
!@#$%^&*() Saves settings in ruler number 0--9. For example,
type ! for ruler 1, @ for ruler 2, and so on.
HELP Displays help on RULER KEYS.
RETURN or Exits from the ruler and resumes editing.
GOLD-RETURN
To move the cursor within the ruler, use the following keys:
Key Effect in Ruler
----------------------------------------------------------------------
LEFT arrow Moves left one column in the ruler.
RIGHT arrow Moves right one column in the ruler.
CTRL/H Moves to the start of the ruler.
CTRL/E Moves to the end of the ruler.
TAB Moves to the next or previous tab stop (T) in ruler.
KP0 (WPS Advance) Moves right and sets the ruler to FORWARD direction.
KP1 (WPS Backup) Moves left and sets the ruler to REVERSE direction.
KP2 (WPS Line) Moves to the start of or end of the ruler.
KP4 (WPS Word) Moves to the next or previous setting indicator --
I, L, P, R T, or W.
o Setting the margins, paragraph indent, and wrap point do NOT by
themselves reformat or rewrap text in the buffer. To reformat text,
use FILL commands.
o Paragraph indent done with the ruler (P or I) is an absolute value,
whereas done with the SET PARAGRAPH INDENT command it is relative to
the left margin.
o Setting tab stops affects existing tabs in the current buffer, if they
were entered with the tab mode set to INSERT. The new tab stops are
immediately applied to the buffer you were editing.
o Only one ruler can be active per buffer. Rulers cannot be embedded in
a file or saved from session to session.
Hint: You can define a key for the WPS Ruler key without setting the WPS
keypad. For example, the following command defines F20 as the WPS
Ruler key: DEFINE KEY= F20 WPS GOLD-R
Related topics:
SET LEFT MARGIN SET PARAGRAPH INDENT SET RIGHT MARGIN
SET TABS SHOW WPS DIFFERENCES
Scroll Bars
Scroll Bars
On DECwindows, you can use scroll bars to scroll through a buffer without
having to type commands or press defined keys.
To use the vertical scroll bar:
/\ Click MB1 on the stepping arrow to scroll up one line,
__ or press and hold MB1 for continuous scrolling.
| |
| | Click MB1 above the thumb to view the previous screen,
| | or press and hold MB1 for continuous scrolling.
| |
|==| Drag the thumb to scroll to that relative position.
|==|
| | Click MB1 below the thumb to view the next screen,
| | or press and hold MB1 for continuous scrolling.
| |
|__| Click MB1 on the stepping arrow to scroll down one line,
\/ or press and hold MB1 for continuous scrolling.
Similarly, use the horizontal scroll bar to move left and right. For
example, clicking MB1 to right of the thumb shifts the window to the right
(typically to view very wide text).
Note: You cannot use scroll bars to scroll the Choices buffer or when
viewing HELP. Instead, use the NEXT SCREEN and PREV SCREEN keys.
Related topics:
NEXT SCREEN POSITION CURSOR PREVIOUS SCREEN
SHIFT LEFT SHIFT RIGHT WHAT LINE
Section Files
Section Files
A section file is a binary file to save key definitions and other
extensions for future editing sessions -- effectively, your own customized
version of EVE.
o To create a section file, use the SAVE EXTENDED EVE command and specify
the name of the section file. The default file type is .TPU$SECTION.
o To use a section file, invoke VAXTPU using the /SECTION qualifier or
define the logical name TPU$SECTION (particularly if there is a section
file you want to use for all or most sessions). Use a complete file
specification, including the device (disk) and directory. Otherwise,
VAXTPU assumes the section file is in SYS$SHARE. For more information,
see DCL help on EDIT/TPU/SECTION.
o For example, the following command invokes VAXTPU, using a section file
called MYSEC.TPU$SECTION in your top-level (or login) directory:
$ EDIT/TPU/SECTION=sys$login:mysec
o You use one section file at a time. Section files are cumulative --
creating a section file saves the current key definitions and
extensions, including any already saved in the section file you are
using.
o Margins, tabs, and other editing preferences are NOT saved in a section
file unless you used a procedure called TPU$LOCAL_INIT in a VAXTPU
command file. Therefore, you may want to use an EVE initialization
file or VAXTPU command file for these settings.
o The default EVE section is SYS$SHARE:EVE$SECTION.TPU$SECTION. To find
out the name of your current section file, use the SHOW SUMMARY
command.
Related topics:
COMMAND FILES INITIALIZATION FILES SAVE EXTENDED EVE
Sequence
Learn Sequence Key The key you pressed is defined for a LEARN sequence. A learn sequence can comprise several keystrokes or commands. Therefore, there is no HELP topic for that key. +-------------------------------------------------------------------+ | For a keypad diagram, press HELP. (With VT100 keypad, press PF2.) | | | | For a list of defined keys, see help on Keys or press GOLD-HELP. | | | | To exit from HELP and resume editing, press RETURN. | +-------------------------------------------------------------------+
Status Line
Status Line
The status line shows information about the buffer in the current EVE
window and lets you toggle some buffer settings.
Buffer name Usually the same as the name of the file specified
when you invoked EVE or when you use the OPEN, OPEN
SELECTED, or GET FILE command. Click MB1 on the
buffer name to toggle between or cycle through several
buffers (same as the NEXT BUFFER command).
Editing status Typically, either Read-only or Write. (See help on the
SET BUFFER command.) Click MB1 to toggle the setting.
Mode Insert, Overstrike, or Unmodifiable. (See help on the
CHANGE MODE command.) Click MB1 to toggle the setting.
Direction Either Forward or Reverse. (See help on the CHANGE
DIRECTION command.) Click MB1 to toggle the setting.
Each window you create in EVE has its own status line. For more
information, see help on Windows.
Related topics:
CHANGE DIRECTION CHANGE MODE NEXT BUFFER SET BUFFER
Stuff
Stuff
On DECwindows, use MB3 to transfer (or "stuff") a select range from EVE
into another application, or conversely, without having to use the
clipboard.
Steps:
To stuff text from EVE into another application:
1. If necessary, change the input focus to EVE.
2. Select text in an EVE buffer.
3. Point where you want to stuff the select range into the other
application, and click MB3.
To stuff text into EVE from another DECwindows application:
1. Change the input focus to another DECwindows application.
2. Select text in that application, such as the Notepad editor.
3. Point where you want to stuff the select range into EVE,
and click MB3.
Stuffing into EVE inserts text whether the mode of the buffer is insert or
overstrike, and uses the current left margin of the buffer.
Related topics:
COPY CUT PASTE SELECT SET CLIPBOARD
Typing Keys
Typing Keys
Typing keys on the main keyboard are for entering characters.
o You can define typing keys in combination with either the CTRL key or
the GOLD key. For example, the following command defines the
combination of GOLD and the letter F as the FILL command:
DEFINE KEY= gold-f fill
o By default, the numeric keypad keys (KP0---KP9, MINUS, COMMA, and
PERIOD) are also typing keys, except with the VT100 keypad. For
example, pressing KP8 is the same as typing the number 8, and pressing
COMMA on the keypad is the same as typing a comma on the main keyboard.
o You can define keys on the numeric keypad without using CTRL or GOLD.
The numeric keypad is also defined by some SET KEYPAD commands. For
example, the VT100 keypad defines KP8 as REMOVE and defines COMMA as
ERASE WORD.
o If you use SET PENDING DELETE and then select text, typing new
characters replaces the select range with the new characters. The
default setting is NOPENDING DELETE. To reinsert what you deleted, use
the RESTORE SELECTION command.
o If you used the VAXTPU built-in DEFINE_KEY 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 that is normally bound to
that key. For example, if you have defined the tilde to execute a
procedure, you can insert a tilde character by doing the following:
1. Use the QUOTE command or press CTRL/V.
2. At the prompt, type a tilde (~).
Related topics:
CONTROL KEYS DEFINE KEY GOLD KEYS SET PENDING DELETE
Unknown
Undefined Key
The key you pressed is undefined or unknown for HELP.
To define the key, use the DEFINE KEY, LEARN, or SET GOLD KEY command.
Also, some SET KEYPAD commands may define the key, such as SET KEYPAD EDT
or SET KEYPAD WPS.
If you use the DEFINE_KEY built-in, such as in a VAXTPU command file,
include a comment in the definition, indicating the command you are
binding to the key. The comment tells EVE the help topic to display for
that key and the label to use in the keypad diagram. For example, in the
following statement, "Split_Window" is the key comment:
DEFINE_KEY ("eve_split_window (3)", PF3, "Split_Window");
+-------------------------------------------------------------------+
| For a keypad diagram, press HELP. (With VT100 keypad, press PF2.) |
| For a list of defined keys, see help on Keys or press GOLD-HELP. |
+-------------------------------------------------------------------+
VT100 Keypad
~GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG~
_______________________________ _______________________________
|~UP~ | | | | |~PF1~ | | | |
| | | | | | | | | |
|_______|_______|_______|_______| |_______|_______|_______|_______|
| | | | |
To get help on commands, type a | | | | |
command or ? and press RETURN. |_______|_______|_______|_______|
| | | | |
For a list of all key definitions, | | | | |
type KEYS and press RETURN, or |_______|_______|_______|_______|
press GOLD-HELP. | | | | |
| | | | |
To show a key definition, use the |_______|_______|_______| |
command SHOW KEY. | | | |
| | | |
|_______________|_______|_______|
~XXXXXXXXXXXXXXXXXXXXXXX~
~XXXXXXXXXXXXXXXXXXXXXXX~
VT200 Keypad
~GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG~
_______________________ _______________________________
To get help on |~F15~ | | |~F17~ | | | |
commands, type | | | | | | | |
a command or ? |_______|_______________| |_______|_______|_______|_______|
and press _______________________ _______________________________
RETURN. | | | | |~PF1~ | | | |
| | | | | | | | |
For a list of |_______|_______|_______| |_______|_______|_______|_______|
all key defini- | | | | | | | | |
tions, type | | | | | | | | |
KEYS and press |_______|_______|_______| |_______|_______|_______|_______|
RETURN, or press | | | | | | |
GOLD-HELP. | | | | | | |
_______|_______|_______ |_______|_______|_______|_______|
To show a key | | | | | | | | |
definition, use | | | | | | | | |
SHOW KEY. |_______|_______|_______| |_______|_______|_______| |
| | | |
~XXXXXXXXXXXXXXXXXXXXXXX~ | | | |
~XXXXXXXXXXXXXXXXXXXXXXX~ |_______________|_______|_______|
VT200 Mini Pad
~GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG~
_______________________________ _______________________
|~F11~ | | | | |~F15~ | |
| | | | | | | |
|_______|_______|_______|_______| |_______|_______________|
_______________________
To get help on commands, type a | | | |
command or ? and press RETURN. | | | |
|_______|_______|_______|
For a list of all key definitions, | | | |
type KEYS and press RETURN, or | | | |
press GOLD-HELP. |_______|_______|_______|
| |
To show a key definition, use the | |
command SHOW KEY. _______|_______|_______
| | | |
| | | |
|_______|_______|_______|
~XXXXXXXXXXXXXXXXXXXXXXX~
~XXXXXXXXXXXXXXXXXXXXXXX~
Windows
Windows
Windows in EVE are areas of the screen for displaying buffers you edit or
other information, such as commands and messages.
Using multiple windows in EVE lets you view or edit different buffers at
the same time or different parts of the same buffer. For example:
(1) Initially, (2) Use TWO (3) Use OPEN to (4) Use PREVIOUS
you have one, WINDOWS to form put another file WINDOW to return
large window. two windows. in the new window. to MEMO.TXT.
+------------+ +------------+ +------------+ +------------+
|[] cursor | | | | | |[] |
| | | MEMO.TXT | | MEMO.TXT | | MEMO.TXT |
| | |------------| |------------| |------------|
| | |[] | | [] | | |
| MEMO.TXT | | MEMO.TXT | | SALES.DAT | | SALES.DAT |
+------------+ +------------+ +------------+ +------------+
You are editing Both windows Thus, you view For example, you
a file called show the same both files at can cut and paste
MEMO.TXT. buffer. the same time. between files.
o Each window has its own status line, showing the name of the buffer in
that window and other information about the buffer (such as its mode
and direction). For more information, see help on Status Line.
o To resize the windows, use SHRINK WINDOW and ENLARGE WINDOW commands.
The maximum number and size of windows depend on the size and type of
your screen.
o To delete the current window, use the DELETE WINDOW command. To
restore a single, large window, use the ONE WINDOW command.
o Multiple windows are also useful in compiling VAXTPU procedures. Use
one window for the buffer containing your procedures, and another
window for the message buffer, so you can read compiler messages more
easily. For more information, see help on Message Buffer.
Related topics:
DELETE WINDOW ENLARGE WINDOW NEXT WINDOW ONE WINDOW
PREVIOUS WINDOW SHRINK WINDOW SPLIT WINDOW TWO WINDOWS
WPS Differences
WPS Differences
SET KEYPAD WPS provides most WPS keypad functions for "GOLD-key editing."
It does NOT fully implement or emulate WPS. Here is a list of differences
between the WPS keypad in EVE and real WPS:
Keys
o Setting the WPS keypad makes PF1 the GOLD key unless you set another
key as GOLD. If you define keys that WPS ordinarily defines, such
as KP5 or GOLD-R, your definitions override the WPS definitions.
o The WPS keypad defines GOLD-[ as DO for typing EVE commands, and
defines both GOLD-> and CTRL/K as LEARN. To end a learn sequence,
press REMEMBER (CTRL/R key) or the WPS Halt key (GOLD-`).
o Some WPS keypad definitions use the corresponding EVE commands,
which may have slighlty different names but are usually functionally
identical to WPS.
o The RESTORE SENTENCE command reinserts what you last erased with the
WPS Delete Beginning Sentence key (GOLD-F13 or GOLD-CTRL/J).
Setting the WPS keypad does NOT define a key for RESTORE SENTENCE.
Therefore, you may want to define a key for RESTORE SENTENCE.
o Setting the WPS keypad defines both GOLD-PF3 and GOLD-PF4 as
RESTORE, which reinserts what you last erased with Delete Word key
(PF3), Delete Beginning Sentence key, ERASE LINE command, and so on,
but does not put back the last character erased or deleted.
Therefore, you may want to redefine GOLD-PF3 as RESTORE WORD and
redefine GOLD-PF4 as RESTORE CHARACTER.
o When you are in the Buffer List buffer, the WPS Cut key deletes a
buffer without your having to type the buffer name.
Paste Buffers and the Clipboard
WPS keypad functions do NOT use the DECwindows clipboard. For example,
the WPS Copy, Cut, and Paste keys use EVE's Insert Here buffer or an
alternate paste buffer you specify by number (GOLD-1 through GOLD-9).
EVE commands and EDT keypad functions use either the Insert Here buffer
or the clipboard, depending on your setting. See help on the SET
CLIPBOARD command.
Rulers
When you use the WPS Ruler key (GOLD-R), only one ruler can be active
at a time. Rulers cannot be embedded in a document. Setting margins
or paragraph indent does NOT automatically rewrap or reformat text. To
reformat text, use FILL commands. For more information, see help on
Ruler Keys.
Scrolling
Scrolling with WPS keypad functions is halted when you press any key --
not just the WPS Halt key (GOLD-`). Pressing a key to stop scrolling
executes whatever function is assigned to that key.
Bound and Free Cursor
Setting the WPS keypad automatically sets the cursor to bound, which
follows the shape of your text. To enable a free cursor, use the SET
CURSOR FREE command, which is otherwise the EVE default setting.
Page Breaks and Pagination
o The WPS keypad defines the following keys for pagination:
GOLD-N ..... INSERT PAGE BREAK ... inserts a hard page break
GOLD-P ..... WPS Page Marker ..... inserts a soft page break
PF2 ........ MOVE BY PAGE ........ puts the cursor on a page break
GOLD-PF2 ... PAGINATE ............ soft break for 54-line page
o A "hard" page break is a form feed (appearing as a small FF on a
line by itself). A "soft" page break is a form feed followed by the
null character (a small NL).
Searches
Searches follow EVE rules for case sensitivity and direction. For more
information, see help on the FIND command.
Paragraph and Sentence Boundaries
"Paragraphs" are bounded by blank lines, the top or bottom of the
buffer, page breaks, or Runoff commands (such as .Blank). "Sentences"
are bounded by periods, question marks, or exclamation points. Periods
in Runoff commands or in decimal numbers are treated as sentence
boundaries.
Centering a Line
The WPS keypad defines GOLD-C as CENTER LINE, which uses spaces to
center the current line between the left and right margins. It does
not leave a centering mark.
Exiting
Exiting does not delete the old version of the input file. Also, if
the buffer or buffers have not been modified (or already written out
and not modified since then), EXIT and QUIT are the same -- no new file
is produced. EVE defines both F10 and CTRL/Z as EXIT. The WPS keypad
defines GOLD-F as EXIT and defined GOLD-K as QUIT.
Help
For a keypad diagram, press HELP (or with the WPS keypad, GOLD-H).
For a list of all key definitions, press GOLD-HELP.
Features NOT Implemented
o Abbreviation or library documents
o Control commands for printing
o Editor math
o Footnotes, paragraph numbering, and table of contents
o Hyphenation and non-breaking spaces
o Output files other than ASCII
o Superscripts, subscripts, or composite characters
o VIEW mode
o TDE (two-dimension editor)
o UDP (user-defined WPS procedures)
o Word-wrap returns (In EVE, all lines end in a "hard" return.)
Related topics:
RULER KEYS SET KEYPAD NOWPS SET KEYPAD WPS