EVE — VMS 5.4
Additional information available:
@ATTACHBOTTOMBOX_COPYBOX_CUTBOX_CUT_INSERT
BOX_CUT_OVERSTRIKEBOX_PASTEBOX_PASTE_INSERT
BOX_PASTE_OVERSTRIKEBOX_SELECTBUFFERCAPITALIZE_WORD
CENTER_LINECHANGE_DIRECTIONCHANGE_MODECONVERT_TABS
COPYCUTDCLDEFINE_KEYDEFINE_MENU_ENTRY
DELETEDELETE_BUFFERDELETE_WINDOWDOEND_OF_LINE
ENLARGE_WINDOWERASE_CHARACTERERASE_LINEERASE_PREVIOUS_WORD
ERASE_START_OF_LINEERASE_WORDEVEEXIT
EXTEND_ALLEXTEND_EVEEXTEND_THISEXTEND_TPU
FILLFILL_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_BUFFERPREVIOUS_SCREEN
PREVIOUS_WINDOWQUITQUOTERECALLRECOVER_BUFFER
RECOVER_BUFFER_ALLREFRESHREMEMBERREMOVE
REPEATREPLACERESETRESTORERESTORE_CHARACTER
RESTORE_LINERESTORE_SELECTIONRESTORE_SENTENCERESTORE_WORD
RETURNREVERSESAVE_ATTRIBUTESSAVE_EXTENDED_EVE
SAVE_EXTENDED_TPUSAVE_FILESAVE_FILE_ASSAVE_SYSTEM_ATTRIBUTES
SELECTSELECT_ALLSET_BOX_NOPADSET_BOX_NOSELECT
SET_BOX_PADSET_BOX_SELECTSET_BUFFERSET_CLIPBOARD
SET_CURSOR_BOUNDSET_CURSOR_FREESET_DEFAULT_COMMAND_FILE
SET_DEFAULT_SECTION_FILESET_EXIT_ATTRIBUTE_CHECKSET_FIND_CASE_EXACT
SET_FIND_CASE_NOEXACTSET_FIND_NOWHITESPACESET_FIND_WHITESPACE
SET_FUNCTION_KEYS_DECWINDOWSSET_FUNCTION_KEYS_NODECWINDOWS
SET_GOLD_KEYSET_JOURNALINGSET_JOURNALING_ALL
SET_KEYPAD_EDTSET_KEYPAD_NOEDTSET_KEYPAD_NOWPSSET_KEYPAD_NUMERIC
SET_KEYPAD_VT100SET_KEYPAD_WPSSET_LEFT_MARGINSET_NOCLIPBOARD
SET_NODEFAULT_COMMAND_FILESET_NODEFAULT_SECTION_FILE
SET_NOEXIT_ATTRIBUTE_CHECKSET_NOGOLD_KEYSET_NOJOURNALING
SET_NOJOURNALING_ALLSET_NOPENDING_DELETESET_NOSECTION_FILE_PROMPTING
SET_NOSHIFT_KEYSET_NOWRAPSET_PARAGRAPH_INDENT
SET_PENDING_DELETESET_RIGHT_MARGINSET_SCROLL_MARGINS
SET_SECTION_FILE_PROMPTINGSET_SHIFT_KEYSET_TABSSET_WIDTH
SET_WILDCARD_ULTRIXSET_WILDCARD_VMSSET_WRAPSHIFT_LEFT
SHIFT_RIGHTSHOWSHOW_BUFFERSSHOW_DEFAULTS_BUFFER
SHOW_KEYSHOW_SUMMARYSHOW_SYSTEM_BUFFERS
SHOW_WILDCARDSSHRINK_WINDOWSPAWNSPELLSPLIT_WINDOW
START_OF_LINESTORE_TEXTTABTOPTWO_WINDOWS
UNDEFINE_KEYUNDEFINE_MENU_ENTRYUPPERCASE_WORD
WHAT_LINEWILDCARD_FINDWRITE_FILE
AbbreviatingAboutAttributesAttributes BoxAvailable Entries
Available MenusBuffer AttributesCanceling CommandsChange Case
Choices BufferClipboardCommandsCommand FilesControl Keys
Customize MenuDECwindows DifferencesDefaultsDialog BoxesDisplay Menu
Editing Command LinesEdit MenuEDT ConversionEDT Differences
Entries MenusEVE VT100 << To get help on commands, type a command or ? and press
EVE VT200 << To get help on commands, type a command or ? and pressExtend Menu
Extend submenuFile MenuFind Case ExactFormat MenuGlobal Attributes
Global Pending DeleteGold KeysHelp MenuInitialization FilesJournal Files
Keypad CaptionsKeys << To get help on commands, type a command or ? and press RETURN.>>
LK201 TemplateLK201 Wide TemplateMail EditingMenusMessage Box
Message BufferModifiableMouseNames For KeysNew Features
New UserNot ImplementedOld Gold KeyPending Delete
Position CursorProgramPrompts And ResponsesQuick CopyRanges And Boxes
Read OnlyReallydelbuffReplace AllRestore submenuRuler KeysScroll Bars
Search AttributesSearch MenuSection FilesSequenceSet Box Pad menu
Set Box Select menuSet MarginsSet WhitespaceSet Wildcards
Status LineTabs VisibleTab ModesTab StopsTyping KeysUnknownVT100 Keypad
VT100 TemplateVT200 KeypadVT200 Mini PadWindows
Word WrapWPS DifferencesWritedelprompt
Abbreviating
Abbreviating
You can abbreviate EVE commands so long as your abbreviation is not
ambiguous. 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
----------------------------- --------------------------
EN W or ENL ENLARGE WINDOW SE B P SET BOX PAD
ER W or E WO ERASE WORD SE B W SET BUFFER WRITE
GE GET FILE SH B SHOW BUFFERS
GO GO TO S K SHOW KEY
I H INSERT HERE S K E SET KEYPAD EDT
I M INSERT MODE SE W SET WIDTH
I P INSERT PAGE BREAK SE W V SET WILDCARD VMS
QUI QUIT SH SHOW
QUO QUOTE SH WIL SHOW WILDCARDS
REPE REPEAT SH WIN SHRINK WINDOW
REPL REPLACE SP W SPLIT WINDOW
RESE RESET STA START OF LINE
REST RESTORE STO STORE TEXT
R SEL RESTORE SELECTION WI WILDCARD FIND
R SEN RESTORE SENTENCE WR WRITE FILE
Similarly, you can abbreviate the following:
o Buffer names ......... for the BUFFER command
o Marker names ......... for the GO TO command
o Keyword parameters ... for SET BUFFER and SET TABS
o Keyword responses .... for FIND, DELETE BUFFER, REPLACE, and so on
o Procedure names ...... for EXTEND EVE or EXTEND TPU
o Key names ............ for DEFINE KEY, SHOW KEY, and so on
You CANNOT abbreviate the following:
o Buffer names ...... for DELETE BUFFER and RECOVER BUFFER
o Menu names ........ for DEFINE MENU ENTRY and UNDEFINE MENU ENTRY
o Procedure names ... 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).
Examples:
Abbreviations Full commands
---------------------------------------
BU MES BUFFER MESSAGES
SE BU R SET BUFFER READ_ONLY
SE TA SP SET TABS SPACES
D K=G-REM B CUT DEFINE KEY= GOLD-REMOVE BOX CUT
Hint: In writing EVE 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 Editing Command Lines
List Of Topics Names For Keys Prompts And Responses
About
About
© Digital Equipment Corporation. 1990. All Rights Reserved.
Related topics:
List Of Topics New Features New User
Attributes
Attributes
Global attributes are settings that apply in all buffers and can be saved
in a section file or as EVE-generated code in a command file, so you can
have the same settings for future editing sessions:
SET BOX PAD [NO]PAD SET [NO]EXIT ATTRIBUTE CHECK
SET BOX [NO]SELECT SET FIND CASE [NO]EXACT
SET [NO]CLIPBOARD SET [NO]PENDING DELETE
SET CURSOR BOUND or FREE SET [NO]SECTION FILE PROMPTING
SET [NO]DEFAULT COMMAND FILE SET TABS INSERT, MOVEMENT, or SPACES
SET [NO]DEFAULT SECTION FILE SET TABS [IN]VISIBLE
Other global settings are not saved, such as scroll margins or type of
wildcards. Buffer settings, such as margins and tab stops, are not saved.
Attributes and Section Files
o A section file is in binary form so it loaded quickly at startup,
but it cannot be printed or edited. In effect, the section file is
your own, customized version of EVE.
o To create a section file, use SAVE ATTRIBUTES or SAVE EXTENDED EVE.
A section file saves the following:
* Compiled procedures
* Global attributes (see list above)
* Key definitions (including LEARN sequences)
* Menu definitions for the DECwindows interface
o If you always want to save in a section file, you can use (and save)
the following commands, so that when you save attributes, EVE
creates a new version of your default section file without prompting
for the file name. This also makes attribute saving faster because
there are fewer prompts.
Command: SET NOSECTION FILE PROMPTING
Command: SET DEFAULT SECTION FILE
For more information, see help on Section Files.
Attributes and Command Files
o A command file contains TPU procedures and statements which are
compiled and executed at startup---in effect, a series of TPU
programs for extending EVE. A command file may be slower at startup
than a section file, but it takes up less disk space and it can be
edited and printed.
o When you use SAVE ATTRIBUTES, you can have EVE create or update a
command file. EVE then generates a specially marked block of TPU
statements for---
* Global attributes (see list above)
* Menu definitions for the DECwindows interface
Thus, if you created a command file containing TPU procedures and
key definitions of your own, you can have EVE add the block of
statements to this command file. If there is already an attribute
block in the command file, EVE replaces it with the new block.
o If you always want to save in a command file, you can use (and save)
the following commands, so that when you save attributes, EVE
prompts for a command file and shows the name of your default
command file in the prompt line. This also makes attribute saving
faster because there are fewer prompts.
Command: SET NOSECTION FILE PROMPTING
Command: SET NODEFAULT SECTION FILE
Command: SET DEFAULT COMMAND FILE
For more information, see help on Command Files.
Attributes and Initialization Files
o Another method for setting and saving attributes is to create an
initialization file (typically, EVE$INIT.EVE) containing the
commands you want executed at startup. This is particularly useful
to set margins, tab stops, and other attributes that are applied to
the $DEFAULTS$ buffer. See help on Defaults.
o At startup, an initialization file is slower than a section file or
command file, depending on how many commands are to be executed.
For example, if you have several key definitions, you should save
them in a section file. For more information, see help on
Initialization Files.
Attribute Checking and Exiting
o On exiting or quitting, if you changed attributes and have not saved
them, EVE asks you whether to save your changes. If you respond
Yes, EVE does a SAVE ATTRIBUTES.
o To simplifiy or speed up exiting and quitting, you can use (and
save) SET NOEXIT ATTRIBUTE CHECK. This is also useful if you
frequently change global settings but do not want to save the
changes.
o SET NOEXIT ATTRIBUTE CHECK does not apply to the current editing
session, but only to subsequent sessions in which you use the
section file or command file in which you saved the setting.
Related topics:
Command Files Defaults Initialization Files
Section Files SAVE ATTRIBUTES SAVE SYSTEM ATTRIBUTES
Attributes Box
Save Attributes or Save System Attributes
Lets you save global attributes and other customizations by creating a
section file, or by creating or updating a command file.
Steps:
1. Choose Save Attributes from the Customize menu.
Usually, a dialog box appears with a list of the current settings. To
scroll the list, use the scroll bar on the right of the box.
2. To save your settings, click MB1 on the button for saving in a section
file or on the button for saving in a command file.
You can type the name of the file on the entry line to the right of
the button. If you set a default section file or default command
file, that file name appears in the respective entry line.
3. When you finish, click on OK or CANCEL.
Note that clicking on CANCEL is the same as clicking on DONT'T SAVE and
then on OK.
Related topics:
Attributes SAVE ATTRIBUTES SAVE SYSTEM ATTRIBUTES
Available Entries
Available Entries
Lists the EVE commands (menu items) available for menus.
Steps:
1. To enter or delete commands in the list, do either of the following:
o Click MB1 on a command in the Available Entries list.
(To scroll the list, use the scroll bar at the right.)
o Type the EVE command on the line just below the list.
2. You can then type the label for the menu entry---for example, if you
are adding the SHOW BUFFERS command to a menu, you can have it appear
as Buffer List instead.
3. To add a command ...... click on ENTER (or press RETURN).
To delete a command ... click on DELETE.
Entering or deleting a command in the Available Entries list does not by
itself change the contents of any pull-down or pop-up menus, but only
changes which commands appear in the list.
Related topics:
Menus DEFINE MENU ENTRY UNDEFINE MENU ENTRY
Available Menus
Available Menus
Lists the EVE menus in which you can add or delete menu items.
Steps:
1. Point to the name of the menu you want to change.
(To scroll the list, use the scroll bar at the right.)
2. Click MB1 on the menu name, such as Select Popup or File Pulldown.
The items in that menu then appear in the list to the right (Entries in
Selected Menu) so you can add or remove a menu item.
Related topics:
Menus DEFINE MENU ENTRY UNDEFINE MENU ENTRY
Buffer Attributes
Buffer Attributes...
Lets you toggle or choose settings that apply to the current buffer:
o Set Left Margin and Set Right Margin
o Set Wrap
o Set Buffer Modifiable
o Set Buffer Read_Only
o Set Tabs At or Set Tabs Every
o Set Paragraph Indent
Steps:
1. Choose Buffer Attributes from the Customize menu.
2. Click MB1 on the settings you want, and type any required
information, such as the column for the left margin.
3. To apply the settings, click on APPLY (which keeps the dialog box
displayed) or click on OK (which dismisses the dialog box).
To discard any changes, click on CANCEL.
Usage notes:
o Changing buffer attributes does not affect existing text, except if you
change the tab stops. For example, changing the margins or paragraph
indent does not reformat or rewrap existing text. To reformat your
text according to the new settings, use FILL.
o To use the same settings for all your buffers, put the relevant
commands in an initialization file (typically, EVE$INIT.EVE) and use
that file when you invoke EVE. For example, if your initialization
file has the command SET RIGHT MARGIN 70, the setting applies to the
Main (or first) buffer and to an EVE system buffer named $DEFAULTS$, so
that each buffer you create has the same right margin. See help on
Initialization Files.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Defaults Dialog Boxes Menus Mouse
Canceling Commands
Canceling Commands
If an EVE command prompts you for more information, such as a file name,
buffer name, search string, or other parameter, you can cancel the
operation by simply pressing RETURN or DO without typing a response.
o For example, INCLUDE FILE prompts you for the name of the file you want
to include. To cancel the operation, simply press RETURN at the prompt
without typing anything.
o Similarly, 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 or CTRL/M, which cannot be defined.
Likewise, you can press the RETURN key or CTRL/M to cancel DEFINE KEY,
SET GOLD KEY, or UNDEFINE KEY.
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 (such as, GOLD-SELECT).
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.
o CTRL/C usually halts an operation, such as a repeat or global replace.
However, if you are using keystroke journaling (instead of buffer-
change journaling), CTRL/C is not recorded in the keystroke journal
file. If you use CTRL/C, you should immediately exit, to save your
edits. Otherwise, if the system fails, you may not be able to recover
your work. This restriction does not apply with buffer-change
journaling.
Related topics:
Choices Buffer Editing Command Lines Prompts And Responses
Change Case
Change Case [->
Lets you change the case of letters without having to retype the text.
Steps:
1. Point to Change Case and drag the mouse to the right
to display your choices:
CAPITALIZE WORD ... First letter uppercase, others lowercase
LOWERCASE WORD .... All letters lowercase
UPPERCASE WORD .... All letters uppercase
2. Drag the mouse to the command you want and release the mouse.
Each of these commands works on a range, box, or single word.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
Ranges And Boxes BOX SELECT FIND SELECT WILDCARD FIND
Choices Buffer
Choices Buffer
The $CHOICES$ buffer appears if you type an ambiguous command. It lists
the possible matches so you can choose the one you want.
Example:
1. You use the following command to edit a file with the type .TXT:
Command: GET FILE *.txt
2. If more than one file matches your request, EVE puts the $CHOICES$
buffer into a second window, listing the matching files. For
example, there may be two files, LETTER.TXT and MEMO.TXT.
3. EVE recalls the command, putting the cursor at the end of the
command line so you can type your choice. For example, type L*.TXT
or M*.TXT---and press RETURN to complete the command.
Usage notes:
o Alternatively, you can select something from the $CHOICES$ buffer in
any of the following ways:
* 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.
* Press a key defined as NEXT WINDOW or PREVIOUS WINDOW to put the
cursor into the $CHOICES$ buffer. Then move to the choice you want
and press DO.
* Put the cursor into the $CHOICES$ buffer. Move to the choice you
want. Press SELECT to copy the choice onto the command line. Move
back to the command window. You can edit the command line, if
necessary. Press RETURN to execute the command.
o To scroll the list of choices, press NEXT SCREEN and PREV SCREEN.
o To cancel the $CHOICES$ buffer display---and discard the command line
---press a key defined as RESET (such as GOLD-SELECT).
o EVE does not display the $CHOICES$ buffer if you specify a file using a
search list or if you use wildcards for the directory (such as [...]).
Instead, EVE ues the first matching file found. For example, the
following command gets the first MEMO.TXT file found:
Command: GET FILE [...]memo.txt
Related topics:
Abbreviating Canceling Commands Editing Command Lines
Prompts And Responses Reset Windows
Clipboard
Set Clipboard
Determines whether EVE uses the DECwindows clipboard or the Insert Here
buffer. for copy, cut, and paste operations.
Usage notes:
o Typically you enable the clipboard to transfer text between EVE and
other DECwindows applications. By default, EVE uses the Insert Here
buffer.
o The clipboard setting affects the following commands and keys.
WPS keys do NOT use the clipboard, regardless of the setting.
EVE Commands EDT Keys
------------------------------ -------------
COPY STORE TEXT BOX COPY Append (KP9)
CUT REMOVE BOX CUT EDT Repl (GOLD-KP9)
PASTE INSERT HERE BOX PASTE Subs (GOLD-ENTER)
o To save your setting for future editing sessions, use SAVE ATTRIBUTES
to create a section file or to create or update a command file (see
help on Attributes). However, for routine editing within EVE, using
the Insert Here buffer may be faster, depending on the amount of text
involved.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Attributes SET CLIPBOARD SET NOCLIPBOARD
Commands
List Of Topics (Commands)
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
BOX OPERATIONS
Box Copy Box Paste Set Box Nopad
Box Cut Box Paste Insert Set Box Noselect
Box Cut Insert Box Paste Overstrike Set Box Pad
Box Cut Overstrike Box Select Set Box Select
Restore Box Selection
SEARCHES
Find Set Find Case Exact Set Wildcard Ultrix
Find Next Set Find Case Noexact Set Wildcard VMS
Find Selected Set Find Nowhitespace Show Wildcards
Replace Set Find Whitespace Wildcard Find
Spell
CURSOR MOVEMENT AND SCROLLING
Bottom Mark Move Right Set Cursor Free
Change Direction Move By Line Move Up Set Scroll Margins
End Of Line Move By Page Next Screen Start Of Line
Forward Move By Word Previous Screen Top
Go To Move Down Reverse What Line
Line Move Left Set Cursor Bound
GENERAL-PURPOSE COMMANDS
Attach Do Help Recall Reset Show
DCL Exit Quit Repeat Return Spawn
FILES AND BUFFERS
Buffer Open Selected Set Journaling
Delete Buffer Previous Buffer Set Journaling All
Get File Recover Buffer Set Nojournaling
Include File Recover Buffer All Set Nojournaling All
New Save File Show Buffers
Next Buffer Save File As Show System Buffers
Open Set Buffer Write File
WINDOWS AND DISPLAY
Delete Window One Window Set Width Shrink Window
Enlarge Window Previous Window Shift Left Split Window
Next Window Refresh Shift Right Two Windows
FORMATTING AND CASE CHANGES
Capitalize Word Insert Page Break Set Paragraph Indent
Center Line Lowercase Word Set Right Margin
Convert Tabs Paginate Set Tabs
Fill Set Left Margin Set Wrap
Fill Paragraph Set Nowrap Tab
Fill Range Uppercase Word
KEY DEFINITIONS
Define Key Set Gold Key Set Keypad VT100
Learn Set Keypad EDT Set Keypad WPS
Remember Set Keypad NoEDT Set Nogold Key
Set Func Key DECwindows Set Keypad NoWPS Show Key
Set Func Key NoDECwindows Set Keypad Numeric Undefine Key
CUSTOMIZING
@ Set Noclipboard
Define Menu Entry Set Nodefault Command File
Extend All Set Nodefault Section File
Extend EVE Set Noexit Attribute Check
Extend This Set Nopending Delete
Save Attributes Set Nosection File Prompting
Save Extended EVE Set Pending Delete
Save System Attributes Set Section File Prompting
Set Clipboard Show Defaults Buffer
Set Default Command File Show Summary
Set Default Section File TPU
Set Exit Attribute Check Undefine Menu Entry
INFORMATIONAL TOPICS
Abbreviating Gold Keys Pending Delete
About Initialization Files Position Cursor
Attributes Journal Files Prompts And Responses
Canceling Commands Keypad (diagram) Quick Copy
Choices Buffer Keys (list) Ranges And Boxes
Command Files List Of Topics Ruler Keys
Control Keys Mail Editing Scroll Bars
DECwindows Differences Menus Section Files
Defaults Message Buffer Status Line
Dialog Boxes Mouse Typing Keys
Editing Command Lines Names For Keys Windows
EDT Conversion New Features WPS Differences
EDT Differences New User
+-------------------------------------------------------------------+
| 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. |
| |
| For help on TPU built-ins, see help on TPU (switches to TPUHELP). |
+-------------------------------------------------------------------+
Command Files
Command Files
A command file contains TPU procedures and statements to customize or
extend EVE, or to create a special environment for building your own TPU
application. Default file type is .TPU.
Example:
The following is a sample TPU command file containing a procedure to
swap or transpose characters, and a key definition for that procedure:
+---------------------------------------------------------------+
| PROCEDURE user_swap_char |
| LOCAL swap_this; |
| swap_this := ERASE_CHARACTER (1); ! Erase current character |
| MOVE_HORIZONTAL (-1); ! Move back one character |
| EVE$INSERT_TEXT (swap_this); ! Insert erased character |
| RETURN (TRUE); |
| ENDPROCEDURE; |
| |
| EVE$DEFINE_KEY ("user_swap_char", KEY_NAME ("s", SHIFT_KEY), |
| "swap char", EVE$X_USER_KEYS); |
+---------------------------------------------------------------+
Usage notes:
o There are three ways to specify a command file for startup:
* Use /COMMAND= and specify the command file
* Define the logical name TPU$COMMAND to specify the command file
* Create a file named TPU$COMMAND.TPU in your current directory
For more information, see DCL help on EDIT/TPU/COMMAND.
o At startup, VAXTPU compiles the procedures in the command file and
executes any statements at the end of the command file, such as
DEFINE_KEY statements. Procedures, settings, and key definitions in
the command file override those in the section file.
o To compile and execute a command file during a session, use commands
such as the following to edit the command file, compile the procedures
it contains, and execute a compiled procedure:
Command: GET FILE procs.tpu
Command: TPU EXECUTE (CURRENT_BUFFER)
Command: TPU user_proc
o When you use SAVE ATTRIBUTES or when you save attributes as part of
exiting or quitting, you can have EVE create or update a command file
to save most global settings and any menu definitions. EVE generates a
specially marked block of TPU statements like the following:
+----------------------------------------+
| ! EVE-generated code begin |
| ! EVE attributes begin |
| eve$set_find_case_sensitivity (FALSE); |
| eve_set_box_noselect; |
| eve_set_box_pad; |
| eve_set_cursor_bound; |
| eve_set_nodefault_command_file; |
| eve_set_nodefault_section_file; |
| eve_set_exit_attribute_check; |
| eve_set_pending_delete; |
| eve_set_nosection_file_prompting; |
| eve_set_tabs ('INSERT'); |
| eve_set_tabs ('VISIBLE'); |
| ! EVE attributes end |
| ! EVE-generated code end |
+----------------------------------------+
o If you always want to save in a command file, you can use (and save)
the following commands, so that SAVE ATTRIBUTES prompts for a command
file (without first prompting for a section file) and shows the name of
your default command file in the prompt line:
Command: SET NOSECTION FILE PROMPTING
Command: SET NODEFAULT SECTION FILE
Command: SET DEFAULT COMMAND FILE
Related topics:
Attributes Initialization Files Section Files
SAVE ATTRIBUTES SET DEFAULT COMMAND FILE 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.
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 EDT CTRL/Z ... Exit
or WPS keypad)
Usage notes:
o When you edit a command line, CTRL/J (or any key defined as ERASE WORD)
works like ERASE PREVIOUS WORD, to emulate DCL command-line editing.
o Setting the EDT or WPS keypad redefines CTRL/J as Delete Previous Word.
The EDT keypad also redefines CTRL/H and CTRL/U slightly differently
from the default EVE definitions.
o You can define most control keys by using DEFINE KEY or LEARN. In
naming control keys, use a dash, slash, or underscore in the key name
(for example, CTRL/A, CTRL-A, or CTRL_A are the same), or use the
circumflex (for example, ^A). The case of the letters does not matter
(for example, CTRL/A and CTRL/a are the same). For more information,
see help on Names For Keys.
o Some control keys cannot be defined unless your terminal is set
accordingly (see help on TPU Nondefinable Keys). Typically, the
operating system traps the following control keys:
CTRL/C CTRL/O CTRL/Q CTRL/S CTRL/T CTRL/X CTRL/Y
o CTRL/C usually halts an operation, such as a repeat or global replace.
However, if you are using keystroke journaling (instead of buffer-
change journaling), CTRL/C is not recorded in the keystroke journal
file. If you use CTRL/C, you should immediately exit, to save your
edits. Otherwise, if the system fails, you may not be able to recover
your work. This restriction does not apply with buffer-change
journaling, which is the EVE default.
o If you redefine CTRL/R, you should define another key as REMEMBER,
because the REMEMBER command cannot be typed to end a learn sequence.
+---------------------------------------------------------------------+
| For a list of key definitions, see help on Keys or press GOLD-HELP. |
+---------------------------------------------------------------------+
Related topics:
Names For Keys DEFINE KEY LEARN SHOW KEY UNDEFINE KEY
Customize Menu
Customize Menu
Lets you create a learn sequence, extend EVE, add or remove menu items,
set attributes, and so on.
Steps:
1. Point to Customize in the menu bar.
2. Press and hold MB1 to pull down the menu.
3. Drag the mouse to the menu item you want and release MB1.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
Attributes Defaults Dialog Boxes Menus New User
DECwindows Differences
DECwindows Differences
You can use EVE on DECwindows as well as on character-cell terminals.
Generally, EVE commands work the same in either environment. If you
invoke EVE using /INTERFACE=DECWINDOWS, EVE has pull-down and pop-up
menus, scroll bars, and other DECwindows features.
The following is a list of features and restrictions when you use EVE on
DECwindows:
Clipboard Operations
On DECwindows, you can enable the clipboard for copy, cut, and paste
operations. Using the clipboard lets you transfer text between EVE and
other DECwindows applications. By default, copy, cut, and paste
operations in EVE use the Insert Here buffer. WPS keys do not use the
clipboard. See help on SET CLIPBOARD.
Dialog Boxes
If a menu item requires additional information, such as a file name,
search string, or other parameter, EVE displays a dialog box for
entering the information. Typing a command or pressing a defined key
prompts you on the command line, the same as on a character-cell
terminal. Some dialog boxes provide features that are not available
when you use EVE on character-cell terminals, or that are not available
in the same way. For example, the dialog box for REPLACE has an ALL
button so you can specify a global replacement at the same time that
you specify the search and replace strings.
Global Selections
Operations to edit selected text can use a selection in another
DECwindows application, as well as a selection within EVE. For
example, you can select the name of a file listed in another DECwindows
application, and then use OPEN SELECTED in EVE to edit that file in an
EVE buffer. Also you can copy or move the selected text by using MB3
or CTRL/MB3. See help on Quick Copy.
Key Definitions
You can use shifted function keys and ALT key combinations on
DECwindows, but not on character-cell terminals or on DECterm. The
COMPOSE CHARACTER key is the ALT key. To enter a compose character
sequence, use ALT/SPACE.
Menu Entries
On DECwindows, you can add and delete menu items by choosing Extend
Menu from the Customize menu, or by using DEFINE MENU ITEM and UNDEFINE
MENU ITEM commands. (You cannot define or undefine menu items on
character-cell terminals.)
Selecting with the Mouse
On DECwindows, you can use the mouse to select text by simply pointing
to the text you want to select and clicking or dragging MB1 as follows:
1 Click ...... Cancels a selection, and repositions the cursor.
2 Clicks ..... Selects all of the word the pointer is on.
3 Clicks ..... Selects all of the line the pointer is on.
4 Clicks ..... Selects all of the paragraph the pointer is on.
5 Clicks ..... Selects all of the buffer (same as SELECT ALL).
Drag ......... Selects text, starting where you press MB1 and
ending where you release MB1.
Shift/Drag ... Extends or shrinks a selection.
To cancel a selection done with the mouse, you can simply move the
cursor out of the select range. See help on SELECT and on Ranges And
Boxes.
Status Line Indicators
On DECwindows (or on DECterm), the status line comprises a kind of menu
as well as an informational display. To toggle the respective
settings, click MB1 on the indicators in the status line---for example,
to change the direction from forward to reverse or to change the mode
from insert to overstrike. See help on Status Line.
Restrictions
o Keystroke journaling and recovery do not work on DECwindows.
However, buffer-change journaling and recovery work on DECwindows as
well as on character-cell terminals. See help on Journal Files.
o ATTACH, SPAWN, and SPELL do not work with the DECwindows interface.
However, if you run several DECwindows applications concurrently,
you may not need to use subprocesses. The EVE command DCL does work
on DECwindows, because it creates a subprocess differently from
SPAWN and SPELL.
o WPS keys do not use the DECwindows clipboard. For example, the WPS
Cut key uses EVE's Insert Here buffer or a WPS-style alternate paste
buffer, whereas the REMOVE or CUT command uses the clipboard or the
Insert Here buffer, depending on your setting.
o Mouse operations are NOT recorded in a learn sequence.
Related topics:
Menus New Features New User Quick Copy
Defaults
Defaults
Global settings (all buffers) Buffer Settings
+--------------------------------+ +------------------------+
| Set Box Noselect | | Forward |
| Set Box Pad | | Insert Mode |
| Set Cursor Free | | Set Buffer Modifiable |
| Set Exit Attribute Check | | Set Buffer Write |
| Set Find Case Noexact | | Set Journaling All |
| Set Find Nowhitespace | | Set Left Margin 1 |
| Set Function Keys NoDECwindows | | Set Paragraph Indent 0 |
| Set Keypad Numeric or VT100 | | Set Right Margin 79 |
| Set Noclipboard | | Set Tabs Every 8 |
| Set Nodefault Command File | | Set Wrap |
| Set Nodefault Section File | +------------------------+
| Set Nogold Key |
| Set Nopending Delete | NOTE: Most global settings can
| Set Scroll Margins 0 0 | be saved in a section file or
| Set Section File Prompting | as EVE-generated code in a TPU
| Set Tabs Insert | command file. See help on
| Set Tabs Visible | ATTRIBUTES.
| Set Wildcard VMS |
| Set Width 80 |
+--------------------------------+
Usage notes:
o Default width is your terminal setting---typically, 80 columns.
Default right margin is one column less than the width---hence,
typically, 79. See help on SET WIDTH.
o For editing EVE command lines, such as when you recall a command by
pressing CTRL/B, the cursor is bound, default direction is reverse, and
default mode is your terminal setting. See help on Editing Command
Lines.
o Setting the WPS keypad automatically sets the cursor to BOUND.
o Setting the EDT or WPS keypad makes PF1 the GOLD key, overriding any
current definition of PF1. However, if you set a different key as
GOLD, then the EDT or WPS keypad uses your GOLD key without redefining
PF1. See help on Gold Keys.
o Most global settings can be saved in a section file or command file
(see help on Attributes). Key definitions can be saved in a section
file.
o To use the same buffer settings for all your buffers, put the relevant
commands in an initialization file (typically, EVE$INIT.EVE) and use
that file when you invoke EVE. For example, if your initialization
file has the command SET RIGHT MARGIN 70, the setting applies to the
Main (or first) buffer and to an EVE system buffer named $DEFAULTS$, so
that each buffer you create has the same right margin. See help on
Initialization Files.
o To check the current $DEFAULTS$ settings, use SHOW DEFAULTS BUFFER.
Related topics:
Attributes Command Files EDT Differences
Initialization Files Section Files WPS Differences
Dialog Boxes
Dialog Boxes
On DECwindows, a dialog box appears so you can enter additional
information or make further choices. Menu items that display a dialog box
are marked with an ellipsis (...) in the menu.
Usage notes:
o Some dialog boxes have entry lines for typing additional information.
To correct any typing errors, press the DELETE key (marked <X]).
To move to the next entry line (if any), press the TAB key.
(Keys in the dialog box are determined by DECwindows, not by EVE.)
o Some dialog boxes contain buttons to choose or toggle settings. You
click MB1 on the buttons.
o Other buttons that may appear:
OK ........ Completes the operation and dismisses the dialog box.
APPLY ..... Applies your choices and keeps the dialog box displayed.
DISMISS ... Dismisses the dialog box.
CANCEL .... Cancels the operation or choices, and dismisses the box.
o If the dialog box covers a part of the text you want to see, you can
drag the box out of the way, as follows:
1. Point to the banner at the top of the dialog box.
2. Press and hold MB1.
3. Drag the box out of the way, and then release MB1.
o Dialog boxes do NOT appear for typed commands or for defined keys.
Instead, EVE prompts you to type the information on the command line.
See help on Prompts And Responses.
Related topics:
DECwindows Menus Mouse
Display Menu
Display Menu
Lets you split the main window into two or more windows, list the buffers
you have created, delete a buffer, and so on.
Steps:
1. Point to Display in the menu bar.
2. Press and hold MB1 to pull down the menu.
3. Drag the mouse to the menu item you want and release MB1.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
Position Cursor Scroll Bars Windows NEXT BUFFER
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 for moving the cursor work the same way on the
command line as in a text buffer. In effect, you edit one of two EVE
system buffers---the Commands buffer, which stores the commands you type,
or the $PROMPTS$ buffer, which stores your responses to command prompts.
Here is a summary of features for command line editing:
Canceling
To cancel a command, erase the command line and press RETURN, or press
a key defined as RESET (such as GOLD-SELECT). Generally, if an EVE
command prompts you for additional information, simply pressing RETURN
at the prompt cancels the operation (see help on Canceling). In some
cases, pressing RETURN indicates a default response.
Cursor Movement
To move the cursor on the command line, press the left and right arrows
or other cursor-movement keys, such as CTRL/H (START OF LINE) and
CTRL/E (END OF LINE). The command line always uses a bound cursor.
Direction
Default direction of the Commands buffer and $PROMPTS$ buffer is
reverse. To change the direction, press a direction-setting key, such
as F11 (CHANGE DIRECTION). The new direction stays in effect for the
rest of the session or until you change it again---it does not revert
to the previous direction when you terminate the command or prompt.
Erasing
To erase text on the command line, use text-editing keys, such as
CTRL/U (ERASE START OF LINE) or DELETE (the <X] key). Note that in
editing a command line, any key defined as ERASE WORD (such as CTRL/J)
works like ERASE PREVIOUS WORD, to emulate DCL-style command line
editing.
Mode for Typing
Default mode of the Commands buffer and $PROMPTS$ buffer matches your
terminal setting. To change the mode, press a key defined as CHANGE
MODE (such as CTRL/A). The new mode stays in effect for the rest of
the session or until you change it again---it does not revert to the
previous mode when you terminate the command.
Quoting Special Characters
To enter control codes as part of a command or response, press a key
defined as QUOTE, such as CTRL/V. For example, to enter an escape
character, press CTRL/V and then CTRL/[ (left bracket).
Recalling Commands
To recall a previous command or response to a prompt, press CTRL/B or
press the UP arrow---effectively, scrolling back through the Commands
buffer or $PROMPTS$ buffer. See help on RECALL.
You can also use keys you defined, including EDT or WPS keys. Note that
setting the EDT or WPS keypad redefines CTRL/J as Delete Previous Word,
which is slightly different from the EVE definition.
Related topics:
Canceling Commands Choices Buffer Prompts And Responses
Edit Menu
Edit Menu
Lets you perform basic editing operations---such as, restoring
(undeleting) text you erased, copying, cutting, or pasting text, and so
on.
Steps:
1. Point to Edit in the menu bar.
2. Press and hold MB1 to pull down the menu.
3. Drag the mouse to the menu item you want and release MB1.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
Menus Pending Delete Ranges And Boxes ERASE LINE
ERASE WORD SELECT SET BOX SELECT SET CLIPBOARD
EDT Conversion
EDT Conversion
If you are accustomed to EDT, you can customize EVE to work in similar
ways. Typically, you create a section file (using SAVE EXTENDED EVE) to
save key definitions, learn sequences, and some global settings, and use
an initialization file (typically, EVE$INIT.EVE) for settings that are not
saved in a section file, such as margins and tab stops.
Here are some hints and examples:
o Use SET KEYPAD EDT 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 to define other keys. For example, you may want to
redefine GOLD-KP8 as FILL RANGE, to avoid accidentally filling text
that does not have blank lines or other paragraph boundaries. Put the
key definitions in an initialization file or save them in a section
file---for example:
In an EDTINI.EDT file In an EVE$INIT.EVE file
---------------------------------------------------------------------
DEF KEY gold 3 AS "ext show buffer." DEF KEY= gold-e3 show buffers
DEF KEY gold l AS "chglw." DEF KEY= gold-l lowercase word
DEF KEY gold u AS "chguw." DEF KEY= gold-u uppercase word
DEF KEY gold 9 AS "cutsr paste." DEF KEY= gold-kp9 store text
DEF KEY cont n as "ext quit." DEF KEY= ctrl/n quit
DEF KEY func 34 AS "shr." DEF KEY= F20 shift left 8
DEF KEY gold 10 AS "ext find=?.." DEF KEY= gold-pf2 buffer
Note the differences in some key names. For example, in EVE, GOLD-3 is
the sequence of the GOLD key and the number 3 on the keyboard. See
help on Names For Keys.
o Use SET CURSOR BOUND to enable an EDT-style bound cursor. By default,
EVE uses a free cursor, which you can move anywhere in the buffer. You
can save the setting in a section file or command file. See help on
Attributes.
o Use SET RIGHT MARGIN much as you use SET WRAP in real EDT---for
example:
In EDT In EVE
----------------------------------------------------
* SET WRAP 7 Command: SET RIGHT MARGIN 70
If you want each buffer to have the same right margin, put the command
in your EVE initialization file (see help on Defaults). Note that in
EVE the SET WRAP command corresponds to the EDT command SET NOTRUNCATE
and is the default setting.
o Use SET SCROLL MARGINS to set distances for scrolling to begin
automatically as you move the cursor up or down. For example, with a
24-line terminal screen (21-line main window), the following EDT and
EVE commands are equivalent:
In EDT In EVE
--------------------------------------------------------
* SET CURSOR 5:15 Command: 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.
To keep your scroll margins for future editing sessions, put the
command in your EVE initialization file.
o Searches follow EVE rules for case sensitivity and whitespace. Use SET
FIND commands to set the way you want searches to work:
In EDT In EVE
-----------------------------------------------------
* SET SEARCH EXACT Command: SET FIND CASE EXACT
These are not exact equivalences, because EVE always matches
diacritical marks exactly as entered in the search string. For more
information about case sensitivity for searches, see help on FIND and
REPLACE.
o Use TPU procedures in place of EDT macros. Create a buffer containing
the procedure and then compile the procedure with EXTEND EVE, or put
the procedure in a TPU command file and then invoke EVE with the
/COMMAND= qualifier. In either case, you can save the compiled
procedure in your section file. The following examples show a macro
from an EDT command file translated into a TPU procedure. Each creates
a new command, WIDEN, which sets the display to 132 columns and sets
the right margin to 120.
EDT Macro TPU Procedure
----------- -------------------
FIND=widen PROCEDURE eve_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 Command: EXTEND eve_widen
* WIDEN Command: WIDEN
Alternatively, use LEARN 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.
o Create "jacket" procedures to add commands to EVE, using EVE$
procedures for EDT keys. (The EVE source files are available in
SYS$EXAMPLES.) Compile your procedures and save them in a section file,
or put the procedures in a command file. For example, the following
procedures create EVE commands named APPEND and CHANGE CASE, using the
procedures for the Append key and ChngCase key:
PROCEDURE eve_append
RETURN (EVE$EDT_APPEND);
ENDPROCEDURE; ! append command
PROCEDURE eve_change_case
RETURN (EVE$EDT_CHNGCASE);
ENDPROCEDURE; ! change case command
o In EVE, using SELECT and then REMOVE or CUT without moving the cursor
selects and removes the current character, whereas in real EDT it
clears the paste buffer. If you want the EDT-style behavior, you can
reassign a variable as follows:
Command: TPU EVE$X_SELECT_REMOVE_FLAG := 1;
The variable assignment is saved when you create a section file.
o Setting the EDT keypad does not define keys for EDT-style tab
adjustment. However, you can get similar effects by defining a key for
the WPS Ruler key (GOLD-R) and then using the ruler to add or delete
tab stops.
For example, the following command defines F20 as the WPS Ruler key
without having to enable the WPS keypad:
Command: DEFINE KEY= F20 WPS GOLD-R
Then, to add or delete tab stops, do the following steps:
1. Press the key you defined for the WPS Ruler. EVE draws a ruler
at the bottom of the current window (just above the status line).
The cursor appears in the ruler. Tab stops are marked with a T.
2. Put the cursor where you want to add or remove a tab stop.
Press the left and right arrows to move within the ruler, or
press TAB to move to the next or previous T in the ruler.
3. Type a T or t at that location to set a tab stop at that column
or to delete a tab stop already there. The new tab stops are
immediately applied to the buffer you are editing.
4. Repeat steps 2 and 3 to add or delete other tab stops. To exit
from the ruler and resume editing, press the RETURN key.
For more information about the WPS Ruler key, including a list of keys
for moving the cursor in the ruler, see help on Ruler Keys.
Related topics:
Command Files EDT Differences Initialization Files
Names For Keys New User Section Files
EDT Differences
EDT Differences
SET KEYPAD EDT enables most of the keypad functions in EDT. It does NOT
fully implement or emulate EDT. The following 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.
Keys
Keys Definitions
--------------------------------------------------------------------
PF1 GOLD. The EDT keypad makes PF1 the GOLD key, overriding
any current definition of PF1. However, if you set a
different key as GOLD, the EDT keypad uses your GOLD key
without redefining PF1. Setting the EDT keypad defines
EVE's default GOLD key combinations, such as GOLD-FIND.
See help on Gold Keys.
GOLD-PF2 HELP KEYPAD. Displays a list of all defined keys.
GOLD-KP7 DO. Enters an EVE command. EVE does not support or
emulate EDT line-mode or "nokeypad" commands.
GOLD-KP8 FILL. Reformats the current paragraph, box, or range.
If you want the key to fill only a range or box, redefine
GOLD-KP8 as FILL RANGE.
CTRL/K LEARN. Starts a learn sequence, so you can bind several
keystrokes to a single key.
CTRL/R REMEMBER. Ends a learn sequence and prompts you to press
the key you want to define for it.
CTRL/Z EXIT. Ends the editing session, typically writing out the
current buffer and asking whether to write out any other
buffers if they were modified. If you want CTRL/Z
"exit-to-line-mode," emulating real EDT, redefine it as DO.
CTRL/C Usually halts an operation, such as a repeat or global
replace. However, if you are using keystroke journaling
(instead of buffer-change journaling), CTRL/C is not
recorded in the journal file. If you use CTRL/C, you
should immediately exit, to save your edits. Otherwise,
if the system fails, you may not be able to recover your
work. This restriction does not apply with buffer-change
journaling, which is the EVE default.
ENTER RETURN. Terminates a command or starts a new line. You
can redefine ENTER, but cannot redefine RETURN or CTRL/M.
KP1 MOVE BY WORD. Uses slightly different word boundaries
from real EDT. In EVE, a "word" includes the trailing
whitespace (spaces or tabs).
F12 EDT Start Of Line. However, using SET FUNCTION KEYS
DECWINDOWS overrides the EDT definition, defining F12
as START OF LINE, which is slightly different.
Ranges And Boxes
Commands and keys that work on a standard, linear range also work on a
box. See help on Ranges And Boxes.
Cutting and Pasting
Commands and keys to copy, cut, and paste text use either EVE's Insert
Here buffer or the DECwindows clipboard, depending on your setting.
Default is SET NOCLIPBOARD, which uses the Insert Here buffer.
Free and Bound Cursor
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 SET CURSOR BOUND. 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 SET SCROLL
MARGINS. Note that in EVE, scroll margins are measured from the top
and the bottom respectively. For example, with a 24-line screen (21-
line main window), the command SET SCROLL MARGINS 5 6 is equivalent to
SET CURSOR 5:15 in real EDT. 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 (see help
on FIND). Because EVE does not treat RETURN and ENTER differently, as
EDT does, search strings cannot contain a carriage return. However,
you can use WILDCARD FIND for these searches, or use SET FIND
WHITESPACE to enable searching across line breaks.
Mode Sensitivity
Some commands and keys depend on the mode of the buffer---insert or
overstrike---for example, the Delete Character and SpecIns keys. For a
list of these commands and keys, see help on CHANGE MODE.
FILL Boundaries
"Paragraphs" for FILL commands are bounded by any of the following:
o Blank line
o Top or bottom of the buffer
o Page break (form feed at the start of a line)
o RUNOFF command (such as .BREAK;) at the start of a line
o VAX DOCUMENT tag (such as <LE>) at the start of a line
Shifting the View
SHIFT LEFT and SHIFT RIGHT move the horizontal position of the window
relative to the buffer; whereas the EDT "nokeypad" commands SHL and SHR
move the buffer relative to the window. Thus, in EVE, the command
SHIFT RIGHT 8 is equivalent to SHL in EDT---column 9 of your text
appears in the leftmost column of the screen.
Exiting and Quitting
Exiting from EVE creates a new file (or new version of a file) only if
you made changes to the buffer (and have not yet written it out).
Quitting discards your edits, but if you made changes to the buffer,
EVE asks you to confirm that you want to quit. See help on EXIT and
QUIT. Also, on exiting or quitting, if you have changed attributes and
not saved them, EVE asks if you want to save the changes. See help on
Attributes.
Startup
When you invoke EVE, if you do not specify a file on the command line,
EVE creates an empty buffer named Main, whereas real EDT prompts you to
specify a file. Also, EVE lets you use wildcards in the file
specification (for example, *.TXT or CHAP%.RNO). See the EVE Reference
Manual or see DCL help on EDIT/TPU.
Journaling and Recovery
By default EVE uses buffer-change journaling, which creates a journal
file for each text buffer. You can use keystroke journaling and
recovery, similar to that in EDT. See help on Journal Files.
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 SET TABS or
define a key for the WPS Ruler key (GOLD-R). See help on EDT
Conversion.
+---------------------------------------------------------------------+
| For a keypad diagram, press HELP or with the EDT keypad, press PF2. |
| |
| For a list of key definitions, see help on Keys or press GOLD-HELP |
| or with the EDT keypad, GOLD-PF2. |
+---------------------------------------------------------------------+
Related topics:
EDT Conversion New User Ranges And Boxes SET KEYPAD EDT
Entries Menus
Entries In Selected Menu
Lists the menu items in the menu selected in the Available Menus list so
you can add or delete menu items.
Steps---Adding a command to a menu:
1. Click MB1 on a command in the Available Commands list,
or type the command on the entry line below the list.
For example, click on Erase Line.
2. Click on the name of a menu in the Available Menus list,
such as Edit Pulldown.
3. Click on the ADD button below the Entries in Selected Menu list.
Steps---Removing a command from a menu:
1. Click MB1 on the name of a menu in the Available Menus list.
2. Click on the menu item you want to remove in the Entries in
Selected Menu list. (To scroll the list, use the scroll bar
at the right of the list box.)
3. Click on the REMOVE button.
Related topics:
Menus DEFINE MENU ENTRY UNDEFINE MENU ENTRY
EVE VT100 << To get help on commands, type a command or ? and press
RETURN.>>
CTRL/A = CHANGE MODE +-------+-------+-------+-------+
CTRL/B = RECALL | FIND | HELP | CHANGE| DO |
CTRL/E = END OF LINE | | | DIREC | |
CTRL/H = START OF LINE +-------+-------+-------+-------+
CTRL/I = TAB |SELECT |REMOVE |INSERT | MOVE |
CTRL/J = ERASE WORD | | | HERE |BY LINE|
CTRL/L = INSERT PAGE BREAK +-------+-------+-------+-------+
CTRL/M = RETURN | | ^ | | ERASE |
CTRL/R = REMEMBER | | | | | WORD |
CTRL/U = ERASE START OF LINE +-------+-------+-------+-------+
CTRL/V = QUOTE | <--- | | | ---> | |
CTRL/W = REFRESH | | V | | CHANGE|
CTRL/Z = EXIT +-------+-------+-------+ MODE |
| NEXT SCREEN | PREV | |
The four arrow keys are defined as | |SCREEN | |
the corresponding MOVE commands. +---------------+-------+-------+
Use the DO key to enter typed commands.
EVE VT200 << To get help on commands, type a command or ? and press
RETURN.>>
F10 F11 F12 F13 F14
+------+ +------+------+------+------+ +------+-------------+
| EXIT | |CHANGE|MOV BY|ERASE |CHANGE| | HELP | DO |
| | |DIREC | LINE | WORD | MODE | | | |
+------+ +------+------+------+------+ +------+-------------+
+------+------+------+
CTRL/A = CHANGE MODE | FIND |INSERT| RE- |
CTRL/B = RECALL | | HERE | MOVE |
CTRL/E = END OF LINE +------+------+------+
CTRL/H = START OF LINE |SELECT| PREV | NEXT |
CTRL/I = TAB | |SCREEN|SCREEN|
CTRL/J = ERASE WORD +------+------+------+
CTRL/L = INSERT PAGE BREAK | ^ |
CTRL/M = RETURN | | |
CTRL/R = REMEMBER +------+------+------+
CTRL/U = ERASE START OF LINE | <--- | | | ---> |
CTRL/V = QUOTE | | V | |
CTRL/W = REFRESH +------+------+------+
CTRL/Z = EXIT
ENTER = RETURN Use the DO key to enter typed commands.
Extend Menu
Extend Menu...
Lets you customize EVE's pull-down and pop-up menus.
The dialog box contains three list boxes similar to FileView's Verbs and
Menus list boxes. Each list box can be scrolled separately:
List Box Contents and Usage
---------------------------------------------------------------------
Available Entries Lists the EVE commands that can be entered in
a menu. To add or remove commands from this
list, click MB1 on a name in the list or type
the command on the line below the list. You
can also type the label for the menu entry,
to give it a name different from the EVE
command.
Available Menus Lists the EVE menus in which you can add or
remove menu items. You select the menu by
clicking MB1 on the menu name.
Entries in Selected Menu Lists the menu items in the menu selected in
the Available Menus list, so you can add or
remove menu items.
Steps---Adding a command to a menu:
1. Choose Extend Menu from the Customize menu.
2. Click MB1 on a command in the Available Commands list,
or type the command on the entry line below the list.
For example, click on Erase Line.
3. Click on the name of a menu in the Available Menus list,
such as Edit Pulldown.
4. Click on the ADD button below the Entries in Selected Menu list.
Steps---Removing a command from a menu:
1. Choose Extend Menu from the Customize menu.
2. Click MB1 on the name of a menu in the Available Menus list.
3. Click on the item you want to remove in the Entries in Selected
Menu list.
4. Click on the REMOVE button.
When you finish adding or removing commands, click on the DISMISS button
to resume editing.
To save menu definitions for future editing sessions, use SAVE ATTRIBUTES
to create a section file or to create or update a command file. See help
on Attributes.
Related topics:
Menus DEFINE MENU ENTRY UNDEFINE MENU ENTRY
Extend submenu
Extend [->
Lets you compile TPU procedures, create a section file, or execute an EVE
initialization file.
Steps:
1. Point to Extend and drag the mouse to the right
to display your choices:
EXTEND EVE .......... Compile one or more specified procedures
EXTEND THIS ......... Compile the procedure the cursor is on
EXTEND ALL .......... Compile all the procedures in the buffer
SAVE EXTENDED EVE ... Create a section file
@EVE file ........... Execute an EVE initialization file
2. Drag the mouse to the command you want and release the mouse.
Related topics:
Initialization Files Section Files TPU
File Menu
File Menu
Lets you create a new buffer, open a file, include another file, save your
edits, or end the editing session.
Steps:
1. Point to File in the menu bar.
2. Press and hold MB1 to pull down the menu.
3. Drag the mouse to the menu item you want and release MB1.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
Dialog Boxes Journal Files Menus Windows
BUFFER DELETE BUFFER SHOW BUFFERS WRITE FILE
Find Case Exact
Set Find Case Exact
Determines whether FIND, REPLACE, and WILDCARD FIND search for a
case-exact match.
Usage notes:
o By default, EVE searches for any occurrence if you type the search
string in all lowercase letters, and searches for an exact match if you
type the search string with any uppercase letters. See help on FIND
and REPLACE.
o Case-exact searches are useful when you want to find or replace only
lowercase occurrences.
o To save your setting for future editing sessions, use SAVE ATTRIBUTES
to create a section file or to create or update a command file. See
help on Attributes.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
FIND REPLACE WILDCARD FIND
SET FIND CASE EXACT SET FIND CASE NOEXACT SET FIND WHITESPACE
Format Menu
Format Menu
Lets you rewrap text, change the case of letters, fill or rewrap text, set
margins, and so on.
Steps:
1. Point to Format in the menu bar.
2. Press and hold MB1 to pull down the menu.
3. Drag the mouse to the menu item you want and release MB1.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
Ranges And Boxes FILL INSERT PAGE BREAK
SET LEFT MARGIN SET RIGHT MARGIN SET TABS
Global Attributes
Global Attributes...
Lets you toggle or choose settings that apply in all buffers:
o Set Clipboard
o Set Cursor Bound or Free
o Set Find Case Exact
o Set Pending Delete
o Set Tabs Insert, Movement,or Spaces
o Set Tabs Visible
o Set Box Select
o Set Box Pad
Steps:
1. Choose Global Attributes from the Customize menu.
2. Click MB1 to set the attributes you want.
3. To apply your settings, click on APPLY (which keeps the dialog
box displayed) or click on OK (which dismisses the dialog box).
To discard any changes, click on CANCEL.
To save global attributes for future editing sessions, use SAVE ATTRIBUTES
to create a section file or to create or update a command file. See help
on Attributes.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Attributes Defaults Dialog Boxes Menus Mouse
Global Pending Delete
Set Pending Delete
Determines whether you can erase a selection by using DELETE (the <X] key)
or by typing new text.
Usage notes:
o By default, pending delete is disabled: whether there is a selection
or not, DELETE erases the character left of the cursor, and typing new
text puts characters at the current position.
o To save your setting for future editing sessions, use SAVE ATTRIBUTES
to create a section file or to create or update a command file. See
help on Attributes.
o To insert the text you erased with a pending delete operation, use
RESTORE SELECTION or RESTORE BOX SELECTION.
o If you use SELECT ALL (or if you click MB1 five times), pending delete
is temporarily disabled to prevent accidentally erasing your work.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Pending Delete Ranges And Boxes RESTORE BOX SELECTION
RESTORE SELECTION SET PENDING DELETE SET NOPENDING DELETE
Gold Keys
GOLD Keys
The GOLD key increases the possible key bindings for the 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 then define the
sequence of GOLD and the letter C (or c) as CENTER LINE. Typing the
letter by itself still enters that character.
Command: SET GOLD KEY pf1
Command: DEFINE KEY= gold-c center line
Usage notes:
o In naming GOLD key sequences, use a dash, slash, or underscore as a
delimiter---for example, GOLD-PF2, GOLD-F20, GOLD-KP0. The case of
letters does not matter (for example, GOLD-A and GOLD-a are the same).
See help on Names For Keys.
o EVE does not have a default GOLD key. Using SET GOLD KEY, SET KEYPAD
EDT, or SET KEYPAD WPS defines the following GOLD key sequences---
sometimes called "sleeper" keys, because they are defined by default
but must be "awakened" by setting the GOLD key:
Key Sequence 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: The EDT or WPS
GOLD-REMOVE ........ Store Text keypad defines some
GOLD-SELECT ........ Reset additional GOLD key
GOLD-PREV_SCREEN ... Previous Window sequences, and lets
GOLD-NEXT_SCREEN ... Next Window you use GOLD-number
GOLD-UP arrow ...... Top sequences for repeat
GOLD-LEFT arrow .... Start Of Line counts or uses.]
GOLD-DOWN arrow .... Bottom
GOLD-RIGHT arrow ... End Of Line
o Setting the EDT or WPS keypad makes PF1 the GOLD key, unless you set a
different key as GOLD. You can have only one key set as 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 your GOLD key and other key definitions for future editing
sessions, use SAVE EXTENDED EVE or SAVE ATTRIBUTES to create a section
file. Alternatively, put SET GOLD KEY and other key definitions in an
initialization file (typically, EVE$INIT.EVE).
+------------------------------------------------------------------+
| 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. |
+------------------------------------------------------------------+
Related topics:
Names For Keys DEFINE KEY SET GOLD KEY SHOW KEY
Help Menu
Help Menu
Lets you get help on on EVE commands, keys, and other topics.
Steps:
1. Point to Help in the menu bar.
2. Press and hold MB1 to pull down the menu.
3. Drag the mouse to the menu item you want and release MB1.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
| |
| For a list of defined keys, see help on Keys or press GOLD-HELP. |
| |
| For help on TPU built-ins, see help on TPU (switches to TPUHELP). |
+-----------------------------------------------------------------------+
Related topics:
DECwindows Dialog Boxes New Features DO HELP
Initialization Files
Initialization Files
An initialization file contains EVE commands, typically to set margins,
tab stops, and other buffer attributes, or to define keys that are not
saved in a section file. Default file type is .EVE.
Example:
The following is a sample EVE initialization file to set margins and
other attributes and to define some keys:
+-----------------------------+
| SET LEFT MARGIN 4 | Each command must be on a separate
| SET PARAGRAPH INDENT +3 | line. If a command is incomplete,
| SET RIGHT MARGIN 72 | EVE prompts you for any required
| SET TABS EVERY 10 | information before continuing to
| SET SCROLL MARGINS 9% 9% | execute the initialization file.
| SET FIND WHITESPACE |
| ! Key definitions | Comments must be on lines separate
| SET KEYPAD EDT | from commands and must begin with
| DEF KEY= F20 SHOW BUFFERS | an exclamation point (!).
| DEF KEY= CTRL/P BOX PASTE |
| DEF KEY= GOLD-S BOX SELECT |
| DEF KEY= KP7 WPS GOLD-R |
+-----------------------------+
Usage notes:
o To use an initialization file when you invoke EVE, do any of the
following:
* Define the logical name EVE$INIT to specify your initialization
file. This is useful if you want to use the same file for all or
most editing sessions---including when you use EVE within VMS MAIL
---and lets you keep the file in any directory you like.
* Create an initialization file named EVE$INIT.EVE in your current,
default directory or in SYS$LOGIN (your top-level, login directory).
Thus, you can have different initialization files for particular
directories and also have a "standard" initialization file for all
other directories.
* Use the /INITIALIZATION= qualifier and specify the initialization
file on the EDIT/TPU command line. This overrides any definition of
EVE$INIT and overrides the search for an EVE$INIT.EVE file. For
more information, see DCL help on EDIT/TPU/INITIALIZATION.
o At startup, commands in an initialization file for buffer settings,
such as margins, paragraph indent, and tab stops, apply to the Main (or
first) buffer and to an EVE system buffer named $DEFAULTS$, so that
each buffer you create has the same settings---in effect, your own
private defaults. For example, if you always want a right margin of
70, put SET RIGHT MARGIN 70 in your initialization file. See help on
Defaults.
o Settings and key definitions in an initialization file override those
in a section file or command file. Typically, you use a section file
to save key definitions and global settings you want for all or most
editing sessions (such as if you always want the EDT keypad and always
want a bound cursor), and use an initialization file for other
settings, such as such as margins and tab stops.
o To execute an initialization file during a session, use the @ command
(at sign). This is effectively the same as typing the commands the
file contains. Commands for editing operations or buffer settings
apply to the current buffer.
o You can also use an initialization file for batch jobs when you invoke
EVE with /NODISPLAY. For example, the following command invokes EVE
using an initialization file named BATCH.EVE.
$ EDIT/TPU /NODISPLAY /INITIALIZATION=batch
This batch file should comprise a complete editing session, including
EXIT or QUIT. Some EVE commands cannot be used in batch, because they
prompt for a key press or other interactive response.
o To put text into the buffer from within an initialization file, use the
EVE$INSERT_TEXT procedure. This is useful if you want to insert a
device control string, standard heading, or some other text at startup.
For example, the following command in a initialization file inserts the
quoted string:
TPU EVE$INSERT_TEXT ("Top Secret Memo!")
Related topics:
@ Attributes Command Files Section Files
Journal Files
Journal Files
Journal files record your edits so that if the system fails during your
editing session you can recover your work. Normally, journal files are
deleted automatically when you exit or quit. If there is a system
failure, such as a communications break between your terminal and the
computer, the journal files are saved.
There are two types of journaling and recovery---buffer-change and
keystroke, as follows:
Buffer-Change Journaling and Recovery
o Buffer-change journaling creates a journal file for each text
buffer. By default, EVE uses buffer-change journaling---both on
DECwindows and on character-cell terminals.
o Buffer-change journal files are created in the directory defined by
the logical name TPU$JOURNAL (default is SYS$SCRATCH, which is
usually your top-level, login directory).
o The name of the journal file derives from the name of the buffer
being edited and the file type .TPU$JOURNAL---for example:
Text buffer Buffer-change journal file
-----------------------------------------------
MAIN MAIN.TPU$JOURNAL
JABBER.TXT JABBER_TXT.TPU$JOURNAL
GUMBO_RECIPE.RNO GUMBO_RECIPE_RNO.TPU$JOURNAL
NEW TEST DATA NEW_TEST_DATA.TPU$JOURNAL
* SCRATCH * __SCRATCH__.TPU$JOURNAL
o To recover your edits with buffer-change journaling, invoke EVE and
then use RECOVER BUFFER. You recover one buffer per command, and
can recover buffers from different editing sessions. For example,
the following command recovers the text of a buffer named MEMO.TXT:
Command: RECOVER BUFFER memo.txt
o If you are unsure of the buffer names or journal file names, use the
asterisk wildcard (*):
Command: RECOVER BUFFER *
EVE then lists the available buffer-change journal files so you can
choose the one you want (see help on Choices Buffer).
o To recover several buffers---one after another---use RECOVER BUFFER
ALL. This recovers each buffer for which there is a buffer-change
journal file available.
o Recovery with buffer-change journaling restores only your text; it
does NOT restore settings, key definitions, or the contents of
system buffers (such as the Insert Here buffer) done before the
system failure.
o Buffer-change journal files may be quite large (even larger than the
files you edit). You may want to redefine TPU$JOURNAL to specify a
larger disk.
o Some editing operations may be slower because of buffer-change
journaling, depending on the extent of the changes---notably,
inserting a large amount of text, such as including a large file
into the buffer or pasting a large amount of text from the
DECwindows clipboard. Usually the recovery is quite fast.
o To disable journaling for a particular buffer, use SET NOJOURNALING.
To disable buffer-change journaling entirely, use SET NOJOURNALING
ALL. Typically, you disable buffer-change journaling if you are
only examining a file without making an edits.
Keystroke Journaling and Recovery
o Keystroke journaling, as used in previous versions of EVE, creates a
single journal file for the editing session, regardless of the
number of buffers you create. To enable keystroke journaling,
invoke EVE using /JOURNAL= and specify the journal file you want
created (default file type is .TJL).
o Keystroke journaling does NOT work when you use /INTERFACE=
DECWINDOWS and has other restrictions which do not apply to buffer-
change journaling. For more information, see DCL help on EDIT/TPU
/JOURNAL.
o To recover your edits with keystroke journaling, invoke EVE by
reissuing the command for original editing session, including all
qualifiers, and adding /RECOVER. EVE then replays your editing
session in a kind of "player piano" fashion. Typically, you then
exit to save the recovered text.
o Before recovering your edits with a keystroke journal file, make
sure that all relevant files and terminal settings are the same as
when you began the original editing session. Otherwise, the
recovery may fail. For more information, see DCL help on EDIT/TPU
/RECOVER.
o Recovery with a keystroke journal file may not work if you used
CTRL/C to halt or cancel an operation during the editing session.
Keystroke journaling does not record CTRL/C. Therefore, when you
replay your keystrokes, the operation continues uninterrupted, which
is likely to affect how the remaining keystrokes are replayed.
Journal files contain information about the text you edit. If you edit
confidential data, be sure to keep the journal files secure, as well as
the text files.
+------------------------------ NOTE -------------------------------+
| Although journaling and recovery are quite reliable, the safest way |
| to protect your work against a system failure is to write out your |
| edits frequently---particularly during all-day editing sessions. |
+---------------------------------------------------------------------+
Related topics:
RECOVER BUFFER RECOVER BUFFER ALL SET JOURNALING
SET JOURNALING ALL SET NOJOURNALING SET NOJOURNALING ALL
Keypad Captions
To get help on commands, type a command or ? and press RETURN. To list all key definitions, type Keys and press RETURN, or press GOLD-HELP. To show a key definition, use SHOW KEY.
Keys << To get help on commands, type a command or ? and press RETURN.>>
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.
LK201 Template
~GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG~
_______________________________ _______________________
|~F11~ | | | | |~F15~ | |
| | | | | | | |
|_______|_______|_______|_______| |_______|_______________|
_______________________
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |~E1~ | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |_______|_______|_______|
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |~E4~ | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |_______|_______|_______|
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |~UP~ |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ _______|_______|_______
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |~LEFT~ | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |_______|_______|_______|
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ ~XXXXXXXXXXXXXXXXXXXXXXX~
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ ~XXXXXXXXXXXXXXXXXXXXXXX~
LK201 Wide Template
~GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG~
_______________________ _______________________________
~FFFFFFFFFFFFF~ |~F15~ | | |~F17~ | | | |
~FFFFFFFFFFFFF~ | | | | | | | |
~FFFFFFFFFFFFF~ |_______|_______________| |_______|_______|_______|_______|
~FFFFFFFFFFFFF~ _______________________ _______________________________
~FFFFFFFFFFFFF~ |~E1~ | | | |~PF1~ | | | |
~FFFFFFFFFFFFF~ | | | | | | | | |
~FFFFFFFFFFFFF~ |_______|_______|_______| |_______|_______|_______|_______|
~FFFFFFFFFFFFF~ |~E4~ | | | | | | | |
~FFFFFFFFFFFFF~ | | | | | | | | |
~FFFFFFFFFFFFF~ |_______|_______|_______| |_______|_______|_______|_______|
~FFFFFFFFFFFFF~ |~UP~ | | | | | |
~FFFFFFFFFFFFF~ | | | | | | |
~FFFFFFFFFFFFF~ _______|_______|_______ |_______|_______|_______|_______|
~FFFFFFFFFFFFF~ |~LEFT~ | | | | | | | |
~FFFFFFFFFFFFF~ | | | | | | | | |
~FFFFFFFFFFFFF~ |_______|_______|_______| |_______|_______|_______| |
~FFFFFFFFFFFFF~ | | | |
~FFFFFFFFFFFFF~ ~XXXXXXXXXXXXXXXXXXXXXXX~ | | | |
~FFFFFFFFFFFFF~ ~XXXXXXXXXXXXXXXXXXXXXXX~ |_______________|_______|_______|
Mail Editing
MAIL Editing
You can make EVE the default editor for VMS MAIL by using the command SET
EDITOR TPU in MAIL. You can also define logical names to specify your own
section file (TPU$SECTION) and initialization file (EVE$INIT).
Steps:
1. To use EVE as the MAIL editor, use the following command in MAIL:
MAIL> SET EDITOR TPU
Thus, SEND/EDIT, REPLY/EDIT, and similar commands in MAIL invoke TPU,
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. If you want to use your own section file instead of standard EVE,
define the logical name TPU$SECTION at the DCL level. For example,
the following command defines TPU$SECTION as a file named
MYSEC.TPU$SECTION in your top-level (or login) directory:
$ DEFINE TPU$SECTION sys$login:mysec
Thus, TPU uses your section file instead of standard EVE, whether in
MAIL or at the DCL level (with EDIT/TPU). You can put the definition
in your LOGIN.COM file.
3. If you want to use an initialization file, create an EVE$INIT.EVE in
your top-level directory (SYS$LOGIN), or define the logical name
EVE$INIT at the DCL level. For example, the following command defines
EVE$INIT as a file named MYINIT.EVE:
$ DEFINE EVE$INIT sys$login:myinit
This is useful if you create an initialization file to define keys or
to set margins, tabs stops, and other attributes. You can put the
definition in your LOGIN.COM file.
Usage notes:
o If your are writing mail messages or other text that will be viewed on
different terminals, you may want to use SET TABS SPACES, so that TAB
inserts spaces instead of a tab character, or use CONVERT TABS to
replace tab characters with spaces. Using spaces instead of tabs keeps
the column alignment of tables and lists regardless independent of the
tab stops set for the printer or display device.
o If you want to run MAIL without having to end your editing session, you
can use the command SPAWN MAIL to spawn a subprocess, suspending your
editing session. Exiting from MAIL then returns to EVE.
Related topics:
Command Files Initialization Files Section Files
Menus
Menus
Using DECwindows menus, you can perform 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.
Usage notes:
o Menu items with an ellipsis (...) display a dialog box for entering
additional information, such as a file name, search string, or other
parameters. See help on Dialog Boxes.
o Menu items with a right arrow ([->) are submenus---drag the mouse to
the right to pull down the submmenu, and then drag the mouse to the
command you want and release the mouse.
o EVE has two different pop-up menus depending on whether you selected
text. The Noselect pop-up menu contains commands like Fill Paragraph,
Center Line, and Paste. The Select pop-up contains commands like Fill
Range, Copy, and Cut.
o The status line is also a kind of menu. Clicking MB1 on the buffer
name puts your next buffer into the window (same as the NEXT BUFFER
command); clicking MB1 on one of the other indicators toggles the
respective setting (for example, to change from insert mode to
overstrike). See help on Status Line.
o To get help on a menu item, do the following:
1. Drag the mouse to the menu item you want help on.
2. Press and hold the HELP key. Release the mouse
and then release the HELP key.
Related topics:
Dialog Boxes Mouse Scroll Bars
Status Line DEFINE MENU ENTRY UNDEFINE MENU ENTRY
Message Box
Message Box To dismiss the message box, click MB1 on the ACKNOWLEDGE button. To put EVE's Messages buffer into the current window---for example, to review all your messages---use the command BUFFER MESSAGES. See help on Message Buffer. For information about status messages, see the VAX Text Processing Utility Manual.
Message Buffer
Message Buffer
Messages received during your editing session are stored in a system
buffer named Messages. 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.
Steps:
1. To view the Messages buffer, use the following command:
Command: BUFFER MESSAGES
This puts the Messages buffer into the current
window. The cursor appears at the bottom of the buffer.
2. To scroll through the Messages buffer, use PREV SCREEN and
NEXT SCREEN or other cursor-movement commands and keys.
3. To return to the buffer you were editing, use SHOW BUFFERS
(which lists your buffers).
Usage notes:
o If you are in the Messages buffer, you can write out your messages to a
file, typically to save compiler messages for debugging purposes or to
send the exact text of an error message to your system manager. For
example, the following command writes out the buffer to a file named
MESSAGES.LIS:
Command: WRITE FILE messages.lis
o Using multiple windows, you can view the Messages buffer in one window
while you compile TPU procedures in a buffer in another window. This
is useful because compiler messages may appear too quickly to read in
the message window.
+-------------+ 1. Put your TPU procedures into an EVE buffer
|[] cursor | ---for example:
| |
| | Command: GET FILE procs.tpu
| PROCS.TPU |
+-------------+
+-------------+ 2. Use two windows, and put the Messages
| PROCS.TPU | buffer into the new window:
|_____________|
| Messages | Command: TWO WINDOWS
|[] | Command: BUFFER MESSAGES
+-------------+
+-------------+ 3. Go to the previous window and compile the
|[] PROCS.TPU | procedures. Compiler messages appears in
|_____________| the other window:
| Messages |
| | Command: OTHER WINDOW
+-------------+ Command: EXTEND ALL
For more information on using multiple windows, see help on Windows.
Related topics:
BUFFER DELETE BUFFER SHOW BUFFERS SHOW SYSTEM BUFFERS
Modifiable
Set Buffer Modifiable
Determines whether you can edit (modify) the text in the buffer.
Usage notes:
o By default, buffers you create are modifiable. Typically you make a
buffer unmodifiable to prevent inadvertently changing text you want to
keep intact, such as reference data or a previous draft.
o Making a buffer read-only also makes it unmodifiable.
o If you create a "scratchpad" or temporary storage buffer, you may want
to set it to read-only and modifiable; this lets you edit the buffer,
but EVE does not write out that buffer on exiting.
o You can also set the modification attribute by using SET BUFFER.
o If you use REMOVE, CUT, or BOX CUT in an unmodifiable buffer, EVE does
a STORE TEXT or BOX COPY instead.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Status Line SET BUFFER SHOW
Mouse
Mouse
On DECwindows, you can use the mouse to perform editing operations instead
of having to type commands or press defined keys:
Mouse key Uses
---------------------------------------------------------------------
MB1 * Choose pull-down menus (File, Edit, Search, and so on).
* Select text (see usage notes below).
* Use vertical or horizontal scroll bars.
* Change the input focus or cursor position.
* Toggle settings using status line indicators.
MB2 Display a pop-up menu.
MB3 Copy or move text between DECwindows applications
(see help on Quick Copy).
Usage notes:
o You can select text by using MB1 as follows (see help on SELECT):
1 Click ...... Cancels a selection, and repositions the cursor.
2 Clicks ..... Selects all of the word the pointer is on.
3 Clicks ..... Selects all of the line the pointer is on.
4 Clicks ..... Selects all of the paragraph the pointer is on.
5 Clicks ..... Selects all of the buffer (same as SELECT ALL).
Drag ......... Selects text, starting where you press MB1 and
ending where you release MB1.
Shift/Drag ... Extends or shrinks a selection.
o You can define the downstroke, upstroke, clicks, and drag of the mouse
as separate keys. If you pressing a mouse key you defined, EVE first
moves the cursor to where you are pointing (see help on Position
Cursor) and then executes the key definition.
o For example, the following commands define the downstroke (press) of
MB3 as INSERT HERE and the upstroke (release) as FILL PARAGRAPH:
Command: DEFINE KEY= mb3down insert here
Command: DEFINE KEY= mb3up fill paragraph
Thus, when you press and release MB3, EVE first moves the cursor to
where you are pointing, inserts the text you previously removed or
copied, and then fills the paragraph that the cursor is in.
o Undefined mouse keys work like MB1. For example, GOLD-MB3CLICK1 is the
same as clicking MB1, and GOLD-MB3DRAG is the same as dragging MB1.
Related topics:
Menus Position Cursor Quick Copy
Ranges And Boxes Scroll Bars Status Line
Names For Keys
Names For Keys
You can type key names for DEFINE KEY, SET GOLD KEY, SHOW KEY, and
UNDEFINE KEY---for example, when defining keys in an EVE initialization
file.
EVE key names are usually the same as the label on the keys. Here is a
list of some exceptions or special cases:
Key name Label Key name Location
--------------------------- ----------------------
F15 or HELP Help UP up arrow
F16 or DO Do LEFT left arrow
E1 or FIND Find DOWN down arrow
E2 or INSERT_HERE Insert Here RIGHT right arrow
E3 or REMOVE Remove KP0 ... KP9 on keypad
E4 or SELECT Select MINUS on keypad
E5 or PREV_SCREEN Prev Screen COMMA on keypad
E6 or NEXT_SCREEN Next Screen PERIOD on keypad
DELETE or DEL_KEY <X] or Delete ENTER on keypad
Usage notes:
o In specifying key combinations, use a dash, slash, or underscore as a
delimiter in the key name---for example, GOLD-A, CTRL/A, or ALT_A.
Note that you can also specify CTRL as CONTROL (or an abbreviation of
this) or as the circumflex (^). For example, CTRL/A, CONTROL/A, and ^A
are the same. Similarly, you can abbreviate the names of other keys.
For example, G-REM is a valid abbreviation for GOLD-REMOVE, but G-R is
an abbreviation for GOLD-R.
o If you use EVE with the DECwindows interface, you can use shifted
function keys (such as SHIFT/F14) and ALT key combinations (such as
ALT/Z). On DECwindows, the COMPOSE CHARACTER key is the ALT key. To
enter a compose key sequence, use ALT/SPACE.
o Some EVE key names are different from the key names used in TPU
procedures---for example:
In EVE commands In TPU procedures
----------------------------------------------
GOLD-A KEY_NAME ("A", SHIFT_KEY)
GOLD-MINUS KEY_NAME (MINUS, SHIFT_KEY)
CTRL/D CTRL_D_KEY
SHIFT/F14 KEY_NAME (F14, SHIFT_MODIFIED)
ALT/A KEY_NAME ("A", ALT_MODIFIED)
o For information about defining mouse keys (MB1, MB2, MB3), see help on
Mouse.
o EVE does not let you define the RETURN key or CTRL/M. You may not be
able to define other keys, such as F1 through F6 and some control keys,
because those keys may be "trapped" by the operating system, depending
on your terminal settings. See help on TPU Nondefinable Keys.
+------------------------------------------------------------------+
| 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. |
+------------------------------------------------------------------+
Related topics:
Control Keys Gold Keys Mouse DEFINE KEY
SET FUNC KEYS DECWINDOWS 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.
Box Editing
You can select and edit rectangular areas---boxes---as well as
contiguous, linear ranges. For example, you select a list or columns
in a table for cutting and pasting or other editing. EVE has the
following new commands for box editing:
BOX COPY BOX PASTE SET BOX NOPAD
BOX CUT BOX PASTE INSERT SET BOX NOSELECT
BOX CUT INSERT BOX PASTE OVERSTRIKE SET BOX PAD
BOX CUT OVERSTRIKE BOX SELECT SET BOX SELECT
RESTORE BOX SELECTION
Most editing operations that work on a range also work on a box. For
example, you can use FILL or FILL RANGE with a box selection to
reformat a list or part of a table. For more information, see help on
Ranges And Boxes.
CONVERT TABS Command
Replaces tab characters with the appropriate number of spaces in a
range, box, or entire current buffer.
/INTERFACE Qualifier
Same as /DISPLAY. For example, to invoke EVE with the DECwindows
interface, use the following command:
$ EDIT/TPU/INTERFACE=DECWINDOWS
Default is /INTERFACE=CHARACTER_CELL. See the EVE Reference Manual, or
see DCL help on EDIT/TPU.
/WORK Qualifier and TPU$WORK Logical Name
By default, TPU creates a work file named TPU$WORK.TPU$WORK in
SYS$SCRATCH. TPU uses the work file to swap memory for editing very
large files. See the VAX Text Processing Utility Manual, or see DCL
help on EDIT/TPU.
Quick Copy and Input Focus
On DECwindows, you can use MB3DRAG and CTRL/MB3DRAG to create a
secondary selection in EVE, regardless of whether EVE has the input
focus. See help on Quick Copy.
The following is a brief summary of the major changes in previous
versions. For detailed information, see the EVE Reference Manual.
TPU/EVE Version 2.4 (VMS Version 5.3)
------------------------------------------------
Attribute saving DEFINE MENU ENTRY
Buffer-change journaling UNDEFINE MENU ENTRY
New paragraph boundaries PREVIOUS BUFFER
ALT key combinations SET FIND CASE [NO]EXACT
Shifted function keys SET FUNC KEYS [NO]DECWINDOWS
TPU/EVE Version 2.2 (VMS Version 5.2)
--------------------------------------
DECwindows interface NEW
"Hot" status line NEXT BUFFER
Pending delete OPEN SELECTED
FIND SELECTED SET PARAGRAPH INDENT
TPU/EVE Version 2.0 (VMS Version 5.0)
------------------------------------------------------------
Bound or free cursor FILL RANGE and FILL PARAGRAPH
Buffer list handling RESET
EDT and WPS keypads RESTORE LINE and so on
GOLD key sequences SET FIND [NO]WHITESPACE
Initialization files STORE TEXT
Multiple windows SET SCROLL MARGINS
Tab mode and visibility SET [NO]WRAP
Wildcard searches SPELL
Related topics:
List Of Topics New User Ranges And Boxes
New User
New User
EVE (for Extensible VAX Editor) is a general-purpose text editor, created
with the VAX Text Processing Utility (TPU). You use EVE to create and
edit text files. You can view and edit more than one file in a session.
There are three ways to execute EVE commands:
Commands To type a command, press DO or PF4, type the command, and
press DO or RETURN. If necessary, EVE prompts you to type
more information, such as a file name or other parameter.
+---------------------------------------------------------+
| For a list of EVE commands, see help on List Of Topics. |
| For help on any command or topic, type the topic name. |
+---------------------------------------------------------+
Keys EVE defines several keys for basic operations, such as DO,
FIND, and SELECT. You can define keys, including GOLD key
combinations and learn sequences. You can also enable the
EDT keypad or WPS keypad.
+---------------------------------------------------------+
| For a keypad diagram, press HELP. On VT100, press PF2. |
| For a list of all the defined keys, see help on Keys. |
+---------------------------------------------------------+
Menus On DECwindows, EVE has pull-down and pop-up menus for most
common editing operations. Use MB1 to choose commands in
pull-down menus and for other operations, such as selecting
text or using scroll bars. Use MB2 to display a pop-up menu.
+----------------------------------------------------------+
| For more information about EVE menus, see help on Menus. |
+----------------------------------------------------------+
For information about the new and changed features of this version of EVE,
see help on New Features. You may also want to read the following topics:
Topic Contents
-----------------------------------------------------------------
Attributes ......... How to save your settings and customizations
for future editing sessions
Defaults ........... List of EVE default settings, and how to set
your own "private defaults"
EDT Conversion ..... How to define keys and change settings to
make EVE emulate EDT
Journal Files ...... How to recover your work in case of a system
failure during your editing session
Ranges And Boxes ... How to highlight text for copying, cutting,
filling, case-changes, and so on.
Windows ............ How to use multiple windows in EVE to view
and edit two or more files or buffers
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 a keypad diagram, press HELP (with VT100 keypad, press PF2). | | | | For a list of defined keys, see help on Keys or press GOLD-HELP. | | | | For help on TPU built-ins, see help on TPU (switches to TPUHELP). | +--------------------------------------------------------------------+
Old Gold Key
Pressed Old GOLD Key
The key you pressed is normally the GOLD key for the current keypad (EDT
or WPS), but you have set a different key as the GOLD key.
For example, PF1 is normally the GOLD key for the EDT or WPS keypad, but
you may have set F17 as the GOLD key and not otherwise defined PF1.
To restore the GOLD key to the default for the current keypad, use SET
NOGOLD KEY, which cancels your GOLD key and restores PF1 as the GOLD key
for the EDT or WPS keypad.
+------------------------------------------------------------------+
| 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. |
+------------------------------------------------------------------+
Related topics:
Gold Keys SET GOLD KEY SET NOGOLD KEY
Pending Delete
Pending Delete
Pending delete lets you erase a selection by simply typing new text or by
using DELETE.
Steps:
1. To enable pending delete, use SET PENDING DELETE.
2. To select the text you want to erase, use any of the following:
SELECT
BOX SELECT
MB1 clicks (DECwindows only---see help on Mouse)
WPS Continue Search/Select key
3. Use DELETE (for example, press the <X] key) or type new text (such
as pressing the space bar).
4. To put back the text you erased, use RESTORE SELECTION
or RESTORE BOX SELECTION.
Usage notes:
o Default is SET NOPENDING DELETE---typing new text or using DELETE works
the same whether there is a selection or not.
o Pending delete does not work if you use SELECT ALL (or MB1CLICK5).
This is to prevent accidentally erasing the entire buffer.
o Pending delete does not use the Insert Here buffer or DECwindows
clipboard. Thus, you can use pending delete and RESTORE SELECTION for
cutting and pasting text without affecting the contents of Insert Here
buffer or the clipboard.
o Erasing a box selection usually pads the area with spaces to keep the
column alignment of text to the right of the box. If you used SET BOX
NOPAD, erasing a box from an insert-mode buffer makes text to the right
of the box "collapse" to the left, closing the gap.
o Using SET BOX SELECT makes RESTORE SELECTION the same as RESTORE BOX
SELECTION, usually overwriting existing text. If you used SET BOX
NOPAD, restoring a box in an insert-mode buffer pushes existing text to
the right of the box---useful to add columns in the middle of a table.
o Erasing or restoring a box converts tab characters to spaces, to keep
the column alignment of the text. See help on CONVERT TABS.
o SET PENDING DELETE is a global attribute which can be saved in a
section file or command file for future editing sessions. See help on
Attributes.
o On DECwindows, using CTRL/MB3DRAG, to create a secondary (underlined)
selection and move it to the application having input focus, erases the
secondary selection like pending delete (see help on Quick Copy). To
put back the erased text in EVE, use RESTORE SELECTION or RESTORE BOX
SELECTION.
Related topics:
Attributes Quick Copy Ranges And Boxes
DELETE RESTORE BOX SELECTION RESTORE SELECTION
SET BOX PAD SET BOX SELECT SET PENDING DELETE
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 move the cursor (input focus).
2. Click MB1 (press and release).
EVE then puts the cursor where you are pointing and cancels any selection
or highlighting of found text (from FIND or WILDCARD FIND).
Pressing a mouse key that is otherwise undefined does the same thing as
clicking MB1. Also, if you define a mouse key, when you use that key, EVE
first does a position cursor operation and then executes the command bound
to that mouse key. See help on Mouse.
Related topics:
Mouse Quick Copy Scroll Bars SELECT
Program
TPU Program Key The key you pressed is defined to execute a TPU program. A TPU program can comprise several statements or procedures. Therefore, there is no HELP topic for that key. To find out the statements bound to the key, use the SHOW 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. | +------------------------------------------------------------------+
Prompts And Responses
Prompts And Responses
If an EVE command or defined key requires more information, such as a file
name or other parameter, EVE prompts you to type the required information
on the command line.
(Menu items that require additional information typically use a dialog
box.)
For example, INCLUDE FILE prompts you with, "File to include:" and you can
do one of the following:
o To complete the command, type the required information
(in this case the file name) and press RETURN.
o To cancel the operation, simply press RETURN or DO
without typing anything. See help on Canceling.
o To recall your previous responses---that is, scrolling
the $PROMPTS$ buffer---press CTRL/B or the UP arrow.
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 or SET TABS, command strings
for DEFINE KEY, and so on.
Related topics:
Canceling Choices Buffer Dialog Boxes Message Buffer
Quick Copy
Quick Copy
You can use MB3 or CTRL/MB3 to copy or move text between EVE and other
DECwindows applications, without having to use the clipboard and without
having to change the input focus.
Mouse Action Usage or Effects
---------------------------------------------------------------------
MB3CLICK (Copy To) Copies the selection to your pointer
location. For example:
1. Select text in EVE (see help on SELECT).
2. Point where you want to copy the selection.
3. Click MB3.
You can copy the selection within EVE or into another
DECwindows application. Similarly, you can select
text in another application and copy it into EVE.
CTRL/MB3CLICK (Move To) Moves the selection to your pointer
location and then erases the selection from its
original location. To insert the erased text in EVE,
use RESTORE SELECTION or RESTORE BOX SELECTION.
MB3DRAG (Copy From) Creates a secondary selection (which
appears underlined). When you release MB3, the
secondary selection is copied to the application that
has the input focus, whether EVE or another
application.
CTRL/MB3DRAG (Move From) Creates a secondary selection (which
appears underlined). When you release MB3, the text
is moved to the application that has the input focus,
and then the selection is erased from its original
location. To insert the erased text in EVE, use
RESTORE SELECTION or RESTORE BOX SELECTION.
Usage notes:
o For example, if you are using MAIL in one window and MAIL has the input
focus, you can point to text in EVE in another window, press MB3 and
drag the mouse. This creates a secondary selection in EVE. When you
release MB3, the selection is copied from EVE into MAIL.
o You can copy or move the primary selection or the secondary selection.
A primary selection is typically created by SELECT and appears in
reverse video, or by BOX SELECT and appears in bold video.
Related topics:
Ranges And Boxes BOX SELECT COPY CUT
PASTE RESTORE BOX SELECTION RESTORE SELECTION SELECT
Ranges And Boxes
Ranges And Boxes
EVE has three ways to highlight text for editing operations, such as
copying, cutting, filling, and case changing:
Select range Use SELECT to highlight a range of text as you move the
cursor. The selection appears in reverse video. To
select the entire buffer, use SELECT ALL. On
DECWindows, you can use the mouse (MB1) to select text
(see usage notes below). With the WPS keypad, you can
use the Continue Search/Select key (GOLD-/ or GOLD-?).
To cancel a selection, repeat SELECT or use RESET.
Box selection Use BOX SELECT to select a rectangular area, such as a
list or part of a table. The start and end of the
selection are the diagonally opposite corners of the
box. Highlighting is in bold video. Using SET BOX
SELECT makes SELECT the same as BOX SELECT without
having to redefine keys.
Found range Use FIND to search for a string of text, and WILDCARD
FIND to search for a pattern. Found text is
highlighted in bold video, with the cursor at the start
of the found string. Most editing operations that work
on a selection work on a found range. SET BOX SELECT
makes found ranges work like boxes. To cancel the
highlighting, move the cursor off the found text or use
RESET.
Usage notes:
o On DECwindows, you can select text by using MB1 as follows:
1 Click ...... Cancels a selection, and repositions the cursor.
2 Clicks ..... Selects all of the word the pointer is on.
3 Clicks ..... Selects all of the line the pointer is on.
4 Clicks ..... Selects all of the paragraph the pointer is on.
5 Clicks ..... Selects all of the buffer (same as SELECT ALL).
Drag ......... Selects text starting where you press MB1 and
ending where you release MB1.
Shift/Drag ... Extends or shrinks a selection.
o To edit a range or box, use any of the following commands or keys.
Some of these commands or keys also work without highlighted text (for
example, CAPITALIZE WORD, CONVERT TABS, FILL, and SPELL), and some do
not work on a found range (such as SPELL and pending delete).
Copying Cutting
-------- -------
BOX COPY BOX CUT
STORE TEXT or COPY BOX CUT INSERT
WPS Copy (GOLD-MINUS) BOX CUT OVERSTRIKE
DECwindows Copy To (MB3CLICK) REMOVE or CUT
Pending delete
Case Change EDT Append (KP9)
--------------- WPS Cut (MINUS or REMOVE)
CAPITALIZE WORD DECwindows Move To (CTRL/MB3CLICK)
LOWERCASE WORD
UPPERCASE WORD Formatting
EDT ChngCase (GOLD-KP1) ------------
WPS Lower Case (GOLD-KP3) CONVERT TABS
WPS Upper Case (KP3) FILL or FILL RANGE
Other Replacing
------------- ---------
FIND SELECTED EDT Replace (GOLD-KP9)
OPEN SELECTED EDT Subs (GOLD-ENTER)
SPELL WPS Replace (GOLD-' or GOLD-")
o With SELECT ALL (or on DECwindows, MB1CLICK5), you cannot use pending
delete, BOX COPY, BOX CUT, FIND SELECTED, or OPEN SELECTED.
o With a standard linear selection, BOX COPY or BOX CUT uses the start
and end of the range as diagonally opposite corners of a box.
o With a box selection, STORE TEXT or COPY is the same as BOX COPY, and
REMOVE or CUT is the same as BOX CUT, so you do not have to redefine
keys.
o A selection takes precedence over a found range. If the search is in
forward direction (right and down), the found text is not part of the
selection. If the search is in reverse direction (left and up), the
found text is part of the selection.
o Box editing has different effects depending on whether you disabled box
padding:
Setting Effects on BOX CUT and BOX PASTE
----------------------------------------------------------------------
SET BOX PAD (Default.) Cutting a box, or erasing a box selection
with pending delete, pads the area with spaces to keep
the column alignment of text to the right of the box.
Pasting or restoring a box overwrites existing text.
SET BOX NOPAD Box editing depends on the mode of the buffer. In
insert mode, cutting or erasing a box makes text to
right "collapse" to left, closing the gap; pasting
or restoring a box pushes existing text to the right.
In overstrike mode, the effects are the same as with
SET BOX PAD.
o To override the settings, use either BOX CUT INSERT and BOX PASTE
INSERT, or BOX CUT OVERSTRIKE and BOX PASTE OVERSTRIKE.
o SET BOX commands are global attributes, which can be saved in a section
file or command file for future editing sessions. See help on
Attributes.
o On DECwindows, if you select text, the pop-up menu (displayed by
holding down MB2) contains COPY, CUT, FILL RANGE, case changes, and
other commands for editing a selection. See help on Menus.
o Hint: If you frequently cut and paste boxes as well as linear ranges,
you may want to define keys for BOX SELECT, BOX PASTE, and BOX PASTE
INSERT. You can use keys defined as STORE TEXT and REMOVE to copy or
cut a box selection.
Related topics:
Pending Delete Quick Copy BOX SELECT FIND
SELECT SET BOX PAD SET BOX SELECT WILDCARD FIND
Read Only
Set Buffer Read_Only
Determines whether EVE writes out the buffer on exiting if it has been
modified.
Usage notes:
o By default, buffers you create (with BUFFER, GET FILE, NEW, or OPEN)
are write-enabled. Thus, on exiting, EVE writes out your buffers if
you made any changes and have not already written out the buffers.
o Typically you make a buffer read-only (also called write-locked) to
prevent inadvertently changing text you want to keep intact, such as
reference data or a previous draft.
o Making a buffer read-only also makes it unmodifiable. You can then
make the buffer modifiable.
o You can also toggle the read/write attribute by clicking MB1 on the
Read-only or Write indicator in the status line.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Status Line SET BUFFER SHOW
Reallydelbuff
Delete Buffer
The buffer you want to delete is a modified buffer (you have made edits
that have not been saved). Therefore, EVE asks you for one of the
following choices:
DELETE_ONLY ... Deletes the specified buffer.
WRITE_FIRST ... Writes out the buffer, and then deletes it. If there
is no file associated with the buffer, EVE asks you
for the file name to use for writing out the buffer.
QUIT .......... Cancels the operation---buffer is NOT deleted.
Related topics:
DELETE BUFFER SHOW BUFFERS SHOW SYSTEM BUFFERS
Replace All
Replace All
Clicking on the ALL button lets you replace all occurrences of the old
string without having EVE prompt you for each replacement---and without
the cursor moving to each occurrence.
Usage notes:
o REPLACE first searches for the old string (the text to be replaced) in
the current direction of the buffer and makes any replacements.
o Then, if the old string is found in the opposite direction, EVE asks if
you want to change the direction of the search and continue the REPLACE
operation---press RETURN for Yes, or type No and press RETURN.
o When the operation is finished, EVE tells you how many replacements
were made, if any.
+----------------------------------------------------------+
| For more information, see help on the REPLACE command. |
+----------------------------------------------------------+
Restore submenu
Restore [->
Lets you put back (undelete) text you last erased with most ERASE commands
or similar EDT or WPS keys.
Steps:
1. Point to Restore and drag the mouse to the right
to display your choices:
RESTORE WORD
RESTORE SELECTION
RESTORE LINE
RESTORE CHARACTER
RESTORE SENTENCE
2. Drag the mouse to the command you want and release the mouse.
Thus, if your last erasure was done with ERASE WORD or ERASE PREVIOUS
WORD, use RESTORE WORD to reinsert that text at your current position.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
Pending Delete RESTORE RESTORE BOX SELECTION
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 the paragraph indent to this column.
L or l Sets the left margin to this column.
P or P Same as I or i.
R or r Sets the right margin to this column.
S or s Saves settings, prompting for ruler number (0--9).
T or t Sets or deletes a tab stop at this column.
W or w Sets the WPS word wrap indent to this column.
SPACE Cancels an I, P, or W at this column.
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 or GOLD-H 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 (regardless of
their definitions otherwise):
Key Movement within Ruler
----------------------------------------------------------------------
<--- Left one column in the ruler.
---> Right one column in the ruler.
CTRL/H Start of the ruler (left side).
CTRL/E End of the ruler (right side).
TAB Next or previous tab stop (T) in ruler.
KP0 Right one column and sets the ruler to FORWARD direction.
KP1 Left one column and sets the ruler to REVERSE direction.
KP2 Start or end of the ruler.
KP4 Next or previous indicator (I, L, P, R T, or W).
Usage notes:
o Setting the margins, paragraph indent, or wrap point does NOT reformat
existing text. To reformat your text, use FILL (with the WPS keypad,
press GOLD-KP5).
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 of the buffer.
o Setting or deleting tab stops affects existing tab characters in the
current buffer. The new tab stops are immediately applied.
o Only one ruler can be active per buffer. Rulers cannot be embedded in
a file or saved from session to session. If you want to use the same
margins, paragraph indent, and tab stops for future editing sessions,
put the relevant commands in an initialization file (typically,
EVE$INIT.EVE) and use that file when you invoke EVE (see help on
Initialization Files). For example, if your initialization file has
the command SET RIGHT MARGIN 70, the setting applies to the Main (or
first) buffer and to an EVE system buffer named $DEFAULTS$, so that
each buffer you create has the same right margin.
o You can define a key for the Ruler without setting the WPS keypad. For
example, the following command defines F20 as the WPS Ruler key:
Command: DEFINE KEY= F20 WPS GOLD-R
o It is possible to move the cursor out of the ruler by using the mouse
(see help on Position Cursor). However, this is not recommended.
Related topics:
WPS Differences SET LEFT MARGIN SET PARAGRAPH INDENT
SET RIGHT MARGIN SET TABS SHOW
Scroll Bars
Scroll Bars
On DECwindows, you can use scroll bars to move 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, |__|
press and hold MB1 for continuous scrolling. \/
Similarly, use the horizontal scroll bar to shift the window left and
right, typically to view very wide text:
__________________________________________
/| [__] |\
\|_________________________________________ |/
For example, clicking MB1 to right of the thumb in the horizontal scroll
bar shifts the window to the right.
Related topics:
Mouse Position Cursor NEXT SCREEN PREVIOUS SCREEN
SET WIDTH SHIFT LEFT SHIFT RIGHT
Search Attributes
Search Attributes [->
Lets you choose settings for FIND and WILDCARD FIND.
Steps:
1. Point to Search Attributes and drag the mouse to the right
to display your choices:
SET FIND WHITESPACE
SET FIND NOWHITESPACE (default)
SET WILDCARD VMS (default)
SET WILDCARD ULTRIX
2. Drag the mouse to the command you want and release the mouse.
(You can choose only one setting of each pair at a time.)
These settings apply in all buffers, but are not saved in a section file
or command file. If you want whitespace find or Ultrix wildcards for
future editing sessions, put the relevant commands in an initialization
file (typically EVE$INIT.EVE). See help on Initialization Files.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
SET FIND CASE EXACT SHOW WILDCARDS
Search Menu
Search Menu
Lets you find or replace text, set search attributes, and so on.
Steps:
1. Point to Search in the menu bar.
2. Press and hold MB1 to pull down the menu.
3. Drag the mouse to the menu item you want and release MB1.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
Dialog Boxes Menus New User Ranges And Boxes
FIND REPLACE SET FIND CASE EXACT WILDCARD FIND
Section Files
Section Files
A section file is a binary file to save key definitions and other
customizations---effectively, your own customized version of EVE. Default
file type is .TPU$SECTION.
Steps:
1. Compile any TPU procedures you have written to extend EVE. Use EXTEND
commands during the editing session, or put the procedures in a
command file executed when you invoke EVE (with EDIT/TPU/COMMAND).
2. Define the keys you want by using DEFINE KEY, LEARN, SET FUNCTION
KEYS, SET GOLD KEY, and SET KEYPAD commands.
3. Add or delete menu items for the DECwindows interface by using DEFINE
MENU and UNDEFINE MENU, or by choosing Extend Menu from the Customize
menu.
4. Set the global attributes you want saved in the section file, such as
bound or free cursor, tab visibility, and so on (see help on
Attributes).
5. To create a section file, use SAVE EXTENDED EVE. For example, the
following command creates a section file named MYSEC.TPU$SECTION in
your current, default directory:
Command: SAVE EXTENDED EVE mysec
Usage notes:
o If you used SET DEFAULT SECTION FILE, then you need not specify a
section file on the command line---SAVE EXTENDED EVE saves in your
default section file.
o To use your section file, invoke TPU using /SECTION= and specifying the
section file, or define the logical name TPU$SECTION (particularly if
there is a section file you want to use for all or most editing
sessions). For example, the following command uses a section file
called MYSEC.TPU$SECTION in your top-level (login) directory:
$ EDIT/TPU/SECTION=sys$login:mysec
o In specifying the section file to be used, include the device (disk)
and directory (default is SYS$SHARE). See DCL help on EDIT/TPU
/SECTION.
o You use one section file at a time. A section file is cumulative,
saving the current key definitions, menu definitions, global
attributes, and compiled procedures---and any already saved in the
section file you are using.
o Margins, tab stops, and other buffer settings are NOT saved in a
section file. To use the same buffer settings for all or most
sessions, put the relevant commands in an initialization file
(typically, EVE$INIT.EVE). For example, if you always want a right
margin of 70, put SET RIGHT MARGIN 70 in your initialization file.
When you invoke EVE using that initialization file, the setting applies
to the Main (or first) buffer and to an EVE system buffer named
$DEFAULTS$, so that each buffer you create has the same setting. See
help on Initialization Files.
Related topics:
Attributes Command Files Initialization Files
SAVE ATTRIBUTES SAVE EXTENDED EVE SET DEFAULT SECTION FILE
Sequence
LEARN Sequence Key
The key you pressed is defined for a LEARN sequence.
A LEARN sequence can comprise several keystrokes or commands or both.
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. |
+------------------------------------------------------------------+
Related topics:
LEARN UNDEFINE KEY
Set Box Pad menu
Set Box Pad
Determines whether box editing operations pad and overstrike.
Usage notes:
o By default, box padding is enabled. Cutting a box, or erasing a box
selection with pending delete, pads the area with spaces to keep the
column alignment of text to the right of the box. Pasting or restoring
a box overwrites existing text---regardless of the mode of the buffer.
o If you disable box padding, then box editing depends on the mode of the
buffer (as shown in the status line). Cutting a box, or erasing a box
selection, from an insert-mode buffer makes text to the right of the
box "collapse" to the left, closing the gap. Pasting or restoring a
box into an insert-mode buffer pushes existing text to the right of the
box.
o To override the settings---forcing one behavior or the other---use
either BOX CUT INSERT and BOX PASTE INSERT, or BOX CUT OVERSTRIKE and
BOX PASTE OVERSTRIKE.
o To save your setting for future editing sessions, use SAVE ATTRIBUTES
to create a section file or to create or update a command file. See
help on Attributes.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Pending Delete Ranges And Boxes BOX CUT BOX PASTE
BOX SELECT SET BOX NOPAD SET BOX PAD SET BOX SELECT
Set Box Select menu
Set Box Select
Determines the type of selections for cutting, pasting, and other edits.
"Box selections" let you edit a rectangular area, rather than a linear
range. For example, you can select, cut, and paste columns of text, such
as in editing a table.
Usage notes:
o When you enable box selection, the following commands work like the
corresponding BOX commands:
Commands Effects with SET BOX SELECT
--------------------------------------------------------
INSERT HERE or PASTE BOX PASTE
REMOVE or CUT BOX CUT
RESTORE SELECTION RESTORE BOX SELECTION
SELECT BOX SELECT
STORE TEXT or COPY BOX COPY
For example, pressing the SELECT key then does a box selection;
choosing PASTE from the Edit menu does a BOX PASTE. Generally, an
editing operation that works on a range also works on a box, and
conversely. See help on Ranges And Boxes.
o By default, box selection is disabled, so you can select and edit
standard, linear ranges. To edit boxes, use BOX commands.
o Typically you enable box selection to make it easier to edit tables or
column-aligned text without having to redefine keys for selecting,
cutting, and pasting. In effect, the setting redefines the keys for
you.
o Enabling box selection also affects editing a found range. For
example, COPY, FILL, REMOVE, or UPPERCASE uses the start and end of the
found range as the diagonally opposite corners of a box.
o To save your setting for future editing sessions, use SAVE ATTRIBUTES
to create a section file or to create or update a command file. See
help on Attributes.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Attributes Pending Delete Ranges And Boxes
SET BOX NOSELECT SET BOX PAD SET BOX SELECT
Set Margins
Set Margins...
Lets you set the left and right margins of the current buffer. The
settings apply to new text or to text you reformat with CENTER LINE or
FILL.
Steps:
1. Choose Set Margins from the Format menu.
2. To set the left margin, click on Set Left Margin and type the
number you want. Default is 1 (which is the leftmost column).
3. To set the right margin, click on Set Right Margin and type the
number you want. Default is usually 79.
4. To apply the settings, click on APPLY (which keeps the dialog
box displayed) or click on OK (which dismisses the dialog box).
To discard any changes, click on CANCEL.
Usage notes:
o The left margin must be less than the right margin. Also, the sum of
the left margin and the paragraph indent (if any) must be at least 1.
For example, if the paragraph indent is -4, the left margin must be at
least 5.
o Margins are buffer attributes---you can have different margins for each
buffer you edit. For example, you can edit a source program in one
buffer using a right margin of 78, and edit a memo in another buffer
using a right margin of 65.
o Changing the margins does not affect existing text. To reformat text
according to new margins, use FILL commands. For example, you increase
or decrease the margins, use FILL PARAGRAPH, and then restore the
previous margins for editing the rest of the buffer.
o To set the same margins for all your buffers, put SET LEFT MARGIN and
SET RIGHT MARGIN in an initialization file (typically, EVE$INIT.EVE)
and use that file when you invoke EVE. For example, if your
initialization file has the command SET RIGHT MARGIN 70, the setting
applies to the Main (or first) buffer and to an EVE system buffer named
$DEFAULTS$, so that each buffer you create has the same right margin.
See help on Initialization Files.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
FILL SET LEFT MARGIN SET PARAGRAPH INDENT SET RIGHT MARGIN
Set Whitespace
Set Whitespace [->
Sets the way FIND and WILDCARD FIND commands treat whitespace (spaces,
tabs, and line breaks) in searching for strings of two or more words.
Steps:
1. Point to Set Whitespace and drag the mouse to the right
to display your choices:
SET FIND WHITESPACE
SET FIND NOWHITESPACE (default)
2. Drag the mouse to the command you want and release the mouse.
The setting applies in all buffers, but is not saved in a section file or
command file. If you want whitespace find for future editing sessions,
put SET FIND WHITESPACE in an initialization file (typically
EVE$INIT.EVE). See help on Initialization Files.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
FIND WILDCARD FIND
Set Wildcards
Set Wildcards [->
Sets the type of wildcards (sometimes called "meta-characters") for
WILDCARD FIND.
Steps:
1. Point to Set Wildcards and drag the mouse to the right
to display your choices:
SET WILDCARD VMS (default)
SET WILDCARD ULTRIX
2. Drag the mouse to the command you want and release the mouse.
The setting applies in all buffers, but is not saved in a section file or
command file. If you want Ultrix wildcards for future editing sessions,
put SET WILDCARD ULTRIX in an initialization file (typically
EVE$INIT.EVE). See help on Initialization Files.
+-----------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
| |
| For help on keys, press HELP and then press the key you want help on. |
+-----------------------------------------------------------------------+
Related topics:
SHOW WILDCARDS WILDCARD FIND
Status Line
Status Line
The status line shows information about the buffer in the current EVE
window and lets you toggle the settings by clicking MB1 on the indicators.
Indicator Meaning or Usage
---------------------------------------------------------------------
Buffer: Shows the name of the buffer in that window.
Typically, this is the same as the file
specified when you invoke EVE or when you use
the OPEN, OPEN SELECTED, or GET FILE command.
To view your next buffer, click MB1 on the
buffer name.
Write or Read-only Whether on exiting, EVE writes out the buffer
if it has been modified. To toggle the
setting, click MB1 on the indicator. Read-
only also implies unmodifiable.
Insert or Overstrike The mode for entering text in the buffer. To
toggle the setting, click MB1 on the
indicator.
Forward or Reverse The direction for searches and some cursor-
movement commands. To toggle the setting,
click MB1 on the indicator.
Usage notes:
o This use of status line indicators with the mouse also works when you
run EVE in a DECterm window or on UIS.
o Each window you create in EVE has its own status line. For information
about using multiple windows in EVE, see help on Windows.
o If you reduce the width of the window, the indicators at the left of
the status line may be clipped, because EVE tries to keep the buffer
name full size. (For example, the forward or reverse indicator may be
omitted). If the window is so narrow that the buffer name does not
fit, EVE shortens the buffer name in the status line.
Related topics:
CHANGE DIRECTION CHANGE MODE NEXT BUFFER SET BUFFER
Tabs Visible
Set Tabs Visible
Determines whether tab characters are visible or invisible during editing.
Usage notes:
o Visible tab characters appear as a small HT. This is an editing
convenience only---no effect how tab characters appear in print.
o Default is SET TABS INVISIBLE---tab characters appear as blank space.
o To save your setting for future editing sessions, use SAVE ATTRIBUTES
to create a section file or to create or update a command file. See
help on Attributes.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Attributes CONVERT TABS SET TABS TAB
Tab Modes
Set Tabs
Determines whether TAB inserts a tab character, inserts space characters,
or simply moves the cursor.
Setting Effects with TAB
---------------------------------------------------
INSERT (Default.) TAB inserts a tab character.
MOVEMENT TAB moves the cursor to the next tab stop
on the line without inserting anything.
SPACES TAB inserts spaces instead of a tab character.
Usage notes:
o Changing the tab mode does not affect existing tabs entered in a
different mode. For example, setting the tab mode to Spaces does not
convert existing tab characters to spaces. Instead, use CONVERT TABS.
o To save your setting for future editing sessions, use SAVE ATTRIBUTES
to create a section file or to create or update a command file. See
help on Attributes.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Attributes CONVERT TABS SET TABS TAB
Tab Stops
Set Tabs At or Every
Sets tab stops for the current buffer.
Steps:
1. Click MB1 on Set Tabs Every or on Set Tabs At.
2. Type the number or numbers for the tab stops. For example, the
following entry sets tab stops at columns 11, 21, 31, and so on:
Set Tabs Every: 10
Usage notes:
o With Set Tabs Every, you specify the interval you want for all tab
stops. Default tab stops are Every 8 columns.
o With Set Tabs At, you specify the columns at which you want tab stops.
These must be in ascending order, separated by spaces---for example:
Set Tabs At: 6 14 30
o Changing the tab stops affects any existing tabs in the buffer, so you
may see your text move to the left or right depending on how much you
increase or decrease tab stops.
o To set the same tab stops for all your buffers, put SET TABS AT or SET
TABS EVERY in an initialization file (typically, EVE$INIT.EVE) and use
that file when you invoke EVE. For example, if your initialization
file has the command SET TABS EVERY 10, the setting applies to the Main
(or first) buffer and to an EVE system buffer named $DEFAULTS$, so that
each buffer you create has the same tab stops. See help on
Initialization Files.
o Tab stops are not stored in the output file. Therefore, in printing or
displaying 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 CONVERT TABS to replace tab characters
with spaces.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
Defaults CONVERT TABS SET TABS TAB
Typing Keys
Typing Keys
Typing keys on the main keyboard are for entering characters. They are
sometimes called "self-inserting" keys.
Usage notes:
o You can define typing keys in combination with a modifier key, such as
the CTRL key, the GOLD key, or on DECwindows, the ALT key. For
example, the following command defines the sequence of GOLD and the
letter C (or c) as CENTER LINE:
Command: DEFINE KEY= gold-c center line
o By default, EVE treats KP0--KP9, MINUS, COMMA, and PERIOD on the keypad
as typing keys, except with the VT100 keypad. For example, pressing
KP8 is the same as typing the number 8, and pressing COMMA is the same
as typing a comma on the main keyboard. Setting the EDT or WPS keypad
also defines or redefines keys on the numeric keypad.
o If you use SET PENDING DELETE and then select text, typing new
characters erases the selection and enters the new characters. See
help on Pending Delete.
o You can define typing keys (letters, numbers, or punctuation marks) by
using the TPU DEFINE_KEY procedure, although this is not generally
recommended. If you defined a typing key, use QUOTE to enter the
character normally bound to that key. For example, if you defined the
tilde (~) to execute a procedure, you can enter a tilde character as
follows:
1. Use the QUOTE command (CTRL/V).
2. At the prompt, type a tilde (~).
Alternatively, use the COPY_TEXT built-in, as in the following example:
Command: TPU COPY_TEXT ("~")
+------------------------------------------------------------------+
| For a list of defined keys, see help on Keys or press GOLD-HELP. |
| |
| For a keypad diagram, press HELP (with VT100 keypad, press PF2). |
+------------------------------------------------------------------+
Related topics:
Control Keys Gold Keys Names For Keys Pending Delete
Unknown
Undefined Key
The key you pressed is undefined or unknown for HELP.
To define the key, use DEFINE KEY or LEARN. Also, some other commands may
define the key, such as SET KEYPAD EDT, SET KEYPAD WPS, or SET FUNCTION
KEYS DECWINDOWS.
If you use the DEFINE_KEY built-in or EVE$DEFINE_KEY procedure, such as in
a command file, include, after the key name, the name of the help topic to
display for that key and the name of the keymap, as in the following
example:
EVE$DEFINE_KEY ("EVE_DCL ('')", CTRL_D_KEY, "DCL", EVE$X_USER_KEYS);
+------------------------------------------------------------------+
| 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~
VT100 Template
~GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG~
_______________________________ _______________________________
|~UP~ |~DOWN~ | | | |~PF1~ | | | |
| | | | | | | | | |
|_______|_______|_______|_______| |_______|_______|_______|_______|
| | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |_______|_______|_______|_______|
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |_______|_______|_______|_______|
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |_______|_______|_______| |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ | | | |
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ |_______________|_______|_______|
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ ~XXXXXXXXXXXXXXXXXXXXXXX~
~FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF~ ~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 are areas of the EVE screen for displaying buffers you edit or
other information, such as commands and messages.
Using multiple windows lets you view or edit different buffers at the same
time or different parts of the same buffer.
Example:
+--------------+
|[] cursor | 1. Initially, EVE has one main window -- in this
| | case, you edit a file named ALPHA.TXT:
| |
| ALPHA.TXT | Command: GET FILE alpha.txt
+--------------+
+--------------+ 2. When you split the main window, the new window
| ALPHA.TXT | also shows the current buffer (ALPHA.TXT). The
|______________| cursor appears in the new, lower window.
|[] |
| ALPHA.TXT | Command: TWO WINDOWS
+--------------+
+--------------+ 3. Put a different file or buffer in the new window
| ALPHA.TXT | (in this case, BETA.TXT), so you can view and
|______________| edit two buffers at the same time:
|[] |
| BETA.TXT | Command: GET FILE beta.txt
+--------------+
+--------------+ 4. You can move from one window to the other, for
|[] ALPHA.TXT | example, to cut and paste text between buffers:
|______________|
| | Command: OTHER WINDOW
| BETA.TXT |
+--------------+
Usage notes:
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 put a different buffer (or file) into a window, use any of the
following commands:
BUFFER NEW PREVIOUS BUFFER
GET FILE OPEN SHOW BUFFER
NEXT BUFFER OPEN SELECTED SHOW SYSTEM BUFFERS
o To resize windows, use SHRINK WINDOW or ENLARGE WINDOW. The maximum
number and size of windows depend on the size and type of your screen.
The minimum size is 1 line for text plus 1 line for the status line,
and on DECwindows, 1 line for the horizontal scroll bar. For example,
with a 21-line main window (as on a VT220 terminal), you can have 11
windows, each displaying one line of text at a time.
o To delete windows use DELETE WINDOW (deleting the current window) or
ONE WINDOW (deleting the other windows, keeping the current window).
o Multiple windows are also useful in compiling TPU procedures---use one
window for your procedures buffer, and use another window to view the
Messages buffer, so you can read compiler messages more easily when you
use EXTEND commands. See help on Message Buffer.
o To shift the window horizontally (to view wide text), use SHIFT RIGHT
and SHIFT LEFT, or use SET WIDTH to increase the width of the windows.
Related topics:
DELETE WINDOW ENLARGE WINDOW NEXT WINDOW ONE WINDOW
PREVIOUS WINDOW SHRINK WINDOW SPLIT WINDOW TWO WINDOWS
Word Wrap
Set Wrap
Determines whether EVE wraps your text to start a new line when your text
exceeds the right margin.
Usage notes:
o By default, wrap is enabled. When you type at the end of a line, EVE
starts a new line when the cursor goes past the right margin---without
your having to press RETURN.
o Typically you disable wrap if your text must exceed the right margin,
such as in creating wide tables or progressively indented statements in
a source program.
o Set Wrap does not reformat existing text. To reformat your text, use
FILL.
+-------------------------------------------------------------------+
| For help on EVE commands, type the command name and press RETURN. |
+-------------------------------------------------------------------+
Related topics:
FILL SET NOWRAP SET WRAP SHOW
WPS Differences
WPS Differences
SET KEYPAD WPS provides most WPS keypad functions for "GOLD-key editing."
It does NOT fully implement or emulate WPS. The following is a list of
differences between the WPS keypad in EVE and real WPS:
Keys
Keys Definitions
--------------------------------------------------------------------
PF1 GOLD. The WPS keypad makes PF1 the GOLD key, overriding
any current definition of PF1. However, if you set a
different key as GOLD, the WPS keypad uses your GOLD key
without redefining PF1. Setting the WPS keypad defines
EVE's default GOLD key combinations, except GOLD-F13
is defined as the Delete Beginning Sentence key. See
help on Gold Keys.
GOLD-[ DO. Enters an EVE command.
GOLD-> LEARN. Starts a learn sequence, so you can bind several
CTRL/K keystrokes to a single key. To end the learn sequence,
press CTRL/R (defined as REMEMBER) or press the WPS Halt
key (GOLD-`).
SELECT With the WPS keypad, selecting text by pressing SELECT on
PERIOD the mini keypad or PERIOD on the numeric keypad also sets
the direction of the buffer to forward. The direction
does not change if you type the SELECT command or if you
use the mouse to select text.
GOLD-PF3 RESTORE. Reinserts the line, word, or sentence you last
GOLD-PF4 erase. Depending on the version of WPS you are accustomed
to, you may want to redefine these keys as RESTORE WORD
and RESTORE CHARACTER, respectively.
CTRL/C Usually halts an operation, such as a repeat or global
replace. However, if you are using keystroke journaling
(instead of buffer-change journaling), CTRL/C is not
recorded in the journal file. If you use CTRL/C, you
should immediately exit, to save your edits. Otherwise,
if the system fails, you may not be able to recover your
work. This restriction does not apply with buffer-change
journaling, which is the EVE default.
GOLD-N INSERT PAGE BREAK. Inserts a "hard" page break---a form
CTRL/L feed (appearing as a small FF) on a line by itself.
GOLD-P WPS Page Marker. Inserts a "soft" page break---a form
feed and null character (FF and NL) on a line by itself.
PF2 MOVE BY PAGE. Moves to the next or previous page break.
GOLD-PF2 PAGINATE. Inserts a "soft" page break for a 54-line page.
GOLD-C CENTER LINE. Centers the current line between the left
and right margins by adding spaces at the start of the
line. Does not leave a centering mark.
GOLD-G INCLUDE FILE. Inserts the text of a specified file. In
EVE, the GET FILE command lets you create or edit another
file in the same editing session.
GOLD-F EXIT. Ends the editing session, typically writing out the
CTRL/Z current buffer and asking whether to write out any other
F10 buffers if they were modified. Exiting does not delete
the old version of the input file.
Copying, Cutting and Pasting
o EVE commands and WPS keys that work on a standard, linear range also
work on a box. See help on Ranges And Boxes.
o Using SET BOX SELECT makes the following WPS keys work like BOX CUT
and BOX PASTE:
WPS Copy WPS Cut WPS Paste WPS Replace
o WPS keys 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 (specified by GOLD-1 through GOLD-9). EVE
commands and EDT keys use either the Insert Here buffer or the
clipboard, depending on your setting.
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 the
margins or paragraph indent does not automatically rewrap or reformat
text. For more information on using the Ruler, including a list of
keys for moving the cursor in the ruler, see help on Ruler Keys.
Scrolling
Scrolling with WPS keys 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. To
enable a free cursor, which can move anywhere in the buffer, use SET
CURSOR FREE which is otherwise the EVE default setting.
Searches
Searches follow EVE rules for case sensitivity and direction. See help
on FIND.
Paragraph and Sentence Boundaries
"Paragraphs" are bounded by any of the following:
* Blank line
* Top or bottom of the buffer
* Page break (form feed at the start of a line)
* RUNOFF command (such as .BREAK;) at the start of a line
* VAX DOCUMENT tag (such as <LE>) at the start of a line
"Sentences" are bounded by periods, question marks, or exclamation
points. Periods in RUNOFF commands or in decimal numbers are treated
as sentence boundaries.
Features NOT Implemented
o Abbreviation or library documents
o Control commands for printing
o DEAD key
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.)
+---------------------------------------------------------------------+
| For a keypad diagram, press HELP or with the WPS keypad, GOLD-H. |
| |
| For a list of key definitions, see help on Keys or press GOLD-HELP. |
+---------------------------------------------------------------------+
Related topics:
Ranges And Boxes New User Ruler Keys SET KEYPAD WPS
Writedelprompt
Write First
The buffer you want to write out and then delete does not have an output
file specification. You must specify an output file to write out the
buffer before it is deleted.
Steps:
1. In the dialog box, type the name of the file you want to write.
2. To complete the operation, click MB1 on the OK button.
EVE then writes out the buffer to the file you specified,
and then deletes the buffer.
To cancel the operation---nothing deleted, nothing written
out---click MB1 on the CANCEL button.
Related topics:
DELETE BUFFER SHOW BUFFERS SHOW SYSTEM BUFFERS