1 WPE ! V5.210 WPE V5.2 WPE is an interactive text editor built using the VAX Text Processing Utility and the EVE interface. WPE emulates the WPE-PLUS editor with extended functions for text file editing. WPE commands are normally entered using the keypad on the terminal (and the function keys on VT2xx/VT3xx terminals). See the WPE users guide for more information. +----------------------------------------------------------------+ | o For a list of WPE commands, type ? or LIST. | | o To see what's new in V5.2 of WPE, type NEW FEATURES. | | o For information on differences between this version of WPE | | and previous versions, type DIFFERENCES. | | o To get to help on EVE, type EVE. | | o To get to help on VAXTPU, type TPU. | +----------------------------------------------------------------+ 1 COMMANDS List of Topics For help on WPE topics, type the name of a topic and press RETURN. ~I~ o To exit from help and resume editing, press RETURN. TEXT-EDITING COMMANDS Delete Line Delete To EOL Escape Signature Return Gold Return Quote CURSOR MOVEMENT AND SCROLLING Find Matching Token Shift Right Shift Left Mark Go To (Mark) Paragraph FILE, BUFFER, AND WINDOW COMMANDS Get File Include File One Window Two Windows Other Window Buffer Select Buffer Change Width View Display Char Write File Shift Right Shift Left TEXT-FORMATTING COMMANDS Paginate New Page Page Marker CTlength Set Page Length NoTabs KEY-DEFINITION COMMANDS Application Numeric Set Keypad WPE Set Keypad WPS Set Keypad EDT Set Keypad EDW Set Key NoWPS Set Key NoEDT Set Key NoEDW Set Keypad Num Set Key NoNum Set Keypad App CUSTOMIZING AND ADVANCED FEATURES Fix Print UnTrans Print Trans Return to Edit EtoA AtoE EVE TPU INFORMATIONAL TOPICS New Features Differences (WPE V2.4 to V5.0/5.2) WPS Differences Keypad (diagram) Keys (list) List of Topics Ctrl Commands Special Comds Gold Keys VT100 Commands Function Keys EDT Keypad Mail Editing 1 APPLICATION Application Cancels the NUMERIC keypad, restoring the keypad to the WPE state or the EDW state Effectively, this is the same as SET KEYPAD WPE or SET KEYPAD EDW. o For a list of defined keys, see help on KEYS or press GOLD/HELP (on the mini keypad). o For a keypad diagram, see help on KEYPAD or press HELP. Related topics: SET KEYPAD WPE SET KEYPAD EDW 1 ATOE AtoE Translate the entire buffer, or a selected part of the buffer, from the ASCII character set to the EBCDIC character set. The translation table used is similar to the translation for the 2780/3780 Protocol Emulator. Except for a few special characters, the translation is reversable by using the ETOA command. 1 BUFFER Buffer ( F19) Puts a buffer into the current window -- for example, to edit another file, view the messages you have received, or create a temporary storage area or "scratchpad." Example: F19 Buffer: jabber.txt Puts a buffer called JABBER.TXT in the main (or current) window. o If the buffer already exists, the cursor returns to your last position in that buffer. The settings of that buffer apply to your edits (direction, margins, mode, tab stops, and wrap). o If you are creating a buffer, the cursor moves to the top of the new buffer. The new buffer has the same settings as the $DEFAULTS$ buffer. See help on DEFAULTS. o You can abbreviate the buffer name. If more than one name matches your request, WPE shows a list of the matching names and recalls the BUFFER command so you can choose the one you want. Typically, a buffer has the same name as the file it contains. To check buffer names, use SHOW BUFFERS or SHOW SYSTEM BUFFERS. You can also use the up_arrow at the "Buffer:" prompt to select from a list of your current buffers o You can also use the BUFFER command to view a system buffer, such as the messages buffer, help buffer, or DCL buffer. See help on MESSAGE BUFFER. o Sometimes, bottom-line messages are displayed too rapidly to read. You can use the BUFFER command to see these messages by typing: F19 Buffer: messages 1 CHANGE_WIDTH Change Width ( E) Changes the display (screen) width for all buffers. If the current width is 80 columns, the display is changed to 132 columns. If the current width is 132, it is changed to 80. Pressing E invokes this command. 1 CTLENGTH Current Text Length The Current Text Length (CT) governs the length of the page that is used by the PAGINATE function ( PF2). The default value for CT is 60 lines per page. To change it, press the DO key. Enter Command: CT and the new value you wish to use. 1 CTRL_COMMANDS WPE Ctrl Commands. Press Ctrl simultaneously with another key (upper and lower case are equivalent): Ctrl_B - Recall last Command: Ctrl_F - Return to editing buffer (from Show, etc.) Ctrl_K - Learn Ctrl_L - Learn Ctrl_R - Remember (after Command: Learn) Ctrl_V - Quote (Press the key to be added:) Ctrl_W - Refresh (repaint) the screen. Ctrl_Z - Exit. Seldom used: Ctrl_H - Move to start of current line. Ctrl_U - Erase to start of current line. 1 DELETE_LINE Delete Line (F6) Deletes the line the cursor is on. The F6 (Del Line) key invokes this function. The last-deleted line is kept in the internal Line Buffer, and may be restored by pressing F6. 1 DELETE_TO_EOL Delete To End Of Line (F20) Deletes from the current cursor position to the end of the current line, but does not append the next line to the current line. The F20 key invokes this function The last-deleted line segment is kept in the internal Word Buffer, and may be restored by pressing Del Word ( PF3). 1 DIFFERENCES Differences between WPE Version 2.5 and Version 5.0/5.2 If you have previously used WPE version 2.5, you will be interested in knowing what has changed in WPE. Version 2.5 of WPE was the last version usable on VMS Version 4.x. WPE was completely rewritten for VMS Version 5.0, and that version of WPE was also numbered 5.0. The current version of WPE is 5.2 (corresponding to VMS Version 5.2) (There were no WPE Versions 3.x or 4.x). This article is in 3 sections, describing the CHANGES and then the NEW FEATURES of WPE Version 5.0 and WPE Version 5.2 ======================================== ---- CHANGES FROM WPE VERSION 2.5 ---- ======================================== The 8-character "hot zone" at the right margin (for wrapping) has been eliminated in WPE Version 5. You are no longer asked about tailoring for .HLP files - WPE now automatically tailors the editing environment (right margin 66). WPE automatically tailors itself for .COM, .TPU, and .FOR files. You are not specifically told that it has done so. Files are not checked for "long lines", and you are no longer asked if you want to go to 132-column mode. The structure and organization of Help has been changed. Forward and Backward scrolling now terminates if you press any key (Ctrl/C not recommended). Scrolling is chosen by Advance and BackUp. Up-Arrow and Down-Arrow, which were previously scrolling, now are Top-of-File and Bottom-of-File. KP3 is now mapped to UpperCase/LowerCase, instead of Exit. The behavior of Paginate has changed slightly. It now inserts FF-NL (a new type of page marker), and automatically re-paginates these markers when used again. ================================================= ---- NEW FEATURES ADDED IN WPE VERSION 5.0 ---- ================================================= When you exit WPE, and then edit the same file again by just entering the WPE command (no filename), you are returned to the place in the file where you were last editing. DECspell (if installed on your system) is integrated into WPE for spell-checking. number or numbers may be used instead of the command REPEAT nn. An optional EDT keypad has been provided. A visual representation of Tab settings (a "ruler") is provided, rather than a message. The method of changing these settings has changed. Command Recall has been made much more versatile. More than 2 screen windows are now supported. The "2 windows" function splits the current window into two, providing up to 8 windows. Capability to print from within WPE, without translating control characters, has been added to the previous print-translated capability. The NoTab mode now uses current Tab settings, rather than setting tabs to "every 8". Capability to toggle between 80-column and 132-column mode ( E) has been added. Wildcard Find capability has been added, and assigned to Find. There are now 2 types of page markers. N inserts a "hard" page marker (FF), while P inserts a "soft" page marker (FF-NL). Buffer recall now allows you to delete a buffer, in addition to changing buffers. Placing the cursor at the end of a line (possibly by using Rignt-Arrow) and then pressing Right-Arrow will now do SHIFT RIGHT 8. Similarly, placing the cursor at the start of a line and pressing Left-Arrow will do SHIFT LEFT 8. Mail editing has been significantly improved, and may now be accessed via callable TPU, rather than in a subprocess. MORE now activates TPU only once, regardless of the number or type of file selections made. WPE can now be installed to use a DCL command, rather than using a .COM file. ================================================= ---- NEW FEATURES ADDED IN WPE VERSION 5.2 ---- ================================================= New commands ETOA and ATOE have been added. These commands translate the current buffer (or a selected region) from EBCDIC to ASCII (etoa), or from ASCII to EBCDIC (atoe). The Paragraph function (KP5 key) will now find: o the next procedure if you are editing a .TPU file o the next help topic if you are editing a .HLP file The Print command will now spawn a subprocess if the printer command begins with the characters DM$ - this allows usage of special procedures such as DM$ATP.COM, which prints to an attached printer. The F18 and G functions will access a file using a filename that you have SELected, if a file with that name exists. If there is only one window on the screen, the F19 key now toggles among your active buffers (previously, you got an error message unless there were two or more windows). +-------------------------------------------------+ | Features available only with EVE T2.2 and above | +-------------------------------------------------+ EVE Version T2.2 was shipped with VMS V5.1. If WPE was built using EVE T2.2 (or above), some additional features are available. You can determine the build-version of EVE by pressing Z (outside of the help screens). The build information is shown at the bottom of the screen. If you enter an ambiguous command, the F19 key will now move between the command line and the CHOICES buffer. Selecting a choice may be done by pressing the SELect key. Pressing the DO key will then execute the command. See the VMS documentation for other features added to EVE. 1 DISPLAY_CHAR Display Current Character ( ?) Displays information about the character at the cursor location. The information includes the character or its mnemonic, and the character value in decimal, octal, and hexidecimal. The control key for the character is also displayed, where appropriate. For example: ( form feed ) Current character is Decimal = 12, Octal = 014, Hex = 0C ^L Press ? to invoke the DISPLAY CHARACTER function. 1 EDT_KEYPAD EDT Keypad WPE now provides an optional EDT keypad, instead of the WPS keypad. The system manager can assist you if you wish to have this as your "default" (startup) mode for WPE. The EDT-default editor is called EDW. The EDT keypad is an addition to WPE. Therefore, all non-EDT additions of WPE ( keys, extended commands, etc.) are still present. Consult EDT documentation for EDT keypad functions. When you are in the editor, you can change the keypad to EDT mode by using either of the Commands: SET KEYPAD EDW SET KEYPAD EDT To restore the keypad to WPS mode, you may use any of the Commands: SET KEYPAD WPE SET KEYPAD WPS SET KEYPAD NOEDW SET KEYPAD NOEDT 1 ESCAPE Escape ( F7) Inserts an Escape character (ascii 27) in your text at the current location. This function is useful for constructing terminal control sequences, which often start with "Escape [". The Escape character will be displayed on your screen as a backwards question mark. Press F7 to insert an Escape character. VT100: CTRL/V Press the key to be added: CTRL/[ 1 ETOA EtoA Translate the entire buffer, or a selected part of the buffer, from the EBCDIC character set to the ASCII character set. The translation table used is similar to the translation for the 2780/3780 Protocol Emulator. Except for a few special characters, the translation is reversable by using the ATOE command. 1 FIND_MATCHING Find Matching ')' ( X) Position the cursor to a left parenthesis ( and press X. WPE will search for the matching right parenthesis ), even if you have a complex nested structure. The pair of parentheses will be highlighted in reverse video, and the line containing the matching item will be displayed at the bottom of the screen. You then have a choice of erasing the highlighting, moving to the matched right parenthesis, or returning to editing. You may later erase the highlighted markers by positioning to something other than a '(' and pressing X. While the highlighting remains, do not confuse the position of the markers with the matched items. If you add or delete text, the markers will remain but they may be wrong (markers are tied to positions in the buffer, not to characters). X invokes the 'Find Matching )' function. 1 FIX Fix Removes CR and LF characters from the current buffer. This command is most frequently used to "clean up" .MEM files and other files with explicit formatting. 1 FUNCTION_KEYS Function Keys Function Keys F6 thru F14 for VT-2xx/3xx terminals. (To see F15 thru F20, type KEYPAD or press the HELP Key) F6 F7 F8 F9 F10 F11 F12 F13 F14 +---------------------------------------+ +-------------------------------+ |DELETE | QUOTE | CAP | | | |FORWARD| MOVE | ERASE |INSERT | | LINE | | WORD | | EXIT | |REVERSE| BY | WORD |OVERSTR| |-------|-------|-------| | | |TOGGLE | LINE |-------|TOGGLE | |UNDELLN|ESCAPE |UPPERWD| | | | | |RUBSENT| | +---------------------------------------+ +-------------------------------+ 1 GET_FILE Get File ( F18) Opens a file you specify, putting it into the current EVE window. This lets you edit or create another file in the same session. (Same as the OPEN command.) You specify a file by typing it's name at the 'File to get:' prompt, after you press F18. You may also specify a file by SELECTing text with the filename in any of your buffers. One way to use this feature is to: o Use the I command to put a directory listing in the DCL buffer. For the current directory, the command DIRECTORY is sufficient. For other directories, use the command DIRECTORY/NOHEADER so that the complete file specification is shown in the DCL buffer. o Move the cursor to the DCL buffer, and position to the start of the filename you wish. Press a SELect key, and then press the 'Word' key (KP4). o Press F18 Example: (prompted method) The following command opens a file called MEMO.TXT in your current (default) directory: ( F18) File to get: memo.txt o Opening a file for the first time creates a buffer named after that file. If there is already a buffer by that name, EVE asks for a different name to use. The new buffer has same settings as the $DEFAULTS$ buffer. (See help on Defaults.) o If you specify a file you have already opened in the editing session, EVE returns to your last location in the buffer for that file, if the buffer still exists. o You can use logical names and wildcards in the file specification. If more than one file matches your request, EVE shows a list of matching files to choose from. (See help on Choices Buffer.) You can open several files in an editing session, but only one per command. o If you make a mistake in specifying the file, use the DELETE BUFFER command to discard the buffer. Related topics: DELETE BUFFER OPEN SELECTED SAVE FILE SAVE FILE AS 1 GO_TO Go To ( KP9) Moves the cursor to the previously marked text. (See MARK.) For example, KP9 Go to: glossary moves the cursor to the position that was named "glossary" by an earlier mark command. Mark names may be abbreviated. If the new position is not in the current buffer, the cursor still moves to the new position. A new buffer is mapped to the current window if necessary. The SHOW ( Z) command displays the names of all the marks in each buffer. Mark names are case-insensitive. The KP9 key is labeled "Under Line" on WPS+ keyboards. 1 GOLD_KEYS Press GOLD (PF1) and then another key... GOLD B - Bottom of file GOLD [ - DO Command GOLD C - Center text GOLD < - Prev Screen GOLD E - Toggle screen width GOLD > - Next Screen GOLD F - File (Exit) GOLD , - Search GOLD G - Get file (Include) GOLD . - Cont Srch GOLD H - Help GOLD / - Cont Srch Sel GOLD I - 1 DCL Command GOLD ? - Display Char GOLD K - Quit. GOLD ; - Global Replc GOLD N - NewPage mark GOLD ' - Replc GOLD P - Page mark GOLD \ - Insert Date GOLD R - Show tab settings GOLD | - Show line GOLD T - Top of file GOLD @ - Signature GOLD V - View tabs GOLD $ - Spawn GOLD W - Write file GOLD [ (DO) Command: 1 GOLD_RETURN Return If the file type is .COM, .TPU, .HLP, or .FOR, inserts a comment line before the current cursor position, moving the cursor to the start of the new line. The comment line begins with "$ ! ", "! " or "C", as appropriate. For other file types, a message indicates that "Para Marker is not implemented in WPE." Note: In these special files, the space bar will also automatically insert another comment line if you type too far. Therefore, you may usually just keep typing until you are finished with your comment. The RETURN key invokes this command. 1 HELP Help VT100: H Provides help on keypad commands. After pressing HELP, press the key that you want HELP on. Press RETURN to leave help. To get help on more advanced commands, use the HELP command. Press the DO key, type help, and press RETURN. The HELP command will then provide you with a list of all the EVE commands. Type the name of the command that you want help on, or type ? to see the list of commands again. At that point, you may also type WPE for help on the WPE extensions to EVE, or type TPU for help on the TPU editor. Press RETURN without typing anything in order to leave the HELP command. You can ask for help on a particular command in one step. For example, help wpe will provide help on the WPE editing environment. VT100: [ Command: help wpe 1 INCLUDE_FILE Include File ( G ) Includes a file into the current buffer, inserting it before the start of the current line. This is useful to combine files. You specify a file by typing it's name at the 'File to include:' prompt, after you press G. You may also specify a file by SELECTing text with the filename in any of your buffers. One way to use this feature is to: o Use the I command to put a directory listing in the DCL buffer. For the current directory, the command DIRECTORY is sufficient. For other directories, use the command DIRECTORY/NOHEADER so that the complete file specification is shown in the DCL buffer. o Move the cursor to the DCL buffer, and position to the start of the filename you wish. Press a SELect key, and then press the 'Word' key (KP4). o Move the cursor to the buffer and place where you want to include all of the text from the selected file. o Press G Example: (prompting method) The following command includes a file called MEMO.TXT from your current (default) directory: INCLUDE FILE memo.txt o You can use logical names and wildcards in the file specification. If more than one file matches your request, EVE shows a list of matching files for you to choose from. (See help on Choices Buffer.) You can include several files in a buffer, but only one per command. o Including a file does not change the buffer name, the output file specification associated with the buffer (if any), or any buffer settings, such as margins and tabs. o The cursor remains on the current character. The text of the included file is inserted whether the mode of the buffer is insert or overstrike. Key: The WPS keypad defines GOLD-G as INCLUDE FILE. Related topics: GET FILE OPEN OPEN SELECTED 1 MARK Mark (KP9) Adds bookmarks to your current editing session. MARK adds a bookmark at the current cursor position. The mark is a character or word which names the position. You can come back to a marked position by using the GO TO command. This command is useful if you are editing a large file and want to go back to a particular section; it avoids searching throughout the file. For example, KP9 Mark name: glossary adds a mark called "glossary" at the current cursor position. You can return to this position later by using "go to glossary" () KP9). 1 MAIL_EDITING Using WPE as your VMS Mail editor It is possible to use WPE as the editor for messages you send using VMS Mail (VAXMail). The system manager may have already provided this capability - and you will see the wpe or edw when you send mail. If not, first enter the following command at the DCL ($) prompt: $ SHOW SYMBOL MAIL See if MAIL is defined as "MAIL/EDIT" (there may be other qualifiers, also). If this is not the case, edit your LOGIN.COM file to include the line: $ MAI*L :== MAIL/EDIT=(SEND,REPLY=EXTRACT) Now enter the mail system. At the MAIL> prompt, type: MAIL> SHOW EDITOR See if it says "Your editor is TPU". If not, type: MAIL> SET EDITOR TPU Now, logout and back in. Try the mail system to see if your editor is set correctly. If this doesn't work, see the system manager for assistance. With the WPE interface, when you reply to mail, the memo you are answering appears in a small window at the top of the screen. You create you answer in the bottom window. 1 NEW_FEATURES This article is in two parts: New features added in WPE Version 5.0, and 5.2 +---------------------------------------+ | New Features added in WPE Version 5.0 | +---------------------------------------+ When you exit WPE, and then edit the same file again by just entering the WPE command (no filename), you are returned to the place in the file where you were last editing. DECspell (if installed on your system) is integrated into WPE for spell-checking. number or numbers may be used instead of the command REPEAT nn. An optional EDT keypad has been provided. A visual representation of Tab settings (a "ruler") is provided, rather than a message. The method of changing these settings has changed. Command Recall has been made much more versatile. More than 2 screen windows are now supported. The "2 windows" function splits the current window into two, providing up to 8 windows. Capability to print from within WPE, without translating control characters, has been added to the previous print-translated capability. The NoTab mode now uses current Tab settings, rather than setting tabs to "every 8". Capability to toggle between 80-column and 132-column mode ( E) has been added. Wildcard Find capability has been added, and assigned to Find. There are now 2 types of page markers. N inserts a "hard" page marker (FF), while P inserts a "soft" page marker (FF-NL). Buffer recall now allows you to delete a buffer, in addition to changing buffers. Capability has been added to shift the screen left and right. Mail editing has been significantly improved, and may now be accessed via callable TPU, rather than in a subprocess. MORE now activates TPU only once, regardless of the number or type of file selections made. WPE can now be installed to use a DCL command, rather than using a .COM file. +---------------------------------------+ | New features added in WPE Version 5.2 | +---------------------------------------+ New commands ETOA and ATOE have been added. These commands translate the current buffer (or a selected region) from EBCDIC to ASCII (etoa), or from ASCII to EBCDIC (atoe). The Paragraph function (KP5 key) will now find: o the next procedure if you are editing a .TPU file o the next help topic if you are editing a .HLP file The Print command will now spawn a subprocess if the printer command begins with the characters DM$ - this allows usage of special procedures such as DM$ATP.COM, which prints to an attached printer. The F18 and G functions will access a file using a filename that you have SELected, if a file with that name exists. If there is only one window on the screen, the F19 key now toggles among your active buffers (previously, you got an error message unless there were two or more windows). +-------------------------------------------------+ | Features available only with EVE T2.2 and above | +-------------------------------------------------+ EVE Version T2.2 was shipped with VMS V5.1. If WPE was built using EVE T2.2 (or above), some additional features are available. You can determine the build-version of EVE by pressing Z (outside of the help screens). The build information is shown at the bottom of the screen. If you enter an ambiguous command, the F19 key will now move between the command line and the CHOICES buffer. Selecting a choice may be done by pressing the SELect key. Pressing the DO key will then execute the command. See the VMS documentation for other features added to EVE. 1 NEW_PAGE New Page ( N) Inserts a "hard" page break -- a form feed (appearing as a small FF) on a line by itself. o If you are NOT at the start of a line, WPE first does a RETURN, then inserts a form feed, and puts the cursor after the form feed. o At the start of a line of text, WPE inserts a form feed puts the cursor after the form feed. o At the start of a blank line, WPE inserts the form feed and puts the cursor at start of the next line -- without doing a RETURN. To erase a page break use MOVE BY PAGE to put the cursor on a form feed; then use ERASE LINE or a similar EDT or WPS keypad function. Keys: WPE defines CTRL/L as INSERT PAGE BREAK. The WPS keypad defines GOLD/N. (See help on WPS DIFFERENCES.) Note that "New Page" and "Page Marker" are different in WPE. 1 NOTABS NoTabs Replaces all tab characters in the current buffer with an appropriate number of spaces, and redefines the TAB key to insert spaces. 1 NOT_IMPLEMENTED WPS+ FEATURE WHICH IS NOT IMPLEMENTED IN WPE The key that you pressed has a defined meaning in WPS+. However, that feature has not been implemented in WPE. This might be because the feature did not seem to be reasonable for an ASCII text editor, or because a full implementation would have been extremely difficult (we chickened out). You may use the DEFINE KEY command or the LEARN and REMEMBER commands to assign a command to this key. 1 NUMERIC Numeric Sets the default, numeric keypad, retaining previous definitions of other keys, such as EDT or WPS, except for the numeric. For example: o The GOLD key may still be set. o The four PF keys may still be defined. o Pressing KP8 is the same as typing the number 8, pressing COMMA (on the keypad) is the same as typing a comma, and so on. For a keypad diagram, see help on KEYPAD or press HELP. For a list of defined keys, see help on KEYS. 1 ONE_WINDOW One Window (F17) Restores a single, large window when the EVE main window is split into two or more windows. Steps: 1. Put the cursor anywhere in the window you want to keep. (See help on the F19 key or the NEXT WINDOW or PREVIOUS WINDOW commands.) 2. Press the F17 key. o WPE then deletes all the windows except the one you are currently using. The buffers associated with those windows are not deleted. o You can also use F17 after using the DCL command, which uses a second window to show the DCL output. See help on DCL. o For more information about using multiple windows, see help on Windows. Related topics: Help on keys F18, F19 DELETE WINDOW SHRINK WINDOW SPLIT WINDOW TWO WINDOWS 1 OTHER_WINDOW Other Window (F19) This command moves the cursor to another editing buffer or window. The effect of the command depends on whether you currently have ONE window, or MORE THAN ONE windows. IF YOU CURRENTLY HAVE ONE WINDOW: ================================ Puts your next buffer into the current EVE window, returning to your last position in that buffer. This lets you toggle between different buffers or cycle through several buffers without having to type their names. Steps: 1. Use the F19 key. 2. Repeat step 1 to continue cycling through your buffers. If you have only two buffers, repeating F19 toggles between them. If you have more than two buffers, the next buffer is determined by the order in which you created the buffers. For a list of your buffers, use the SHOW BUFFERS command. IF YOU CURRENTLY HAVE MORE THAN ONE WINDOW: ========================================== Puts the cursor at your last position in the next window, if you are using two or more windows in EVE. (Same as NEXT WINDOW). o For example, if you are using three windows like this: +-----------------+ From the top window, the cursor returns to | [] cursor | your last position in the middle window. |_________________| | [] | From the middle window, the cursor returns to |_________________| your last position in the the bottom window. |[] | | | From the bottom window, the cursor returns to +-----------------+ your last position in the top window. o For more information about using multiple windows, see help on Windows. o If the Choices buffer is displayed, you can press the F19 key to move between the Choices buffer and the command line. See help on Choices Buffer. Related topics: help on keys F17, F18 NEXT WINDOW PREVIOUS WINDOW SPLIT WINDOW TWO WINDOWS BUFFER DELETE BUFFER SHOW BUFFERS STATUS LINE 1 PAGE_MARKER WPS Page Marker Inserts a page marker or "soft" page break at the start of a line and positions the cursor after the marker. o A soft page break is a form feed followed by the null character (appearing as a small FF and a small NL). o By contrast, a "hard" page break (inserted with CTRL/L) is a form feed only (small FF). Keys: The WPS keypad defines these keys for pagination: GOLD/P ..... WPS Page Marker (soft page break) GOLD/PF2 ... WPS Paginate (soft break for 54-line pages) GOLD/N ..... INSERT PAGE BREAK (hard page break; same as CTRL/L) PF2 ........ MOVE BY PAGE (puts the cursor on a page break) 1 PAGINATE WPS Paginate ( PF2) Paginates using "soft" breaks (page markers). A soft page break is a form feed followed by the null character (appearing as a small FF and a small NL). Steps: 1. Press the WPS Paginate key (GOLD/PF2). WPE then moves back to the previous page break (if any) and checks ahead for page breaks within the next 'CT' lines. (CT defaults to 60) 2. If soft breaks are found within the 'CT' lines, WPE removes them, then moves down 'CT' lines, inserts a soft break (if necessary), and puts the cursor on the next line. You can repeat the operation to paginate further. If a hard page break is found (form feed only), WPE stops at that page break so you can remove it (using ERASE LINE) and then insert a soft break by pressing the WPS Page Marker key (GOLD/P). You may change 'CT' by pressing DO and then typing: Command: CT nn where nn is your desired value for 'CT'. Related topics: CTLENGTH SET PAGE LENGTH 1 PARAGRAPH WPS Paragraph (KP5) Moves the cursor to the start of the next or previous paragraph, depending on the current direction of the buffer (shown in the status line). Steps: 1. If necessary, set the direction you want to move in. (Press KP0 for WPS Advance or KP1 for WPS Backup.) 2. Press the WPS Paragraph key (KP5). o In forward direction (advance), the cursor moves to the start of the next paragraph, if there is one. In reverse direction (backup), it moves to the start of the previous paragraph, if there is one. o In EVE, "paragraphs" are bounded by any of the following: Blank lines Top or bottom of the buffer Page breaks RUNOFF commands (such as .Blank) o In WPE, if you are editing a .TPU file, a "paragraph" is a TPU procedure, regardless of blank lines or page breaks. o In WPE, if you are editing a .HLP file, the start of a "paragraph" is identified as a line which has a number in column 1. o If there are no blank lines or other paragraph boundaries in the current direction, the cursor moves to the top or bottom of the buffer. 1 PRINT_TRANS Print Translated Copies the current buffer or select range to a new buffer (named TRANSLATE). Control characters in the new buffer are then changed to a printable form (, , etc.). The buffer is then printed to the device of your choice. 1 PRINT_UNTRANS Print Untranslated The buffer or select range is printed to the device of your choice. 1 QUOTE Quote (F7) Enters a control code or other character, either in text or in a command. Steps: 1. Use QUOTE or press F7 or CTRL/V. 2. Enter the control code or character (for example, press CTRL/[ for escape or CTRL/J for line feed). o WPE enters the character according to the current mode of the buffer, as shown in the status line (insert or overstrike). Some control codes appear as a backwards question mark. o You can also use CTRL/V, or F7, in entering a string for FIND, REPLACE, or WILDCARD FIND commands. For example, if you have set tabs to spaces or movement, you can search for tab characters by doing the following: 1. Press FIND and at the prompt, 2. Press F7 3. Press TAB (or CTRL/I) for the tab character. 4. Press RETURN to complete the command. o If you used the VAXTPU built-in DEFINE_KEY to define a typing key (letter, number, or punctuation mark) or a control key, you can use QUOTE to enter the character or control code normally bound to that key. For example, if you have defined the tilde to execute a procedure, you insert a tilde by doing the following: 1. Press F7. 2. Type the tilde (~). Some characters (e.g., CTRL/S, CTRL/Q, CTRL/Y) cannot be inserted with QUOTE. For these, press DO; then - for CTRL/Y (25) - type: tpu copy_text (ascii(25)) The F7 (Quote) key invokes this command. VT100: CTRL/V Press the key to be added: 1 RETURN Return Inserts a new line before the current cursor position, moving the cursor to the start of the new line. As a convenience, if the file type is .FOR, a Tab character is inserted to start the new line. The RETURN key invokes this command. 1 RETURN_TO_EDIT Return To Editing (CTRL_F) Some TPU and WPE commands will leave you in a non-editing buffer. The most common occurance is the SHOW buffer. To return to the buffer you were editing, press Ctrl_F (press the Ctrl key simultaneously with either 'f' or 'F'). Note that some "unusual" buffers are considered to be editing buffers (For instance, the MESSAGE buffer). You can always use the Buffer command (or F19) to select another buffer. 1 SELECT_BUFFER Select or Sel a BUFFER Puts a new buffer in the current window. The cursor moves to the position it was in the last time you used this buffer. In the CHOOSE A BUFFER display: 1. Move the cursor to the buffer you want to select. (Anywhere on the line is sufficient). 2. Press the Select , Sel, or Return key. The selected buffer will now be in the current window. NOTE: The CHOOSE A BUFFER display is activated when you press F19, and then press the up_arrow, Related topics: BUFFER 1 SET_KEYPAD_APP Set Keypad Application Cancels the NUMERIC keypad, restoring the keypad to the WPE state or the EDW state Effectively, this is the same as SET KEYPAD WPE or SET KEYPAD EDW. o For a list of defined keys, see help on KEYS or press GOLD/HELP (on the mini keypad). o For a keypad diagram, see help on KEYPAD or press HELP. Related topics: SET KEYPAD WPE SET KEYPAD EDW 1 SET_KEYPAD_EDT Set Keypad EDT Sets the EDT-style keypad, defining the numeric keypad and other keys, but leaving most special WPE keys unchanged. o PF1 is GOLD. If you have already defined keys that EDT ordinarily defines, such as CTRL/U or GOLD/KP8, your definitions override the EDT definitions. o To keep the EDT keypad for future sessions, use SAVE EXTENDED EVE to create a section file or put the command in an initialization file. o For a list of defined keys, see help on KEYS or press GOLD/HELP. For a keypad diagram, see help on KEYPAD or press HELP. 1 SET_KEYPAD_EDW Set Keypad EDW Sets the EDT-style keypad, defining the numeric keypad and other keys, but leaving most special WPE keys unchanged. o PF1 is GOLD. If you have already defined keys that EDT ordinarily defines, such as CTRL/U or GOLD/KP8, your definitions override the EDT definitions. o To keep the EDT keypad for future sessions, use SAVE EXTENDED EVE to create a section file or put the command in an initialization file. o For a list of defined keys, see help on KEYS or press GOLD/HELP. For a keypad diagram, see help on KEYPAD or press HELP. 1 SET_KEY_NOEDT Set Keypad NoEDT Cancels the EDT keypad, restoring the keypad to the WPE state. Effectively, this is the same as SET KEYPAD WPS. o For a list of defined keys, see help on KEYS or press GOLD/HELP (on the mini keypad). o For a keypad diagram, see help on KEYPAD or press HELP. Related topics: SET KEYPAD EDT SET KEYPAD WPS 1 SET_KEY_NOEDW Set Keypad NoEDW Cancels the EDT keypad, restoring the keypad to the WPE state. Effectively, this is the same as SET KEYPAD WPS. o For a list of defined keys, see help on KEYS or press GOLD/HELP (on the mini keypad). o For a keypad diagram, see help on KEYPAD or press HELP. Related topics: SET KEYPAD EDT SET KEYPAD WPS 1 SET_KEY_NONUM Set Keypad NoNumeric Cancels the NUMERIC keypad, restoring the keypad to the WPE state or the EDW state Effectively, this is the same as SET KEYPAD WPE or SET KEYPAD EDW. o For a list of defined keys, see help on KEYS or press GOLD/HELP (on the mini keypad). o For a keypad diagram, see help on KEYPAD or press HELP. Related topics: SET KEYPAD WPE SET KEYPAD EDW 1 SET_KEY_NOWPS Set Keypad NoWPS This command is not allowed in the WPE editor. 1 SET_KEYPAD_NUM Set Keypad Numeric Sets the default, numeric keypad, retaining previous definitions of other keys, such as EDT or WPS, except for the numeric. For example: o The GOLD key may still be set. o The four PF keys may still be defined. o Pressing KP8 is the same as typing the number 8, pressing COMMA (on the keypad) is the same as typing a comma, and so on. For a keypad diagram, see help on KEYPAD or press HELP. For a list of defined keys, see help on KEYS. 1 SET_KEYPAD_WPE Set Keypad WPE Sets the WPS-style keypad, defining the numeric keypad and other keys, and sets the cursor to BOUND. o PF1 is GOLD. If you have already defined keys that WPS ordinarily defines, such as GOLD/R or KP0, your definitions override the WPS definitions. o To keep the WPS keypad for future sessions, use SAVE EXTENDED EVE to create a section file or put the command in an initialization file. o For a list of defined keys, see help on KEYS or press GOLD/HELP. For a keypad diagram, see help on KEYPAD or press HELP. Related topics: WPS DIFFERENCES SET CURSOR BOUND SET KEYPAD NOWPS 1 SET_KEYPAD_WPS Set Keypad WPS Sets the WPS-style keypad, defining the numeric keypad and other keys, and sets the cursor to BOUND. o PF1 is GOLD. If you have already defined keys that WPS ordinarily defines, such as GOLD/R or KP0, your definitions override the WPS definitions. o To keep the WPS keypad for future sessions, use SAVE EXTENDED EVE to create a section file or put the command in an initialization file. o For a list of defined keys, see help on KEYS or press GOLD/HELP. For a keypad diagram, see help on KEYPAD or press HELP. Related topics: WPS DIFFERENCES SET CURSOR BOUND SET KEYPAD NOWPS 1 SET_PAGE_LENGTH Set Page Length The Current Text Length (CT) governs the length of the page that is used by the PAGINATE function ( PF2). The default value for CT is 60 lines per page. To change it, press the DO key. Enter Command: SET PAGE LENGTH and the new value you wish to use. 1 SHIFT_LEFT Start Of Line / Shift Left Moves the cursor to the start of the current line, unless you are already there. If you are already at the start of a line, your viewpoint may be moved to the left. When you type or recall a command, pressing GOLD/LEFT arrow moves the cursor to the start of the command line. If your viewpoint is shifted to the right, placing the cursor at the start of a line and then pressing GOLD/LEFT arrow will allow you to view text farther to the left. The text actually moves to the right by 8 columns. Repeating the command moves your viewpoint 8 more columns to the left each time, until your viewpoint is no longer shifted. Keys: WPE defines CTRL/H and GOLD/LEFT arrow as START OF LINE. 1 SHIFT_RIGHT End Of Line / Shift Right Moves the cursor to the end of the current line, unless you are already there. If you are already at the end of a line, shifts your viewpoint to the right by 8 columns. When you type or recall a command, pressing GOLD/RIGHT arrow moves the cursor to the end of the command line. If your text is too long to fit on a single screen, placing the cursor at the end of a line and then pressing GOLD/RIGHT arrow will allow you to view text farther to the right. The text actually moves to the left by 8 columns. Repeating the command moves your viewpoint 8 more columns to the right each time. Keys: WPE defines GOLD/RIGHT arrow as END OF LINE / SHIFT RIGHT. 1 SIGNATURE Signature ( @) Copies a file (SYS$LOGIN:SIGNATURE.WPE) from your login (root) directory into the buffer you are currently editing. The file can be anything you wish. This is called the Signature function because it is often used to put a standard signature block (plain or fancy) in a memo or document. Press @ to insert the standard file. 1 SPECIAL_COMDS WPE Commands which are not available as single keys: Press Do and enter the Command: Command: CT nn - To change the Current Text length. (Set Page Length) Command: Print - To print a copy of the current buffer or select range, with or without control characters translated to printable form. (Formatted or Unformatted) Command: Fix - To create a copy of the current buffer with CR and LF characters properly removed. This command is often used to convert .MEM files to a more reasonable format. Command: Numeric - To change to Numeric Keypad. Command: Application - To change to Application Keypad. Command: Notab - To replace all tabs with spaces, and redefine the TAB key to insert spaces. Command: EtoA - To translate the entire buffer, or a selected part, from EBCDIC to ASCII Command: AtoE - To translate the entire buffer, or a selected part, from ASCII to EBCDIC 1 TOKEN Paired Token Places a pair of items in your text, and positions the cursor so that you can easily enter text between the items. This function is only useful if you are in Insert mode. Press To get: ( or ) () { or } [] " "" 1 TWO_WINDOWS Two Windows (F18) Splits the current window into two windows. This lets you view different buffers at the same time or different parts of the same buffer. o The cursor appears in the new, lower window. Each window has its own status line and displays the buffer you are currently editing. o To put a different file in the new window, use the F18, or G command. See help on these keys. o To form three or more windows, use F18 repetitively. The maximum number of windows in EVE depends on the size and type of terminal you are using. Related topics: help on keys F17, F19 DELETE WINDOW ENLARGE WINDOW NEXT WINDOW ONE WINDOW OTHER WINDOW PREVIOUS WINDOW SHRINK WINDOW SPLIT WINDOW 1 VT100_COMMANDS Since VT100 terminals don't have a DO key, you must press [ before entering special (WPE or EVE) commands. [ (DO) Command: Command: buffer test.txt - Change to buffer with this name. Command: get file test.txt - New file & new buffer. Command: one window - One window editing (from 2). Command: two windows - Two window editing (from 1). Command: other - Move cursor to other window. Command: forward - Change direction to Forward. Command: reverse - Change direction to Reverse. Command: insert mode - Change to Insert mode. Command: overstrike - Change to Overstrike mode. Command: CT nn - To change the Current Text length. Command: fix - Removes CR and LF from the buffer. Command: print - Prints buffer/range (can translate controls). Command: numeric - To change to Numeric Keypad. Command: application - To change to Application Keypad. Command: help - For HELP on these and other WPE commands. Command: EtoA - Translate EBCDIC to ASCII Command: AtoE - Translate ASCII to EBCDIC Press CTRL/V to invoke the QUOTE function. 1 VIEW View ( V) Makes Tab characters visible on the screen, to facilitate editing in some situations. Press V to invoke this function. Press V again to turn off viewing of Tabs. NOTE: For text with graphics controls (line drawings, etc.), you may occasionally need to set the display to display the actual appearance, rather than the controls. For this, press DO; then type: tpu set (text, current_window, no_translate) Pressing V turns off no_translate mode. 1 WPS_DIFFERENCES WPS Differences SET KEYPAD WPS provides most keypad functions of WPS-8, WPS-PLUS/VMS, and DPE. It does NOT fully implement or emulate WPS. Here is a list of differences between the WPS keypad in WPE and real WPS: Keys: o The WPS keypad defines GOLD/[ as DO for typing WPE commands. CTRL/K and CTRL/L are defined as LEARN. To end a learn sequence, press REMEMBER (CTRL/R key) or the WPS Halt key (GOLD/`). Rulers: When you use a WPS ruler (GOLD/R key), only one ruler is active at a time. Rulers cannot be embedded in a document. Setting margins does NOT automatically rewrap or reformat text. To reformat text with new margins, use FILL commands. For more information, see help on RULER KEYS. Scrolling: Scrolling (with WPS keypad functions) is halted when you press any key -- not just the WPS Halt key (GOLD/`). Pressing that key executes whatever function is assigned to it. Free/Bound cursor: Setting the WPS keypad automatically sets the cursor to BOUND, which follows the shape of your text. To enable a free cursor, use SET CURSOR FREE, which is otherwise the EVE default setting. Page Breaks and Pagination: o A "hard" page break is a form feed (appearing as a small FF on a line by itself). A "soft" page break is a form feed followed by the null character (a small NL). o The WPS keypad defines the following keys for pagination functions: GOLD/P ..... WPS Page Marker (soft page break) GOLD/PF2 ... WPS Paginate (soft break for 54-line pages) GOLD/N ..... INSERT PAGE BREAK (hard page break; same as CTRL/L) PF2 ........ MOVE BY PAGE (puts the cursor on a page break) For more information, see help on the relevant keypad functions. Searches: Searches follow the EVE rules for case sensitivity and direction. For more information, see help on FIND. Paragraph Boundaries: Paragraphs are bounded by blank lines, the top or bottom of the buffer, page breaks, or RUNOFF commands (such as .B). Centering a Line: The WPS keypad defines GOLD/C as CENTER LINE, which uses spaces to center the line and does NOT leave a centering mark. Exiting: The WPS keypad defines GOLD/F as EXIT. Exiting does NOT delete the old version of the input file. SELECT With the WPS keypad, SELECT sets the direction to FORWARD. HELP: For a keypad diagram, press HELP (or Gold H). For a list of all key definitions, press GOLD/HELP. Features NOT Implemented: o Abbreviation or library documents o Bold-, reverse-, or underline-highlighting o Control commands for printing o Cut and paste between separate editing sessions o Editor math o Footnotes, paragraph numbering, and table of contents o Hyphenation and non-breaking spaces o Output files other than ASCII o Superscripts, subscripts, or composite characters o TDE (two-dimension editor) o UDP (user-defined WPS procedures) o Word-wrap returns (In WPE, all lines end in a "hard" return.) 1 WRITE_FILE Write File ( W) The WRITE FILE command places the some or all of the contents of the current buffer in the file you specify. When you press W, you will be prompted for a File to write to: If you have established a Select Region, the contents of the region will be written to the file you specify. If you do not have a Select Region, the entire buffer will be written. If you specify the same file name as the current buffer, a new version of the file you are editing will be written. Of course, you may also write the file with a different name. WRITE FILE is often used to save parts of a file under different names. It will also allow you to save the results of "editing" a file when you are using the MORE utility. The W key invokes the WRITE FILE function.