.! a free Xeroxed copy of this file should be available in D108; .! if necessary, you can use RUNOFF and then PRINT the .mem file. .! .flags overstrike .no autosubtitle .no autoparagraph .no headers .no fill .no justify .no autojustify .keep .paging .page size 58,73 .left margin 8 .right margin 73 .spacing 1 Educational Computing Kalamazoo College .right;Rev. 3/31/86 .c;Using the VAXTPU EDT Keypad Emulator .title ########TPU EDT .headers A new implementation of the EDT screen editor is now in use. It generally runs faster, so that you can get more work done in less time. It also improves overall system response time, especially with a large number of users active at once. It is invoked now, instead of EDT, by the commands ED, EDI, or EDIT (which are described collectively as "ED*IT", below). To get full benefit, obtain the file TPUINI.TPU with the GET command. ^&However\&, there are some differences in the screen display, a few EDT commands that are not implemented, and some new commands. For a short period of time we will permit anyone to access the old EDT editor, with the command "EDITEDT filename", but because it places an excessive load on the system, we want the use of the old EDT to stop as soon as possible. Therefore, if you find that the new editor cannot do what you need, ^&TELL US ABOUT IT\& right away, either in person or by system MAIL to user SYSTEM. The fast editor is written in a new programming language, VAXTPU (Text Processing Utility), which provides for two stages of customization, called "SECTION" and "COMMAND" files. Command files are compiled each time you start editing, while section files are precompiled, so we have kept our command files small and placed the bulk of our modifications into the section file. All of the customizations to EDT that were implemented in our former standard EDTINI.EDT file and some new ones are included in the Kalamazoo section file (SYST:[SYSLOGIN]KAZSECINI.TPU is the source code; KAZSECINI.GBL is the compiled code usable as a section file; SYS$LIBRARY:TPUSECINI.GBL is another copy of the compiled code), and have defined system-wide that the commands ED*IT will all use that last file. The editor also looks in your current directory for a file named TPUINI.TPU; if it finds such a file, it attempts to use it as a command file. You can obtain your own copy of our standard TPUINI.TPU file by using the GET command. You can override the choice of command and section files, as discussed below in the section "Customizing the Editor". ^&Display Differences\& Instead of [EOB] at the bottom of the file, it now shows [End of Main]. Control characters, such as , (= CTRL/L), etc., are displayed differently. Many of them are just displayed as a solid block. .page Error and informational messages, from the editor and from the operating system (for example, if you get mail or someone tries to phone you) are displayed at the bottom of the screen in a new format, and can be reviewed by selecting the MESSAGE buffer using the command sequence + B. On those occasions when a command does take a long time to execute, you will ^¬\& get the "Working" message flashed at the bottom of the screen. Lines with 81 characters, or longer, will have the first 79 characters displayed, followed by a "diamond" in the last column. Nothing is lost, you just can't see it all at once. Since this ordinarily happens only temporarily while adding text in the middle of a line, it should present little difficulty. You ^&can examine\& the vanished text by using + LEFT ARROW (and later return to normal display with + RIGHT ARROW), but that will conceal the beginnings of the lines (without showing diamonds to indicate the loss). Using the PAGE command (PAD 7) does NOT locate the cursor at the top of the screen, but it does search to the next character. You will therefore now be able to see on-screen the end of one page and the start of the next, immediately after the command. ^&Command Differences\& If you use CTRL/C to abort a command, the journal file may be invalidated. Therefore, if you do this, exit the editor with + CTRL/Z and then re-enter with + . CTRL/K = Define Key, now takes key definitions in VAXTPU syntax, not in the old EDT Line Mode syntax. You may find yourself in a situation where you will want to give the same series of editor commands repeatedly. This is easier if you take advantage of the editor's ability to LEARN a sequence of keystrokes and then to ^&define a specific key\& to cause the execution of that whole learned sequence. You start with the command + K, then give the keystrokes that are to be learned, then give the command + CTRL/K, and finally specify the key to used when that sequence is to be "replayed". + PAD 7 = Command, now takes commands in VAXTPU syntax, not in the old EDT Line Mode syntax. To give commands in the old EDT Line Mode syntax, first type CTRL/Z to get the "*" prompt. The VAXTPU command "EXIT" does not write a new copy of the file unless you actually made changes, but the Kalamazoo custom exit, + CTRL/Z, does. .page CTRL/Z still gives you an "*" prompt at the bottom of the screen, but only a few of the old EDT Line Mode commands will be accepted. If you need one that isn't implemented, PLEASE LET US KNOW RIGHT AWAY. Afterwards, type C to change back to edit mode. To go to a specific line of a file, use the new command + C; you will be prompted for the line number you want to go to. The new command CTRL/X can be used to stifle the error messages being spit out at you if you do get ahead of the editor, for example in moving beyond the ends of the buffer. Searches: (a) The key now also terminates a search string, not just the key. (b) You cannot at this time search for a control character; if you need the capability, PLEASE LET US KNOW. The new editor will work only on terminals operating in ANSI mode, such as VT-100's, GIGI's, and Z-29's; it will not work on terminals operating in VT-52 mode. The sentence jump commands have changed from CTRL/F to CTRL/G or + CTRL/F and from CTRL/B to CTRL/B or + CTRL/B. The old CTRL/T = TAB ADJUST command no longer takes a numerical prefix. The new ^&equivalent\& command + T, however, does. A new command, + CTRL/W, is useful when you want to modify two files in a coordinated way. This command sets up the top half of the screen as a window in the originally-edited file, and the bottom half for the other file. When you exit, ^&both files will be updated\&. When you want to move between the two, toggles back and forth between them. To revert to full-screen, single-window editing, use + CTRL/W again and specify 1 window; you will be left in the file you were editing at that time, but can then use + B or + M as usual if you want to go full-screen with the other file. Both files will still be updated when you EXIT; if you want only one file to be updated, then use + O to write it out, followed by + Q to QUIT; you will need to respond "Y" to the question about continuing quitting. The scrolling commands + and + are adjusted for the window size. To execute a DCL command from within the editor, and have the resulting output placed into a buffer that will be visible on one half of the screen, use the new command + W. The DCL window can be removed by using + CTRL/W and specifying 1 window. The DCL output can be CUT from that buffer and PASTED into any other location, or it may be convenient just to see the information on screen while you are in the editor. If you use to go into the DCL window, you can move the cursor to the interesting part of the output; if later you want to give another .page DCL command, you need not re-position the cursor, that will be done automatically. To write the current buffer out to disk and compile it, use the new command + P. The language is presumed to be PASCAL, unless you are using the command file TPUINI.FOR, in which case it is presumed to be FORTRAN. You can customize a command file to any other language, if you wish. ^&Summary\& The following summarizes all of the commands that are added to the standard VAX TPU EDT Keypad Emulator repetoire by the files TPUINI.TPU and KAZSECINI.GBL, located in SYST:[SYSLOGIN]. The former can be obtained with the GET command. Nearly all of these commands were first implemented in EDTINI.EDT, using the original version of EDT. The commands listed below are also discussed in the "Command Guide for EDT." The commands are listed in groups according to function: Pointer Motion Text Alteration Editing Conveniences Programmers' Delights Multi-Buffer Operations ^&Pointer Motion\& CTRL/B or -SEN Move the pointer back one sentence. + CTRL/B CTRL/G or +SEN Move the pointer forward one sentence. + CTRL/F CTRL/N -PAR Move the pointer back one paragraph. CTRL/P +PAR Move the pointer forward one paragraph. CTRL/V Mark position for later restoration. CTRL/R Restore to position marked by CTRL/V. + CTRL/P Move to 58 th line (bottom) of present page; gives "String not found" message, but works, if at the top of the page. .page + Move back 21 lines (a full screen jump). + Move forward 21 lines (a full screen jump). + Move 8 characters in the current direction. ^&Text Alteration\& + D Inserts the character string "__:" which has the effect of a forward half linefeed (moves the print DOWN half a line) when printing on the NEC Spinwriter the .MEM file that RUNOFF produces from your .RNO file with this character string. See + U, below. (Used to begin subscripts and to end superscripts.) + F Re-FILL the entire present paragraph; pointer must be in the interior of the paragraph. + I INCLUDE a file into the current buffer. + R INCLUDE the file STANDARD.RNO. Used when editing a RUNOFF file in order to easily set the defaults. + U Inserts the character string "__;" which has the effect of a reverse half linefeed (moves the print UP half a line) when printing on the NEC Spinwriter. See + D, above. (Begin superscripts and end subscripts.) + V for overstrikes, inserts the character = CTLR/H; the two characters on either side of the CTRL/H will be printed on top of each other when you get hardcopy. In RUNOFF, use the _% character after once giving the command ".flags overstrike". + Swap characters on either side of pointer, correcting a common sort of typographical error. ^&Editing Conveniences\& + A Sets current buffer to insert mode for text entry. This is the default. .page + CTRL/A Sets current buffer to overstrike mode for text entry. Be sure that you are in ^&insert\& mode before performing any of the following commands: cut, paste, undelete character, undelete word, or undelete line. + H Obtain brief description of customized key actions. + K Begin LEARN mode: all keystrokes following will be remembered, if terminated with + CTRL/K End LEARN mode: you will now be prompted for the key to be used for later "replays" of the learned sequence. + Q QUIT, no SAVE of journal file. + W DCL Window: give a DCL command while in the editor; the output will be displayed in the second window, and can be CUT and PASTED into another buffer. + CTRL/Z EXIT, no SAVE of journal file; protects you against disk quota and other errors. ^&Programmers' Delights\& + C Find a line by number. + CTRL/D Swaps delimiters between WP and Programming, i.e., changes the definition of a "WORD" for keypad commands. Activates autoindent. + P Write out the current buffer and compile it. Edit TPUINI.TPU to change from PASCAL to another language, or use GET to obtain TPUINI.PAS and TPUINI.FOR. ^&Multi-Buffer Operations\& (Note, you will be requested to name the buffer.) + B Edit a buffer. + M Return to editing the MAIN buffer. .page + O Write a buffer to a file, defaults to current buffer and same filename it would have at exit, if any. + S Show buffer information. + Erase a buffer. + CTRL/W Permits single- or dual-window editing. Toggle between windows during dual-window editing. ^&Customizing the Editor\& You may find it convenient to maintain several specific initialization files for the editor: perhaps one for editing PASCAL programs, another for term papers, etc.. If you want to do that, we suggest that you keep one of them named TPUINI.TPU, probably the paper-writing one. Your LOGIN.COM file would then be edited to include, for example, lines such as the following: $! $ ES :== EDIT/TPU/COMMAND=SYS$LOGIN:TPUINI.SIP $! $ EP :== EDIT/TPU/COMMAND=SYS$LOGIN:TPUINI.PAS (SYS$LOGIN is a synonym for your default directory at login time). These would define the new commands ES for editing your SIP and EP for editing PASCAL programs. Some alternate command files are available with GET. See the comments in the standard TPUINI files for guidance in modifying them. If you want to make more extensive customizations, please come in and talk to us, so that we can keep track of what is going on. ^&References\& ^&VAXTPU EDT Keypad Emulator Quick Reference Guide\&. DIGITAL. ^&VAX Text Processing Utility Reference Manual\&. DIGITAL. .no headers .page Educational Computing Kalamazoo College .c;^&Key Definitions Cheat Sheet\& You can use the LEARN command ( + K) to define keys. The keys that are already defined by the operating system or EDT are shown in the table below, including definitions from Kalamazoo customizations. Before re-defining any of them, find out what they do, to see if the function is one you can do without, or if some other sequence has the same effect. ^& Action CTRL/key + key + CTRL/key key\& A Adj. Tabs Insert mode Overstrike mode B Back 1 Sent. Edit a buffer Back 1 Sent. C ABORT COMMAND Find line by number ABORT COMMAND D Decrement Tabs NEC Subscripts Swap WORD delim. E Extend Tabs Extend Tabs F Exit TPU HELP Fill Paragraph Advance 1 Sent. G Advance 1 Sent. H Terse HELP Swap characters I Include file Jump 8 characters J K Define key Begin LEARN End LEARN L M Edit MAIN buffer N Back 1 Paragr. O DISCARD OUTPUT Output to file DISCARD OUTPUT P Advance 1 Para. Write and Compile Find Page bottom Q STOP OUTPUT QUIT STOP OUTPUT R Restore Position Copy STANDARD.RNO S START OUTPUT Show Buffer Info. START OUTPUT T Indent Section Indent Section U Del. left line NEC Superscripts V Mark position Insert W Repaint screen DCL Command Window Multi-window X Abort error msg. Y ABORT ABORT Z EDT Line mode Normal EXIT Erase a buffer The other definable keys are followed by any printing puctuation. There is no CTRL/ possible with those keys, nor therefore any + CTRL/. Richard D. Piccard Rev. 3/21/86