User's Guide to EVEPlus None Revision/Update Information: Revision/Update Information: Revision/Update Information: A-15 - DECUS Edition This book describes a series of extensions to the EVE Editor called EVEPlus. There are instructions on installing, customizing, and using the EVEPlus editor. Operating System and Version: Operating System and Version: Operating System and Version: VAX/VMS V4.2 Software Version: Software Version: Software Version: E1.0 July, 1985 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Copyright (c) 1985 by Digital Equipment Corporation All Rights Reserved. Printed in U.S.A. The postpaid READER'S COMMENTS form on the last page of this document requests the user's critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: DEC DIBOL RSX DEC/CMS EduSystem UNIBUS DEC/MMS IAS VAX DECnet MASSBUS VMS DECsystem-10 PDP VT DECSYSTEM-20 PDT DECUS RSTS DECwriter PREFACE PREFACE PREFACE INTENDED AUDIENCE INTENDED AUDIENCE INTENDED AUDIENCE This book is intended for users of the EVE text editor who wish to have additional capabilities beyond what EVE itself provides. CONVENTIONS USED IN THIS DOCUMENT CONVENTIONS USED IN THIS DOCUMENT CONVENTIONS USED IN THIS DOCUMENT Convention Meaning Convention Meaning Convention Meaning The phrase CTRL/x indicates that you must press the key labeled CTRL whily you simultaneously press another key. [option] Square brackets indicated that the enclosed item is optional. (Square brackets are not, however, optional in the syntax of a directory name in a file specification). {abc|def} Braces indicate that you must choose one of the enclosed items. ASSOCIATED DOCUMENTS ASSOCIATED DOCUMENTS ASSOCIATED DOCUMENTS The reader is presumed to be familiar with the EVE text editor ___ ___ ______ _____ described in VAX EVE User's Guide. iii CHAPTER 1 CHAPTER 1 CHAPTER 1 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS 1.1 DESCRIBE KEY 1.1 DESCRIBE KEY 1.1 DESCRIBE KEY This command requests a key and then returns a one-line description of the key (if one exists). Format Format Format Describe Key Steps Steps Steps 1. Press . 2. Enter the DESCRIBE KEY command. 3. Press . 4. The editor will ask you to press the key that you wish described. 5. A one-line description of the key is displayed in the message window. 1.2 DESTROY BUFFER 1.2 DESTROY BUFFER 1.2 DESTROY BUFFER This command will destroy the contents of a buffer, and the buffer itself. If the buffer you are destroying has been modified or is a system buffer, you will be asked to confirm the operation. 1-1 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS DESTROY BUFFER DESTROY BUFFER DESTROY BUFFER The DESTROY BUFFER command is useful when you no longer wish to have a buffer in your editing session. Format Format Format Destroy Buffer buffer-name Steps Steps Steps 1. Press . 2. Enter the DESTROY BUFFER command followed by a buffer name. 3. Press . 4. The buffer (and its contents) are deleted from the EVE editing session. If the buffer was mapped to a visible window, another buffer is substituted. 1.3 DISPLAY CHARACTER 1.3 DISPLAY CHARACTER 1.3 DISPLAY CHARACTER When the EVE editor cannot display a character (e.g., a control character) it substitutes a reverse question mark in its place. This command will interpret the character the cursor is on, and produce a readable version. Information about the character includes its octal, decimal, and hexidecimal values. Format Format Format Display Character Steps Steps Steps 1. Press . 2. Enter the DISPLAY CHARACTER command. 3. Press . 1-2 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS DISPLAY CHARACTER DISPLAY CHARACTER DISPLAY CHARACTER 4. The interpretation of the character is displayed in the message window. 1.4 ELIMINATE TABS 1.4 ELIMINATE TABS 1.4 ELIMINATE TABS This command will remove tabs from your file and substitute the proper number of spaces to keep the appearance of the document the same. The ELIMINATE TABS command assumes tabs are set every 8 positions. Format Format Format Eliminate Tabs Steps Steps Steps 1. Press . 2. Enter the ELIMINATE TABS command. 3. Press . 4. All tabs are removed from the buffer and replaced by spaces. 1.5 FIX CRLFS 1.5 FIX CRLFS 1.5 FIX CRLFS This command removes carriage returns and linefeeds from buffers (e.g., if you are reading a file generated by Runoff). Format Format Format Fix CRLFs Steps Steps Steps 1. Press . 1-3 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS FIX CRLFS FIX CRLFS FIX CRLFS 2. Enter the FIX CRLFS command. 3. Press . 4. All carriage-return linefeed sequences are removed. 1.6 LIST BUFFERS 1.6 LIST BUFFERS 1.6 LIST BUFFERS This command will produce a list of buffers currently in use. If you specify ALL buffers, then both system and user buffers are listed, otherwise only user buffers are listed. The LIST BUFFERS command produces the following display: Buffer name Lines Attributes $LOCAL$INI$ 4 System CHOICES 0 Modified No-write System COMMANDS 5 Modified No-write System DCL 0 No-write System HELP 0 No-write System INSERT HERE 0 No-write System LIST BUFFER 12 Modified No-write System MAIL_20E00748.TMP 17 Modified MESSAGES 11 Modified No-write System PROMPTS 0 No-write System SHOW 0 No-write System After you issue the command, the Select and Remove keys change their function (see table below). When you leave the buffer containing the buffer listing (e.g., via the BUFFER, GET FILE, or GOTO commands) the keys are restored to their original function. Function Key Operation Function Key Operation Function Key Operation . 3. Position cursor to the other end of the range of text you want printed. 4. Press . 5. Enter the PRINT RANGE command. 6. Press . 1.13 PRINT SCREEN 1.13 PRINT SCREEN 1.13 PRINT SCREEN Prints the contents of the current screen on a printer attached to the user's terminal. 1-8 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS PRINT SCREEN PRINT SCREEN PRINT SCREEN Format Format Format Print Screen Steps Steps Steps 1. Press . 2. Enter the PRINT SCREEN command. 3. Press . 1.14 RELEASE BUFFERS 1.14 RELEASE BUFFERS 1.14 RELEASE BUFFERS This command will write out all writable, modified user buffers and delete all remaining buffers for the session. This command is useful if you run EVE as a "kept" editor and wish to "clean house". Format Format Format Release Buffers Steps Steps Steps 1. Press . 2. Enter the RELEASE BUFFERS command. 3. Press . 4. You will be positioned in the MESSAGES buffer. From here you can enter commands to bring in new files, etc. 1.15 SEARCH 1.15 SEARCH 1.15 SEARCH This command is an enhanced version of the default searching mechanism built into the Eve editor. The SEARCH command allows wild-carded searches. 1-9 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS SEARCH SEARCH SEARCH Meta Operation/Matches Meta Operation/Matches Meta Operation/Matches * Multi-character wildcard, do not cross record boundaries % Single-character wildcard « Beginning of line » End of line # Multi-character wildcard, cross record boundaries \ Quote next character ^ Next character is a control character Format Format Format Search search-pattern Steps Steps Steps 1. Press . 2. Enter the SEARCH command followed by the string or pattern you wish to locate in the current buffer. 3. Press . 4. You are positioned in your buffer to a string that matches. 1.16 SET EAG WINDOW KEYS 1.16 SET EAG WINDOW KEYS 1.16 SET EAG WINDOW KEYS This command establishes an alternate windowing environment to the one supplied by the Eve editor. Features of EAG windowing are: o Quick or continuous display of all non-system buffer names. o Swift, two-keystroke access to (a maximum of) 9 editing buffers. o Function keys for reading and writing files. 1-10 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS SET EAG WINDOW KEYS SET EAG WINDOW KEYS SET EAG WINDOW KEYS If you enable the EAG window environment, you get the following keypad assignments: Keystroke Sequence Operation Keystroke Sequence Operation Keystroke Sequence Operation _ _ n n = 1 to 9 is equivalent to the EVE _ BUFFER command for that buffer. n = 0 displays buffers. Get a file and map to a buffer. Write file associated with current buffer. Write a named file. Other window. Toggle between 1 and 2 windows. <_^_> <_^_> <_^_> Scroll message window up one line. <_V_> <_V_> <_V_> Scroll message window down one line. --> --> --> Shift current window to the right. <-- <-- <-- Shift current window to the left. The symbol in the above table refers to your current "shift" key. This is established with the SET SHIFT KEY command. A subsetted version of the EAG windowing keys is available via the SET MAPPING command. Format Format Format Set [No]EAG Window Keys Steps Steps Steps 1. Press . 2. Enter the SET EAG WINDOW KEYS command. 1-11 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS SET EAG WINDOW KEYS SET EAG WINDOW KEYS SET EAG WINDOW KEYS 3. Press . 1.17 SET FLASHING 1.17 SET FLASHING 1.17 SET FLASHING This command locates corresponding characters in a buffer and "flashes" them whenever you type the character given in the command. The line with the matching character is displayed in the message window. For example, this command can be used to make the editor display which "(" matches which ")" in a program with the command SET FLASHING ). The following characters can be used to flash their corresponding character: ) } > » ' " Format Format Format Set [No]Flashing characters-to-match Steps Steps Steps 1. Press . 2. Enter the SET FLASHING command followed by one or more characters that are to be matched. 3. Press . 1.18 SET MAPPING 1.18 SET MAPPING 1.18 SET MAPPING This command provides a subset of the features supplied by the SET EAG WINDOWS command. In particular, the SET MAPPING command provides the two-keystroke access to (a maximum of) 9 editing buffers. The following keypad assignments are made with the SET MAPPING command: Keystroke Sequence Operation Keystroke Sequence Operation Keystroke Sequence Operation 1-12 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS SET MAPPING SET MAPPING SET MAPPING _ _ n n = 1 to 9 is equivalent to the EVE BUFFER command for that buffer. 0 Displays the user buffer list. The symbol in the above table refers to your current "shift" key. This is established with the SET SHIFT KEY command. Format Format Format Set [No]Mapping Steps Steps Steps 1. Press . 2. Enter the SET MAPPING command. 3. Press . 1.19 SET MATCHING 1.19 SET MATCHING 1.19 SET MATCHING This command will automatically insert a corresponding character into a buffer. For example, if you type a "(", a matching ")" is also placed in the buffer. The cursor is positioned so that the next character typed will be between the matched characters. The following characters will generate a corresponding match character: ( { < « ` ' " Format Format Format Set [No]Matching characters-to-match 1-13 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS SET MATCHING SET MATCHING SET MATCHING Steps Steps Steps 1. Press . 2. Enter the SET MATCHING command followed by the character(s) you wish to have matched during this editing session. 3. Press . 1.20 SET WRITE 1.20 SET WRITE 1.20 SET WRITE When EVE creates a buffer, it normally considers it writable. Sometimes, it is convenient to mark the buffer as non-writable. This command lets you change current buffer's writable status. If you set the buffer to "No Write" EVE will not automatically write out the ____ __ ___ ______ __ buffer when you exit the editing session even if you modify it. The status line will indicate buffers that have been marked NO WRITE (by bolding and underlining) when the buffer is mapped to a window. Format Format Format Set [No]Write Steps Steps Steps 1. Press . 2. Enter the SET WRITE command. 3. Press . 4. The current buffer will be considered writable or read-only, depending on your choice. 1.21 SET RECTANGULAR 1.21 SET RECTANGULAR 1.21 SET RECTANGULAR This command turns rectangular cut-and-paste on or off. When the SET RECTANGULAR command is issued, the SELECT, REMOVE, and INSERT HERE keys are redefined to perform rectangular cut and paste operations. 1-14 EVEPLUS COMMANDS EVEPLUS COMMANDS EVEPLUS COMMANDS SET RECTANGULAR SET RECTANGULAR SET RECTANGULAR Rectangles are formed by positioning the cursor to where the upper-left corner of the rectangle will be and pressing