% VAX-11 Librarian V04-00 ѷ,@/IJ5 EVE @1 EVE 2 COMMANDS EVEPLUS COMMANDSFP Advance Extend tpu Normal cursor Set noeag window keP Append Extract to file Number lines Set noflashing P Attach Fetch file Occurs Set nomapping P Backup Fill paragraph One window Set nomatching P Bottom Find Only window Set norectangular P Buffer Fix c ), WATSON EVE 6I WATSON EVE ` WATSON EVE!t WATSON EVE =d-{ WATSON EVEO΀楐 WATSON EVEꥐ WATSON EVE`@7 WATSON EVESrlfs Other window Set novms line editP Capitalize word Flush Overstrike mode Set nowrite P Center line Fndnxt Page Set rectangular P Change case Forward Preserve buffers Set right margin P Change direction Full margins Previous screen Set shift key P Change mode Get file Print buffer Set tabs at P Column Go to  lB`1 EVE 2 BUFFER BUFFERA The BUFFER command puts a new buffer in the current window. TheC cursor moves to the position it was in the last time you used this buffer. For example, buffer test.txt@ will return you to the buffer named TEST.TXT. Buffer names areC displayed in the status line at the bottom of the window. You can> use the SHOW command to find out which buffers you have used.! Buffer names may be abbreviated.@ Some EVE commands,  such as TPU and EXTEND TPU, can display many< error messages too rapidly to read. You can use the BUFFER( command to see these messages by typing buffer messages: EVEplus mod: with no argument, offers returns to previous> buffer; typing new buffer name overrides this default action.7 Use Control-C to abort if no action at all is desired. 2 COPYTEXT COPYTEXT (Author: A. Watson) = The COPYTEXT command is identical to the standard EVE Remove@ command with a single exception: the text that is copied to theB Paste Buffer is not removed from the original buffer. It providesB a way to copy text from one file for inclusion in another without@ making any alteration to the original file. That is, you do not@ need to first Remove it and then immediately execute the Insert Here command to put it back. > The TPU procedure is named "eve_copytext". Therefore, you can= execute this command with the DO key followed by "copytext",> or you can use Define Key to place it on any key. I normally> bind it to the Gold-Remove key with a TPU command as follows: > define_key("eve_copytext",key_name(E3,shift_key),"Copytext"); 2 DEFAULT DEFAULT ? EVEplus command, this sets the default device and/or directoryA to use in file input and output operations if none is specified.; Commands affected include Get File, Fetch File, Read File, and Write File. 2 DELETE_END_WORD$ DELETE END WORD (Author: A. Watson) ? Alternative for Erase Word, more closely emul ates EDT's Delete; Word command. This command erases *from the current cursor: location* to the end of the word, rather than erasing the@ entire word on which the cursor is placed. To bind this command: to a key in place of Erase Word, put one of the following; two lines into your TPUINI.TPU file depending on which key& you want to use for it, Minus or F13: ? define_key("eve_delete_end_word",Minus,"delete_end_word");= define_key("eve_delete_end_word",F13,"delete_end_word"); 2 DELETE_WINDOW# DELETE WINDOW (Author: A. Watson)I This command will remove the current window from the screen. The bufferJ associated with the window is not affected. The window being deleted willH be absorbed by the window above it. If the window being deleted is theJ top window on the screen, it will be absorbed by the window below it. IfF only one text window is on screen, an error message will be returned.2 DESCRIBE_KEY DESCRIBE KEYH This EVEplus procedure will display th e comment text associated with aH key by the DEFINE_KEY TPU function. Most keys are defined with a shortL description of their function in this comment field. You can obtain furtherH help on the key's function by typing DO, "HELP", and the text displayedH by DESCRIBE KEY. When asked for "key to describe", press the key whose function you wish to know.2 DESTROY_BUFFER DESTROY BUFFER buffer-nameM This EVEplus command will erase the contents of a buffer and totally deleteH the buffer from EVE's buffer list. It will ask for confirmation first,< if the buffer has been modified since last writing to disk.L If EAG WINDOW KEYS has been set, the GOLD-DELETE key will perform a DESTROY& BUFFER command on the current buffer. 2 DIRECTORY DIRECTORY = This enhancement to EVEplus will produce a directory listing; for you in its own buffer, DIRECTORY BUFFER, which remains; available for re-use. You can place the cursor on any file< specification and press Gold-Select to read  it in (executes This File command). 2 DISPLAY_CHARACTER DISPLAY CHARACTERN This EVEplus procedure will display the numeric values of any key in decimal,L octal, and hexidecimal. Particularly useful for determining the real valueM of non-displayable characters such as control characters, normally displayed? by EVE as a reverse question mark or black square like this: N To use, place the cursor on the character in question and execute the commandG with the DO key. Example: fo r a CTRL/A character the display will be:; Current Character is '', Octal=001, Decimal=1, Hex=01, ^A2 DOMAIL DOMAIL A Enhancement to EVEplus, Author: A. Watson. Provides an interface9 to the Mail utility by running Mail in its own, separate9 DCL subprocess and buffer. Clears away any extra windows; you may have to use only one window, and prompts for input< in the prompt line. Input can be any standard Mail commands; except Spawn. EVEplus windows are used for any Send, Mail, > Reply, or Forward commands, allowing full use of the editor's features. ; While running DOMAIL, Prev Screen and Next Screen keys are9 redefined to scroll the Mail Command window up and down;; the Do key is redefined specially to execute EVE commands;? keypad Minus does "READ/NEW" and keypad Comma does "DIRECTORY/: NEW"; F20 key will do an EVE Attach to Parent command. No@ other keys normally defined for EVEplus will work while running DOMAIL. = To exit DOMAIL back to regular EVEplus, use the Mail command= "EX" or "EXIT", the F10 key, or Control-Z. The Quit command,9 offered to DOMAIL, has a special behavior: it leaves the? Mail program running in the subprocess and returns to EVEplus;9 the next execution of DOMAIL returns to the Mail program where it left off. 2 DRAW_BOX DRAW BOXE Help text to be written by AAW. EVEPLUS command; first tests not too successful.2 ELIMINATE_TABS ELIMINATE TABS (EVEplus); Eliminate Tabs turns  tab characters into spaces, assuming< tabs are set to the default, which is every 8 spaces on the< screen. A tab character will be replaced with 1 to 8 spaces= depending on its location in the line; the appearance of the> line will not be changed. Eliminate Tabs is useful if you are= trying to get columns to line up in Runoff .LITERAL mode andC are having difficulty because of differences between your terminal= and the printer; eliminating tabs and using only spaces will< guarantee that the text is treated identically by both your! terminal screen and the printer.2 EOF EOF (Author: A. Watson)B EOF sends an end of file character (CTRL/Z) to the DCL subprocess@ within EVE. Some programs, if executed by the EVE DCL command,A are difficult to exit because they require a CTRL/Z to exit; EVE< understands a CTRL/Z as its own Exit command and terminatesB EVERYTHING! EOF avoids this problem. For example, if you execute@ HELP within the EVE DCL subprocess, you can exit it back to DCLB level by using the EOF command. Likewise, the MAIL Send or Reply' command may require EOF to exit them. 2 ERASE_CHARACTER ERASE CHARACTER@ Erases the character at the current cursor position. In InsertC mode the rest of the the line moves left one space to close up theA space. In Overstrike mode, the character at the cursor position? is replaced by a space and the rest of the line remains in the same place on the screen.B When the cursor is at the end of a line, the Return at the end ofA that line is deleted. The text on the next line is moved to the' right of the text in the current line. ; EVEplus enhancement: deleted character is saved and can be@ restored by Undelete Char command, normally bound to Gold-Comma: in EVEplus; Erase Character in EVEplus is bound to keypad Comma. 2 ERASE_LINE ERASE LINE( Modified for EVEplus from standard EVE. : Erases from the current cursor position to the end of the> current line, including the e nd-of-line character. If used at@ the start of a line, the entire line is erased from the buffer.; If used anywhere else in the line, all to the right of the@ cursor is erased and the next line is appended to the remaining? portion. The erased line can be inserted back into a buffer by= using the RESTORE command. Bound to PF4 in EVEplus; Gold-PF4 does a Restore. 2 ERASE_WORD ERASE WORDA Erases the current word and moves the cursor to the start of theB next word. If the cursor is between words, then the next word isC erased. If the cursor is at the end of a line, the next line willB be appended to the current line. The erased word can be inserted: back into a buffer by using the RESTORE command. Bound to! the Keypad Minus key in EVEplus. = An alternate command that more closely emulates EDT's Delete; Word command is available and can be substituted for Erase. Word. See separate Help on "Delete End Word". 4 The ERASE WORD key (F13) also invokes this command. 2 EXPAND_WINDOW" EXPAND WINDOW (Author A. Watson)E This procedure will expand or shrink the current window by adding or< subtracting lines from the top and/or bottom of the window.< It will prompt for the lines to "add" to the top or bottom.= To move the top line of the window up on the screen, specify> a negative number of lines to add to the top; to move the top; line lower on the screen, specify a positive number to add< to the top. To move the bottom line down toward the bott omA of the screen, specify a positive number; to move it up, specify; a negative number. To leave either top or bottom where it* is, specify 0 or just hit the Return key. 2 FETCH_FILE? The Fetch File command is a variation of the Get File command;> it reads a file into a new buffer. If the buffer name already< exists, however, instead of requiring a new buffer name, it; offers the option of overwriting the existing buffer or of@ creating a new buffer with a new name. This allows re-reading a8 file which has been undesirably modified in the buffer.> Uses the device/directory defaults set by the Default command9 if any have been given; otherwise uses process defaults.2 FILL_PARAGRAPH@ FILL PARAGRAPH reformats the current paragraph so the text fitsA between the left and right margins. The cursor moves to the end= of the current paragraph. Note that filling occurs correctly; whatever the settings of the margins (see Set Left Margin, Set Right Margin).; Blank l ines and RUNOFF (Digital's standard text formatting: program) command lines are recognized by EVE as paragraph> boundaries. You may place the cursor anywhere in the current3 paragraph before using the FILL PARAGRAPH command.= Modified for EVEplus to also recognize LaTeX commands (lines= starting with a reverse slash, "/") as paragraph delimiters,2 allowing paragraph filling in LaTeX source files. 2 FIX_CRLFS FIX CRLFSK This EVEplus procedure will scan an entire buffer, turning !carriage returnGand line feed characters into EVE line breaks, and removing leading CRsLand trailing CRLFs. Useful for processing Runoff output files into editableform for modification. 2 GET_FILE GET FILE@ Use the GET FILE command when you wish to start editing anotherA file. GET FILE reads a file from the file system, puts the file< in a new buffer, and displays the new buffer in the current@ window. The cursor is moved to the beginning of the file. The; file still exists in "its original form in the file system. For example, get file test.txtC will move the cursor to the beginning of the file test.txt, in the new buffer test.txt.@ If a modified buffer with the same name as the new file already@ exists, GET FILE will ask you for a buffer name. In some casesB you will want a new buffer; in other cases you will probably wantB to use the BUFFER command to move to a file that is already being- edited. (See also Fetch File and Read File.) 9 M#odified for EVEplus to use default device and directory9 specified by the Default command, if any has been given. 2 HELP HELP? The HELP key provides help on keypad commands. After pressingB HELP, press the key that you want HELP on. Press RETURN to leave help.A To get help on more advanced EVE commands, use the HELP command.A Press the DO key, type help, and press RETURN. The HELP commandA will then provide you with a list of all the EVE commands. TypeA the name of the c$ommand that you want help on, or type ? to seeB the list of commands again. Press RETURN without typing anything? in order to leave the HELP command. If you are using the HELP1 key, press RETURN before using the HELP command.? You can ask for help on a particular command in one step. For example, help top& will provide help on the TOP command.7 Programmer's note: modified in EVEplus to first searchF SYS$LIBRARY:EVEPLUSHELP.HLB before searching SYS$LIBRARY:TPUHELP.HLB. %2 LIST_BUFFERS LIST BUFFERS8 This EVEplus command will produce a list of all buffers< currently in use. If you specify LIST ALL BUFFERS, the bothA system and user buffers are listed; otherwise, only user buffers@ are listed. The display includes the following information forA each buffer: name, number of lines, modification status, and any/ special attributes such as NO WRITE or SYSTEM.= After you use the command, the Select And Remove keys change? their function to "select" (e &xecute a BUFFER command) a buffer< or "remove" (delete) the buffer; place the cursor on a line? containing the buffer name you want to select or remove. When< you leave the LIST BUFFERS buffer, the keys are restored to their original functions.2 LIST_COMMANDS LIST COMMANDSA This EVEplus procedure scans the command definitions internal to? EVE and creates a sorted list of all defined commands known to> this copy of EVE, whether or not help files are available for@ the commands. ' The sorted list is displayed in a special window? that is displayed full screen. You can scroll through the list? with NEXT SCREEN and PREVIOUS SCREEN. Pressing DO will remove? the list from the screen; if you don't want to actually DO any* command at this point, just press RETURN.< The list is still in memory, and can be brought back to the3 screen in any window by the command "BUFFER SHOW".2 MAIL_A_BUFFER# MAIL A BUFFER (Author: A. Watson)? MAIL A BUFFER will invoke VMS MAI(L and send the current buffer? as a Mail message. It will prompt you for "To:" whom you want$ the message to go, and the Subject. ; You must create a buffer containing the message BEFORE you" invoke the Mail A Buffer command. = Note: see DOMAIL for complete interface to the Mail utility. 2 MESS_DOWN MESS DOWN See MESSAGE_WINDOW_DOWN.2 MESSAGE_WINDOW_DOWN MESSAGE WINDOW DOWN? This EVEplus command scrolls the MESSAGE WINDOW down one line.: Mapped to the GOLD DOWN)-ARROW key by SET EAG WINDOW KEYS. 2 MESS_UP MESS UP See MESSAGE_WINDOW_UP.2 MESSAGE_WINDOW_UP MESSAGE WINDOW UP= This EVEplus command scrolls the MESSAGE WINDOW up one line.8 Mapped to the GOLD UP-ARROW key by SET EAG WINDOW KEYS.2 MOVE_BY_SENTENCE& MOVE BY SENTENCE (Author: A. Watson)< Moves the cursor to the next end of sentence, moving in the6 current direction. Usually mapped to the GOLD-E key. 2 MOVE_DOWN MOVE DOWNC Moves the cursor down one line on the* screen. If the cursor is on@ the last line of a window, scrolls the window forward one line.9 Because EVEplus does not use "free" cursor movement, the< presence of tab characters in lines may appear to cause the: cursor to move left to right (because tabs are treated as: single characters no matter how many spaces are displayed on the screen.)) The down-arrow key invokes this command. 2 MOVE_LEFT MOVE LEFT? Moves the cursor left one column on the screen. If the cursor? is on t+he first column on the screen, it wraps to the previousA line and shifts the window if necessary. (Modified for EVEplus.)) The left-arrow key invokes this command. 2 MOVE_RIGHT MOVE RIGHT@ Moves the cursor right one column on the screen. If the cursor> is on the last column on the screen, it wraps to the previous@ line and shifts the window as required. (Modified for EVEplus.)* The right-arrow key invokes this command. 2 MOVE_UP MOVE UPA Moves the cursor up one line on the s,creen. If the cursor is onB the first line of a window, scrolls the window backward one line.' The up-arrow key invokes this command.9 Because EVEplus does not use "free" cursor movement, the< presence of tab characters in lines may appear to cause the: cursor to move left to right (because tabs are treated as: single characters no matter how many spaces are displayed on the screen.)2 NEWOUT NEWOUT (Author: A. Watson)< Changes the name of the output file for the current buffe -r.@ Allows you to change the name of the output file to be written.> The file is NOT written by this command; only the name of the output file is changed. 2 NEXTLINE NEXTLINE (Author: A. Watson); This command moves the cursor to the beginning of the next> line, moving the the direction (forward or reverse) currently= set for the buffer. It functions identically to the KP0 key< in EDT. For efficiency it should always be bound to a key;0 the normal Bergen Record EVE binding is to KP 0.= To bind to another key, use the TPU define_key function, not@ EVE's Define Key command, which will not recognize the Nextline; command. The full name of the procedure to use in the TPU= command is "aaw_nextline". The command can be executed with5 the DO key by typing DO and then "TPU AAW_NEXTLINE".wwww0 ?ꥐ1 EVE 2 COMMANDS EVEPLUS COMMANDSFP Advance Extend tpu Normal cursor Set noeag window keP Append Extract to file Number lines Set noflashing P Attach Fetch file Occurs Set nomapping P Backup Fill paragraph One window Set nomatching P Bottom Find Only window Set norectangular P Buffer Fix c1rlfs Other window Set novms line editP Capitalize word Flush Overstrike mode Set nowrite P Center line Fndnxt Page Set rectangular P Change case Forward Preserve buffers Set right margin P Change direction Full margins Previous screen Set shift key P Change mode Get file Print buffer Set tabs at P Column Go to 2 Quit Set tabs every P Copytext Help Quote Set vms line editinP Dcl Home Read file Set width P Default Include buffer Read mail Set write P Define key Include file Recall Shift left P Delete Indent Rectangular insert Shift right P Delete end word Insert here Rectangular r3emove Show P Delete window Insert mode Rectangular select Show map P Describe key Keep Refresh Sort buffer P Destroy buffer Last buffer Release buffers Space P Directory Learn Remember Spawn P Dired Line Remove Spell P Display character List all buffers Repeat Split w4indow P Do List buffers Replace Start of line P Domail List commands Restore Status line off P Dont really exit List keys Return Status line on P Draw box Locate key Reverse Tab P Eag find mark Lowercase word Rigid cursor Text margins P Eag insert mark Mail a buffer Rigid down This file P5 Eag remove mark Map buffer Rigid left Time P Eliminate tabs Mark Rigid right Toggle number of wiP End of line Mess down Rigid up Top P End of window Mess up Save extended tpu Tpu P Eof Move by line Scrolling Transpose char P Erase character Move by paragraph Search Transpose lines P Erase line 6 Move by sentence Section Trim buffer P Erase previous word Move by word Select Two windows P Erase start of line Move down Send to dcl Undelete char P Erase to eol Move left Set eag markers Uppercase word P Erase word Move right Set eag window keys What line P Execute dcl line Move up Set flashing Whitespace compressP Execute eve buffer Newout 7 Set left margin Write file P Execute eve file Next screen Set mapping Zap < Exit Next window Set matching < Expand window Noonly Set noeag markers 7 FOLLOWING IS STANDARD "EVE" command list, categorized:O KEYPAD COMMANDS@ Change Direction Find Move Right Select? Change Mode Help Move Up Spacef= Delete Insert Here8 Next Screen Tabl7 Do Move By Line Previous Screen . Erase Word Move Down Remove. Exit Move Left Return EDITING COMMANDSiJ Bottom Fill Paragraph Overstrike Mode Set Right MarginG Capitalize Word Forward Quit Start Of Linen= Center Line Go To Quote TopeH End Of Line Insert Mode Recall Uppercase Word/ Erase Cha9racter Line Replacee/ Erase Line Lowercase Word Restore*/ Erase Previous Word Mark Reverseh7 Erase Start Of Line Move By Word Set Left Margink FILE AND WINDOW COMMANDSy2 Buffer One Window Write File# Get File Other WindowC" Include File Two Windows ADDITIONAL SCREEN COMMANDSe, Refresh Set Width Show! Set Tabs At Shift Leftt" Set Tabs Every Shift Right: ADVANCED COMMANDSB Attach Extend TPU Repeat Spawn@ DCL Learn Save Extended TPU TPU5 Define Key Remember Set Shift Key.2 BUFFER BUFFER A The BUFFER command puts a new buffer in the current window. TheoC cursor moves to the position it was in the last time you used thise buffer. For example, buffer test.txta@ will return you to the buffer named TEST.TXT. Buffer names areC displayed i;n the status line at the bottom of the window. You cani> use the SHOW command to find out which buffers you have used.! Buffer names may be abbreviated. @ Some EVE commands, such as TPU and EXTEND TPU, can display many< error messages too rapidly to read. You can use the BUFFER( command to see these messages by typing buffer messagess: EVEplus mod: with no argument, offers returns to previous> buffer; typing new buffer name overrides this default action.7 Use Control-C to abort <if no action at all is desired.2 COLUMN COLUMN  E Author A. Watson. Positions the cursor to a particular column on the E current line, given the column number. Column numbers begin at 1. Ift< no number is given, simply reports current column position. tF If a column number is given that is past the current end of line, theC procedure notifies you and asks if you wish to extend the line. If 1 you reply yes, the line is extended with blanks. d2 COMMAND_PROCEDURES Q- See EXECUTE= EVE FILE and EXECUTE EVE BUFFER.i 2 COPYTEXT COPYTEXT (Author: A. Watson) i= The COPYTEXT command is identical to the standard EVE Remove @ command with a single exception: the text that is copied to theB Paste Buffer is not removed from the original buffer. It providesB a way to copy text from one file for inclusion in another without@ making any alteration to the original file. That is, you do not@ need to first Remove it and then immediately execute the Insert Here command to put i>t back. > The TPU procedure is named "eve_copytext". Therefore, you can= execute this command with the DO key followed by "copytext",e> or you can use Define Key to place it on any key. I normally@ bind it to the Gold-Remove key and to Gold-X with the following TPU commands: t> define_key("eve_copytext",key_name(E3,shift_key),"Copytext");? define_key("eve_copytext",key_name("X",shift_key),"Copytext");r 2 DEFAULTr DEFAULT l? EVEplus command, this sets the default device and/or dire?ctoryeA to use in file input and output operations if none is specified.a; Commands affected include Get File, Fetch File, Read File,c; and Write File. To set a new default, give it as argument:  u default sys$login:[mydir.com]o n: To display the current default settings, give the command with no argument: E defaulto a2 DELETE_END_WORDd$ DELETE END WORD (Author: A. Watson) l? Alternative for Erase Word, more closely emulates EDT's Delete; Word command. This command erases *Afrom the current cursor: location* to the end of the word, rather than erasing the@ entire word on which the cursor is placed. To bind this command: to a key in place of Erase Word, put one of the following; two lines into your TPUINI.TPU file depending on which key& you want to use for it, Minus or F13: l? define_key("eve_delete_end_word",Minus,"delete_end_word");a= define_key("eve_delete_end_word",F13,"delete_end_word"); 2 DELETE_WINDOWu# DELETE WINDOW (Author: A. Watson) AI This command will remove the current window from the screen. The buffernJ associated with the window is not affected. The window being deleted willH be absorbed by the window above it. If the window being deleted is theJ top window on the screen, it will be absorbed by the window below it. IfF only one text window is on screen, an error message will be returned.2 DESCRIBE_KEY DESCRIBE KEY@ This EVEplus procedure will display the comment text associated: with a key by the DEFINE_KEY BTPU function. Most keys are; defined with a short description of their function in this8 comment field. To execute it, press the Do Key and type? "describe" and then Return. When asked for "key to describe",n/ press the key whose function you wish to know.  w@ You can obtain further help on the key's function by typing DO,8 "HELP", and the command name displayed by DESCRIBE KEY.2 DESTROY_BUFFER DESTROY BUFFER buffer-nameM This EVEplus command will erase the contents of a buffer aCnd totally delete H the buffer from EVE's buffer list. It will ask for confirmation first,< if the buffer has been modified since last writing to disk.L If EAG WINDOW KEYS has been set, the GOLD-DELETE key will perform a DESTROY& BUFFER command on the current buffer. 2 DIRECTORYi DIRECTORY t= This enhancement to EVEplus will produce a directory listings; for you in its own buffer, DIRECTORY BUFFER, which remainss; available for re-use. You can place the cursor on any filet< specificaDtion and press Gold-Select to read it in (executes This File command).2 DIRED DIRED  T< Users of EMACS will know what this is. The version of DIRED> provided here does not have *all* of the features of DIRED in* EMACS but it has the most important ones. > DIRED is not bound to any key; execute it with the DO key and then type "DIRED".S A DIRED is a "Directory Editor". It will start a DCL subprocess ifE? one does not exist, and pass a "DIRECTORY filespec" command tEoo? it to produce a directory listing in a buffer. Your cursor is 9 then placed into the buffer on the first file name line.e8 While in DIRED, several keys are re-defined for special5 "editing" of the directory. The keys are as follows:n ; E -- "Examine" the file. Causes the file to be read into an? buffer. You can use any of the normal positioning keys to scan < the file. It is possible to modify the file; normally, any= modifications you make will not be saved, but if you want to<F actually edit, you can, and can save your changes using the> "Write File" command (or the Gold-Enter key, which will write the current buffer). A While in Examine mode, all keys function normally except CTRL/Z,m" which is used to return to DIRED. 7 If in a DIRED directory listing you type "E" on a line A containing the name of a subdirectory file, DIRED will go into aeA sublevel of directory editing and will display a listing of thath subdirectory. e* You exit "exaGmine mode" by typing CTRL/Z.? D -- Marks the file on that line with "D" for delete; the filet' will be deleted when you "quit" DIRED.u d: N -- For "next", moves the cursor to the next file in the listing.f :> P -- For "previous", moves the cursor to the previous file in the listing.n o@ ?,H -Displays a brief Help buffer that lists these commands for DIRED operations. t= U -- For "undelete" will remove the "D" on the file you have =H previously marked for delete. Typing a space will also do ani undelete. n6 Q -- "Quit" this level of DIRED. If you are editing a? sub-directory, you will return to the previous DIRED directory4= level. If you are at the top level DIRED directory, you will > return to normal EVEplus in the buffer you were in when DIRED was invoked. ? When you quit a DIRED level, you will be shown a list of filesW> you have marked for delete (if any), and asked to confirm the dIeletion. n 2 DISPLAY_CHARACTER  DISPLAY CHARACTER> This EVEplus procedure will display the numeric values of anyA key in decimal, octal, and hexidecimal. Particularly useful foreA determining the real value of non-displayable characters such asm; control characters, normally displayed by EVE as a reversel+ question mark or black square like this: T: To use, place the cursor on the character in question and< execute the command with the DO key. Example: for a CTRL/A character theJ display will be:i; Current Character is '', Octal=001, Decimal=1, Hex=01, ^Ao2 DOMAIL DOMAIL  cA Enhancement to EVEplus, Author: A. Watson. Provides an interfacer9 to the Mail utility by running Mail in its own, separate 9 DCL subprocess and buffer. Clears away any extra windows; you may have to use only one window, and prompts for input< in the prompt line. Input can be any standard Mail commands; except Spawn. EVEplus windows are used for any Send, Mail,d> Reply, or Forward comKmands, allowing full use of the editor's features. i; While running DOMAIL, Prev Screen and Next Screen keys aree9 redefined to scroll the Mail Command window up and down;h; the Do key is redefined specially to execute EVE commands;? keypad Minus does "READ/NEW" and keypad Comma does "DIRECTORY/ : NEW"; F20 key will do an EVE Attach to Parent command. No@ other keys normally defined for EVEplus will work while running DOMAIL. h= To exit DOMAIL back to regular EVEplus,L use the Mail commandc= "EX" or "EXIT", the F10 key, or Control-Z. The Quit command, 9 offered to DOMAIL, has a special behavior: it leaves ther? Mail program running in the subprocess and returns to EVEplus;e9 the next execution of DOMAIL returns to the Mail programd where it left off.n 2 DRAW_BOX DRAW BOXE Help text to be written by AAW. EVEPLUS command; first tests not toor successful.2 ELIMINATE_TABS ELIMINATE TABS (EVEplus); Eliminate Tabs turns tab characters into spaMces, assumingE< tabs are set to the default, which is every 8 spaces on the< screen. A tab character will be replaced with 1 to 8 spaces= depending on its location in the line; the appearance of theu> line will not be changed. Eliminate Tabs is useful if you are= trying to get columns to line up in Runoff .LITERAL mode andeC are having difficulty because of differences between your terminal= and the printer; eliminating tabs and using only spaces willy< guarantee that the text is treated idenNtically by both your! terminal screen and the printer.t 2 END_OF_LINEl END OF LINE A This command moves the cursor to the end of the current line. InaA normal EVE, a message is displayed if you are already at the endo; of the line. In EVEplus the behaviour has been modified toE< be like EDT. That is, if you are at end of line, the cursor; will move to the next (or previous) line, depending on ther$ setting of direction in the buffer.% The CTRL/E key invokes this command.2 END_OFO_WINDOWS END OF WINDOW A< Author A. Watson. Moves the cursor to the lower left corner= of the current window. Usually bound to the Gold-Next Screen  key of VT200's.2 EOFa EOF (Author: A. Watson) B EOF sends an end of file character (CTRL/Z) to the DCL subprocess@ within EVE. Some programs, if executed by the EVE DCL command,A are difficult to exit because they require a CTRL/Z to exit; EVE< understands a CTRL/Z as its own Exit command and terminatesB EVERYTHING! EOF avoids this Pproblem. For example, if you execute@ HELP within the EVE DCL subprocess, you can exit it back to DCLB level by using the EOF command. Likewise, the MAIL Send or Reply' command may require EOF to exit them. u2 ERASE_CHARACTER  ERASE CHARACTER@ Erases the character at the current cursor position. In InsertC mode the rest of the the line moves left one space to close up the$A space. In Overstrike mode, the character at the cursor positiono? is replaced by a space and the rest of the liQne remains in theo same place on the screen.B When the cursor is at the end of a line, the Return at the end ofA that line is deleted. The text on the next line is moved to thee' right of the text in the current line.r ; EVEplus enhancement: deleted character is saved and can ben@ restored by Undelete Char command, normally bound to Gold-Comma: in EVEplus; Erase Character in EVEplus is bound to keypad Comma.f 2 ERASE_LINE ERASE LINEe( Modified for EVEplus from standard EVE. s:R Erases from the current cursor position to the end of the> current line, including the end-of-line character. If used at@ the start of a line, the entire line is erased from the buffer.; If used anywhere else in the line, all to the right of ther@ cursor is erased and the next line is appended to the remaining? portion. The erased line can be inserted back into a buffer by = using the RESTORE command. Bound to PF4 in EVEplus; Gold-PF4p does a Restore.2 ERASE_TO_EOL ERASE TO EOLh e" Erase To EOL performs as follows: ; -- if the cursor is anywhere other than the start of line,s@ everything from the cursor up to (but not including) the end of line marker is erased.u @ -- if the cursor is at the start of line, all characters on the' line are erased, leaving a blank line. : -- if the cursor is on a blank line, the line is entirely erased. h1 This command is executed by Gold-KP2 in EVEplus.a wA To restore text erased with this procedure you may use GOLD-PT Quit Set tabs every P Copytext Help Quote Set vms line editinP Dcl Home Read file Set width P Default Include buffer Read mail Set write P Define key Include file Recall Shift left P Delete Indent Rectangular insert Shift right P Delete end word Insert here Rectangular rUemove Show P Delete window Insert mode Rectangular select Show map P Describe key Keep Refresh Sort buffer P Destroy buffer Last buffer Release buffers Space P Directory Learn Remember Spawn P Dired Line Remove Spell P Display character List all buffers Repeat Split wVindow P Do List buffers Replace Start of line P Domail List commands Restore Status line off P Dont really exit List keys Return Status line on P Draw box Locate key Reverse Tab P Eag find mark Lowercase word Rigid cursor Text margins P Eag insert mark Mail a buffer Rigid down This file PW Eag remove mark Map buffer Rigid left Time P Eliminate tabs Mark Rigid right Toggle number of wiP End of line Mess down Rigid up Top P End of window Mess up Save extended tpu Tpu P Eof Move by line Scrolling Transpose char P Erase character Move by paragraph Search Transpose lines P Erase line X Move by sentence Section Trim buffer P Erase previous word Move by word Select Two windows P Erase start of line Move down Send to dcl Undelete char P Erase to eol Move left Set eag markers Uppercase word P Erase word Move right Set eag window keys What line P Execute dcl line Move up Set flashing Whitespace compressP Execute eve buffer Newout Y Set left margin Write file P Execute eve file Next screen Set mapping Zap < Exit Next window Set matching < Expand window Noonly Set noeag markers 7 FOLLOWING IS STANDARD "EVE" command list, categorized:D KEYPAD COMMANDS@ Change Direction Find Move Right Select? Change Mode Help Move Up Space = Delete Insert Here Z Next Screen Tabr7 Do Move By Line Previous Screen. Erase Word Move Down Remove. Exit Move Left Return EDITING COMMANDSRJ Bottom Fill Paragraph Overstrike Mode Set Right MarginG Capitalize Word Forward Quit Start Of Linee= Center Line Go To Quote TopH End Of Line Insert Mode Recall Uppercase Word/ Erase Cha[racter Line Replacep/ Erase Line Lowercase Word Restoreb/ Erase Previous Word Mark Reversea7 Erase Start Of Line Move By Word Set Left Marginr FILE AND WINDOW COMMANDST2 Buffer One Window Write File# Get File Other Windows" Include File Two Windows ADDITIONAL SCREEN COMMANDSi, Refresh Set Width Show! Set Tabs At Shift Left " Set Tabs Every Shift Right\ ADVANCED COMMANDSB Attach Extend TPU Repeat Spawn@ DCL Learn Save Extended TPU TPU5 Define Key Remember Set Shift Keyc2 BUFFER BUFFERlA The BUFFER command puts a new buffer in the current window. TheOC cursor moves to the position it was in the last time you used thisf buffer. For example, buffer test.txtr@ will return you to the buffer named TEST.TXT. Buffer names areC displayed i ]n the status line at the bottom of the window. You canf> use the SHOW command to find out which buffers you have used.! Buffer names may be abbreviated.a@ Some EVE commands, such as TPU and EXTEND TPU, can display many< error messages too rapidly to read. You can use the BUFFER( command to see these messages by typing buffer messagesd: EVEplus mod: with no argument, offers returns to previous> buffer; typing new buffer name overrides this default action.7 Use Control-C to abort ^if no action at all is desired.p2 COLUMN COLUMN  dE Author A. Watson. Positions the cursor to a particular column on theEE current line, given the column number. Column numbers begin at 1. Ifo< no number is given, simply reports current column position. nF If a column number is given that is past the current end of line, theC procedure notifies you and asks if you wish to extend the line. Ift1 you reply yes, the line is extended with blanks.D 2 COMMAND_PROCEDURES - See EXECUTE _ EVE FILE and EXECUTE EVE BUFFER.e 2 COPYTEXT COPYTEXT (Author: A. Watson) "= The COPYTEXT command is identical to the standard EVE Remove @ command with a single exception: the text that is copied to theB Paste Buffer is not removed from the original buffer. It providesB a way to copy text from one file for inclusion in another without@ making any alteration to the original file. That is, you do not@ need to first Remove it and then immediately execute the Insert Here command to put i`t back. > The TPU procedure is named "eve_copytext". Therefore, you can= execute this command with the DO key followed by "copytext", > or you can use Define Key to place it on any key. I normally@ bind it to the Gold-Remove key and to Gold-X with the following TPU commands: > define_key("eve_copytext",key_name(E3,shift_key),"Copytext");? define_key("eve_copytext",key_name("X",shift_key),"Copytext");s 2 DEFAULTr DEFAULT a? EVEplus command, this sets the default device and/or direactory A to use in file input and output operations if none is specified.h; Commands affected include Get File, Fetch File, Read File,e; and Write File. To set a new default, give it as argument:, a default sys$login:[mydir.com]  s: To display the current default settings, give the command with no argument: t defaultw 2 DELETE_END_WORDa$ DELETE END WORD (Author: A. Watson) 0? Alternative for Erase Word, more closely emulates EDT's Delete:; Word command. This command erases * bfrom the current cursoru: location* to the end of the word, rather than erasing the@ entire word on which the cursor is placed. To bind this command: to a key in place of Erase Word, put one of the following; two lines into your TPUINI.TPU file depending on which keys& you want to use for it, Minus or F13: F? define_key("eve_delete_end_word",Minus,"delete_end_word"); = define_key("eve_delete_end_word",F13,"delete_end_word"); 2 DELETE_WINDOWr# DELETE WINDOW (Author: A. Watson)i cI This command will remove the current window from the screen. The buffersJ associated with the window is not affected. The window being deleted willH be absorbed by the window above it. If the window being deleted is theJ top window on the screen, it will be absorbed by the window below it. IfF only one text window is on screen, an error message will be returned.2 DESCRIBE_KEY DESCRIBE KEY@ This EVEplus procedure will display the comment text associated: with a key by the DEFINE_KEY dTPU function. Most keys are; defined with a short description of their function in thisa8 comment field. To execute it, press the Do Key and type? "describe" and then Return. When asked for "key to describe",/ press the key whose function you wish to know.A (@ You can obtain further help on the key's function by typing DO,8 "HELP", and the command name displayed by DESCRIBE KEY.2 DESTROY_BUFFER DESTROY BUFFER buffer-nameM This EVEplus command will erase the contents of a buffer aend totally delete H the buffer from EVE's buffer list. It will ask for confirmation first,< if the buffer has been modified since last writing to disk.L If EAG WINDOW KEYS has been set, the GOLD-DELETE key will perform a DESTROY& BUFFER command on the current buffer. 2 DIRECTORYa DIRECTORY = This enhancement to EVEplus will produce a directory listingt; for you in its own buffer, DIRECTORY BUFFER, which remainsn; available for re-use. You can place the cursor on any filea< specificaftion and press Gold-Select to read it in (executes This File command).2 DIRED DIREDb < Users of EMACS will know what this is. The version of DIRED> provided here does not have *all* of the features of DIRED in* EMACS but it has the most important ones. > DIRED is not bound to any key; execute it with the DO key and then type "DIRED".W A DIRED is a "Directory Editor". It will start a DCL subprocess if ? one does not exist, and pass a "DIRECTORY filespec" command t go? it to produce a directory listing in a buffer. Your cursor is 9 then placed into the buffer on the first file name line.,8 While in DIRED, several keys are re-defined for special5 "editing" of the directory. The keys are as follows:n ; E -- "Examine" the file. Causes the file to be read into aO? buffer. You can use any of the normal positioning keys to scant< the file. It is possible to modify the file; normally, any= modifications you make will not be saved, but if you want toa< h actually edit, you can, and can save your changes using the> "Write File" command (or the Gold-Enter key, which will write the current buffer).  A While in Examine mode, all keys function normally except CTRL/Z,I" which is used to return to DIRED. 7 If in a DIRED directory listing you type "E" on a linehA containing the name of a subdirectory file, DIRED will go into asA sublevel of directory editing and will display a listing of that  subdirectory. l* You exit "exaimine mode" by typing CTRL/Z.? D -- Marks the file on that line with "D" for delete; the files' will be deleted when you "quit" DIRED.h m: N -- For "next", moves the cursor to the next file in the listing.u C> P -- For "previous", moves the cursor to the previous file in the listing. m@ ?,H -Displays a brief Help buffer that lists these commands for DIRED operations. f= U -- For "undelete" will remove the "D" on the file you havet= j previously marked for delete. Typing a space will also do ant undelete. 6 Q -- "Quit" this level of DIRED. If you are editing a? sub-directory, you will return to the previous DIRED directoryt= level. If you are at the top level DIRED directory, you will > return to normal EVEplus in the buffer you were in when DIRED was invoked.w f? When you quit a DIRED level, you will be shown a list of filesn> you have marked for delete (if any), and asked to confirm the dkeletion. d 2 DISPLAY_CHARACTER  DISPLAY CHARACTER> This EVEplus procedure will display the numeric values of anyA key in decimal, octal, and hexidecimal. Particularly useful foreA determining the real value of non-displayable characters such asi; control characters, normally displayed by EVE as a reverse + question mark or black square like this: a: To use, place the cursor on the character in question and< execute the command with the DO key. Example: for a CTRL/A character thel display will be:s; Current Character is '', Octal=001, Decimal=1, Hex=01, ^Aa2 DOMAIL DOMAILo eA Enhancement to EVEplus, Author: A. Watson. Provides an interfaceh9 to the Mail utility by running Mail in its own, separatel9 DCL subprocess and buffer. Clears away any extra windows ; you may have to use only one window, and prompts for inputg< in the prompt line. Input can be any standard Mail commands; except Spawn. EVEplus windows are used for any Send, Mail,T> Reply, or Forward com mmands, allowing full use of the editor's features. p; While running DOMAIL, Prev Screen and Next Screen keys arev9 redefined to scroll the Mail Command window up and down;t; the Do key is redefined specially to execute EVE commands;u? keypad Minus does "READ/NEW" and keypad Comma does "DIRECTORY/r: NEW"; F20 key will do an EVE Attach to Parent command. No@ other keys normally defined for EVEplus will work while running DOMAIL. n= To exit DOMAIL back to regular EVEplus,n use the Mail commando= "EX" or "EXIT", the F10 key, or Control-Z. The Quit command,r9 offered to DOMAIL, has a special behavior: it leaves the ? Mail program running in the subprocess and returns to EVEplus; 9 the next execution of DOMAIL returns to the Mail programo where it left off.s 2 DRAW_BOX DRAW BOXE Help text to be written by AAW. EVEPLUS command; first tests not tooh successful.2 ELIMINATE_TABS ELIMINATE TABS (EVEplus); Eliminate Tabs turns tab characters into spa oces, assuming < tabs are set to the default, which is every 8 spaces on the< screen. A tab character will be replaced with 1 to 8 spaces= depending on its location in the line; the appearance of the > line will not be changed. Eliminate Tabs is useful if you are= trying to get columns to line up in Runoff .LITERAL mode andDC are having difficulty because of differences between your terminalu= and the printer; eliminating tabs and using only spaces will< guarantee that the text is treated idenptically by both your! terminal screen and the printer.t 2 END_OF_LINE END OF LINE oA This command moves the cursor to the end of the current line. InTA normal EVE, a message is displayed if you are already at the end ; of the line. In EVEplus the behaviour has been modified tok< be like EDT. That is, if you are at end of line, the cursor; will move to the next (or previous) line, depending on thea$ setting of direction in the buffer.% The CTRL/E key invokes this command.E2 END_OFq_WINDOWp END OF WINDOW a< Author A. Watson. Moves the cursor to the lower left corner= of the current window. Usually bound to the Gold-Next Screent key of VT200's.2 EOFc EOF (Author: A. Watson) B EOF sends an end of file character (CTRL/Z) to the DCL subprocess@ within EVE. Some programs, if executed by the EVE DCL command,A are difficult to exit because they require a CTRL/Z to exit; EVEe< understands a CTRL/Z as its own Exit command and terminatesB EVERYTHING! EOF avoids this rproblem. For example, if you execute@ HELP within the EVE DCL subprocess, you can exit it back to DCLB level by using the EOF command. Likewise, the MAIL Send or Reply' command may require EOF to exit them. 2 ERASE_CHARACTERE ERASE CHARACTER@ Erases the character at the current cursor position. In InsertC mode the rest of the the line moves left one space to close up the A space. In Overstrike mode, the character at the cursor position ? is replaced by a space and the rest of the lisne remains in thee same place on the screen.B When the cursor is at the end of a line, the Return at the end ofA that line is deleted. The text on the next line is moved to theh' right of the text in the current line.U .; EVEplus enhancement: deleted character is saved and can be;@ restored by Undelete Char command, normally bound to Gold-Comma: in EVEplus; Erase Character in EVEplus is bound to keypad Comma.m 2 ERASE_LINE ERASE LINE.( Modified for EVEplus from standard EVE. Y: t Erases from the current cursor position to the end of the> current line, including the end-of-line character. If used at@ the start of a line, the entire line is erased from the buffer.; If used anywhere else in the line, all to the right of they@ cursor is erased and the next line is appended to the remaining? portion. The erased line can be inserted back into a buffer byE= using the RESTORE command. Bound to PF4 in EVEplus; Gold-PF4a does a Restore.2 ERASE_TO_EOL ERASE TO EOLf " Eurase To EOL performs as follows: ; -- if the cursor is anywhere other than the start of line,r@ everything from the cursor up to (but not including) the end of line marker is erased.a @ -- if the cursor is at the start of line, all characters on the' line are erased, leaving a blank line.e : -- if the cursor is on a blank line, the line is entirely erased. 1 This command is executed by Gold-KP2 in EVEplus.r A To restore text erased with this procedure you may use GOLD-P vF4,h@ "Restore". Note that the memory area that saves the erased textA is the same as that used by PF4, Erase Line. The Restore commande= will restore exactly that part of the text which was erased.N 2 ERASE_WORD ERASE WORDfA Erases the current word and moves the cursor to the start of thehB next word. If the cursor is between words, then the next word isC erased. If the cursor is at the end of a line, the next line willVB be appended to the current line. The erased word can be insertwed: back into a buffer by using the RESTORE command. Bound to! the Keypad Minus key in EVEplus. = An alternate command that more closely emulates EDT's Deleten; Word command is available and can be substituted for Erasec. Word. See separate Help on "Delete End Word". s4 The ERASE WORD key (F13) also invokes this command.2 EXPAND_WINDOWt" EXPAND WINDOW (Author A. Watson)E This procedure will expand or shrink the current window by adding or:< subtracting lines from the top and/or b xottom of the window.< It will prompt for the lines to "add" to the top or bottom.= To move the top line of the window up on the screen, specifya> a negative number of lines to add to the top; to move the top; line lower on the screen, specify a positive number to addw< to the top. To move the bottom line down toward the bottomA of the screen, specify a positive number; to move it up, specify ; a negative number. To leave either top or bottom where itE* is, specify 0 or just hit the Return ykey.2 EXECUTE_DCL_LINE EXECUTE DCL LINE  y= If you use the DCL command execution ability of EVEplus, you ? often want to re-execute the same command. Until now, you hadm@ to re-type the full command every time. Now, with the creationA of the EXECUTE_DCL_LINE command, you can easily re-execute a DCLs command.l oA Simply place the cursor on the line you want to execute. The DCLb; command line can be in the DCL buffer, a procedure you areh? editing, or in any buffer at all. Hit tzhe DO key, and type thek? command "Execute DCL". The command line the cursor is on willr, be sent to the DCL subprocess and executed. . This command is bound to the Gold-Return key.2 EXECUTE_EVE_BUFFER EXECUTE EVE BUFFER  t: Written by Valerie Matthews of Digital. Usage via Do Key: EXECUTE EVE BUFFER buffername < This executes a series of EVEplus commands contained in the? buffer you name, one command per line. This provides somethingi9 like a Learn Sequence which you can edi{t to your heart'se; content until you get it right. Commands are echoed in thea> message area as they are executed. See also Execute Eve File. g2 EXECUTE_EVE_FILE EXECUTE EVE FILE  = Written by Valerie Matthews of Digital. Usage is via Do Key:t EXECUTE EVE FILE filespec f: This command reads the file you specify into a buffer and? then executes EVEplus commands found in that file, one commandi: per line. This provides a permanent means of keeping sets? of EVEplus commands around fo|r re-execution. Commands executedt> are not echoed to the message area, as in Execute Eve Buffer.8 As a for-instance, here is a command sequence that will> transpose the current paragraph with the preceding paragraph,9 assuming the cursor is somewhere in the lower paragraph.m n REVERSE MOVE BY PARAGRAPHm SELECT FORWARDe MOVE BY PARAGRAPH. REMOVE MOVE UPn REVERSE  MOVE BY PARAGRAPHy FORWARD  INSERT HEREI> If th }is series of commands is placed into a buffer called TP,= then the command "execute eve buffer tp" will run the entirer> sequence for you. Or put it into a file and use "execute eve file tp.eve". @ If you have a series of EVEplus commands you would like to make? part of your EVEplus initialization, put them into a file (sayb: "eveinit.eve") and then insert this TPU command into your TPUINI.TPU file:  t* eve_execute_eve_file("eveinit.eve");> A side comment: if you want y~our TPUINI.TPU executed whenever> you enter EVEplus, no matter what directory you are in at the) time, put this into your login.com file:. l. $ DEFINE/JOB TPUINI SYS$LOGIN:TPUINI.TPU2 EXTRACT_TO_FILEu EXTRACT TO FILE s Author: A. Watson gA Used to write a *selected region* to a file. You can specify thew filespec in the command, e.g.  extract info.txty 8 If no file spec is given, you will be prompted for one. : If no selected region exists, the command issues an error message and exits.n 2 FETCH_FILE? The Fetch File command is a variation of the Get File command;e> it reads a file into a new buffer. If the buffer name already< exists, however, instead of requiring a new buffer name, it; offers the option of overwriting the existing buffer or ofE@ creating a new buffer with a new name. This allows re-reading a8 file which has been undesirably modified in the buffer.> Uses the device/directory defaults set by the Default command9 i f any have been given; otherwise uses process defaults.b2 FILL_PARAGRAPH@ FILL PARAGRAPH reformats the current paragraph so the text fitsA between the left and right margins. The cursor moves to the endc= of the current paragraph. Note that filling occurs correctlye; whatever the settings of the margins (see Set Left Margin,h Set Right Margin).e; Blank lines and RUNOFF (Digital's standard text formatting: program) command lines are recognized by EVE as paragraph> boundaries. You may place the cursor anywhere in the current3 paragraph before using the FILL PARAGRAPH command.l= Modified for EVEplus to also recognize LaTeX commands (linesr= starting with a reverse slash, "/") as paragraph delimiters,2 allowing paragraph filling in LaTeX source files. 2 FIX_CRLFSs FIX CRLFSsK This EVEplus procedure will scan an entire buffer, turning carriage return.Gand line feed characters into EVE line breaks, and removing leading CRseLand trailing CRLFs. Useful for processing Runoff output files into editableform for modification.2 FLUSHe FLUSH n? Two new commands have been added to the EVEplus editor: Flush,T= and Keep. Because these commands are very similar, they are  documented together.c 7 Flush and Keep both search each line of a buffer for ao? particular string and erase lines from the buffer depending on 7 whether or not they contain the specified string. Ther> difference is this: Flush will erase all lines that *contain*? the specified string, while Keep will erase all lines that *dor9 not contain* the specified string. You can think of theB commands in this way: r7 Flush -- erase all lines that contain this string.o :D Keep -- keep only lines that contains this string and erase all others. E@ Both commands are executed by the Do key and typing the command- name; they are not by default bound to keys.e ? For instance, to remove every line in a program which containsr; the string "obsol ete", you would press the Do key and typel: "flush obsolete". Or, if your buffer contains a directory; listing of files, to keep only the lines specifying ".com" 0 files, you would press Do and type "keep .com"." HOW FLUSH AND KEEP TREAT CASE t7 Both procedures allow two types of search: EXACT (case+ dependent) or NO_EXACT (case independent).d pA If the string you type after the command contains only lowercaseyA letters, the search will be case independent. Thus, "flush abc "e4 will erase lines containing "abc", "ABC", or "Abc". i; If the search string contains *any* uppercase letters, thed@ search will be case dependent, or exact. Thus, "keep Abc" will> keep only lines containing "Abc"; lines with "abc", "ABC", or> any other combination of upper and lower case, will be erased: along with lines that don't contain "abc" in any fashion. b= A means is provided to force a case dependent search for alle< lowercase; if you enclose the lowercase string in t wo tildeA characters, the search will be forced to be exact. Thus, "flushnA ~abc~" will erase only lines containing "abc"; lines with "ABC",R; "aBc", or any other combination of case, will be retained.s e@ The Keep command has a built-in safeguard: if the result of theA command would retain no lines, the command is ignored. Thus, ife> you said "keep abc" and no lines contained the letters "abc",> you would see the message "Nothing to keep; command ignored". t8 Flush does not have a similar safeguard, as it would be= difficult to implement. Thus if you say "flush a" and everyo7 line contains a letter A, every line *will* be erased.v e6 In any case, take care using these commands! They can@ drastically alter the contents of a buffer. You may want to use> the Occurs command to view the lines that will potentially be; affected by Flush or Keep before executing either command.VA Remember, however, that Occurs is never case sensitive. You cand@ safeguard yourself by copying the buffer you are working on, as follows:w o; - Create a temporary buffer by executing a command such asdA "Buffer TEMP" (which creates a buffer called TEMP and maps it toe the screen).o u4 - Execute the command "Include Buffer buffer-name",; giving the name of the buffer you want to copy. It will beo copied to the TEMP buffer. d: - Execute the command "Buffer buffer-name" to switch back to the original buffer. oA You can now operate on your original buffer with Flush, Keep, orT< any other commands. If you accidentally delete material youA need, you can switch back to the TEMP buffer and recover it fromf there.  v> Both Flush and Keep will accept their string arguments on theA command line. If no argument is given on the command line, they. will prompt you for the string to search for. l? If, at such a prompt, you simply hit Return, the commands willw0 exit with a message such as "Nothing to Flush". 2 GET_FILE GET FILE@ Use the GET FILE command when you wish to start editing anotherA file. GET FILE reads a file from the file system, puts the filen< in a new buffer, and displays the new buffer in the current@ window. The cursor is moved to the beginning of the file. The; file still exists in its original form in the file system. For example,n get file test.txt C will move the cursor to the beginning of the file test.txt, in ther new buffer test.txt. @ If a modified buffer with the same name as the new file already@ exists, GET FILE will ask you for a buffer name. In some casesB you will want a new buffer; in other cases you will probably wantB to use the BUFFER command to move to a file that is already being- edited. (See also Fetch File and Read File.) G9 Modified for EVEplus to use default device and directoryY9 specified by the Default command, if any has been given.c t2 HELP HELPa? The HELP key provides help on keypad commands. After pressingKB HELP, press t he key that you want HELP on. Press RETURN to leaveE help. Press Next Screen to see help text below the bottom of screen.uA To get help on more advanced EVE commands, use the HELP command.cA Press the DO key, type help, and press RETURN. The HELP command A will then provide you with a list of all the EVE commands. TypedA the name of the command that you want help on, or type ? to seeeB the list of commands again. Press RETURN without typing anything? in order to leave the HELP command. If you are using the HELPi1 key, press RETURN before using the HELP command. ? You can ask for help on a particular command in one step. Fort example,a help top& will provide help on the TOP command.7 Programmer's note: modified in EVEplus to first searchhF SYS$LIBRARY:EVEPLUSHELP.HLB before searching SYS$LIBRARY:TPUHELP.HLB.9 TO EXTRACT HELP TEXT to a file: after you execute a helpe: command, the text you viewed is in a System Buffer called: "HELP". You can use the Buffer command to switch to this; buffer, and then use Write File to write it out to a file.a2 HOME HOME  F< Author A. Watson. Moves the cursor to the upper left corner= of the current window. Usually bound to the Gold-Prev Screenm key on VT200 terminals. .2 INCLUDE_BUFFER INCLUDE BUFFERt i; Author A. Watson. Accepts the name of a buffer as argument.> and includes the contents of the buffer at the current cursor% location. Analogous to Include File.  2 INDENT INDENT. = Aut hor A. Watson. Indent will insert or delete spaces at theo@ left end of a given number of lines. It will prompt you for the? number of lines to indent, and then will prompt for the numberM< of spaces to insert. To remove spaces from the beginning of, lines, specify a negative number (e.g. -4).A Indent, when removing spaces, will delete up to the named numberE: of spaces; it will not delete any non-space characters. A@ restriction: Indent will not delete leading Tab Characters from? a line. Indent is not affected by the current direction set inT@ the buffer; it will always start at the line current containing; the cursor and move forward towards the end of the buffer. 2 KEEP KEEPt h< See the help for the FLUSH command; both Flush and Keep are documented together.v t2 LIST_BUFFERS LIST BUFFERSn8 This EVEplus command will produce a list of all buffers< currently in use. If you specify LIST ALL BUFFERS, the bothA system and user buffers are listed; otherwise, only use r buffers @ are listed. The display includes the following information forA each buffer: name, number of lines, modification status, and any/ special attributes such as NO WRITE or SYSTEM.o= After you use the command, the Select And Remove keys changee? their function to "select" (execute a BUFFER command) a buffer< or "remove" (delete) the buffer; place the cursor on a line? containing the buffer name you want to select or remove. Wheno< you leave the LIST BUFFERS buffer, the keys are r estored to their original functions.2 LIST_COMMANDSf LIST COMMANDS A This EVEplus procedure scans the command definitions internal ton? EVE and creates a sorted list of all defined commands known tod> this copy of EVE, whether or not help files are available for@ the commands. The sorted list is displayed in a special window? that is displayed full screen. You can scroll through the list ? with NEXT SCREEN and PREVIOUS SCREEN. Pressing DO will remove ? the list from the screen; if you don't want to actually DO anyE* command at this point, just press RETURN.< The list is still in memory, and can be brought back to the3 screen in any window by the command "BUFFER SHOW".t 2 LIST_KEYSe LIST KEYS r9 EVEplus special: by pressing the DO key and typing "listrA keys", you can get a complete list of all keys that havet< been defined. The procedure quickly creates a buffer called@ "LIST KEYS", and fills it with a short description of every key? which has been defi ned in your current version of EVEplus. Thea@ buffer is mapped to your current viewing window. You will need@ to use the "Buffer" command to get back to your editing buffer. pA List Keys uses the "help text" that is associated with a defined = key to describe each key. If you use the EVE command "Definee@ Key" to bind commands to keys for your own use, these *will* be< included in the List Keys list. If you define keys in yourA TPUINI.TPU file, using the TPU command "define_key", you mu st beuA certain to include the "help text" as the third parameter of the 0 command for List Keys to find the description.  > List Keys will display some keys like this, "<5>". These are@ "legal" key codes which have no actual corresponding key on the; keyboard, and can be ignored. Numbers from 65 up, however, ? represent the standard ASCII character set. Thus "SHIFT/<65>"sA refers to Shift-A, or "Gold-A" in EVEplus parlance. The Shift ord Gold key is the PF1 key.c  2 LOCATE_KEY LOCATE KEYn> Another EVEplus procedure, Locate Key, accepts the input of a= command name or *partial command name*. It searches the LISTA> KEYS buffer (if it exists) and reports any lines that contain@ the input string. It uses the existing Occurs command to do the< search. Thus, DO "locate key end_of_line" would display the following in the Occurs buffer: m' <5> {end_of_line}o' KP2 {End_of_line}y' CTRL/E {end_of_line}e< If the LIST KEYS buffer does not yet exist, Locate Key will6 first run the List Keys command to create the buffer. w@ Notice that EVEplus command names to look up must be typed with? underscore characters between the words of the command. If youe= type a command name that is not currently bound to a key, or? misspell the command name, the "Occurs" buffer display will be empty. > Since Locate Key is simply searching the LIST KEYS buffer, it; can also be used to see what command is bound to a key, byd; giving the key name instead of the command name. Example:n% "Locate Key pf3" would produce this:e " {PF3} Fndnxt SHIFT/{PF3} Find2 MAIL_A_BUFFERy# MAIL A BUFFER (Author: A. Watson)e? MAIL A BUFFER will invoke VMS MAIL and send the current bufferb? as a Mail message. It will prompt you for "To:" whom you want$ the message to go, and the Subject. ; You must create a buffer containing the message BEFORE youc" invoke the Mail A Buffer command. o= Note: see DOMAIL for complete interface to the Mail utility.r 2 MESS_DOWNl MESS DOWNs See MESSAGE_WINDOW_DOWN.2 MESSAGE_WINDOW_DOWNl MESSAGE WINDOW DOWNc? This EVEplus command scrolls the MESSAGE WINDOW down one line.l: Mapped to the GOLD DOWN-ARROW key by SET EAG WINDOW KEYS. 2 MESS_UP MESS UPa See MESSAGE_WINDOW_UP.2 MESSAGE_WINDOW_UP  MESSAGE WINDOW UPE= This EVEplus command scrolls the MESSAGE WINDOW up one line.i8 Mapped to the GOLD UP-ARROW key by SET EAG WINDOW KEYS.2 MOVE_BY_PARAGRAPHd MOVE BY PARAGRAPH r< Author: A. Watson. Moves the cursor forward or backward one9 paragraph, depending on the direction set in the buffer.c= The cursor will be placed at the paragraph boundary (usuallyo7 a blank line, but could be a Runoff or LaTeX command).e) This command is bound to the Gold-P key.u a2 MOVE_BY_SENTENCE& MOVE BY SENTENCE (Author: A. Watson)< Moves the cursor to the next end of sen tence, moving in the6 current direction. Usually mapped to the GOLD-S key. 2 MOVE_DOWNe MOVE DOWN rC Moves the cursor down one line on the screen. If the cursor is ons@ the last line of a window, scrolls the window forward one line.9 Because EVEplus does not use "free" cursor movement, thea< presence of tab characters in lines may appear to cause the: cursor to move left to right (because tabs are treated as: single characters no matter how many spaces are displayedA on the screen.) Modified for EVEplus; see additional informationc* under "RIGID CURSOR" and "NORMAL CURSOR".) The down-arrow key invokes this command.t 2 MOVE_LEFT MOVE LEFT? Moves the cursor left one column on the screen. If the cursor ? is on the first column on the screen, it wraps to the previousu@ line and shifts the window if necessary. (Modified for EVEplus;< see additional information under "RIGID CURSOR" and "NORMAL CURSOR".)) The left-arrow key invokes this command.h 2 MOVE_RIGHT MOVE RIGHTn@ Moves the cursor right one column on the screen. If the cursor> is on the last column on the screen, it wraps to the previous? line and shifts the window as required. (Modified for EVEplus;e< see additional information under "RIGID CURSOR" and "NORMAL CURSOR".)* The right-arrow key invokes this command. 2 MOVE_UP" MOVE UPA Moves the cursor up one line on the screen. If the cursor is on < the first line of a window, scrolls the window backward one= line. Modified for EVEplus; see additional information undert$ "RIGID CURSOR" and "NORMAL CURSOR". s' The up-arrow key invokes this command.s9 Because EVEplus does not use "free" cursor movement, theo< presence of tab characters in lines may appear to cause the: cursor to move left to right (because tabs are treated as: single characters no matter how many spaces are displayed on the screen.)2 NEWOUT NEWOUT (Author: A. Watson)< Changes the name of the output file for the current buffer.@ Allows you to change the name of the output file to be written.> The file is NOT written by this command; only the name of the output file is changed. 2 NEXTLINE NEXTLINE (Author: A. Watson); This command moves the cursor to the beginning of the next > line, moving the the direction (forward or reverse) currently= set for the buffer. It functions identically to the KP0 keyd< in EDT. For efficiency it should always be bound to a key;& the normal EVEplus binding is to KP0.= To bi nd to another key, use the TPU define_key function, noto@ EVE's Define Key command, which will not recognize the Nextline; command. The full name of the procedure to use in the TPU = command is "aaw_nextline". The command can be executed withs5 the DO key by typing DO and then "TPU AAW_NEXTLINE".a 2 NEXT_WINDOWn! NEXT WINDOW (Author: A. Watson)c: The NEXT WINDOW command moves the cursor to the next text= window below the current one, to the cursor location last in 9 use in that window. It will not move the cursor into thee= single-line Message or Command windows that EVE keeps at thec> bottom of the screen. If the cursor is already in the bottom: window on the screen, the cursor moves to the top window. h; If you have called the Message Buffer into a larger window = above the normal one-line window, NEXT WINDOW will not allow > you to move to that window. In fact, if the buffer displayed= in a window is any SYSTEM buffer except the DCL buffer, NEXTe WINDOW will not move there. d= If only one text window is on screen, NEXT WINDOW will issuee) the message "Only one window on screen." 2 NOONLY NOONLY (Author: A. Watson)? NOONLY undoes the effect of the ONLY WINDOW command, returningu> the screen to whatever multiple windows were in effect before ONLY WINDOW was executed.2 NORMAL CURSOR_ NORMAL CURSOR ; Restores the normal functioning of the four Arrow Keys, as ? described under Move Up, Move Down, Move Left, and Move Right,u; after they have been modified by the Rigid Cursor command.m s2 RIGID CURSOR RIGID CURSORo ? Some users have complained about the way cursor movement worksf= in EVEplus, especially vertical cursor movement. The EVEplusb? cursor commands are based upon *character position* within them? line, rather than absolute screen position. This can result inIA unexpected effects when lines contains Tab characters, which can < display on screen as from one to eight screen columns. Most@ noticably, when moving the cursor vertically through lines that? contain tabs, you may see apparent horizontal movement as well @ because EVEplus is keeping the cursor on the "n"th character ofA a line, which will not always be the same as the "n"th column ofa> the screen. If you are editing formatted compiler input (e.g.) FORTAN) this can be especially annoying. = RIGID CURSOR gives you an optional alternate cursor movementi> that you will find useful. The TPU built-ins give really two< options: what TPU calls "free " or "bound" cursor movement.  o5 "Bound" movement is what EVEplus has had all along. w o9 In "free" movement, cursor positioning is done by screenn@ position rather than character position, which gives you one ofA the things wanted: the ability to move vertically up or down ando> be guaranteed of staying in the same screen column. However,: there are also curious side-effects of this mode in TPU.  t> One side-effect is that the left and right movement keys will= not wrap fr om line to line; they go to the screen margin ande stop. D o@ The second side-effect is that the cursor can go where there is@ no real character. One such example is sitting in the middle of? an 8-space tab character; that's OK and necessary for what you @ want. The other example is not so neat; you can move right past; the actual end of line, all the way to the screen margin.  0@ The third side-effect is that if you do certain things, such as< typing a space, while you are in su ch an "unreal" zone (one= where no characters actually exist), TPU will automatically,e; with no notice to you, fill in the line to the left of thehA cursor with blanks. This can result in lots of lines with extra < trailing blanks or can change a single tab character into a@ small group of spaces plus a tab. This has no visible effect on; the screen, nor on compiles I'm sure, but it can make yourrA source files a little bigger than they need be. If you use thisO= stuff, you might want to tr y using the Do key and the "trim"e9 command to strip off trailing blanks when you are done. i ? To use the alternate cursor commands, enter EVEplus in a file,q@ press the DO key, and type "RIGID CURSOR" plus Return key. ThatA will give you the "free" style I've described. See how you likei> it. You can switch back to the normal EVEplus cursor movement@ with the command "NORMAL CURSOR". I think you may find that for@ most editing, the normal style is best; you may want to use the; rigid style only when you are doing things that are columnf dependent.  @ This alternate "rigid cursor" set of commands is provided on an? expermental basis only. Incidentally, standard EVE as providede? by DEC uses the "rigid cursor"; what I call "normal cursor" inm: EVEplus is unique to EVEplus and is an attempt to emulate EDT-like cursor movement.2 NUMBER_LINES NUMBER LINES; This EVEplus command will insert line numbers at the startm> of every line of the current bu ffer. Room is allowed for six3 digits in the line number, followed by two spaces.  c< Note that these line numbers are actually INSERTED into the@ text of every line, modifying the buffer. There is no UNNUMBER? LINES command, so if you want to preserve the unnumbered text,P< you should make a copy of the text in another buffer before executing NUMBER LINES.2 OCCURS OCCURS (Author: A. Watson)? OCCURS will scan the entire current buffer from top to bottom,l; searching for occurances of a particular text string. Eachc> line with a match will be copied to a scratch buffer, and theA matching text will be bracketed with curly brackets like {this}.iA If the string occurs twice in one line, that line will be copied ; to the scratch buffer twice, once for each occurance. Whene= all lines have been searched, OCCURS will overlay the screenF< with a view of the scratch buffer displaying the occurancesA located. Hitting RETURN or any key will erase the OCCURS BUFFERe" and restore y our original screen. A< If OCCURS finds more than 22 lines containing the text, you= will see only the last 22 on screen in the original display. > To see the rest, use the BUFFER command to move to the buffer; named "OCCURS BUFFER"; you can then view the entire buffert with normal movement commands.U R4 KNOW BUG (6-JUN-1986): Using OCCURS to search for a> single-character text string will cause the procedure to loop> indefinitely; CTRL/C will interrupt it. This should be fixed very soon.e 2 ONE_WINDOW ONE WINDOW = The ONE WINDOW command returns the screen to one view of thetA current buffer. The window the cursor is in becomes the current A window. If you have been viewing two different documents in thet@ two windows, EVE removes the other window from the screen. TheA contents of the other buffer are not affected; you can return tom1 editing this buffer by using the BUFFER command."< When you use the multi-window commands written by A. Watson> (SPLIT WINDOW, NE XT WINDOW, EXPAND WINDOW, and DELETE WINDOW)@ you should not use ONE WINDOW directly. (It is used indirectly< by DELETE WINDOW when you are deleting one of two remaining> windows.) No disastrous results will occur if you do, but you< will leave extraneous windows defined that should have been> deleted with DELETE WINDOW, and possibly EVE's windowing will= become confused; some extra windows may not be unmapped fromh the screen. 2 ONLY_WINDOW ! ONLY WINDOW (Author: A. Watson) ; ONLY WIND OW is designed to be used when you have split thel= screen into multiple windows with SPLIT WINDOW. It will take @ the buffer currently being edited and map it to one full-screen; (lines 1-22) window which will be overlaid on any existingo> windows. The existing windows are not destroyed or unmapped,, they are merely occluded by the new window. c< The effect of ONLY WINDOW is to take the current window and= blow it up to a 22-line window to allow a larger view of thee buffer. MA When yo u are done using this ONLY WINDOW, use the NOONLY commandL8 to remove it, restoring the original multi-window view. s; If you attempt to use SPLIT WINDOW while ONLY WINDOW is inmB effect, you will be told you cannot split the ONLY WINDOW window. aC I like mapping ONLY WINDOW to the KP1 key, and NOONLY to Gold-KP1.C 2 OPENLINE OPENLINE (Author: A. Watson); This command functions like GOLD-KP0 in EDT, and creates a,A blank line above the line on which the cursor rests. The cursorm< is placed upon the new blank line. This command is normally( bound to GOLD-KP0 in Bergen Record EVE.@ For efficiency OPENLINE should always be bound to a key. Direct< execution is possible by DO followed by "tpu aaw_openline".< To bind this to a key, use the TPU define_key function, and= not the EVE Define Key command, which will not recognize ther Openline command.2 OPPS!c DESTROY BUFFER buffer-nameM This EVEplus command will erase the contents of a buffer and totally delete H the b uffer from EVE's buffer list. It will ask for confirmation first,< if the buffer has been modified since last writing to disk.2 OTHER_WINDOW OTHER WINDOW@ The OTHER WINDOW command allows you to move the cursor from oneB window to the other. Many editing functions are performed at theC current location of the cursor, so you may frequently want to move= it from one window to the other. If you want scrolling in af> window, for example, you must have the cursor in that window.2 PAGE PAGEd N9 Author A. Watson. Page searches in the current directionn= for the next Formfeed character that occurs at the beginninge9 of a line, and positions the cursor there. A Formfeed atA= the beginning of a line is the usual delimiter between pages : in a paginated listing, such as compiler output or Runoff output. y2 PRESERVE_BUFFERS PRESERVE BUFFERSs i Author: A. Watson.  < This command, accessible through the Do key, will cause all7 currently modified user buffers to be written to their A associated files. It will not affect system buffers, modified ore< not. One restriction: if a buffer has no associated files,= either input or output, that buffer will not be written to ar? file, but simply retained. Such a buffer can occur only if youe@ use the Buffer command to create a new, empty buffer, and write? text into it without ever issuing a Write File command to link  the buffer to an output file. lA Preserve Buffers is intended primarily for those who like to runs@ EVEplus in a subprocess, using Attach to switch between EVEplusA and the main DCL process. It allows you to quickly preserve youro9 modifications before you leave EVEplus to do other work.O s; Preserve Buffers differs from the existing command Release A Buffers in that Preserve Buffers writes out modified buffers butT= leaves them intact; Release Buffers, in addition, erases thecA buffers and deletes them from your editing context, giving you a@ completely clean slate. The latter is primarily useful when you> have reached or neared your virtual memory limits and need to reclaim buffer space. g SUGGESTIONS FOR USE:e 1. A Learn sequence.e e@ You might want to issue the Do "Learn" command, and then Do the? Preserve Buffers and Attach commands, and bind the key to F20,yA instead of a simple Attach (normally bound to the F20 key). Thist> would cause your buffers to be written out to disk every time you attach to your DCL process. i/ 2. A personal "Preserve_and_Attach" procedure.d > The following TPU code, put into your TPUINI.TPU file, would- create the same effect in compiled TPU code:  i procedure my_exit eve_preserve_buffers; eve_attach; endprocedure; s) define_key("my_exit",F20,"my_exit");a 2 PRINT_BUFFER PRINT BUFFERA This EVEplus command sends the contents of the current editing@ buffer to a designated printer queue (default is Sys$Print).> Embedded control charac ters are translated to a readable form5 (e.g., the BEL character will be printed as ). ; When you execute this command you will be prompted for thee> DCL PRINT command to be used. You can enter any print command? with qualifiers to direct the output to any print queue, causer< multiple copies to be printed, etc. For example, after you? enter PRINT BUFFER, at the prompt "Print command to be used?",y; you could enter "PRINT/QUE=ISDLN03/COPIES=5" to cause five 9 copies of the buffer to be printed on the ISDLN03 queue.I 2 READ_FILEz READ FILEeA Does the same thing as GET FILE except that the buffer is markeduA NOWRITE automatically, so that changes to the buffer will not bee< saved when you exit. This is useful when you want to simply? examine a file and do not want to modify it accidentally. Thet: Read File command has been assigned to the GOLD R key. It9 respects the default device/directory set by the Default: command. Special for EVEplus. 2 READ_MAILa READ MAIL (Author: A. Watson)-; (This command is almost obsolete and may be unavailable if5 in the near future. See DOMAIL for a better option.)  ? The READ MAIL command allows you to read MAIL messages withoute= leaving EVE. It splits the window into two screens (or uses_? another window on screen if one exists), brings the DCL buffermB into it, and executes a MAIL command. The "MAIL>" prompt appears< on the bottom line of the screen. Anything you type at this; point will be sent to t he MAIL program to be executed, forrA example "READ". Output from MAIL will be sent to the DCL buffert on your screen. d= It is recommended that you DO NOT enter a Mail REPLY or SENDgC command, since the mail message must be terminated by a CTRL/Z; itbC is rather tricky to send a CTRL/Z command to MAIL from within EVE!;@ The CTRL/Z key has its own meaning to EVE -- the EXIT command!!@ Hitting CTRL/Z will terminate your EVE session, which you don't want to do. : To exit from the READ MAIL command, enter "EX" or "EXIT".2 SEARCH SEARCH (Wildcard search) : This EVEplus command, enhanced by AAW, performs wildcard = searches. It can be invoked, in Bergen Record EVEplus, from e> the CTRL/F key. Using the Do Key, the command name is simply ; "Search". The following wildcard characters are supported.r3 * Multi-character wildcard, do not cross line endso % Single character wildcard < Beginning of line > End of line, # Multi-character wildcard, cross line ends \ Quote next character 2 ^ Next character is a control character (e.g. ^A)5 [] Match any character contained within the bracketsI2 SET_EAG_WINDOW_KEYSh SET EAG WINDOW KEYS A This EVEplus command defines a whole set of procedures and binds C them to keys for easy execution. No, I don't know what EAG stands ? for! The command set makes it easy to use many buffers and too: list or call them up with simple keystrokes. For the keyA definitions to work YOU MUST HAVE A TPU SHIFT KEY (known also a sNA GOLD KEY) defined. Normally, this is the PF1 key on the keypad.e= You can define your own shift key by the SET SHIFT command. d" Keys defined by this command are:? (All number keys below are KEYBOARD digits, not KEYPAD digits) : GOLD 0 - List current buffers, showing numbers associated with them.I: GOLD n - With "n" being a keyboard digit 1 to 9, call the= buffer associated with that number (in the GOLD 0 list) intoo the current window.3 GOLD ENTER - Writes current buffer to a d isk file.t: ENTER - Does a GET FILE command to read a file from disk;5 if the file has already been read, simply changes tol that buffer.o; GOLD DELETE - The GOLD key followed by the Delete key (theu9 convenience. EAG markers are unnamed. Instead of identifying< the destination marker by name, you go to the most recently? accessed marker in a circular list of five markers, similar to ? the circle of marks in EMACS. Successive requests cause you to > circulate through your markers one by one. If you define two- markers, you can ping pong between the two. a@ Note that if the marker you go to is in another editing buffer,@ that buffer is automatically mapped to the current window. This; provides a convenient way to switch back and forth betweene= buffers, simply by setting a mark in each buffer you want ton8 access. Use "set eag markers" to enable the special key9 assignments; use "set noeag markers" to restore original0 key functions.EA EAG maps three marker functions to the GOLD level of three VT200i keys: K a7 Gold/Insert --- Places a marker at the current cursorn position.h8 Gold/Find --- Positions to the most recently accessed 0 marker unless you are already there, in1 which case it positions you to the next m& marker in the circular list. ; Gold/Remove --- Removes the marker at the current cursor m- position. If you aren't on a marker, yous get a warning message. > This section is a template for customizing the EAG_MARKER.TPU@ support. It is entirely optional; but if you want to change the@ way the support is supplied, copy this section of the file intoA your own TPUINI.TPU initialization file and edit those statmentse? you wish. Use this section in your EVEPlus input files if you A -o- Want to change how the markers are indicated - uncomment and= modify the statement below to get the marker style you want. A (REVERSE is the default; do nothing if that's what you'd like.) h"! eag_g_mark_rendition := reverse;! eag_g_mark_rendition := none; ! eag_g_mark_rendition := bold;i$! eag_g_mark_rendition := underl ine; ! eag_g_mark_rendition := blink;? -o- Want to change the keypad assignment of one or more Marker @ keys. Here are the default assignments. Do nothing if you want= them. Uncomment the statement(s) you need and modify the keyu1 name on the right to get alternate assignments. r6! eag_g_insert_mark_key := key_name ( e2, shift_key );6! eag_g_remove_mark_key := key_name ( e3, shift_key );4! eag_g_find_mark_key := key_name ( e1, shift_key );@ -o- Want to include EAG marker support in your default keypad -; by default, EAG marker support is not enabled. To use EAGo6 markers, issue the eve command "set eag markers". To= disable them, issue the eve command "set noeag markers". Tol9 get marker support in your default keypad, uncomment the/7 statement below and place it in your TPUINI.TPU file. f! eve_set_eag_markers; n SIDE EFFECTS :-o- Describe Key won't work for shifted key sequences.  e= The saving and restoring of the Shift key somehow alters the ? shift key definition so that the Describe Key command, if usedt1 after Set Noeag Markers in an attempt to get thei@ description of a shifted key, will return the definition of PF18 as ``Shift Key'', and will not accept the PF1-Other key@ sequence. This seems of minor consequence since key definitions? can also be viewed using List Keys or Locate Key. For example,eA if you need to know what command, if any, is bound to the Gold-RS- key (Shift Key, R), use Locate Key shift/R. o t&-o- Gold-Remov e definition is changed. p? Gold-Remove in standard EVEplus executes the Copytext command,h? which copies selected text into the Insert Here buffer without = removing it from the editing buffer. When Set EAG Markers ism@ executed this key sequence is re-defined as Remove EAG Marker.  lA Since Copytext is also available via the Gold-X key, this is notF< considered a show stopper. You will need to remember to use< Gold-X for Copytext, that's all, if you have EAG markers in< effect. I f you do a Set Noeag Markers command, the original( definition of Gold-Remove is restored. 2 SET_FLASHING SET FLASHING  f@ EVEplus command. This command locates corresponding charactersA in a buffer and ``flashes'' them whenever you type the characterT? given in the command. It is helpful when you are entering textl8 containing lots of matching pairs of characters such asA parentheses, brackets, quotes, and so on. For instance, when youe? type a left parenthesis, the line containing the correspondingb? right parenthesis will be flashed in the message window at the"> bottom of the screen; the matching character will be flashing from normal to reverse video.: For instance, this command can be used to make the editor: display which ``('' matches which ``)'' with the command: SET FLASHING )4 The following characters can be used to flash their corresponding characters: ) } > ; ' "9 To turn off flashing, use Set Noflash character-to-matchy> You can spe!cify one or more of the characters in a single Set [No]Flash command.i 2 SET_MAPPING SET MAPPING C9 EVEplus command, provides a subset of the Set EAG Window < Keys definitions. In particular, provides the two-keystroke: access to nine editing buffers. The following definitions are included: g; GOLD 0 -- List current buffers, showing numbers associateds with them.O E< GOLD n -- with "n" being a keyBOARD digit 1 to 9; calls the< buffer associated with that number into the currentF4, @ "Restore". Note that the memory area that saves the erased textA is the same as that used by PF4, Erase Line. The Restore command,= will restore exactly that part of the text which was erased.c 2 ERASE_WORD ERASE WORDtA Erases the current word and moves the cursor to the start of thecB next word. If the cursor is between words, then the next word isC erased. If the cursor is at the end of a line, the next line willhB be appended to the current line. The erased word can be inserted: back into a buffer by using the RESTORE command. Bound to! the Keypad Minus key in EVEplus.a t= An alternate command that more closely emulates EDT's Deletes; Word command is available and can be substituted for Erase . Word. See separate Help on "Delete End Word". p4 The ERASE WORD key (F13) also invokes this command.2 EXPAND_WINDOW " EXPAND WINDOW (Author A. Watson)E This procedure will expand or shrink the current window by adding ori< subtracting lines from the top and/or bottom of the window.< It will prompt for the lines to "add" to the top or bottom.= To move the top line of the window up on the screen, specifyo> a negative number of lines to add to the top; to move the top; line lower on the screen, specify a positive number to addO< to the top. To move the bottom line down toward the bottomA of the screen, specify a positive number; to move it up, specifya; a negative number. To leave either top or bottom where it * is, specify 0 or just hit the Return key.2 EXECUTE_DCL_LINE EXECUTE DCL LINEC c= If you use the DCL command execution ability of EVEplus, youo? often want to re-execute the same command. Until now, you had @ to re-type the full command every time. Now, with the creationA of the EXECUTE_DCL_LINE command, you can easily re-execute a DCLu command.t hA Simply place the cursor on the line you want to execute. The DCLl; command line can be in the DCL buffer, a procedure you are ? editing, or in any buffer at all. Hit the DO key, and type thed? command "Execute DCL". The command line the cursor is on will , be sent to the DCL subprocess and executed. t. This command is bound to the Gold-Return key.2 EXECUTE_EVE_BUFFER EXECUTE EVE BUFFERe a: Written by Valerie Matthews of Digital. Usage via Do Key: EXECUTE EVE BUFFER buffername < This executes a series of EVEplus commands contained in the? buffer you name, one command per line. This provides somethingg9 like a Learn Sequence which you can edit to your heart's ; content until you get it right. Commands are echoed in then> message area as they are executed. See also Execute Eve File. o2 EXECUTE_EVE_FILE EXECUTE EVE FILE F= Written by Valerie Matthews of Digital. Usage is via Do Key:u EXECUTE EVE FILE filespec a: This command reads the file you specify into a buffer and? then executes EVEplus commands found in that file, one command : per line. This provides a permanent means of keeping sets? of EVEplus commands around for re-execution. Commands executedh> are not echoed to the message area, as in Execute Eve Buffer.8 As a for-instance, here is a command sequence that will> transpose the current paragraph with the preceding paragraph,9 assuming the cursor is somewhere in the lower paragraph.t p REVERSE  MOVE BY PARAGRAPHa SELECT FORWARDa MOVE BY PARAGRAPHa REMOVE MOVE UP REVERSEe MOVE BY PARAGRAPH FORWARDa INSERT HEREa> If this series of commands is placed into a buffer called TP,= then the command "execute eve buffer tp" will run the entire > sequence for you. Or put it into a file and use "execute eve file tp.eve". @ If you have a series of EVEplus commands you would like to make? part of your EVEplus initialization, put them into a file (sayb: "eveinit.eve") and then insert this TPU command into your TPUINI.TPU file:  r* eve_execute_eve_file("eveinit.eve");> A side comment: if you want your TPUINI.TPU executed whenever> you enter EVEplus, no matter what directory you are in at the) time, put this into your login.com file:  m. $ DEFINE/JOB TPUINI SYS$LOGIN:TPUINI.TPU2 EXTRACT_TO_FILEt EXTRACT TO FILE h Author: A. Watson iA Used to write a *selected region* to a file. You can specify theu filespec in the command, e.g.  extract info.txtn 8 If no file spec is given, you will be prompted for one. : If no selected region exists, the command issues an error message and exits.a 2 FETCH_FILE? The Fetch File command is a variation of the Get File command; > it reads a file into a new buffer. If the buffer name already< exists, however, instead of requiring a new buffer name, it; offers the option of overwriting the existing buffer or ofw@ creating a new buffer with a new name. This allows re-reading a8 file which has been undesirably modified in the buffer.> Uses the device/directory defaults set by the Default command9 if any have been given; otherwise uses process defaults.i2 FILL_PARAGRAPH@ FILL PARAGRAPH reformats the current paragraph so the text fitsA between the left and right margins. The cursor moves to the endt= of the current paragraph. Note that filling occurs correctlye; whatever the settings of the margins (see Set Left Margin, Set Right Margin).e; Blank lines and RUNOFF (Digital's standard text formattinge: program) command lines are recognized by EVE as paragraph> boundaries. You may place the cursor anywhere in the current3 paragraph before using the FILL PARAGRAPH command. = Modified for EVEplus to also recognize LaTeX commands (linesn= starting with a reverse slash, "/") as paragraph delimiters,i2 allowing paragraph filling in LaTeX source files. 2 FIX_CRLFS FIX CRLFSfK This EVEplus procedure will scan an entire buffer, turning carriage returnpGand line feed characters into EVE line breaks, and removing leading CRsdLand trailing CRLFs. Useful for processing Runoff output files into editableform for modification.2 FLUSHC FLUSH ? Two new commands have been added to the EVEplus editor: Flush,e= and Keep. Because these commands are very similar, they arer documented together.h f7 Flush and Keep both search each line of a buffer for a? particular string and erase lines from the buffer depending ons7 whether or not they contain the specified string. TheS> difference is this: Flush will erase all lines that *contain*? the specified string, while Keep will erase all lines that *do 9 not contain* the specified string. You can think of then commands in this way: 7 Flush -- erase all lines that contain this string.  D Keep -- keep only lines that contains this string and erase all others. o@ Both commands are executed by the Do key and typing the command- name; they are not by default bound to keys.e E? For instance, to remove every line in a program which contains ; the string "obsolete", you would press the Do key and typee: "flush obsolete". Or, if your buffer contains a directory; listing of files, to keep only the lines specifying ".com"C0 files, you would press Do and type "keep .com"." HOW FLUSH AND KEEP TREAT CASE 7 Both procedures allow two types of search: EXACT (casek+ dependent) or NO_EXACT (case independent).e sA If the string you type after the command contains only lowercase A letters, the search will be case independent. Thus, "flush abc"r4 will erase lines containing "abc", "ABC", or "Abc". i; If the search string contains *any* uppercase letters, thea@ search will be case dependent, or exact. Thus, "keep Abc" will> keep only lines containing "Abc"; lines with "abc", "ABC", or> any other combination of upper and lower case, will be erased: along with lines that don't contain "abc" in any fashion. d= A means is provided to force a case dependent search for alla< lowercase; if you enclose the lowercase string in two tildeA characters, the search will be forced to be exact. Thus, "flushtA ~abc~" will erase only lines containing "abc"; lines with "ABC",f; "aBc", or any other combination of case, will be retained.d u@ The Keep command has a built-in safeguard: if the result of theA command would retain no lines, the command is ignored. Thus, ift> you said "keep abc" and no lines contained the letters "abc",> you would see the message "Nothing to keep; command ignored". e8 Flush does not have a similar safeguard, as it would be= difficult to implement. Thus if you say "flush a" and everyn7 line contains a letter A, every line *will* be erased.  t6 In any case, take care using these commands! They can@ drastically alter the contents of a buffer. You may want to use> the Occurs command to view the lines that will potentially be; affected by Flush or Keep before executing either command.eA Remember, however, that Occurs is never case sensitive. You cane@ safeguard yourself by copying the buffer you are working on, as follows:T t; - Create a temporary buffer by executing a command such asAA "Buffer TEMP" (which creates a buffer called TEMP and maps it toe the screen).f m4 - Execute the command "Include Buffer buffer-name",; giving the name of the buffer you want to copy. It will bec copied to the TEMP buffer.  e: - Execute the command "Buffer buffer-name" to switch back to the original buffer. tA You can now operate on your original buffer with Flush, Keep, or < any other commands. If you accidentally delete material youA need, you can switch back to the TEMP buffer and recover it fromr there.  s> Both Flush and Keep will accept their string arguments on theA command line. If no argument is given on the command line, theyu. will prompt you for the string to search for. r? If, at such a prompt, you simply hit Return, the commands wille0 exit with a message such as "Nothing to Flush". 2 GET_FILE GET FILEi@ Use the GET FILE command when you wish to start editing anotherA file. GET FILE reads a file from the file system, puts the fileu< in a new buffer, and displays the new buffer in the current@ window. The cursor is moved to the beginning of the file. The; file still exists in its original form in the file system. For example,A get file test.txtAC will move the cursor to the beginning of the file test.txt, in thec new buffer test.txt.a@ If a modified buffer with the same name as the new file already@ exists, GET FILE will ask you for a buffer name. In some casesB you will want a new buffer; in other cases you will probably wantB to use the BUFFER command to move to a file that is already being- edited. (See also Fetch File and Read File.)W W9 Modified for EVEplus to use default device and directory 9 specified by the Default command, if any has been given. p2 HELP HELP ? The HELP key provides help on keypad commands. After pressing B HELP, press the key that you want HELP on. Press RETURN to leaveE help. Press Next Screen to see help text below the bottom of screen.eA To get help on more advanced EVE commands, use the HELP command.RA Press the DO key, type help, and press RETURN. The HELP commandfA will then provide you with a list of all the EVE commands. TypeiA the name of the command that you want help on, or type ? to seeyB the list of commands again. Press RETURN without typing anything? in order to leave the HELP command. If you are using the HELPT1 key, press RETURN before using the HELP command.v? You can ask for help on a particular command in one step. Ford example,U help top& will provide help on the TOP command.7 Programmer's note: modified in EVEplus to first searchtF SYS$LIBRARY:EVEPLUSHELP.HLB before searching SYS$LIBRARY:TPUHELP.HLB.9 TO EXTRACT HELP TEXT to a file: after you execute a helpe: command, the text you viewed is in a System Buffer called: "HELP". You can use the Buffer command to switch to this; buffer, and then use Write File to write it out to a file.m2 HOME HOMEs y< Author A. Watson. Moves the cursor to the upper left corner= of the current window. Usually bound to the Gold-Prev Screenw key on VT200 terminals. a2 INCLUDE_BUFFER INCLUDE BUFFERM s; Author A. Watson. Accepts the name of a buffer as argumenti> and includes the contents of the buffer at the current cursor% location. Analogous to Include File.y M2 INDENT INDENT; s= Author A. Watson. Indent will insert or delete spaces at theR@ left end of a given number of lines. It will prompt you for the? number of lines to indent, and then will prompt for the numbern< of spaces to insert. To remove spaces from the beginning of, lines, specify a negative number (e.g. -4).A Indent, when removing spaces, will delete up to the named numbern: of spaces; it will not delete any non-space characters. A@ restriction: Indent will not delete leading Tab Characters from? a line. Indent is not affected by the current direction set int@ the buffer; it will always start at the line current containing; the cursor and move forward towards the end of the buffer.S2 KEEP KEEPU R< See the help for the FLUSH command; both Flush and Keep are documented together.e c2 LIST_BUFFERS LIST BUFFERS 8 This EVEplus command will produce a list of all buffers< currently in use. If you specify LIST ALL BUFFERS, the bothA system and user buffers are listed; otherwise, only user buffers@ are listed. The display includes the following information forA each buffer: name, number of lines, modification status, and anya/ special attributes such as NO WRITE or SYSTEM.s= After you use the command, the Select And Remove keys changei? their function to "select" (execute a BUFFER command) a buffer < or "remove" (delete) the buffer; place the cursor on a line? containing the buffer name you want to select or remove. Whenr< you leave the LIST BUFFERS buffer, the keys are restored to their original functions.2 LIST_COMMANDS  LIST COMMANDSaA This EVEplus procedure scans the command definitions internal tod? EVE and creates a sorted list of all defined commands known too> this copy of EVE, whether or not help files are available for@ the commands. The sorted list is displayed in a special window? that is displayed full screen. You can scroll through the listN? with NEXT SCREEN and PREVIOUS SCREEN. Pressing DO will remove? the list from the screen; if you don't want to actually DO anyn* command at this point, just press RETURN.< The list is still in memory, and can be brought back to the3 screen in any window by the command "BUFFER SHOW".h 2 LIST_KEYS LIST KEYS f9 EVEplus special: by pressing the DO key and typing "listoA keys", you can get a complete list of all keys that havea< been defined. The procedure quickly creates a buffer called@ "LIST KEYS", and fills it with a short description of every key? which has been defined in your current version of EVEplus. Thei@ buffer is mapped to your current viewing window. You will need@ to use the "Buffer" command to get back to your editing buffer. A List Keys uses the "help text" that is associated with a definedN= key to describe each key. If you use the EVE command "Define @ Key" to bind commands to keys for your own use, these *will* be< included in the List Keys list. If you define keys in yourA TPUINI.TPU file, using the TPU command "define_key", you must be A certain to include the "help text" as the third parameter of the 0 command for List Keys to find the description.  > List Keys will display some keys like this, "<5>". These are@ "legal" key codes which have no actual corresponding key on the; keyboard, and can be ignored. Numbers from 65 up, however,p? represent the standard ASCII character set. Thus "SHIFT/<65>" A refers to Shift-A, or "Gold-A" in EVEplus parlance. The Shift ori Gold key is the PF1 key.n 2 LOCATE_KEY LOCATE KEYl> Another EVEplus procedure, Locate Key, accepts the input of a= command name or *partial command name*. It searches the LISTn> KEYS buffer (if it exists) and reports any lines that contain@ the input string. It uses the existing Occurs command to do the< search. Thus, DO "locate key end_of_line" would display the following in the Occurs buffer: ' <5> {end_of_line}e' KP2 {End_of_line}i' CTRL/E {end_of_line}m< If the LIST KEYS buffer does not yet exist, Locate Key will6 first run the List Keys command to create the buffer. t@ Notice that EVEplus command names to look up must be typed with? underscore characters between the words of the command. If youe= type a command name that is not currently bound to a key, orn? misspell the command name, the "Occurs" buffer display will bew empty. > Since Locate Key is simply searching the LIST KEYS buffer, it; can also be used to see what command is bound to a key, by; giving the key name instead of the command name. Example:i% "Locate Key pf3" would produce this:o " {PF3} Fndnxt SHIFT/{PF3} Find2 MAIL_A_BUFFERh# MAIL A BUFFER (Author: A. Watson) ? MAIL A BUFFER will invoke VMS MAIL and send the current buffer;? as a Mail message. It will prompt you for "To:" whom you wanti$ the message to go, and the Subject. t; You must create a buffer containing the message BEFORE you " invoke the Mail A Buffer command. = Note: see DOMAIL for complete interface to the Mail utility.i 2 MESS_DOWNa MESS DOWN See MESSAGE_WINDOW_DOWN.2 MESSAGE_WINDOW_DOWNt MESSAGE WINDOW DOWNc? This EVEplus command scrolls the MESSAGE WINDOW down one line..: Mapped to the GOLD DOWN-ARROW key by SET EAG WINDOW KEYS. 2 MESS_UP MESS UPn See MESSAGE_WINDOW_UP.2 MESSAGE_WINDOW_UPp MESSAGE WINDOW UPo= This EVEplus command scrolls the MESSAGE WINDOW up one line. 8 Mapped to the GOLD UP-ARROW key by SET EAG WINDOW KEYS.2 MOVE_BY_PARAGRAPH MOVE BY PARAGRAPH t< Author: A. Watson. Moves the cursor forward or backward one9 paragraph, depending on the direction set in the buffer. = The cursor will be placed at the paragraph boundary (usuallye7 a blank line, but could be a Runoff or LaTeX command).w) This command is bound to the Gold-P key.  e2 MOVE_BY_SENTENCE& MOVE BY SENTENCE (Author: A. Watson)< Moves the cursor to the next end of sentence, moving in the6 current direction. Usually mapped to the GOLD-S key. 2 MOVE_DOWNw MOVE DOWN C Moves the cursor down one line on the screen. If the cursor is on @ the last line of a window, scrolls the window forward one line.9 Because EVEplus does not use "free" cursor movement, the < presence of tab characters in lines may appear to cause the: cursor to move left to right (because tabs are treated as: single characters no matter how many spaces are displayedA on the screen.) Modified for EVEplus; see additional informations* under "RIGID CURSOR" and "NORMAL CURSOR".) The down-arrow key invokes this command.n 2 MOVE_LEFTb MOVE LEFT? Moves the cursor left one column on the screen. If the cursorS? is on the first column on the screen, it wraps to the previous @ line and shifts the window if necessary. (Modified for EVEplus;< see additional information under "RIGID CURSOR" and "NORMAL CURSOR".)) The left-arrow key invokes this command.U 2 MOVE_RIGHT MOVE RIGHTO@ Moves the cursor right one column on the screen. If the cursor> is on the last column on the screen, it wraps to the previous? line and shifts the window as required. (Modified for EVEplus;n< see additional information under "RIGID CURSOR" and "NORMAL CURSOR".)* The right-arrow key invokes this command. 2 MOVE_UP  MOVE UPA Moves the cursor up one line on the screen. If the cursor is ons< the first line of a window, scrolls the window backward one= line. Modified for EVEplus; see additional information underT$ "RIGID CURSOR" and "NORMAL CURSOR". E' The up-arrow key invokes this command.9 Because EVEplus does not use "free" cursor movement, theu< presence of tab characters in lines may appear to cause the: cursor to move left to right (because tabs are treated as: single characters no matter how many spaces are displayed on the screen.)2 NEWOUT NEWOUT (Author: A. Watson)< Changes the name of the output file for the current buffer.@ Allows you to change the name of the output file to be written.> The file is NOT written by this command; only the name of the output file is changed. 2 NEXTLINE NEXTLINE (Author: A. Watson); This command moves the cursor to the beginning of the nexto> line, moving the the direction (forward or reverse) currently= set for the buffer. It functions identically to the KP0 keyw< in EDT. For efficiency it should always be bound to a key;& the normal EVEplus binding is to KP0.= To bind to another key, use the TPU define_key function, nott@ EVE's Define Key command, which will not recognize the Nextline; command. The full name of the procedure to use in the TPU = command is "aaw_nextline". The command can be executed withn5 the DO key by typing DO and then "TPU AAW_NEXTLINE".i 2 NEXT_WINDOWw! NEXT WINDOW (Author: A. Watson) : The NEXT WINDOW command moves the cursor to the next text= window below the current one, to the cursor location last inm9 use in that window. It will not move the cursor into thet= single-line Message or Command windows that EVE keeps at the> bottom of the screen. If the cursor is already in the bottom: window on the screen, the cursor moves to the top window. ; If you have called the Message Buffer into a larger windowe= above the normal one-line window, NEXT WINDOW will not allow> you to move to that window. In fact, if the buffer displayed= in a window is any SYSTEM buffer except the DCL buffer, NEXT  WINDOW will not move there. r= If only one text window is on screen, NEXT WINDOW will issuee) the message "Only one window on screen." 2 NOONLY NOONLY (Author: A. Watson)? NOONLY undoes the effect of the ONLY WINDOW command, returninge> the screen to whatever multiple windows were in effect before ONLY WINDOW was executed.2 NORMAL CURSORt NORMAL CURSOR n; Restores the normal functioning of the four Arrow Keys, asN? described under Move Up, Move Down, Move Left, and Move Right,T; after they have been modified by the Rigid Cursor command.b k2 RIGID CURSOR RIGID CURSORh u? Some users have complained about the way cursor movement workss= in EVEplus, especially vertical cursor movement. The EVEplus? cursor commands are based upon *character position* within thet? line, rather than absolute screen position. This can result inTA unexpected effects when lines contains Tab characters, which cane< display on screen as from one to eight screen columns. Most@ noticably, when moving the cursor vertically through lines that? contain tabs, you may see apparent horizontal movement as welll@ because EVEplus is keeping the cursor on the "n"th character ofA a line, which will not always be the same as the "n"th column ofo> the screen. If you are editing formatted compiler input (e.g.) FORTAN) this can be especially annoying.e= RIGID CURSOR gives you an optional alternate cursor movementt> that you will find useful. The TPU built-ins give really two< options: what TPU calls "free" or "bound" cursor movement.  5 "Bound" movement is what EVEplus has had all along. h o9 In "free" movement, cursor positioning is done by screen:@ position rather than character position, which gives you one ofA the things wanted: the ability to move vertically up or down andi> be guaranteed of staying in the same screen column. However,: there are also curious side-effects of this mode in TPU.  ,> One side-effect is that the left and right movement keys will= not wrap from line to line; they go to the screen margin ando stop. t e@ The second side-effect is that the cursor can go where there is@ no real character. One such example is sitting in the middle of? an 8-space tab character; that's OK and necessary for what you @ want. The other example is not so neat; you can move right past; the actual end of line, all the way to the screen margin. o t@ The third side-effect is that if you do certain things, such as< typing a space, while you are in such an "unreal" zone (one= where no characters actually exist), TPU will automatically,r; with no notice to you, fill in the line to the left of theBA cursor with blanks. This can result in lots of lines with extrau< trailing blanks or can change a single tab character into a@ small group of spaces plus a tab. This has no visible effect on; the screen, nor on compiles I'm sure, but it can make your A source files a little bigger than they need be. If you use thism= stuff, you might want to try using the Do key and the "trim"e9 command to strip off trailing blanks when you are done.  e? To use the alternate cursor commands, enter EVEplus in a file,u@ press the DO key, and type "RIGID CURSOR" plus Return key. ThatA will give you the "free" style I've described. See how you liket> it. You can switch back to the normal EVEplus cursor movement@ with the command "NORMAL CURSOR". I think you may find that for@ most editing, the normal style is best; you may want to use the; rigid style only when you are doing things that are columne dependent.  @ This alternate "rigid cursor" set of commands is provided on an? expermental basis only. Incidentally, standard EVE as providedi? by DEC uses the "rigid cursor"; what I call "normal cursor" ina: EVEplus is unique to EVEplus and is an attempt to emulate EDT-like cursor movement.2 NUMBER_LINES NUMBER LINES; This EVEplus command will insert line numbers at the startY> of every line of the current buffer. Room is allowed for six3 digits in the line number, followed by two spaces.  p< Note that these line numbers are actually INSERTED into the@ text of every line, modifying the buffer. There is no UNNUMBER? LINES command, so if you want to preserve the unnumbered text, < you should make a copy of the text in another buffer before executing NUMBER LINES.2 OCCURS OCCURS (Author: A. Watson)? OCCURS will scan the entire current buffer from top to bottom,t; searching for occurances of a particular text string. Eachi> line with a match will be copied to a scratch buffer, and theA matching text will be bracketed with curly brackets like {this}.A If the string occurs twice in one line, that line will be copiedd; to the scratch buffer twice, once for each occurance. Wheno= all lines have been searched, OCCURS will overlay the screenu< with a view of the scratch buffer displaying the occurancesA located. Hitting RETURN or any key will erase the OCCURS BUFFERe" and restore your original screen. e< If OCCURS finds more than 22 lines containing the text, you= will see only the last 22 on screen in the original display.a> To see the rest, use the BUFFER command to move to the buffer; named "OCCURS BUFFER"; you can then view the entire buffer  with normal movement commands.d o4 KNOW BUG (6-JUN-1986): Using OCCURS to search for a> single-character text string will cause the procedure to loop> indefinitely; CTRL/C will interrupt it. This should be fixed very soon. 2 ONE_WINDOW ONE WINDOW= The ONE WINDOW command returns the screen to one view of theEA current buffer. The window the cursor is in becomes the currentdA window. If you have been viewing two different documents in thet@ two windows, EVE removes the other window from the screen. TheA contents of the other buffer are not affected; you can return tou1 editing this buffer by using the BUFFER command.a< When you use the multi-window commands written by A. Watson> (SPLIT WINDOW, NEXT WINDOW, EXPAND WINDOW, and DELETE WINDOW)@ you should not use ONE WINDOW directly. (It is used indirectly< by DELETE WINDOW when you are deleting one of two remaining> windows.) No disastrous results will occur if you do, but you< will leave extraneous windows defined that should have been> deleted with DELETE WINDOW, and possibly EVE's windowing will= become confused; some extra windows may not be unmapped fromK the screen. 2 ONLY_WINDOW! ONLY WINDOW (Author: A. Watson)h; ONLY WINDOW is designed to be used when you have split thei= screen into multiple windows with SPLIT WINDOW. It will takem@ the buffer currently being edited and map it to one full-screen; (lines 1-22) window which will be overlaid on any existingM> windows. The existing windows are not destroyed or unmapped,, they are merely occluded by the new window. u< The effect of ONLY WINDOW is to take the current window and= blow it up to a 22-line window to allow a larger view of ther buffer. gA When you are done using this ONLY WINDOW, use the NOONLY commandu8 to remove it, restoring the original multi-window view. k; If you attempt to use SPLIT WINDOW while ONLY WINDOW is innB effect, you will be told you cannot split the ONLY WINDOW window. rC I like mapping ONLY WINDOW to the KP1 key, and NOONLY to Gold-KP1.d 2 OPENLINE OPENLINE (Author: A. Watson); This command functions like GOLD-KP0 in EDT, and creates aEA blank line above the line on which the cursor rests. The cursor2< is placed upon the new blank line. This command is normally( bound to GOLD-KP0 in Bergen Record EVE.@ For efficiency OPENLINE should always be bound to a key. Direct< execution is possible by DO followed by "tpu aaw_openline".< To bind this to a key, use the TPU define_key function, and= not the EVE Define Key command, which will not recognize the  Openline command.2 OPPS!_ DESTROY BUFFER buffer-nameM This EVEplus command will erase the contents of a buffer and totally deleteRH the buffer from EVE's buffer list. It will ask for confirmation first,< if the buffer has been modified since last writing to disk.2 OTHER_WINDOW OTHER WINDOWi@ The OTHER WINDOW command allows you to move the cursor from oneB window to the other. Many editing functions are performed at theC current location of the cursor, so you may frequently want to moven= it from one window to the other. If you want scrolling in ae> window, for example, you must have the cursor in that window.2 PR ESERVE_BUFFERS PRESERVE BUFFERSr s Author: A. Watson.  f< This command, accessible through the Do key, will cause all7 currently modified user buffers to be written to theirrA associated files. It will not affect system buffers, modified ork< not. One restriction: if a buffer has no associated files,= either input or output, that buffer will not be written to av? file, but simply retained. Such a buffer can occur only if you @ use the Buffer command to create a new, empty buffer, and w rite? text into it without ever issuing a Write File command to linkm the buffer to an output file. tA Preserve Buffers is intended primarily for those who like to rune@ EVEplus in a subprocess, using Attach to switch between EVEplusA and the main DCL process. It allows you to quickly preserve yourm9 modifications before you leave EVEplus to do other work.a e; Preserve Buffers differs from the existing command Release A Buffers in that Preserve Buffers writes out modified buffers but = leaves them intact; Release Buffers, in addition, erases the A buffers and deletes them from your editing context, giving you at@ completely clean slate. The latter is primarily useful when you> have reached or neared your virtual memory limits and need to reclaim buffer space. t SUGGESTIONS FOR USE:  1. A Learn sequence.o a@ You might want to issue the Do "Learn" command, and then Do the? Preserve Buffers and Attach commands, and bind the key to F20,rA instead of a simp le Attach (normally bound to the F20 key). Thise> would cause your buffers to be written out to disk every time you attach to your DCL process. a/ 2. A personal "Preserve_and_Attach" procedure.: > The following TPU code, put into your TPUINI.TPU file, would- create the same effect in compiled TPU code:-  procedure my_exit eve_preserve_buffers; eve_attach; endprocedure; ) define_key("my_exit",F20,"my_exit");e a2 PRINT_BUFFER PRINT BU FFERA This EVEplus command sends the contents of the current editing_@ buffer to a designated printer queue (default is Sys$Print).> Embedded control characters are translated to a readable form5 (e.g., the BEL character will be printed as ). m; When you execute this command you will be prompted for the > DCL PRINT command to be used. You can enter any print command? with qualifiers to direct the output to any print queue, caused< multiple copies to be printed, etc. For example, after you? enter PRINT BUFFER, at the prompt "Print command to be used?",P; you could enter "PRINT/QUE=ISDLN03/COPIES=5" to cause five9 copies of the buffer to be printed on the ISDLN03 queue. 2 READ_FILEe READ FILEtA Does the same thing as GET FILE except that the buffer is markedtA NOWRITE automatically, so that changes to the buffer will not be < saved when you exit. This is useful when you want to simply? examine a file and do not want to modify it accidentally. Thet: Read File command has been assigned to the GOLD R key. It9 respects the default device/directory set by the Defaulty command. Special for EVEplus. 2 READ_MAILw READ MAIL (Author: A. Watson)o; (This command is almost obsolete and may be unavailable if 5 in the near future. See DOMAIL for a better option.)G -? The READ MAIL command allows you to read MAIL messages withouth= leaving EVE. It splits the window into two screens (or usesm? another window on screen if one exists), brings the DCL bufferuB into it, and executes a MAIL command. The "MAIL>" prompt appears< on the bottom line of the screen. Anything you type at this; point will be sent to the MAIL program to be executed, foroA example "READ". Output from MAIL will be sent to the DCL buffer on your screen. S= It is recommended that you DO NOT enter a Mail REPLY or SENDoC command, since the mail message must be terminated by a CTRL/Z; itoC is rather tricky to send a CTRL/Z command to MAIL from within EVE!s@ The CTRL/Z key has its own meaning to EVE -- the EXIT command!!@ Hitting CTRL/Z will terminate your EVE session, which you don't want to do. r: To exit from the READ MAIL command, enter "EX" or "EXIT".2 SEARCH SEARCH (Wildcard search)h: This EVEplus command, enhanced by AAW, performs wildcard = searches. It can be invoked, in Bergen Record EVEplus, from e> the CTRL/F key. Using the Do Key, the command name is simply ; "Search". The following wildcard characters are supported.A3 * Multi-character wildcard, do not cross line endsH % Single character wildcard < Beginning of line > End of line, # Multi-character wildcard, cross line ends \ Quote next character 2 ^ Next character is a control character (e.g. ^A)5 [] Match any character contained within the bracketsi2 SET_EAG_WINDOW_KEYSo SET EAG WINDOW KEYSWA This EVEplus command defines a whole set of procedures and bindsrC them to keys for easy execution. No, I don't know what EAG standss? for! The command set makes it easy to use many buffers and to : list or call them up with simple keystrokes. For the keyA definitions to work YOU MUST HAVE A TPU SHIFT KEY (known also asA GOLD KEY) defined. Normally, this is the PF1 key on the keypad.= You can define your own shift key by the SET SHIFT command. " Keys defined by this command are:? (All number keys below are KEYBOARD digits, not KEYPAD digits)e: GOLD 0 - List current buffers, showing numbers associated with them.: GOLD n - With "n" being a keyboard digit 1 to 9, call the= buffer associated with that number (in the GOLD 0 list) intor the current window.3 GOLD ENTER - Writes current buffer to a disk file.e: ENTER - Does a GET FILE command to read a file from disk;5 if the file has already been read, simply changes tog that buffer.*; GOLD DELETE - The GOLD key followed by the Delete key (ther9 convenience. EAG markers are unnamed. Instead of identifying< the destination marker by name, you go to the most recently? accessed marker in a circular list of five markers, similar to? the circle of marks in EMACS. Successive requests cause you to> circulate through your markers one by one. If you define two- markers, you can ping pong between the two. @ Note that if the marker you go to is in another editing buffer,@ that buffer is automatically mapped to the current window. This; provides a convenient way to switch back and forth betweens= buffers, simply by setting a mark in each buffer you want tot8 access. Use "set eag markers" to enable the special key9 assignments; use "set noeag markers" to restore original  key functions.oA EAG maps three marker functions to the GOLD level of three VT200o keys: t o7 Gold/Insert --- Places a marker at the current cursort position.s8 Gold/Find --- Positions to the most recently accessed 0 marker unless you are already there, in1 which case it positions you to the next l& marker in the circular list. ; Gold/Remove --- Removes the marker at the current cursor o- position. If you aren't on a marker, youy get a warning message. h> This section is a template for customizing the EAG_MARKER.TPU@ support. It is entirely optional; but if you want to change the@ way the support is supplied, copy this section of the file intoA your own TPUINI.TPU initialization file and edit those statments ? you wish. Use this section in your EVEPlus input files if you bA -o- Want to change how the markers are indicated - uncomment andr= modify the statement below to get the marker style you want.OA (REVERSE is the default; do nothing if that's what you'd like.) a"! eag_g_mark_rendition := reverse;! eag_g_mark_rendition := none;a! eag_g_mark_rendition := bold;o$! eag_g_mark_rendition := underline; ! eag_g_mark_rendition := blink;? -o- Want to change the keypad assignment of one or more Marker,@ keys. Here are the default assignments. Do nothing if you want= them. Uncomment the statement(s) you need and modify the keyt1 name on the right to get alternate assignments. s6! eag_g_insert_mark_key := key_name ( e2, shift_key );6! eag_g_remove_mark_key := key_name ( e3, shift_key );4! eag_g_find_mark_key := key_name ( e1, shift_key );@ -o- Want to include EAG marker support in your default keypad -; by default, EAG marker support is not enabled. To use EAGc6 markers, issue the eve command "set eag markers". To= disable them, issue the eve command "set noeag markers". ToO9 get marker support in your default keypad, uncomment theI7 statement below and place it in your TPUINI.TPU file. o! eve_set_eag_markers; i SIDE EFFECTSa:-o- Describe Key won't work for shifted key sequences.  = The saving and restoring of the Shift key somehow alters the? shift key definition so that the Describe Key command, if usedE1 after Set Noeag Markers in an attempt to get the @ description of a shifted key, will return the definition of PF18 as ``Shift Key'', and will not accept the PF1-Other key@ sequence. This seems of minor consequence since key definitions? can also be viewed using List Keys or Locate Key. For example,wA if you need to know what command, if any, is bound to the Gold-Rp- key (Shift Key, R), use Locate Key shift/R.  n&-o- Gold-Remove definition is changed. o? Gold-Remove in standard EVEplus executes the Copytext command,e? which copies selected text into the Insert Here buffer withouts= removing it from the editing buffer. When Set EAG Markers is:@ executed this key sequence is re-defined as Remove EAG Marker.  aA Since Copytext is also available via the Gold-X key, this is not < considered a show stopper. You will need to remember to use< Gold-X for Copytext, that's all, if you have EAG markers in< effect. If you do a Set Noeag Markers command, the original( definition of Gold-Remove is restored. 2 SET_FLASHING SET FLASHING t@ EVEplus command. This command locates corresponding charactersA in a buffer and ``flashes'' them whenever you type the character ? given in the command. It is helpful when you are entering textn8 containing lots of matching pairs of characters such asA parentheses, brackets, quotes, and so on. For instance, when youn? type a left parenthesis, the line containing the correspondingw? right parenthesis will be flashed in the message window at they> bottom of the screen; the matching character will be flashing from normal to reverse video.: For instance, this command can be used to make the editor: display which ``('' matches which ``)'' with the command: SET FLASHING )4 The followi ng characters can be used to flash their corresponding characters: ) } > ; ' "9 To turn off flashing, use Set Noflash character-to-matchu> You can specify one or more of the characters in a single Set [No]Flash command.I 2 SHIFT_LEFT SHIFT LEFT,B SHIFT LEFT shifts or moves the window horizontally to the left byB the number of columns you specify. SHIFT LEFT allows you to viewA characters located to the left of the current screen width. Youl; can use SHIFT LEFT to reverse' the results of a SHIFT RIGHTfA command. For example, if the current window is shifted right byh 15 characters,n shift left 15mA will restore the window to its unshifted state. You can use theh@ SHOW command to see how many columns over the current window is shifted.sJ If SET EAG WINDOW KEYS has been executed then the GOLD LEFT-ARROW key will do a SHIFT LEFT 40.i 2 SHIFT_RIGHTm SHIFT RIGHTA SHIFT RIGHT shifts or moves the window horizontally to the rightB by " window. W2 SET_MATCHING SET MATCHING_ R; EVEplus command. With Set Matching in effect, EVEplus will ? automatically insert a corresponding character into the buffer < when the first of a pair is typed. For example, if you type? a "(", a matching ")" is automatically placed into the bufferu= to the right of the cursor, so that the next character typed 9 will be between the matched characters. Useful in typings; long parenthesized expressions and such. When you give the A Set Matching #command you will be asked which of these charactersE@ you want to match for. Set NoMatching will cancel the automatic matching. e< The following characters can generate a corresponding match. character, which is shown on the second line: p$ Opening characters: ( { < [ ` ' "$ Matching characters: ) } > ] ' ' "2 SET_NOMATCHING SET NOMATCHINGi p See Set Matching. e 2 SET_NOWRITE. SET NOWRITE = Eveplus command. Changes the status of the buffer from Writet= to No Write. Su $ch buffers are ignored when you exit EVEplus, = even if they are modified. Also, the Write File command wille; ask for verification before writing a No Write buffer. Use ; this to guard against changing files you don't really wantf? to alter. Set Write will undo a Set NoWrite. The buffer statush= line is underscored in bold to indicate the No Write status.y i2 SET_RECTANGULARn SET RECTANGULAR s; Alters the function of the Select, Remove, and Insert Herec8 keys on VT200 terminals to allo %w cutting and pasting of; rectangular regions; for example, columns of numbers. "Sets: NoRectangular" will restore the original functions of the keys. < To cut a rectangular region, press Select at the upper left< corner of the rectangle, move the cursor to the lower right6 corner, and press Remove. (The selected region is NOT: highlighted.) The region you selected will be removed and *replaced with spaces*. W> To insert a rectangular region, place the cursor at the point< where you w&ish the upper left corner of the inserted region6 to be and press Insert Here. The inserted region will6 *overwrite* anything currently occupying that region.3 The author (A. Watson) is not too pleased with thegA implementation of Set Rectangular and hopes to improve it in the  future. e 2 SET_WRITE SET WRITE : Changes the current buffer status from No Write to Write.: A Writable buffer, if modified, is eligible to be written; out when you exit EVEplus. Buffers you create are writa7bler by default. (See Set NoWrite.)e e 2 SHIFT_LEFT SHIFT LEFT B SHIFT LEFT shifts or moves the window horizontally to the left byB the number of columns you specify. SHIFT LEFT allows you to viewA characters located to the left of the current screen width. You; can use SHIFT LEFT to reverse the results of a SHIFT RIGHTA command. For example, if the current window is shifted right by 15 characters, shift left 15A will restore the window to its unshifted state. You (the number of columns you specify. You can use SHIFT RIGHT toC see beyond the width of the screen. For example, suppose that you@ are editing a file with lines 160 characters long, and you have SET WIDTH to 132. You can use shift right 28B to see the characters in columns 29 through 160. You can use the@ SHOW command to see how many columns over the current window is shifted.? If SET EAG WINDOW KEYS has been executed then GOLD RIGHT-ARROW will execute a SHIFT RIGHT 40.) 2 SORT_BUFFER SORT BUFFER = From EVEplus, modified by A. Watson. Execute via the Do Key.9 Normal action is to sort the entire current buffer, line< by line. The name of the buffer to be sorted must be given,= but the buffer need not be visible on screen (e.g. you could; say "sort buffer insert here" after cutting something from' the screen to sort what you just cut). 9 If no buffer name is given you will be prompted for one.< However, if a region has been set with the Select* key, Sort9 Buffer will offer to sort the selected region instead of= the entire buffer. When defining a region for sorting, place; the bottom of the region at the *end* of the last line you= want included; placing it at the start of a line will result9 in a blank line being sorted to the top of the resulting? region. The contents of the Insert Here buffer are overwritten when you sort a region. 2 SPELL SPELL > A new function has been added to the EVEplus editor: spelling8 c+hecking. I have taken a procedure brought here by Seth? Silverstein and modified by him to use the DECUS SPELL utility> (the original used Digital's DECspell, which we do not have),@ and added it to EVEPplus. I made a few additional modifications@ to ensure that the SPELL command is properly defined for use by EVEplus.  ? The procedure may be invoked by pressing the DO key and typing: "spell". It invokes the SPELL utility against the@ current buffer. If you have defined a reg,ion of text within the@ buffer, using the Select key, Spell will check only the defined region. ? To run the Spell program, EVEplus will spawn a DCL subprocess.? If a DCL subprocess already exists, it will be used. The first? time you use the command in an editing session, the subprocess? will be given two commands to ensure that the Spell command is% properly defined for the subprocess: DELETE/SYMBOL/GLOBAL SPELL SET COMMAND ENGL:SPELL = The first com-mand may generate an error message if no symbol< "spell" had been defined previously; this is not a problem. > The logical name "ENGL" used in the second command is defined= during execution of the UTIL_LOGIN procedure that sets up my0 package of utilities. You should either include= "@SYS$COM:UTIL_LOGIN" in your login.com file, or you can putA just that one line in your file. One way or the other, ENGL must@ be defined for SPELL to work. The safest is to use UTIL_LOGIN,@ in case t.he definition ever changes in the future. The current definition is: . $ DEFINE ENGL DISK_FSGPROD:[SYSUTL.SPELL]; After setting up the command, the buffer or region will be? written to a temporary file, and SPELL will be run against it.A The output, which is the list of possibly misspelled words, will@ appear in your DCL buffer. You can use the F18 key (Next Window@ command) to move the cursor from window to window, and when youA are done, you can delete the DCL window by pl/acing the cursor in2 it and hitting Gold-F17 (Delete Window command).  = As you check through the list output by Spell, note that the; numbers to the left are the line numbers in the buffer (or; region) you were checking. When you are checking an entire@ buffer, placing the cursor in that buffer and typing the DO key? and "line nn" will move the cursor to line "nn", where you can make your correction. 2 THIS_FILE THIS FILE A A new command, "this file", has been added to E0VEplus. The "this= file" command allows you to place your cursor on a file name? that appears in any buffer, press DO and type "this", and have4 the file called up for editing into its own buffer. < The command in intended mainly for use with the "directory"@ command. By using "directory" to create a listing of files, you< can then place the cursor on any file name in the directory9 listing, type DO "this", and have the file called up for> editing. The file name is briefly high-ligh1ted in bold as the command executes. ; The "this file" command, however, is not limited to use in? conjunction with "directory". You can use it in *any* buffer. ? Example: you are editing a command procedure. One of its lines is: ; $ @GS$FSGC:[PROJECT.SIMPLE_STUFF.COM]DO_THE_THING.COM @ If you place your cursor anywhere on the file specification andA hit the DO key, type "this", the file named in that line will be< called up for editing or review. An e2normous time-saver for fumble-fingered typists. 2 TOGGLE_#_WINDOWS TOGGLE NUMBER OF WINDOWS> Switch back and forth between two windows and one when using% TWO WINDOWS and ONE WINDOW commands.2 TRANSPOSE_CHAR$ TRANSPOSE CHAR (Author: A. Watson)< The Transpose Char command will cause the two characters to> the left of the cursor to exchange places, leaving the cursor? where it was originally. Useful for quickly correcting common> typographic errors such as typing "teh" whe3n "the" was meant.2 TRANSPOSE_LINES% TRANSPOSE LINES (Author: A. Watson); The Transpose Lines command will cause the line containing5 the cursor and the line above it to exchange places.2 WHITESPACE_COMPRESS WHITESPACE COMPRESS  Author: A. Watson. A If the cursor is sitting on a whitespace character (space, tab),? that character and any whitespace characters on either side of) it will be compressed to a single space. = If the cursor is on a whitespace characte4r at the start of a: line, all whitespace at the start of line will be erased. A If the cursor is not on a whitespace character, the command does nothing. 2 WRITE_FILE WRITE FILEA The WRITE FILE command places the contents of the current buffer in the file you specify. Use write fileA to create a new version of an existing file. You can also write- the buffer to a new file name. For example, write file new.txt@ writes the current buffer to the fi5le new.txt, even if the fileA already existed with a different name. The editing session does8 not end until you use either the EXIT or QUIT commands.? The WRITE FILE command does not change the buffer name, but itC does change the output file name. A subsequent WRITE FILE command= will write the buffer to the new file name (as will the EXIT@ command, if the buffer has been modified). You can examine the0 current output file name with the SHOW command.A Modifications for EVEplus: re6spects the default device/directory9 set by the Default command. Also, if buffer has been setA NOWRITE, asks first before writing, and if you tell it to write,? the buffer is set WRITE. If you file to specify an output file' spec, the name FILE.TXT will be used.2 WRITE_NEW_FILE WRITE NEW FILE@ This EVEplus command will write out the current buffer to disk? after prompting you for a new file name, allowing you to alter< a file and write the changed version using a different file name. 2 ZAP ZAP < Author: A. Watson. This command erases all the text between: the cursor up to and including the first occurance of the= single character you give as argument. Example: "zap ;" will; erase forward from the cursor up to and including the next semicolon.ww8can use the@ SHOW command to see how many columns over the current window is shifted.J If SET EAG WINDOW KEYS has been executed then the GOLD LEFT-ARROW key will do a SHIFT LEFT 40. 2 SHIFT_RIGHT SHIFT RIGHTA SHIFT RIGHT shifts or moves the window horizontally to the rightB by the number of columns you specify. You can use SHIFT RIGHT toC see beyond the width of the screen. For example, suppose that you@ are editing a file with lines 160 characters long, and you have9 SET WIDTH to 132. You can use shift right 28B to see the characters in columns 29 through 160. You can use the@ SHOW command to see how many columns over the current window is shifted.? If SET EAG WINDOW KEYS has been executed then GOLD RIGHT-ARROW will execute a SHIFT RIGHT 40. 2 SORT_BUFFER SORT BUFFER = From EVEplus, modified by A. Watson. Execute via the Do Key.9 Normal action is to sort the entire current buffer, line< by line. The name of the buffer to :be sorted must be given,= but the buffer need not be visible on screen (e.g. you could; say "sort buffer insert here" after cutting something from' the screen to sort what you just cut). 9 If no buffer name is given you will be prompted for one.< However, if a region has been set with the Select key, Sort9 Buffer will offer to sort the selected region instead of= the entire buffer. When defining a region for sorting, place; the bottom of the region at the *end* of the last line you= ; want included; placing it at the start of a line will result9 in a blank line being sorted to the top of the resulting? region. The contents of the Insert Here buffer are overwritten when you sort a region. 2 SPELL SPELL > A new function has been added to the EVEplus editor: spelling8 checking. I have taken a procedure brought here by Seth? Silverstein and modified by him to use the DECUS SPELL utility> (the original used Digital's DECspell, which we do not have),@ and added i <t to EVEPplus. I made a few additional modifications@ to ensure that the SPELL command is properly defined for use by EVEplus.  ? The procedure may be invoked by pressing the DO key and typing: "spell". It invokes the SPELL utility against the@ current buffer. If you have defined a region of text within the@ buffer, using the Select key, Spell will check only the defined region. ? To run the Spell program, EVEplus will spawn a DCL subprocess.? If a DCL subprocess alr =eady exists, it will be used. The first? time you use the command in an editing session, the subprocess? will be given two commands to ensure that the Spell command is% properly defined for the subprocess: DELETE/SYMBOL/GLOBAL SPELL SET COMMAND ENGL:SPELL = The first command may generate an error message if no symbol< "spell" had been defined previously; this is not a problem. > The logical name "ENGL" used in the second command is defined= during execut >ion of the UTIL_LOGIN procedure that sets up my0 package of utilities. You should either include= "@SYS$COM:UTIL_LOGIN" in your login.com file, or you can putA just that one line in your file. One way or the other, ENGL must@ be defined for SPELL to work. The safest is to use UTIL_LOGIN,@ in case the definition ever changes in the future. The current definition is: . $ DEFINE ENGL DISK_FSGPROD:[SYSUTL.SPELL]; After setting up the command, the buffer or region will be? wri ?tten to a temporary file, and SPELL will be run against it.A The output, which is the list of possibly misspelled words, will@ appear in your DCL buffer. You can use the F18 key (Next Window@ command) to move the cursor from window to window, and when youA are done, you can delete the DCL window by placing the cursor in2 it and hitting Gold-F17 (Delete Window command).  = As you check through the list output by Spell, note that the; numbers to the left are the line numbers in the buf@fer (or; region) you were checking. When you are checking an entire@ buffer, placing the cursor in that buffer and typing the DO key? and "line nn" will move the cursor to line "nn", where you can make your correction.2 STATUS_LINE_OFF STATUS LINE OFF ; Turns the EVE buffer status line off, giving an extra line> for editing. Useful for taking pictures of the screen. Status Line On turns the line back on. 2 STATUS_LINE_ON STATUS LINE ON : Turns on the buffer status liAne if you have turned it off( using Status Line off. Eveplus command. 2 THIS_FILE THIS FILE A A new command, "this file", has been added to EVEplus. The "this= file" command allows you to place your cursor on a file name? that appears in any buffer, press DO and type "this", and have= the file called up for editing into its own buffer.  < The command in intended mainly for use with the "directory"@ command. By using "directory" to create a listing of files, you< cBan then place the cursor on any file name in the directory9 listing, type DO "this", and have the file called up for> editing. The file name is briefly high-lighted in bold as the command executes. ; The "this file" command, however, is not limited to use in? conjunction with "directory". You can use it in *any* buffer. ? Example: you are editing a command procedure. One of its lines is: ; $ @GS$FSGC:[PROJECT.SIMPLE_STUFF.COM]DO_THE_THING.COM @ If you Cplace your cursor anywhere on the file specification andA hit the DO key, type "this", the file named in that line will be< called up for editing or review. An enormous time-saver for fumble-fingered typists. 2 TIME TIME ? Displays the current date and time in the message line. Author> A. Watson. Does NOT automatically refresh; just shows current time once. 2 TOGGLE_#_WINDOWS TOGGLE NUMBER OF WINDOWS> Switch back and forth between two windows and one when using% TWOD WINDOWS and ONE WINDOW commands.2 TRANSPOSE_CHAR$ TRANSPOSE CHAR (Author: A. Watson)< The Transpose Char command will cause the two characters to> the left of the cursor to exchange places, leaving the cursor? where it was originally. Useful for quickly correcting common> typographic errors such as typing "teh" when "the" was meant.2 TRANSPOSE_LINES% TRANSPOSE LINES (Author: A. Watson); The Transpose Lines command will cause the line containing5 the cursor and the line aboveE it to exchange places. 2 TRIM_BUFFER TRIM BUFFER : EVEplus command. Removes all trailing spaces or tabs from9 lines in the current buffer. Only the current buffer can< be trimmed; the buffer to be trimmed must be visible in the< currently selected window, and only the *entire* buffer can+ be trimmed. No partial trims are possible. 2 WHAT_LINE WHAT LINE ? Reports the current line position of the cursor in the buffer.< The current line number, total lines in the buffer, aFnd the> approximate percentage of the buffer that is above the cursor9 are displayed. The report appears in the message window, like this: % You are on line 311 out of 352 (88%) : Executing this command in a buffer with many thousands of" lines can take considerable time.2 WHITESPACE_COMPRESS WHITESPACE COMPRESS  Author: A. Watson. A If the cursor is sitting on a whitespace character (space, tab),? that character and any whitespace characters on either sideG of) it will be compressed to a single space. = If the cursor is on a whitespace character at the start of a: line, all whitespace at the start of line will be erased. A If the cursor is not on a whitespace character, the command does nothing. 2 WRITE_FILE WRITE FILEA The WRITE FILE command places the contents of the current buffer in the file you specify. Use write fileA to create a new version of an existing file. You can also write- the buffer to H a new file name. For example, write file new.txt@ writes the current buffer to the file new.txt, even if the fileA already existed with a different name. The editing session does8 not end until you use either the EXIT or QUIT commands.? The WRITE FILE command does not change the buffer name, but itC does change the output file name. A subsequent WRITE FILE command= will write the buffer to the new file name (as will the EXIT@ command, if the buffer has been modified). YouI can examine the0 current output file name with the SHOW command.A Modifications for EVEplus: respects the default device/directory9 set by the Default command. Also, if buffer has been setA NOWRITE, asks first before writing, and if you tell it to write,? the buffer is set WRITE. If you file to specify an output file' spec, the name FILE.TXT will be used.2 WRITE_NEW_FILE WRITE NEW FILE@ This EVEplus command will write out the current buffer to disk? after prompting you for a new file name, allowing you to alter< a file and write the changed version using a different file name. 2 ZAP ZAP < Author: A. Watson. This command erases all the text between: the cursor up to and including the first occurance of the= single character you give as argument. Example: "zap ;" will; erase forward from the cursor up to and including the next semicolon.ww