EEEEEEEEE VVV VVV EEEEEEEEEEEE DDDDDDDDDD TTTTTTTTTTTTTTTT EEEEEEEEEE VVV VVV EEEEEEEEEEEE DDDDDDDDDDDD TTTTTTTTTTTTT EEE VVV VVV EEE DDD DDD TTT EEE VVV VVV EEE DDD DDD TTT EEE VVV VVV EEE DDD DDD TTT EEEEEEEEEEEEEE VVV VVV EEEEEEEEE DDD DDD TTT EEEEEEEEEEEEEEE VVV VVV EEEEEEEEE DDD DDD TTT EEE VVV VVV EEE DDD DDD TTT EEE VVV VVV EEE DDD DDD TTT EEE VVV VVV EEE DDD DDD TTT EEEEEEEEEEEEEEEEEEE VVVVVV EEEEEEEEEEEE DDDDDDDDDDDD TTT EEEEEEEEEEEEEEEEEEEE VVVVV EEEEEEEEEEEE DDDDDDDDDD TTT USERS GUIDE for the Extensible VAX Editor - EDT Extension [ EVEDT ] (EVEDT Version V4.0-110188) (For use with VMS 5.x and TPU 2.x and above) AUTHOR Steven K. Shapiro SKS Associates POB 610637 Austin, TX 78761 30 December 1988 The EVEDT software package including all source code, section files, online help and documentation is subject to change without notice and should therefore not be construed as a commitment by its author. EVEDT Version 4.0 (and above) is designed to work with systems which are equipped with TPU V2.0 and above. EVEDT Version 3.x (and below) is designed to work with systems which are equipped with TPU V1.x and below. Since DIGITAL assumes no responsibility for its TPU product, I assume no responsibility for the use or reliability of EVEDT on any equipment or for any purpose and it is therefore offered as is. CONTENTS 1 INTRODUCTION . . . . . . . . . . . . . . . . . . . . 1 1.1 DOCUMENTATION . . . . . . . . . . . . . . . . . . 1 1.2 GETTING STARTED . . . . . . . . . . . . . . . . . 2 1.3 HANDY HINTS . . . . . . . . . . . . . . . . . . . 3 1.4 USING THIS MANUAL . . . . . . . . . . . . . . . . 4 1.5 REFERENCES . . . . . . . . . . . . . . . . . . . . 4 1.5.1 Synopsis Of EVEDT Users Guide . . . . . . . . . . 4 2 THE EVEDT KEYPAD . . . . . . . . . . . . . . . . . . 5 2.1 KEYPAD DIFFERENCES . . . . . . . . . . . . . . . . 6 2.2 KEYPAD KEY DESCRIPTIONS . . . . . . . . . . . . . 7 2.2.1 PF1 Key - Gold Shift . . . . . . . . . . . . . . . 7 2.2.2 PF2 Key - Split Screen . . . . . . . . . . . . . . 7 2.2.3 PF3 Key - Find Next . . . . . . . . . . . . . . . 7 2.2.4 PF4 Key - Delete Line . . . . . . . . . . . . . . 7 2.2.5 KP7 Key - Recall . . . . . . . . . . . . . . . . . 7 2.2.6 KP8 Key - Section . . . . . . . . . . . . . . . . 8 2.2.7 KP9 Key - Previous Buffer . . . . . . . . . . . . 8 2.2.8 MINUS Key - Delete Word . . . . . . . . . . . . . 8 2.2.9 KP4 Key - Advance . . . . . . . . . . . . . . . . 8 2.2.10 KP5 Key - Page Up . . . . . . . . . . . . . . . . 8 2.2.11 KP6 Key - Remove . . . . . . . . . . . . . . . . . 8 2.2.12 COMMA Key - Delete Character . . . . . . . . . . . 9 2.2.13 KP1 Key - Word . . . . . . . . . . . . . . . . . . 9 2.2.14 KP2 Key - End Of Line . . . . . . . . . . . . . . 9 2.2.15 KP3 Key - Get File . . . . . . . . . . . . . . . . 9 2.2.16 KP0 Key - Line . . . . . . . . . . . . . . . . . . 9 2.2.17 PERIOD Key - Select . . . . . . . . . . . . . . . 9 2.2.18 ENTER Key - Insert / Overstrike . . . . . . . . 10 2.3 GOLD SHIFTED KEYPAD KEY DESCRIPTIONS . . . . . . 11 2.3.1 Gold+PF2 Key - Other Window . . . . . . . . . . 11 2.3.2 Gold+PF3 Key - Find . . . . . . . . . . . . . . 11 2.3.3 Gold+PF4 Key - Undelete Line . . . . . . . . . . 11 2.3.4 Gold+KP7 Key - Do . . . . . . . . . . . . . . . 11 2.3.5 Gold+kp8 - Repeat Next Command . . . . . . . . . 11 2.3.6 Gold+KP9 Key - Next Buffer . . . . . . . . . . . 11 2.3.7 Gold+MINUS Key - Undelete Word . . . . . . . . . 11 2.3.8 Gold+KP4 Key - Bottom . . . . . . . . . . . . . 12 2.3.9 Gold+KP5 Key - Top . . . . . . . . . . . . . . . 12 2.3.10 Gold+KP6 Key - Insert . . . . . . . . . . . . . 12 2.3.11 Gold+COMMA Key - Undelete Character . . . . . . 12 2.3.12 Gold+KP1 Key - Learn . . . . . . . . . . . . . . 12 2.3.13 Gold+KP2 Key - Delete To EOL . . . . . . . . . . 12 2.3.14 Gold+KP3 Key - Prior Buffer . . . . . . . . . . 13 2.3.15 Gold+KP0 Key - Open Line . . . . . . . . . . . . 13 2.3.16 Gold+PERIOD Key - Rectangular Select . . . . . . 13 2.3.17 Gold+ENTER Key - Print Buffer . . . . . . . . . 13 3 GOLD SHIFTED MAIN TYPING ARRAY KEYS . . . . . . . 14 3.1 GOLD+RETURN - RETURN TO MAIN BUFFER . . . . . . 14 3.2 GOLD+A - SPECINS . . . . . . . . . . . . . . . . 14 3.3 GOLD+B - LIST ALL BUFFERS . . . . . . . . . . . 14 3.4 GOLD+C - CENTER . . . . . . . . . . . . . . . . 14 3.5 GOLD+D - DRAW BOX . . . . . . . . . . . . . . . 14 3.6 GOLD+E - EXIT AND UPDATE DATE TIME STAMP . . . . 14 3.7 GOLD+F - FILL RECTANGULAR . . . . . . . . . . . 14 3.8 GOLD+G - GOTO LINE # . . . . . . . . . . . . . . 15 3.9 GOLD+H - DISPLAY COLUMN NUMBER . . . . . . . . . 15 3.10 GOLD+I - INCLUDE FILE . . . . . . . . . . . . . 15 3.11 GOLD+J - FILL (JUSTIFY) . . . . . . . . . . . . 15 3.12 GOLD+K - KEY DEFINITION . . . . . . . . . . . . 15 3.13 GOLD+L - LOWERCASE RANGE/WORD . . . . . . . . . 16 3.14 GOLD+M - SET MATCHING . . . . . . . . . . . . . 16 3.15 GOLD+N - FILENAME + DTS @ TOP . . . . . . . . . 16 3.16 GOLD+O - OUTPUT TO FILE . . . . . . . . . . . . 16 3.17 GOLD+P - POSITION TO COLUMN . . . . . . . . . . 16 3.18 GOLD+Q - QUIT . . . . . . . . . . . . . . . . . 16 3.19 GOLD+R - RULER WINDOW . . . . . . . . . . . . . 17 3.20 GOLD+S - SPAWN . . . . . . . . . . . . . . . . . 17 3.21 GOLD+T - TIME MESSAGE . . . . . . . . . . . . . 17 3.22 GOLD+U - UPPERCASE RANGE/WORD . . . . . . . . . 17 3.23 GOLD+V - VMS DCL COMMAND . . . . . . . . . . . . 17 3.24 GOLD+W - WILDCARD FIND . . . . . . . . . . . . . 17 3.25 GOLD+X - TOGGLE SCREEN WIDTH . . . . . . . . . . 18 3.26 GOLD+Y - INSERT DATE / TIME STAMP . . . . . . . 18 3.27 GOLD+Z - INSERT DATE . . . . . . . . . . . . . . 18 4 GOLD SHIFTED NUMERIC / PUNCTUATION KEYS . . . . . 19 4.1 GOLD+1 KEY - LANGUAGE CONSTRUCT . . . . . . . . 19 4.2 GOLD+2 KEY - LANGUAGE CONSTRUCT . . . . . . . . 19 4.3 GOLD+3 KEY - LANGUAGE CONSTRUCT . . . . . . . . 19 4.4 GOLD+4 KEY - LANGUAGE CONSTRUCT . . . . . . . . 19 4.5 GOLD+5 KEY - LANGUAGE CONSTRUCT . . . . . . . . 19 4.6 GOLD+6 KEY - LANGUAGE CONSTRUCT . . . . . . . . 19 4.7 GOLD+7 KEY - LANGUAGE CONSTRUCT . . . . . . . . 19 4.8 GOLD+8 KEY - LANGUAGE CONSTRUCT . . . . . . . . 20 4.9 GOLD+9 KEY - LANGUAGE CONSTRUCT . . . . . . . . 20 4.10 GOLD+0 - SELECT CONSTRUCTS . . . . . . . . . . . 20 4.11 GOLD+! - FIND MATCHING BEGIN / END . . . . . . . 20 4.12 GOLD+@ - SELECT CAPITALIZE . . . . . . . . . . . 20 4.13 GOLD+# - SHOW BUFFER ATTRIBUTES . . . . . . . . 20 4.14 GOLD+$ - EXPAND TABS . . . . . . . . . . . . . . 20 4.15 GOLD+% - FILTER BUFFER . . . . . . . . . . . . . 21 4.16 GOLD+^ - DISPLAY CHARACTER . . . . . . . . . . . 21 4.17 GOLD+& - REPLACE ANY ASCII . . . . . . . . . . . 21 4.18 GOLD+* - CLIST . . . . . . . . . . . . . . . . . 21 4.19 GOLD+( - FIND MATCHING . . . . . . . . . . . . . 21 4.20 GOLD+) - COUNT PAGE . . . . . . . . . . . . . . 21 4.21 GOLD+SPACE - CANCEL GOLD SHIFT . . . . . . . . . 22 4.22 GOLD+_ - TRIM LINE . . . . . . . . . . . . . . . 22 4.23 GOLD+- - TRIM BUFFER . . . . . . . . . . . . . . 22 4.24 GOLD++ - OPEN FILE AT CURSOR . . . . . . . . . . 22 4.25 GOLD+= - LIST USER BUFFERS . . . . . . . . . . . 22 4.26 GOLD+~ = FIX CRLF'S . . . . . . . . . . . . . . 22 4.27 GOLD+` - DELETE CURRENT BUFFER . . . . . . . . . 22 4.28 GOLD+{ - INSERT C / PL/1 COMMENT LINE . . . . . 22 4.29 GOLD+[ - INSERT BUFFER NAME STAMP . . . . . . . 23 4.30 GOLD+} - INSERT FORTRAN COMMENT LINE . . . . . . 23 4.31 GOLD+] - FIND ANY ASCII . . . . . . . . . . . . 23 4.32 GOLD+: - INSERT TPU COMMENT LINE . . . . . . . . 23 4.33 GOLD+; - DRAW COMMENT BOX . . . . . . . . . . . 23 4.34 GOLD+" - CAPITALIZE WORD . . . . . . . . . . . . 23 4.35 GOLD+' - SORT BUFFER . . . . . . . . . . . . . . 23 4.36 GOLD+| - EXECUTE CURRENT BUFFER . . . . . . . . 23 4.37 GOLD+\ - COMPILE CURRENT BUFFER . . . . . . . . 24 4.38 GOLD+< - INSERT START LEVEL 1 LIST . . . . . . . 24 4.39 GOLD+, - INSERT LIST ENTRY . . . . . . . . . . . 24 4.40 GOLD+> - INSERT END LEVEL 1 LIST . . . . . . . . 24 4.41 GOLD+. - DISPLAY VERSION . . . . . . . . . . . . 24 4.42 GOLD+? - INSERT RUNOFF COMMENT LINE . . . . . . 24 4.43 GOLD+/ - REPLACE . . . . . . . . . . . . . . . . 24 5 CONTROL KEYS . . . . . . . . . . . . . . . . . . . 25 5.1 CONTROL-B - RECALL . . . . . . . . . . . . . . . 25 5.2 CONTROL-E - INSERT CHARACTER . . . . . . . 25 5.3 CONTROL-F - INSERT CHARACTERS . . . . . 25 5.4 CONTROL-G - INSERT CHARACTER . . . . . . . 25 5.5 CONTROL-J - INSERT CHARACTER . . . . . . . 25 5.6 CONTROL-K - KEEP LEARN . . . . . . . . . . . . . 25 5.7 CONTROL-L - INSERT FORM FEED . . . . . . . . . . 25 5.8 CONTROL-P - RETURN TO SELECT POSITION . . . . . 25 5.9 CONTROL-R - REFRESH SCREEN . . . . . . . . . . . 26 5.10 CONTROL-U - ERASE TO START OF LINE . . . . . . . 26 5.11 CONTROL-V - INSERT KEYCODE . . . . . . . . . . . 26 5.12 CONTROL-Z - EXIT . . . . . . . . . . . . . . . . 26 6 LABELED KEYS . . . . . . . . . . . . . . . . . . . 27 6.1 GOLD+TAB- SKIP TAB - SKIP TO NEXT TAB STOP . . . 27 6.2 BACKSPACE - MOVE TO START OF LINE . . . . . . . 27 7 LK201 FUNCTION KEYS . . . . . . . . . . . . . . . 28 7.1 F11 - CHANGE DIRECTION . . . . . . . . . . . . . 28 7.2 F12 - END OF LINE . . . . . . . . . . . . . . . 28 7.3 F13 - DELETE WORD . . . . . . . . . . . . . . . 28 7.4 F14 - INSERT / OVERSTRIKE . . . . . . . . . . . 28 7.5 F17 - UPDATE FILE . . . . . . . . . . . . . . . 28 7.6 F18 - EXTEND TPU . . . . . . . . . . . . . . . . 28 7.7 F19 - ATTACH . . . . . . . . . . . . . . . . . . 28 7.8 GOLD F19 - KILL SUBPROCESS . . . . . . . . . . . 28 7.9 F20 - [NOT DEFINED] . . . . . . . . . . . . . . 28 8 LK201 KEYPAD KEYS . . . . . . . . . . . . . . . . 29 8.0.1 HELP Key . . . . . . . . . . . . . . . . . . . . 29 8.0.2 DO Key . . . . . . . . . . . . . . . . . . . . . 29 8.0.3 GOLD + Find . . . . . . . . . . . . . . . . . . 29 8.0.4 GOLD + Insert Here [UNDEFINED] . . . . . . . . . 29 8.0.5 GOLD + Remove [UNDEFINED] . . . . . . . . . . . 29 8.0.6 GOLD + Select [UNDEFINED] . . . . . . . . . . . 29 8.0.7 GOLD + Prev Screen [UNDEFINED] . . . . . . . . . 29 8.0.8 GOLD + Next Screen [UNDEFINED] . . . . . . . . . 29 9 DIRECTION KEYS . . . . . . . . . . . . . . . . . . 30 9.1 GOLD+LEFT ARROW - SHIFT TEXT TO THE LEFT 60 CHARACTERS . . . . . . . . . . . . . . . . . . . 30 9.2 GOLD+RIGHT ARROW - SHIFT TEXT TO THE RIGHT 60 CHARACTERS . . . . . . . . . . . . . . . . . . . 30 9.3 GOLD+UP ARROW - SCROLL MESSAGE BUFFER UP . . . . 30 9.4 GOLD+DOWN ARROW - SCROLL MESSAGE BUFFER DOWN . . 30 10 MOUSE SUPPORT . . . . . . . . . . . . . . . . . . 31 10.1 MOUSE BUTTON ASSIGNMENTS . . . . . . . . . . . . 31 10.1.1 M1DOWN . . . . . . . . . . . . . . . . . . . . . 31 10.1.2 M2DOWN . . . . . . . . . . . . . . . . . . . . . 31 10.1.3 M3DOWN . . . . . . . . . . . . . . . . . . . . . 31 10.1.4 GOLD + M3DOWN . . . . . . . . . . . . . . . . . 31 10.2 USING THE MOUSE TO CUT AND PASTE . . . . . . . . 32 11 CALLABLE EVEDT COMMANDS NOT MAPPED TO KEYS . . . . 33 11.1 COMPRESS PARAGRAPH . . . . . . . . . . . . . . . 33 11.2 COUNT CHARACTERS . . . . . . . . . . . . . . . . 33 11.3 CSR . . . . . . . . . . . . . . . . . . . . . . 33 11.4 DEFAULT MARGINS . . . . . . . . . . . . . . . . 33 11.5 DESCRIBE KEY . . . . . . . . . . . . . . . . . . 33 11.6 ESR . . . . . . . . . . . . . . . . . . . . . . 33 11.7 INVERSE WORD . . . . . . . . . . . . . . . . . . 33 11.8 LIST COMMANDS . . . . . . . . . . . . . . . . . 33 11.9 MAIL MARGINS . . . . . . . . . . . . . . . . . . 34 11.10 NOTES MARGINS . . . . . . . . . . . . . . . . . 34 11.11 RNO MARGINS . . . . . . . . . . . . . . . . . . 34 11.12 SLM . . . . . . . . . . . . . . . . . . . . . . 34 11.13 SET NOMATCHING . . . . . . . . . . . . . . . . . 34 11.14 SET NOSHOW TABS . . . . . . . . . . . . . . . . 34 11.15 SRM . . . . . . . . . . . . . . . . . . . . . . 34 11.16 SET SHOW TABS . . . . . . . . . . . . . . . . . 34 11.17 SRM HERE . . . . . . . . . . . . . . . . . . . . 34 11.18 STATUS LINE OFF . . . . . . . . . . . . . . . . 35 11.19 STATUS LINE ON . . . . . . . . . . . . . . . . . 35 11.20 TOGGLE JUSTIFY . . . . . . . . . . . . . . . . . 35 12 THE EVEDT COMMAND SET . . . . . . . . . . . . . . 36 13 GENERAL EVE NOTES . . . . . . . . . . . . . . . . 37 13.1 DELETION RECOVERY . . . . . . . . . . . . . . . 37 13.2 INITIALIZATION FILES. . . . . . . . . . . . . . 37 13.3 COMMAND FILES. . . . . . . . . . . . . . . . . . 38 13.4 USING EVEDT WITH VAX MAIL . . . . . . . . . . . 38 13.5 USING EVEDT WITH VAX NOTES . . . . . . . . . . . 38 13.6 BUFFERS USED BY EVEDT . . . . . . . . . . . . . 41 13.6.1 Internal EVE Buffers . . . . . . . . . . . . . . 41 13.6.2 COMMANDS . . . . . . . . . . . . . . . . . . . . 42 13.6.3 DCL . . . . . . . . . . . . . . . . . . . . . . 42 13.6.4 DELETE . . . . . . . . . . . . . . . . . . . . . 42 13.6.5 HELP . . . . . . . . . . . . . . . . . . . . . . 42 13.6.6 INSERT HERE . . . . . . . . . . . . . . . . . . 42 13.6.7 LIST . . . . . . . . . . . . . . . . . . . . . . 42 13.6.8 LIST BUFFER . . . . . . . . . . . . . . . . . . 42 13.6.9 MESSAGES . . . . . . . . . . . . . . . . . . . . 43 13.6.10 PROMPTS . . . . . . . . . . . . . . . . . . . . 43 13.6.11 RULER_LINE . . . . . . . . . . . . . . . . . . . 43 13.6.12 SCRATCH . . . . . . . . . . . . . . . . . . . . 43 13.6.13 SHOW . . . . . . . . . . . . . . . . . . . . . . 43 14 EVEDT QUICK REFERENCE CHART . . . . . . . . . . . 43 EVEDT USERS GUIDE Page 1 (Continued) 30 December 1988 1 INTRODUCTION Originally the EVEDT editor was to provide an EDT extension to the EVE editor. It was to provide the user with a familiar editing interface as well as all of the functionality of the TPU/EVE editor without the need for an extended learning period. With the introduction of VMS V5.0 and TPU V2.0, an EDT keypad definition and its corresponding functionality was provided by DEC. Over the years EVEDT has grown to be more than just a familiar interface, it has become a powerful programming and text writing tool, equipped with functionality no other single editor provides. As already mentioned, the EVEDT editor combines commands and features of a variety of editors. If a convincing argument can be made by any user for the development and / or inclusion of a particular command, it will be given consideration. Today EVEDT is equipped with the most commonly used procedures of the EDT keypad, all of the EVE procedures and several which exemplify the added power of the TPU/EVE system. Some of the major advantages that the EVEDT editor has over the EDT and EVE editors are: (1) Split Screens (2) Multiple buffers (3) Insert / Overstrike modes (4) Rectangular cut & paste (5) Keystroke Learning (6) Command Repeat (7) Spawn a subprocess from within the editor (8) Execute a DCL command from within the editor (9) Find matching begin / end blocks even if nested (10) Find matching open and close characters ({[<>]}) (11) Pascal, FORTRAN, C, PL/1 or PDL constructs inserted with a single key sequence 1.1 DOCUMENTATION The documentation for the EVEDT editor (which you are currently reading) may be found in the file: DISK$2:[SHAPIRO.USERS.EVE]EVEDTDOC.MEM EVEDT USERS GUIDE Page 2 (Continued) 30 December 1988 1.2 GETTING STARTED Before you can use the EVEDT editor you must first define it's location. These symbol definitions and assignments should be included in your login command file. There are two ways to define the editor, either may be used depending on your preference. The first method is as follows: ED*IT :== EDIT/TPU/SEC=EVE:EVEDT.TPU$SECTION Where: EVE is logically assigned as: ASSIGN DISK$2:[SHAPIRO.USERS.EVE] EVE The second (and recommended) method to define the section and initialization files is as follows: ED*IT :== EDIT/TPU ASSIGN DISK$2:[SHAPIRO.USERS.EVE] EVE DEFINE/NOLOG TPU$SECTION EVE:EVEDT.TPU$SECTION In either case, you should also define the HELP logical: DEFINE/NOLOG EVEDT$HELP EVE:HELP_EVEDT.HLB If you want to provide customization for your editor, you may define the following logicals. The first may contain EVE commands which will be executed at editor startup time. The second may contain TPU commands/procedures which will be executed at startup time. These files are described in more detail in sections 12.2 and 12.3 DEFINE/NOLOG EVE$INIT [YOUR.DIR]EVEDT$INIT.EVE DEFINE/NOLOG TPU$COMMAND [YOUR.DIR]EVEDT$COMMAND.TPU To envoke the editor (in either case) you would merely type: ED at the VMS command line prompt to edit the file EVEDT USERS GUIDE Page 3 (Continued) 30 December 1988 1.3 HANDY HINTS Realizing that some individuals prefer the learn-by-doing method, and only resort to reading the instructions under threat of death or worse, I have compiled a list of handy hints and tips for using the EVEDT editor. (1) When entering EVEDT, it is a good idea to specify a filename to edit. You don't have to, but if you don't the text you edit isn't associated with a file. (2) Using the BUFFER command to get a new buffer is sometimes dangerous since there is no file associated with the buffer, instead use the GETFILE key (KP3), this associates the file with a buffer (and vice-versa). (3) When you wish to make a different buffer the current buffer, you may use the GETFILE key (KP3). If the buffer exists, it will become current, if it doesn't it will search for a file of the same name, and if found, make it the current buffer. If the file doesn't exist, it will be created and saved upon exit. (4) Like all good programmers, you should save your current versions at frequent intervals. The GOLD O (Output to file) procedure is quick and easy and was intended to be used for this purpose. (5) Select ON/OFF is a TOGGLE. (6) Be careful when you are assigning a learn-ed sequence to a key. If the key you are assigning the sequence to is used within the sequence, you will put yourself into a recursive loop which may (probably) do strange and wonderous things to the file you are editing. (7) The GOLD S (SPAWN) procedure will enable you to return to VMS level without leaving the edit session. This is handy if you wish to answer / send mail or perform other activities at the VMS level. Don't forget to LOGOFF the spawned process when you have finished your activity. If you start re-editing the file which is being edited in the other process, you will wind up with various revisions with various changes in them. (8) The GOLD V (VMS Command) procedure will allow you to execute a single DCL command (at a time) from within the editor. EVEDT USERS GUIDE Page 4 (Continued) 30 December 1988 1.4 USING THIS MANUAL This Users Guide is intended to familiarize the user with the facilities available in EVEDT. It is not intended to be an exhaustive treatise, and will not provide detailed descriptions of the procedures available when a detailed description of the procedure is available in another document. The User should be familiar with the EDT editor as well as with the EVE editor. EVEDT (Extensible VAX Editor - EDT extension) is designed to incorporate the best features of the EDT editor with the improvements in speed and the greater extensibility and power of the EVE editing interface which is implemented in the VAX TPU language. The Keypad was originally designed for use with the VT100 series of terminals and has been modified for use with the VT200 series (and above) also. Extensive changes have been made to the keypad in the EVEDT implementation, as well as the procedures of the defined keys on the main typing array. 1.5 REFERENCES Since, as stated previously, this is not an exhaustive treatise, the reader is advised to become familiar with the documentation of the EDT Editor the EVE editing interface, the EVEDT editing interface, and the VAX Text Processing Utility reference manual for the complete description of procedures. 1.5.1 Synopsis Of EVEDT Users Guide Sections 2 through 10 of this manual briefly describe the procedures mapped to the keys and list the documents to refere to for a more detailed description of the procedures performed by the keys. Section 11 briefly describes the procedures which are not mapped to keys but are available via the command line. Section 12 of this manual contains an itemized and alphabetized list of all of the commands currently available within EVEDT. Section 13 contains various notes about using EVEDT in general, using EVEDT with VAX Mail and using EVEDT with VAX Notes. Section 14 of this manual is a Quick Reference Chart and may be torn out without destroying the integrity of this manual. EVEDT USERS GUIDE Page 5 (Continued) 30 December 1988 2 THE EVEDT KEYPAD +--------------+--------------+--------------+--------------+ | | Split Screen | Find Next | Delete Line | | | | | | | GOLD | Other Window | Find | Undel Line | +--------------+--------------+--------------+--------------+ | Recall | Section | Prev. Buffer | Delete Word | | | | | | | DO | Repeat | Next Buffer | Undel Word | +--------------+--------------+--------------+--------------+ | Advance | Backup | Remove | Delete Char | | | | | | | Bottom | Top | Insert | Undel Char | +--------------+--------------+--------------+--------------+ | Word | End Of Line | Get File | Insert/ | | | | | Overstrike | | Learn | Del to EOL | Prior Buffer | | +--------------+--------------+--------------+ | | Line | Select | | | | | Print | | Open Line | Rect. Select | | +-----------------------------+--------------+--------------+ Figure 1-1. The EVEDT Keypad +-------+-------+-------+-------+ +-------+-------+-------+-------+ |F11 |F12 |F13 |F14 | |F17 |F18 |F19 |F20 | |DIRECTN| EOL |DELWORD|INS/OVR| |UPDATE |EXT TPU|ATTACH | | | | | | | | | |KIL SUB| | +-------+-------+-------+-------+ +-------+-------+-------+-------+ +-------+-------+-------+ | FIND | INSERT| REMOVE| | | | | |FNDTHIS| | | +-------+-------+-------+ | SELECT|PRVSCRN|NXTSCRN| | | | | | | | | +-------+-------+-------+ | UP | | | |UP MSG | +-------+-------+-------+ | LEFT | DOWN | RIGHT | | | | | |WIND 60|DWN MSG|WIND 60| +-------+-------+-------+ Figure 1-2. The EVEDT LK201 Keypad EVEDT USERS GUIDE Page 6 (Continued) 30 December 1988 2.1 KEYPAD DIFFERENCES The EVEDT keypad has been modified somewhat from the standard EDT keypad to take advantage of the features of TPU. The keys which are different are: (1) PF2 - there is no keypad help procedure. This key allows the user to split the screen and edit 2 files concurrently. For help, you must type 'help' at the command level or use the 'HELP' key (if you are using a VT200 series terminal). (2) GOLD PF2 - This key allows the user to toggle between the split screens. (3) KP7 - there is no keypad page procedure. This key allows the user to execute the previous command line command specified. (4) GOLD KP8 - there is no keypad fill procedure. This key allows the user to have a command or procedure repeated several times. The fill procedure has been changed to GOLD J. (5) KP9 - there is no keypad append procedure. This key allows the user to scroll forward thru the previous buffers edited. (6) GOLD KP9 - there is no keypad replace procedure. This key allows the user to scroll backward thru the subsequent buffers edited. (7) GOLD KP1 - there is no keypad change case procedure. This key allows the user to enter a key sequence to be learned. Change case may be entered from the command line for upper, lower or inverted cases. See also GOLD+L and GOLD+U key descriptions. (8) KP3 - there is no keypad char procedure. This key allows the user to specify a file which should be retrieved into an editing buffer. (9) GOLD KP3 - there is no keypad special insert procedure. This key allows the user to toggle to the prior buffer being edited. The special insert procedure has been replace by GOLD A. (10) PERIOD - this procedure is a select TOGGLE. (11) GOLD PERIOD - there is no keypad select reset procedure. This key allows the user to select a rectangular section. Like select, this key is also a toggle. (12) ENTER - there is no keypad enter procedure. This key allows the user to toggle between INSERT and OVERSTRIKE modes. (13) GOLD ENTER - there is no keypad substitute procedure. This key causes the current buffer to be queued to SYS$PRINT for printing. EVEDT USERS GUIDE Page 7 (Continued) 30 December 1988 2.2 KEYPAD KEY DESCRIPTIONS 2.2.1 PF1 Key - Gold Shift This key invokes the Gold shift procedure. Refer to EDT Reference Manual as well as the VAXTPU Users Guide for more details on the use and operation of the GOLD Shift procedure. 2.2.2 PF2 Key - Split Screen Unlike the standard EDT keypad, the PF2 HELP procedure is not needed. You may still obtain help by typing HELP at the command line via the DO key or by striking the 'HELP' key (if you are using a VT200 series terminal). This key will split the screen into 2 separate windows. The current file you are editing will be displayed in both windows. You will be prompted for the name of a new file to get and display in the new window. You may get another file or buffer and display it in the current window, or you may move to the other window and get another file or buffer. If you choose not to get another file, do not specify a filename, and hit return. 2.2.3 PF3 Key - Find Next This key invokes the EVE "Find" procedure such that it will search for the subsequent occurrences of the previously found string. EVEDT V4.0 and above implements the set_find_whitespace command. This means that multiple spaces or even a carriage return or line feed may separate characters within the search and EVEDT will still find it. Refer to the EVE Users Guide for a description of the operation of this procedure. 2.2.4 PF4 Key - Delete Line This key invokes a procedure which will delete the current line. Refer to the VAX EDT Reference Manual for a description of the operation of this procedure. See also section 10, Deletion Recovery. 2.2.5 KP7 Key - Recall This key invokes the EVE Recall procedure. This procedure will allow the user to recall a command by name. When the command key is pressed, recall prompts for a string to match to a previous command which is stored in the command buffer. If the user enters a string, recall tries to find it in the command buffer. If it finds a match, the command is displayed and the user may execute it by pressing RETURN. If recall cannot find a match, it aborts and displays the current line number. EVEDT USERS GUIDE Page 8 (Continued) 30 December 1988 If it finds a match and the user doesn't want that command, the up and down arrow keys may be used to scroll through the command buffer in an effor to find another command to execute. Each time it will place the user at command level with the previous command entered. The user may designate that command by hitting return, or modify the command via command line editing similar to that at VMS level. 2.2.6 KP8 Key - Section This key will scroll the text forward or backward a full screen depending on the current direction. Refer to the EDT Users Guide for a description of the operation of this procedure. 2.2.7 KP9 Key - Previous Buffer EVEDT is buffer oriented. When you get a file, it is put into a holding buffer with the same name as the filename you specified. EVEDT keeps a list of the buffers you are currently using. This key allows you to 'scroll backward' through the list of buffers you have used. When you reach the first buffer in the list, you will wrap around to the last buffer. 2.2.8 MINUS Key - Delete Word This key invokes a procedure which deletes the current word. Refer to the VAX EDT Reference Manual for a description of the operation of this procedure. See also section 10, Deletion Recovery. 2.2.9 KP4 Key - Advance This key invokes the EVE "Forward" procedure. It changes the direction in which various commands traverse the buffer to forward. Refer to the EDT Users Guide for a description of the operation of this procedure. 2.2.10 KP5 Key - Page Up This key invokes the EVE "Reverse" procedure. It changes the direction in which various commands traverse the buffer to reverse. Refer to the EDT Users Guide for a description of the operation of this procedure. 2.2.11 KP6 Key - Remove This key invokes the EVE "Remove" procedure. It will cut the selected text from the current buffer. It will remove the text regardless of whether it was rectangular or regular SELECTed. Refer EVEDT USERS GUIDE Page 9 (Continued) 30 December 1988 to the EVE Users Guide for a description of the operation of this procedure. See also section 10, Deletion Recovery. 2.2.12 COMMA Key - Delete Character This key invokes a procedure which deletes the current character. Refer to the VAX EDT Reference Manual for a description of the operation of this procedure. See also section 10, Deletion Recovery. 2.2.13 KP1 Key - Word This key invokes the EVE "Move by Word" procedure. It will move the cursor to the start of the next word. Refer to the EVE Users Guide for a description of the operation of this procedure. 2.2.14 KP2 Key - End Of Line This key will position the cursor at the end of the current line, the end of the next line, or the end of the previous line depending on the position of the cursor in the line, and the status of the Forward / Reverse key. 2.2.15 KP3 Key - Get File This key envokes a procedure which will open a new current buffer and include the specified file into it. This procedure is designed such that wildcard characters may specified in the file name. All files matching the pattern will be mapped to buffers. 2.2.16 KP0 Key - Line This key invokes a procedure which will move the cursor to the beginning of the next line. Refer to the VAX EDT Reference Manual for a description of the operation of this procedure. 2.2.17 PERIOD Key - Select This key invokes the EVE "Select" procedure. Unlike EDT, this key will toggle between select and unselect. Refer to the EVE Users Guide for a description of the operation of this procedure. When a "LIST BUFFERS" or "LIST ALL BUFFERS" command has been entered, this key is temporarily redefined to allow the user to select a buffer in the list to become the current buffer. There is more information regarding this in the section describing the GOLD+B key sequence. EVEDT USERS GUIDE Page 10 (Continued) 30 December 1988 2.2.18 ENTER Key - Insert / Overstrike This key invokes the EVE "Insert/Overstrike" procedure. This will allow you to toggle betwee the 2 modes. Refer to the EVE Users Guide for a description of the operation of this procedure. EVEDT USERS GUIDE Page 11 (Continued) 30 December 1988 2.3 GOLD SHIFTED KEYPAD KEY DESCRIPTIONS 2.3.1 Gold+PF2 Key - Other Window This key sequence will allow you to scroll through (or toggle between) the multiple windows on the screen. 2.3.2 Gold+PF3 Key - Find This key sequence invokes the EVE "Find" procedure, which prompts for the string to be located. Refer to the EVE Users Guide for a description of the operation of this procedure. 2.3.3 Gold+PF4 Key - Undelete Line This key sequence invokes a procedure which will undelete a line deleted with the DELETE LINE key. Refer to the VAX EDT Reference Manual for a description of the operation of this procedure. 2.3.4 Gold+KP7 Key - Do This key sequence invokes the EVE "Do" procedure. It emulates the "Command" procedure of EDT. Refer to the EVE Users Guide for a description of the operation of this procedure. 2.3.5 Gold+kp8 - Repeat Next Command This key sequence invokes the EVE Repeat command. This command will allow the user to specify the number of times the next command is to be executed. This is very useful when the user desires to repeat a learn sequence. Refer to the EVE Users Guide for a description of the operation of this procedure. 2.3.6 Gold+KP9 Key - Next Buffer EVEDT is buffer oriented. When you get a file, it is put into a holding buffer with the same name as the filename you specified. EVEDT keeps a list of the buffers you are currently using. This key sequence allows you to 'scroll forward' through the list of buffers you have used. When you reach the last buffer in the list, you will wrap around to the first buffer. 2.3.7 Gold+MINUS Key - Undelete Word This key sequence invokes a procedure which will undelete the word deleted by the DELETE WORD key. Refer to the VAX EDT Reference Manual for a description of the operation of this procedure. EVEDT USERS GUIDE Page 12 (Continued) 30 December 1988 2.3.8 Gold+KP4 Key - Bottom This key sequence invokes the EVE "Bottom" procedure. It will position the cursor at the bottom of the current buffer. Refer to the EVE Users Guide for a description of the operation of this procedure. 2.3.9 Gold+KP5 Key - Top This key sequence invokes the EVE "Top" procedure. It will position the cursor at the top of the current buffer. Refer to the EVE Users Guide for a description of the operation of this procedure. 2.3.10 Gold+KP6 Key - Insert This key sequence invokes the EVE "Insert Here" procedure. It will insert the text cut via the Remove procedure, KP6, at the current cursor location. Refer to the EVE Users Guide for a description of the operation of this procedure. 2.3.11 Gold+COMMA Key - Undelete Character This key sequence invokes a procedure which will undelete the character deleted by the DELETE CHARACTER key. Refer to the VAX EDT Reference Manual for a description of the operation of this procedure. 2.3.12 Gold+KP1 Key - Learn This key sequence invokes the EVE "Learn" procedure. Refer to the EVE Users Guide for a description of the operation of this procedure. When learn is invoked, the status line states you must enter CTRL/K to remember the keystrokes. When CTRL/K is entered you are prompted to press the key you want to hold the learned keystrokes. This key must be a valid assignment, ie: no return, break, etc. keys. 2.3.13 Gold+KP2 Key - Delete To EOL This key sequence invokes a procedure which will delete the text to the end of the current line. Refer to the VAX EDT Reference Manual for a description of the operation of this procedure. See also section 10, Deletion Recovery. EVEDT USERS GUIDE Page 13 (Continued) 30 December 1988 2.3.14 Gold+KP3 Key - Prior Buffer This key sequence will allow you to toggle between your current buffer, and the prior buffer edited. If there is no prior buffer, EVEDT will inform you. 2.3.15 Gold+KP0 Key - Open Line This key sequence emulates the EDT Open Line command. Refer to the VAX EDT reference manual for a description of the operation of this procedure. 2.3.16 Gold+PERIOD Key - Rectangular Select This key sequence will allow you to select a rectangular area of text to be cut. Like Select, this key will toggle between select and unselect. When rectangular select is envoked, the entire block of text being selected is not highlighted as it is in the normal cut and paste mode. Only the character which the cursor was on when the SELECT key was pressed is highlighted (reverse video). This defines one corner of the rectangular block, the other corner is defined by moving to the opposite (diagonal) corner of the area of the screen that you want to cut from. It doesn't matter if you start the selection in the upper left corner or the lower right corner to define the block, you can start in any corner that you like. Pressing the REMOVE key will remove the selected text and fill the void with spaces. The cursor will also be moved to the upper left corner of the block The text that is cut is the text that lies within a box defined by the outside edges of the highlighted starting corner and the current cursor position, ie the line and column that both these markers are in is cut. When inserting text in this mode the text is restored below and to the right of the cursor position, and the text that was there is overwritten. Care should therefore be exercised to insure that sufficient space is allowed so that text is not destroyed. 2.3.17 Gold+ENTER Key - Print Buffer This key sequence invokes the EVE_PRINT_BUFFER procedure to print the current buffer. When you issue a PRINT BUFFER command, the current buffer is filtered to expand and translate any ASCII control characters or DEC multinational characters. The filtered version is placed in a new buffer with the same filename and an extension of .PNT. A subprocess is spawned and the .PNT file is queued to SYS$PRINT. EVEDT USERS GUIDE Page 14 (Continued) 30 December 1988 3 GOLD SHIFTED MAIN TYPING ARRAY KEYS 3.1 GOLD+RETURN - RETURN TO MAIN BUFFER This key sequence will return the user to the main buffer which is the initial buffer opened in the current editing session. 3.2 GOLD+A - SPECINS This key sequence invokes a procedure which emulates the EDT special insert procedure. The user may specify the decimal equivalent of an ASCII character and it will be inserted at the cursor. EVEDT does not represent special characters the same way EDT does. 3.3 GOLD+B - LIST ALL BUFFERS This key sequence will create a sorted list of all buffers currently in use, including any buffers allocated by EVEDT for its own use. To designate one of these buffers as the current buffer, move the cursor to the line containing the desired buffer, and designate the Select key, (Keypad PERIOD). 3.4 GOLD+C - CENTER This key sequence will cause the text on the current line to be centered within the margins. 3.5 GOLD+D - DRAW BOX This key sequence will draw a dashed line box around the area currently defined by a rectangular select. 3.6 GOLD+E - EXIT AND UPDATE DATE TIME STAMP This key sequence will search for the first occurrance of a date / time stamp in the buffer. If it is found, it is updated to the current date and time, the buffer is saved to a file, and the EVEDT editor is exited. If the stamp is not found, the user is notified, the buffer is saved to a file, and the EVEDT editor is exited. 3.7 GOLD+F - FILL RECTANGULAR This key sequence will allow you to fill a rectangularly marked block with a specified character or characters. If you are filling with a character sequence, the procedure will repeat the sequence continuously, wrapping from the end of one line, to the beginning of the next. If you want the sequence to remain unbroken, the EVEDT USERS GUIDE Page 15 (Continued) 30 December 1988 marked block should be as wide as a multiple of the size of the fill sequence. A rectangularly marked block must be specified prior to envoking this command. 3.8 GOLD+G - GOTO LINE # This key sequence allows you to explicitly specify the line number to go to in a file. If the line does not exist, EVEDT informs you as to how many lines are in the buffer. 3.9 GOLD+H - DISPLAY COLUMN NUMBER This key sequence will display the column number of the current cursor position. 3.10 GOLD+I - INCLUDE FILE This key sequence allows you to include an external file into the current buffer at the current cursor position. It is similar to the EDT Include command. 3.11 GOLD+J - FILL (JUSTIFY) This key sequence will cause the text in the current paragraph to be reformatted within the current margins. It is similar to the EDT GOLD kp8 command but unlike the EDT command, you do not need to select a range to be FILLed. If a range has been selected, only the text on the lines within the selected range will be FILLed. This implementation will use the current paragraph boundary definitions as delimiters. The command TOGGLE_JUSTIFY will allow you to toggle how the paragraph is filled. The default will cause the paragraph to be filled without any margin justification. This will result in the text in the right margins being ragged. When toggled, the paragraph will be filled such that blanks will be embedded as necessary between words to justify the line to the right margin. Refer to the COMPRESS_PARAGRAPH command for eliminating embedded, trailing and leading blanks from a paragraph. 3.12 GOLD+K - KEY DEFINITION This key sequence will allow the user to map an EVEDT procedure to a key. This mapping is only in effect for the duration of the current editing session or until the key is redefined. EVEDT USERS GUIDE Page 16 (Continued) 30 December 1988 3.13 GOLD+L - LOWERCASE RANGE/WORD This key sequence will change all the letters in the current range to lowercase. The cursor is then positioned to the first character of the next word. If there is no range specified, this procedure will change the case of the current word. 3.14 GOLD+M - SET MATCHING This key sequence allows you to specify which characters are matching characters. This command will automatically insert a corresponding character into a buffer. For example, if you type a "(", a matching ")" is also placed in the buffer. The cursor is positioned so that the next character typed will be between the matched characters. The following characters will generate a corresponding match character: [ ( { < 3.15 GOLD+N - FILENAME + DTS @ TOP This key sequence will cause EVEDT to move to the top of the current buffer and insert a line of the form: ! FILENAME.EXT -<( DD-MMM-YYYY HH:MM:SS.HH )>- 3.16 GOLD+O - OUTPUT TO FILE This key sequence will cause EVEDT to write the current buffer to a file by the same name. If the file already exists, a new revision is created. 3.17 GOLD+P - POSITION TO COLUMN This key sequence will cause the user to be prompted for the column on the current line that the cursor is to be positioned to. The companion procedure is: WHAT COL which returns the column number where the cursor is currently located, and may be invoked from the command line. 3.18 GOLD+Q - QUIT This key sequence will exit the user from the editor without saving the current buffer. If any changes have been made to the buffer, EVEDT will ask the user if the buffer should be saved to a file. EVEDT USERS GUIDE Page 17 (Continued) 30 December 1988 3.19 GOLD+R - RULER WINDOW This key sequence will open a 2 line window at the top of the current window. This window will have the text of a ruler line displayed. 3.20 GOLD+S - SPAWN This key sequence will spawn a sub process. When you LOG out of the sub process, you are returned to the editor. 3.21 GOLD+T - TIME MESSAGE This key sequence will display the current system time in the message window. 3.22 GOLD+U - UPPERCASE RANGE/WORD This key sequence will change all the letters in the current range to uppercase. The cursor is then positioned to the first character of the next word. If there is no range specified, this procedure will change the case of the current word. 3.23 GOLD+V - VMS DCL COMMAND This key sequence will allow the user to generate a DCL command from within EVEDT. A window is opened containing the buffer of information retrieved via the DCL command. This command may be useful for trapping text generated by a program which writes to SYS$OUTPUT as well as obtaining directory lists, etc. 3.24 GOLD+W - WILDCARD FIND This key sequence will allow you to specify wildcards within the string to be searched. Valid patterns recognized by VMS WILDCARD FIND are: * An arbitrary amount of text (within a line) ** An arbitrary amount of text, crossing lines % An arbitrary character \< Beginning of line \> End of line \[abc] Anything in the set abc \[1-9] Anything in the set 123456789 \[~1-9] Anything not in the set 123456789 \. Repeat previous pattern zero or more, including original \: Repeat previous pattern at least once, including original \ May be used to quote any of '\*%]~' \w An arbitrary amount of whitespace, with up to 1 line break EVEDT USERS GUIDE Page 18 (Continued) 30 December 1988 \d A decimal digit \o An octal digit \x A hexadecimal digit \a An alphabetic character (including supplemental) \n An alphanumeric character (letter or decimal digit) \s A symbol constituent (alphanumeric + $ and _) \l A lowercase letter \u An uppercase letter \p Punctuation character \f Formatting character \^ Control character \+ Any character with bit 7 set 3.25 GOLD+X - TOGGLE SCREEN WIDTH This key sequence will allow the user to toggle between screen widths of 80 and 132. 3.26 GOLD+Y - INSERT DATE / TIME STAMP This key sequence will insert a date / time stamp at the current cursor location. The format is -<( DD-MMM-YYYY HH:MM:SS.DD )>-. 3.27 GOLD+Z - INSERT DATE This key sequence will cause a date string of the form DD-MMM-YYYY to be inserted at the current cursor location. EVEDT USERS GUIDE Page 19 (Continued) 30 December 1988 4 GOLD SHIFTED NUMERIC / PUNCTUATION KEYS 4.1 GOLD+1 KEY - LANGUAGE CONSTRUCT Depending on the state of EVE_TOGGLE_CONSTRUCT, this key sequence will insert a PDL, PL/1, Pascal or C BEGIN END construct into the text at the current cursor location. 4.2 GOLD+2 KEY - LANGUAGE CONSTRUCT Depending on the state of EVE_TOGGLE_CONSTRUCT, this key sequence will insert a PDL IF THEN construct, PL/1 DO END construct, C IF construct, FORTRAN IF construct or Pascal IF construct into the text at the current cursor location. 4.3 GOLD+3 KEY - LANGUAGE CONSTRUCT Depending on the state of EVE_TOGGLE_CONSTRUCT, this key sequence will insert an IF THEN ELSE construct or CASE OF into the text at the current cursor location. 4.4 GOLD+4 KEY - LANGUAGE CONSTRUCT Depending on the state of EVE_TOGGLE_CONSTRUCT, this key sequence will insert a PDL CASE OF construct, PL/1 SELECT construct, C SWITCH construct, FORTRAN IF-ELSE-IF construct or Pascal WHILE construct into the text at the current cursor location. 4.5 GOLD+5 KEY - LANGUAGE CONSTRUCT Depending on the state of EVE_TOGGLE_CONSTRUCT, this key sequence will insert a PDL or PL/1 WHEN construct, a C CASE construct, a FORTRAN ELSEIF construct or a Pascal REPEAT construct into the text at the current cursor location. 4.6 GOLD+6 KEY - LANGUAGE CONSTRUCT Depending on the state of EVE_TOGGLE_CONSTRUCT, this key sequence will insert a PDL, PL/1, C or FORTRAN DO WHILE construct or Pascal FOR construct into the text at the current cursor location. 4.7 GOLD+7 KEY - LANGUAGE CONSTRUCT Depending on the state of EVE_TOGGLE_CONSTRUCT, this key sequence will insert a PDL or PL/1 DO UNTIL construct, C UNTIL construct, FORTRAN DO END DO construct or Pascal WITH construct into the text at the current cursor location. EVEDT USERS GUIDE Page 20 (Continued) 30 December 1988 4.8 GOLD+8 KEY - LANGUAGE CONSTRUCT Depending on the state of EVE_TOGGLE_CONSTRUCT, this key sequence will insert a PDL DO FOR construct, PL/1 DO TO construct, C FOR construct, FORTRAN COMPUTED GOTO construct or Pascal GOTO construct into the text at the current cursor location. 4.9 GOLD+9 KEY - LANGUAGE CONSTRUCT Depending on the state of EVE_TOGGLE_CONSTRUCT, this key sequence will insert a PDL or PL/1 ON CONDITION construct or FORTRAN GOTO construct into the text at the current cursor location. 4.10 GOLD+0 - SELECT CONSTRUCTS This key sequence will allow the user to change the GOLD + numeric key definitions between the Pascal, PDL, PL/1, C and FORTRAN constructs. 4.11 GOLD+! - FIND MATCHING BEGIN / END This key sequence invokes the procedure which will search for the matching BEGIN / END. When the cursor is placed with a begin or end string, EVEDT will search for the corresponding BEGIN or END string. 4.12 GOLD+@ - SELECT CAPITALIZE This key sequence invokes the procedure which will provide the user with a menu of each of the methods of capitalization. This includes 1) All uppercase, 2) All lowercase, 3) Capitalize first character of each word and 4) Invert cases of all characters. 4.13 GOLD+# - SHOW BUFFER ATTRIBUTES This key sequence invokes the procedure which will display the buffer attributes. 4.14 GOLD+$ - EXPAND TABS This key sequence invokes the procedure which will expand all the tabs within a specified range or from the current cursor location to the end of the buffer. If no range has been specified, it will expand all tabs in the current buffer. EVEDT USERS GUIDE Page 21 (Continued) 30 December 1988 4.15 GOLD+% - FILTER BUFFER This key sequence invokes the procedure which will filter the current buffer so as to expand and translate any ASCII control characters or DEC multinational characters. The filtered buffer is placed in a new buffer with the same filename and an extension of .FLT. 4.16 GOLD+^ - DISPLAY CHARACTER This key sequence invokes the procedure which will display information about the character at the current cursor position. The format of the output is: [ASCII Representation] [Octal Value] [Decimal Value] [Hex Value] [ASCII Control Code (if appropriate)] and [DEC Multinational Symbol (if appropriate)]. 4.17 GOLD+& - REPLACE ANY ASCII This key sequence invokes the procedure which will allow the user to replace any single ASCII character with a text string. This operates the exact same way as the REPLACE procedure except it is for single characters. 4.18 GOLD+* - CLIST This key sequence invokes the procedure which will allow you to debug code which has errors. When you compile the source, specify an output list file. If there are errors, edit the source file. Press the * keys. The .LIS file will be brought into the bottom window and the first error text will be highlighted. The cursor is positioned to the corresponding source file line in the top window. Subsequent * activations will search for subsequent errors in the .LIS file. 4.19 GOLD+( - FIND MATCHING This key sequence invokes the procedure which will search for the match to the characters: <({[ and ]})>. The cursor must be on the character to be matched. 4.20 GOLD+) - COUNT PAGE This key sequence invokes the procedure which will count 60 lines, up or down depending on the current direction. This is helpful for determining where to put form feeds when developing text files for printing. EVEDT USERS GUIDE Page 22 (Continued) 30 December 1988 4.21 GOLD+SPACE - CANCEL GOLD SHIFT This key sequence invokes a procedure which cancels the Gold Shift and displays a message in the message window. 4.22 GOLD+_ - TRIM LINE This key sequence invokes the procedure which will trim trailing blanks from the current line. 4.23 GOLD+- - TRIM BUFFER This key sequence invokes the procedure which will trim trailing blanks from all lines in the current buffer. 4.24 GOLD++ - OPEN FILE AT CURSOR This key sequence invokes the procedure which will search for the file which matches the string at the cursor. If found it will open a buffer and put the file into it, making it the current buffer. If the file is not found, it will create a new buffer and name it after the string at the cursor. The filename may contain logical symbols. 4.25 GOLD+= - LIST USER BUFFERS This key sequence invokes the procedure which will list all of the current user buffers. 4.26 GOLD+~ = FIX CRLF'S This key sequence allows you to remove carriage returns and linefeeds from buffers (e.g., if you are reading a file generated by Runoff). 4.27 GOLD+` - DELETE CURRENT BUFFER This key sequence invokes the procedure which will delete the current buffer. If the current buffer has been modified, the user is prompted to verify the deletion. 4.28 GOLD+{ - INSERT C / PL/1 COMMENT LINE This key sequence invokes the procedure which will insert a C / PL/1 comment line into the current buffer at the subsequent line. EVEDT USERS GUIDE Page 23 (Continued) 30 December 1988 4.29 GOLD+[ - INSERT BUFFER NAME STAMP This key sequence invokes the procedure which will insert the name of the current buffer at the current cursor position. 4.30 GOLD+} - INSERT FORTRAN COMMENT LINE This key sequence invokes the procedure which will insert a FORTRAN comment line into the current buffer at the subsequent line. 4.31 GOLD+] - FIND ANY ASCII This key sequence invokes the procedure which will allow the user to locate any ASCII character. The user is prompted for the decimal value of the ASCII character to search for. 4.32 GOLD+: - INSERT TPU COMMENT LINE This key sequence invokes the procedure which will insert a TPU comment line into the current buffer at the subsequent line. 4.33 GOLD+; - DRAW COMMENT BOX This command will draw a box with PL/1, Pascal, C, FORTRAN, TPU or text comment characters surrounding the rectangularly SELECTed text. The type of box drawn is based on the filename extension. 4.34 GOLD+" - CAPITALIZE WORD This key sequence will cause the current word at the cursor to be capitalized. 4.35 GOLD+' - SORT BUFFER This key sequence invokes the procedure which will sort the current buffer. 4.36 GOLD+| - EXECUTE CURRENT BUFFER This key sequence invokes the procedure which will execute the TPU procedures which are in the current buffer. EVEDT USERS GUIDE Page 24 (Continued) 30 December 1988 4.37 GOLD+\ - COMPILE CURRENT BUFFER This key sequence invokes the procedure which will compile the TPU procedures which are in the current buffer. 4.38 GOLD+< - INSERT START LEVEL 1 LIST This key sequence invokes the procedure which will insert a RUNOFF start level 1 list string into the current buffer at the current cursor position. 4.39 GOLD+, - INSERT LIST ENTRY This key sequence invokes the procedure which will insert a RUNOFF list entry string into the current buffer at the current cursor position. 4.40 GOLD+> - INSERT END LEVEL 1 LIST This key sequence invokes the procedure which will insert a RUNOFF end level 1 list string into the current buffer at the current cursor position. 4.41 GOLD+. - DISPLAY VERSION This key sequence invokes the procedure which will display the current EVEDT version on the message line. 4.42 GOLD+? - INSERT RUNOFF COMMENT LINE This key sequence invokes the procedure which will insert a RUNOFF comment line into the current buffer at the subsequent line. 4.43 GOLD+/ - REPLACE This key sequence invokes the procedure which will allow the user to replace one text string with another. EVEDT USERS GUIDE Page 25 (Continued) 30 December 1988 5 CONTROL KEYS 5.1 CONTROL-B - RECALL This key sequence will insert a backspace character at the current cursor position. 5.2 CONTROL-E - INSERT CHARACTER This key sequence will insert an escape character at the current cursor position. 5.3 CONTROL-F - INSERT CHARACTERS This key sequence will insert a character pair at the current cursor position. 5.4 CONTROL-G - INSERT CHARACTER This key sequence will insert a character at the current cursor position. 5.5 CONTROL-J - INSERT CHARACTER This key sequence will insert an character at the current cursor position. 5.6 CONTROL-K - KEEP LEARN This key sequence causes EVEDT to save the keystrokes entered via the LEARN command. When CTRL/K is entered you are prompted to press the key you want to hold the learned keystrokes. This may be any valid keystroke, ie: no return, break, etc. keys. 5.7 CONTROL-L - INSERT FORM FEED This key sequence inserts a form feed character at the current cursor location. 5.8 CONTROL-P - RETURN TO SELECT POSITION This key sequence invokes a procedure which returns the cursor to the position where it was when the select was enabled and cancels the select. Refer to the VAXTPU Reference Manual for information on the operation of the select procedure. EVEDT USERS GUIDE Page 26 (Continued) 30 December 1988 5.9 CONTROL-R - REFRESH SCREEN This key sequence will refresh current screen. 5.10 CONTROL-U - ERASE TO START OF LINE This key sequence will cause the text between the start of the current line and the cursor to be deleted. See also section 10, Deletion Recovery. 5.11 CONTROL-V - INSERT KEYCODE This key sequence will insert the escape code of the key pressed into the text. 5.12 CONTROL-Z - EXIT This key sequence will search for the first occurrance of a date / time stamp in the buffer. If it is found, it is updated to the current date and time, the buffer is saved to a file, and the EVEDT editor is exited. If the stamp is not found, the user is notified, the buffer is saved to a file, and the EVEDT editor is exited. EVEDT USERS GUIDE Page 27 (Continued) 30 December 1988 6 LABELED KEYS 6.1 GOLD+TAB- SKIP TAB - SKIP TO NEXT TAB STOP This key sequence envokes the the procedure which will skip the cursor to the next specified tab setting. No characters are inserted. 6.2 BACKSPACE - MOVE TO START OF LINE This key sequence will move the cursor to the of the current line. EVEDT USERS GUIDE Page 28 (Continued) 30 December 1988 7 LK201 FUNCTION KEYS 7.1 F11 - CHANGE DIRECTION This key will change the scrolling direction. 7.2 F12 - END OF LINE This key will move the cursor to the end of the line. 7.3 F13 - DELETE WORD This key will delete the word at the cursor. See also section 10, Deletion Recovery. 7.4 F14 - INSERT / OVERSTRIKE This key will toggle the Insert / Overstrike mode. 7.5 F17 - UPDATE FILE This key sequence will allow you update the current file. It will erase the contents of the current buffer and then include the current contents of the file which the buffer points to. This is useful when looking at log files which are being updated dynamically. 7.6 F18 - EXTEND TPU This procedure will execute the current line as if it were a TPU command. 7.7 F19 - ATTACH If EVEDT is being run in a subprocess, this key sequence will switch the current process to the parent process. 7.8 GOLD F19 - KILL SUBPROCESS This key sequence will stop any subprocesses. 7.9 F20 - [NOT DEFINED] EVEDT USERS GUIDE Page 29 (Continued) 30 December 1988 8 LK201 KEYPAD KEYS 8.0.1 HELP Key This key invokes the HELP procedure. The help screens reflect the EVEDT enhancements which have been made. You may obtain help in any of three ways. First, by striking the 'HELP' key (if you are using a VT200 series terminal) or by entering 'HELP' at the command line. This format will provide you with a list of commands from which you may obtain help. The second method is by entering 'KEYS HELP' at the command line. This format will request you to strike the individual keys about which you require information. Third, you may refer to the EVEDT Quick Reference Guide at the end of this manual (last page). 8.0.2 DO Key This key sequence invokes the EVE "Do" procedure. It emulates the "Command" procedure of EDT. Refer to the EVE Users Guide for a description of the operation of this procedure. 8.0.3 GOLD + Find This key sequence invokes the FIND THIS procedure. This procedure will search for the string matching the current word at the cursor. 8.0.4 GOLD + Insert Here [UNDEFINED] 8.0.5 GOLD + Remove [UNDEFINED] 8.0.6 GOLD + Select [UNDEFINED] 8.0.7 GOLD + Prev Screen [UNDEFINED] 8.0.8 GOLD + Next Screen [UNDEFINED] EVEDT USERS GUIDE Page 30 (Continued) 30 December 1988 9 DIRECTION KEYS 9.1 GOLD+LEFT ARROW - SHIFT TEXT TO THE LEFT 60 CHARACTERS This key sequence invokes the EVE_SHIFT_LEFT procedure with an argument of 60. Refer to the EVE Users Guide for a description of the operation of this function. 9.2 GOLD+RIGHT ARROW - SHIFT TEXT TO THE RIGHT 60 CHARACTERS This key sequence invokes the EVE_SHIFT_RIGHT procedure with an argument of 60. Refer to the EVE Users Guide for a description of the operation of this function. 9.3 GOLD+UP ARROW - SCROLL MESSAGE BUFFER UP This key sequence invokes the procedure which will scroll up through the previous messages. 9.4 GOLD+DOWN ARROW - SCROLL MESSAGE BUFFER DOWN This key sequence invokes the procedure which will scroll back down through subsequent messages. EVEDT USERS GUIDE Page 31 (Continued) 30 December 1988 10 MOUSE SUPPORT EVEDT V4.x is equipped to support the use of the mouse on all VAX Workstations. To utilize the mouse you must verify that the system logical: UIS$VT_ENABLE_LOCATOR = TRUE has been assigned. 10.1 MOUSE BUTTON ASSIGNMENTS 10.1.1 M1DOWN When depressed, this button will position the text cursor to the current location of the mouse cursor (provided that the mouse cursor is within the editing viewport). It doesn't matter how many windows you have, or which window you are in, you may transcend window boundaries merely by placing the mouse cursor where you want and pressing the leftmost button. Since a scrolling region has been defined, you may use the mouse to scroll the text up or down instead of using the next or prev screen keys. To do this you must position the mouse cursor within the top or bottom scrolling region and press mouse button 1. The text will scroll down or up respectively. You will notice that the mouse cursor stays in the same spot while the text cursor scrolls. Subsequent pressing of mouse button 1 will continue to scroll the text. 10.1.2 M2DOWN When depressed, this button performs the select function. 10.1.3 M3DOWN When depressed, this key will remove the text in the range specified. 10.1.4 GOLD + M3DOWN When this sequence is pressed, the removed text will be inserted at the current text cursor location. EVEDT USERS GUIDE Page 32 (Continued) 30 December 1988 10.2 USING THE MOUSE TO CUT AND PASTE 1. Position the mouse cursor to the start of text to be removed and press mouse button 1. 2. Initiate the select by pressing mouse button 2. 3. You may abort the select by pressing mouse button 2 a second time. 4. Position the mouse cursor to the end of text to be removed and press mouse button 1. 5. To cut text press mouse button 3. 6. Position the mouse cursor to where the text is to be inserted and press mouse button 1. 7. Press the GOLD key and then mouse button 3. The text has now been inserted at the cursor location. EVEDT USERS GUIDE Page 33 (Continued) 30 December 1988 11 CALLABLE EVEDT COMMANDS NOT MAPPED TO KEYS 11.1 COMPRESS PARAGRAPH This command will reformat a paragraph compressing and trimming any embedded, trailing or leading blanks. 11.2 COUNT CHARACTERS This command will count the number of occurences of the specified character. The character to count must be specified as the decimal value as found in the ASCII character code table. 11.3 CSR This command will perform a TPU compile on the selected range. 11.4 DEFAULT MARGINS This command will reset the current margins to the default EVEDT margins. 11.5 DESCRIBE KEY This command will describe the procedure definition of the specified key. 11.6 ESR This command will execute the TPU commands in a selected range. 11.7 INVERSE WORD This command will invert the case of the characters in the current word. If a select range is specified it will invert the case of all of the characters in the range. Inverse_word works just like eve_uppercase_word and eve_lowercase_word. 11.8 LIST COMMANDS This command will compile a list of all available commands. EVEDT USERS GUIDE Page 34 (Continued) 30 December 1988 11.9 MAIL MARGINS This command will set the margins to the VAX Mail defaults. Column 5 and 75. 11.10 NOTES MARGINS This command will set the margins to the 11.11 RNO MARGINS This command will set the current margins to the runoff defaults. 11.12 SLM This command will set the left margin at the current cursor location. 11.13 SET NOMATCHING This command will allow the user to remove matched characters. See also Set Matching. 11.14 SET NOSHOW TABS This command will turn off the show tabs. This causes the tab characters to become 'invisible'. See also Show Tabs. 11.15 SRM This command will set the right margin at the current cursor location. 11.16 SET SHOW TABS This command will set show tabs. This causes the tab characters to become 'visible'. See also Set Noshow Tabs. 11.17 SRM HERE This command will set the right margin at the current column. EVEDT USERS GUIDE Page 35 (Continued) 30 December 1988 11.18 STATUS LINE OFF This command will turn off the status line. 11.19 STATUS LINE ON This command will turn on the status line. 11.20 TOGGLE JUSTIFY This command will allow you to toggle how the paragraph is filled. The default will cause the paragraph to be filled without any margin justification. When toggled, the paragraph will be filled such that blanks will be embedded as necessary between words to justify the line to the right margin. Refer to the COMPRESS_PARAGRAPH and FILL commands. EVEDT USERS GUIDE Page 36 (Continued) 30 December 1988 12 THE EVEDT COMMAND SET Many commands are mapped to keys. The command may be invoked by pressing the appropriate key sequence, or by typing in the command name at the COMMAND: prompt. A complete list of commands may be obtained by using the command, LIST COMMANDS, the output of which is stored in the SHOW buffer. Help for each command may be obtained while in the EVEDT editor. The following chart lists the current EVEDT commands available at the time of this manuals revision date. o Commands Mapped To Keys ccb clist comment_line count_page date_stamp dbuffer describe_key display_char draw_box draw_comment_box dts ecb eliminate_tabs faa fill_rectangular find_be_match find_matching find_this first_user_buffer fix_crlfs go_col inspecial justify label_file mess_down mess_up move_left_wrap name_file nxt_buffer open pas_begend pas_caseof pas_for pas_goto pas_ifthenelse pas_repeat pas_while pas_with print_buffer prior_buffer prv_buffer put_bs put_cr put_crlf put_esc put_ff put_lf raa rectangular_insert_here rectangular_remove rectangular_select select_capitalize select_construct sort_buffer space_tab specins time_message toggle_nomodify toggle_nowrite toggle_tracebac toggle_width toggle_winum_get trim_buffer update_file version what_col xtpu o Commands Not Mapped To Keys ccom_line chc_constructs chfor_construct chpas_construct chpdl_construct chpli_construct comcom_line compress_par count_char csr c_begend c_case c_dowhile c_for c_ifthen c_ifthenelse c_switch c_while default_margins dti_stamp dts_replace esr fill_chars filter_buffer forcom_line for_cgoto for_doendo for_dowhile for_elseif for_goto for_if for_ifelseif for_ifthenelse for_margins get_line insertchars insreq list_commands maccom_line mail_margins notes_margins parenthesize EVEDT USERS GUIDE Page 37 (Continued) 30 December 1988 pascom_line pdl_begend pdl_caseof pdl_dofor pdl_dountil pdl_dowhile pdl_ifthen pdl_ifthenelse pdl_oncond pdl_when plicom_line pli_begend pli_caseof pli_doend pli_dofor pli_dountil pli_dowhile pli_ifthenelse pli_oncond pli_when print_select_range rnocom_line rno_margins set_matching set_nomatching set_norectangular set_noshow_tabs set_rectangular set_show_tabs skip_tab slm_here srm_here start_notes status_line_off status_line_on toggle_justify tpucom_line user_set_margins user_strip_margins width xrecall 13 GENERAL EVE NOTES This section describes any additional or unique differences between the ways that EVEDT and EDT operate as well as useful information regarding the nuances of EVEDT. 13.1 DELETION RECOVERY EVEDT has a buffer dedicated to holding all text which was deleted. The buffer name is DELETE and may be opened by using the SET BUF DELETE command at the command prompt. Text may then be retrieved from this buffer and moved to a different buffer. Regardless of whether it was a character, line, block or rectangular block delete, the deleted text is saved to this buffer. If at any time you realize you should not have deleted something, you may cut it from this buffer and paste it back into your current text. 13.2 INITIALIZATION FILES. EVEDT, like EDT uses an initialization file. This is a file which contains a series of VAX EVE commands which are to be executed at EVEDT startup time. This file is pointed to by the EVE$INIT logical. It may be defined as: DEFINE/NOLOG EVE$INIT [YOUR.DIR]EVE$INIT.EVE This file is comprised of any valid EVE or EVEDT procedure command. For more detailed information, refer to the VAX EVE Reference manual. EVEDT USERS GUIDE Page 38 (Continued) 30 December 1988 13.3 COMMAND FILES. Similar to the initialization file is the command file. This is a file which contains a series of VAX TPU commands and/or procedures which are to be executed at EVEDT startup time. The execution of these commands / procedures is much faster than those in the initialization file so you may prefer this method of customization. The command file is pointed to by the TPU$COMMAND LOGICAL. It may be defined as: DEFINE/NOLOG TPU$COMMAND [YOUR.DIR]EVEDT$COMMAND.TPU NOTE: If you are currently using a TPUINI file, those commands would now be placed in this file. 13.4 USING EVEDT WITH VAX MAIL It is possible to specify the EVEDT editor as the editor of choice while using mail. This is done by using the command SET EDITOR TPU. This will only work if you have used method 2 as described in the Getting Started section of this manual. 13.5 USING EVEDT WITH VAX NOTES There are several ways to use the EVEDT editor with VAX Notes depending on how much versatility you want. This discussion is VAX Notes specific so a working knowledge of VAX Notes would help. If you want FULL control and maximum versatility while in VAX Notes, the following procedures should be followed: 1). Make sure you have defined the logical TPU$SECTION. DEFINE/NOLOG TPU$SECTION EVE:EVEDT.TPU$SECTION 2). Define the following logicals for use with VAX Notes: $ DEFINE/NOLOG NOTES$COMMAND DISK:[DIR.SUBDIR]NOTESKDEF.INI $ DEFINE/NOLOG NOTES$EDIT DISK:[DIR.SUBDIR]NOTESEDIT.COM The NOTESKDEF.INI file is an initialization files similar to TPU$COMMAND. It may be used to (re)define keys, procedures, etc. The NOTESEDIT.COM file is used to setup the definitions as to which editor is to be used while in notes. Step 3 below describes this file in detail. 3). Create a command file which will be used by VAX Notes to access the editor. For example: $ ! $ ! FILENAME: NOTESEDIT.COM EVEDT USERS GUIDE Page 39 (Continued) 30 December 1988 $ ! PROCEDURE: Command control file to use EVEDT with $ ! AUTHOR: Steven K. Shapiro $ ! (C) SKS Enterprises, Austin TX, 1988 $ ! DATE: 29-JUL-1988 Original. $ ! HISTORY: -<( 28-SEP-1988 09:44:18.72 )>- current. $ ! $ !456789A123456789B123456789C123456789D123456789E123456789F123456 $ ! $ ! Command procedure to invoke an editor for VAX NOTES. $ ! $ ! Inputs: $ ! $ ! P1 = Input file name. $ ! P2 = Output file name. $ ! $ ! If NOTES$EDIT is undefined, NOTES will invoke callable EDT. $ ! If NOTES$EDIT is defined to be a command procedure, $ ! NOTES will create a subprocess to edit the note. $ ! $ ! Note that this procedure is run in the context of a subprocess. $ ! LOGIN.COM is not executed. However, all process logical names $ ! and DCL global symbols are copied. $ ! $ ! The default directory is the same as the parent process. $ ! $ DEFINE /USER SYS$INPUT 'F$TRNLNM("SYS$OUTPUT")' $ ! $ ! Save off the current INI logical. $ ! $ orig_ini := 'F$TRNLNM("TPUINI")' $ ! $ ! Define the TPUINI logical to point to the NOTES INI file. $ ! $ DEFINE/NOLOG TPUINI COM:NOTESINI.INI $ ! $ IF P1 .EQS. "" THEN GOTO NOINPUT $ EDIT/TPU/OUTPUT='P2' 'P1' $ EXIT $ ! $NOINPUT: $ EDIT/TPU 'P2' $ ! $ ! Reset the INI definition to the original. $ ! $ DEFINE/NOLOG TPUINI 'orig_ini $ EXIT This procedure redefines the logical symbol so that it points to the initialization file which is to be used specifically for editing in a VAX Notes session. Unless you have defined information specific to editing in VAX Notes, you may omit this line and the default EVEDT initialization file will be used. The editor is then envoked. EVEDT USERS GUIDE Page 40 (Continued) 30 December 1988 When editing is completed, the initialization logical is reset to the original. If you omitted the redefinition, this line may be omitted also. 4). Go into VAXNotes 5). Enter the command: SET PROFILE/EDITOR=(@DISK:[DIRECTORY.SUBDIR]NOTESEDIT.COM,SPAWN) -OR- If you have defined the logicals: $ DEFINE/NOLOG NOTES$COMMAND COM:NOTESKDEF.INI $ DEFINE/NOLOG NOTES$EDIT COM:NOTESEDIT.COM then: SET PROFILE/EDITOR=(@NOTES$COMMAND,SPAWN) 6). You should now be all set to use your editor. To verify, do a WRITE or a REPLY and see if your editor is being used. EVEDT USERS GUIDE Page 41 (Continued) 30 December 1988 13.6 BUFFERS USED BY EVEDT The LIST ALL BUFFERS command will display a screen which resembles: Buffer name Lines Attributes $CHOICES$ 0 Modified No-write System Perm $DEFAULTS$ 0 No-write No-modify System $LOCAL$INI$ 24 System $MATCHES$ 1 Modified No-write System Perm $PROMPTS$ 1 Modified No-write System $RECALL_LINE$ 24 Modified No-write System Perm $RESTORE$ 1 Modified No-write System $RESTORE$CHAR$ 1 Modified No-write System $RESTORE$LINE$ 1 Modified No-write System $RESTORE$WORD$ 1 Modified No-write System COMMANDS 7 Modified No-write System Perm DELETE 39 Modified No-write System Perm HELP 10 Modified No-write System Perm INSERT HERE 15 Modified No-write System LIST 0 No-write System Perm LIST BUFFER 25 Modified No-write System MESSAGES 54 Modified No-write System Perm PROMPTS 4 Modified No-write System Perm RULER_LINE 2 Modified No-write System SCRATCH 0 No-write System Perm SHOW 0 No-write System These are the system defined buffers used by EVEDT. Note, the number of lines in each buffer will vary depending on your implementation. 13.6.1 Internal EVE Buffers These are system buffers for internal use by EVE. Refer to VAX EVE documentation for more information regarding these buffers. 1. $CHOICES$ 2. $DEFAULTS$ 3. $LOCAL$INI$ 4. $MATCHES$ 5. $PROMPTS$ 6. $RECALL_LINE$ 7. $RESTORE$ 8. $RESTORE$CHAR$ 9. $RESTORE$LINE$ 10. $RESTORE$WORD$ EVEDT USERS GUIDE Page 42 (Continued) 30 December 1988 13.6.2 COMMANDS This is the buffer which contains all of the commands which have been issued via the DO key(s). When you enter an EVEDT command from the command line you are able to scroll through all commands previously issued rather than having to type them in again. 13.6.3 DCL This is the DCL buffer. If the user issues a V command, the command and its associated text are displayed to the user in this buffer. 13.6.4 DELETE This buffer contains the text of commands which deleted text. This includes the delete line, delete word, delete character, delete to end of line, delete to beginning of line, remove, rectangular remove and delete previous char procedures. (Refer to the appropriate sections of this document for detailed descriptions of these procedures.) The purpose of this buffer is to have a common buffer in which all text which was removed may be found. This will allow a user to restore any text lost due to a mistaken delete. 13.6.5 HELP This buffer is used to contain the text displayed by the HELP key. 13.6.6 INSERT HERE This buffer contains the text currently cut by a remove or rectangular remove. It is transient in that it only contains the currently removed text. 13.6.7 LIST This buffer is used to contain the .LIS file when a CLIST command is envoked. 13.6.8 LIST BUFFER This is the buffer which contains the list of buffers. EVEDT USERS GUIDE Page 43 (Continued) 30 December 1988 13.6.9 MESSAGES This is the buffer which contains all of the messages which have been displayed in the message line. 13.6.10 PROMPTS This buffer contains a list of all of the prompts which have been issued to the user. 13.6.11 RULER_LINE This buffer contains the headline ruler which is displayed when the R command is envoked. 13.6.12 SCRATCH This buffer is a generic scratch buffer. It is currently used to hold text for a variety of procedures which need a place to temporarily store text. 13.6.13 SHOW This buffer contains the information displayed when the SHOW command is envoked. 14 EVEDT QUICK REFERENCE CHART - The following pages contain a brief synopsis of the EVEDT commands which have been mapped to keys. They may be copied and posted for reference as desired. EVEDT KEY DEFINITIONS - KEYPAD QUICK REFERENCE GUIDE +-------+-------+-------+-------+ +-------+-------+-------+-------+ |F11 |F12 |F13 |F14 | |F17 |F18 |F19 |F20 | |DIRECTN| EOL |DELWORD|INS/OVR| |UPDATE |EXT TPU|ATTACH | | | | | | | | | |KIL SUB| | +-------+-------+-------+-------+ +-------+-------+-------+-------+ +-------+-------+-------+ +-------+-------+-------+-------+ | FIND | INSERT| REMOVE| | | SPLIT | NEXT | DELIN | | | | | | | | | | |FNDTHIS| | | | GOLD | TOGGLE| FIND | UNDEL | +-------+-------+-------+ +-------+-------+-------+-------+ | SELECT|PRVSCRN|NXTSCRN| | RECALL|SECTION|PRV BUF| DLWRD | | | | | | | | | | | | | | | DO | REPEAT|NXT BUF| UDLWRD| +-------+-------+-------+ +-------+-------+-------+-------+ | UP | |ADVANCE| BACKUP| REMOVE| DLCHR | | | | | | | | |UP MSG | | BOTTOM| TOP | INSERT| UDLCHR| +-------+-------+-------+ +-------+-------+-------+-------+ | LEFT | DOWN | RIGHT | | WORD | EOL |GETFILE| | | | | | | | | |INSERT/| |WIND 60|DWN MSG|WIND 60| | LEARN | DLEOL | PRIOR |OVERSTK| +-------+-------+-------+ +-------+-------+-------+ | | LINE | SELECT| | | | | PRINT | | OPEN LINE |RECTSEL| | +---------------+-------+-------+ EVEDT KEY DEFINITIONS - KEYBOARD QUICK REFERENCE GUIDE GOLD A - SPECINS GOLD RETURN TO MAIN BUFFER GOLD B - LIST ALL BUFFERS GOLD ~ - FIX CRLF'S GOLD C - CENTER LINE GOLD ` - DELETE BUFFER GOLD D - DRAW BOX @ GOLD ! - FIND BEGIN / END MATCH GOLD E - EXIT & UPDATE DTS @ GOLD @ - SELECT CAPITALIZE GOLD F - FILL RECTANGULAR @ GOLD # - SHOW BUFFER GOLD G - GOTO LINE # GOLD $ - EXPAND TABS GOLD H - DISPLAY COLUMN NUMBER GOLD % - FILTER BUFFER GOLD I - INCLUDE FILE GOLD ^ - DISPLAY CHARACTER GOLD J - FILL (JUSTIFY) GOLD & - REPLACE ANY ASCII GOLD K - KEY DEFINITION GOLD * - CLIST GOLD L - LOWERCASE WORD / RANGE @ GOLD ( - FIND MATCHING GOLD M - SET MATCHING GOLD ) - COUNT PAGE (60 LINES) GOLD N - FILENAME + DTS @TOP GOLD - - TRIM BUFFER GOLD O - OUTPUT TO FILE GOLD _ - TRIM LINE GOLD P - POSITION TO COLUMN @ GOLD + - OPEN FILE AT CURSOR GOLD Q - QUIT GOLD = - LIST USER BUFFERS GOLD R - RULER WINDOW @ GOLD { - TOGGLE NOWRITE GOLD S - SPAWN @ GOLD } - TOGGLE NOMODIFY GOLD T - TIME MESSAGE GOLD [ - BUFFER NAME STAMP GOLD U - UPPERCASE WORD / RANGE GOLD ] - FIND ANY ASCII GOLD V - VMS DCL COMMAND @ GOLD : - CONTEXT SENS. CMNT LINE @ GOLD W - WILDCARD FIND @ GOLD ; - CONTEXT SENS. CMNT BOX GOLD X - TOGGLE SCREEN WIDTH GOLD " - CAPITALIZE WORD GOLD Y - INSERT DATE / TIME STAMP GOLD ' - SORT BUFFER GOLD Z - INSERT DATE GOLD | - TPU EXECUTE CUR. BUFFER GOLD \ - TPU COMPILE CUR. BUFFER GOLD 1 - BEGIN / END; GOLD < - START RNO LEVEL 1 LIST GOLD 2 - IF THEN ELSE GOLD > - END RNO LEVEL 1 LIST GOLD 3 - CASE OF GOLD , - INSERT RNO LIST ENTRY GOLD 4 - WHILE DO GOLD . - DISPLAY VERSION GOLD 5 - REPEAT UNTIL @ GOLD ? - TOGGLE TRACEBACK GOLD 6 - FOR TO DO GOLD / - REPLACE <> W/<> GOLD 7 - WITH AS DO BKSP - MOVE TO START OF LINE GOLD 8 - GOTO ; LFEED - DELETE TO NEXT WORD GOLD 9 - UNDEFINED GOLD 0 - SELECT CONSTRUCT CONTROL KEYS: Key: @ CTRL A - TOGGLE INSERT / OVERSTRIKE @ Functionality CHANGED in V4.x CTRL B - INSERT ! Functionality DELETED in V4.x CTRL E - INSERT CTRL F - INSERT CTRL G - INSERT CTRL J - INSERT CTRL K - KEEP LEARN CTRL L - INSERT FORM FEED CTRL N - CTRL P - GOTO SELECT POSITION CTRL R - REFRESH SCREEN @ CTRL T - PROCESS INFORMATION CTRL U - ERASE TO SOL CTRL V - INSERT KEY INTO TEXT CTRL Z - EXIT