       WPE Editor Version 2.3     (WPS+ for ASCII files)     Includes the MORE utility      April, 1987         J The WPE editor is similar to WPS-PLUSTM, but is intended for general use C in editing ASCII files (e.g., LOGIN.COM, documentation, etc.).  It  C matches WPS-PLUSTM where practical, and provides several extended  * capabilities including two-window editing.      % Accessing WPE:  from the VMS prompt--         $ WPE filename   G (After you have done WPE once with a filename, it will "remember" your  4 last edited filename - so you only have to type WPE)       Exiting WPE:  7      Press <Gold> F or key F10 to "file" your document.       H WPE works with VT2xx series terminals.  Your VT2xx setup should be some C variant of VT2xx (NOT VT100 ID).  WPE also works with VT100s, with  I slightly reduced capability (no function keys).  With terminal emulators   on PCs, you're on your own.     < MORE is a "read-only" version of WPE -- see the description.        F WPE was originally produced (using saved keystrokes) by Dale E. Coy.  G The current version, using TPU source, was produced by Dale E. Coy and  < Karl Nielsen.  Both are with Los Alamos National Laboratory.  ) WPS-PLUSTM Digital Equipment Corporation          WPE Mini-Tutorial   A This tutorial will assume that you are a DP professional, or are  H familiar with the WPS-PLUSTM document editor.  WPE is useful in either E case: it provides enhancements to the EVE editor (and is much better  H than EDT), and gives a uniform keyboard "feel" when editing ASCII files  (if you also use WPS-PLUSTM).  G WPE uses the "Gold Key" standards, which means that to use many of the  E editing functions you need to press the Gold key (the PF1 key on the  G keypad) first, and then another key.  In this document, we usually use  I the convention <Gold>.  For instance, <Gold> T means to press the <Gold>  H key and then press T to go to the top of the file you are editing.  You F may use either upper or lower case: <Gold> T and <Gold> t do the same  thing.  < We will also use the terms "file", "document", and "buffer" E interchangeably, except where we need to be specific.  Each of these  5 terms refers to the text you are editing at the time.   C There are often several ways to do the same thing in WPE.  We will  H describe the most convenient way, and sometimes list alternatives.  The D descriptions assume you have a VT-2xx terminal.  If you are using a ? VT-1xx, there is a list of alternatives later in this document.      WPE and MORE  E WPE is used to create and edit ASCII text files.  It is particularly  F tuned to editing .COM files, and is also excellent for regular text.  I MORE is used when you only want to look at a file (but want to make sure  ; you don't change it).  You can't edit a new file with MORE.   % Accessing WPE:  from the VMS prompt--         $ WPE filename    Exiting WPE:  D      Press <Gold> F or F10 to "file" your document (exit).  You can G      press <Gold> K if you want to quit without saving any changes you  C      have made in your editing session.  (Note: the '3' key on the  7      keypad, labeled Upper Case, is also a "file" key).1  F After you have done WPE once with a filename, it will "remember" your I last edited filename - so you may omit the filename.  You then only have .E to type WPE to edit the same file again.  Note: this "memory" is not e retained when you LOgout.i  & Accessing MORE:  from the VMS prompt--        $ MORE filename(s)   G When using MORE, you may use VMS wildcards, as well as lists of files,  G in the filename, and MORE will present the files in sequence (only the PI latest version of each file is used unless you specify x.y;*).  Switches u6 may also be used (anything legal for the DIR command).  F To exit MORE, use any of the methods listed for exiting WPE: they are  all equivalent to "quit".   F MORE is essentially identical to WPE.  We will first concentrate on a I description of WPE.  A separate section is provided near the end of this  6 document which summarizes the few differences in MORE.     Help  I Press the Help key (or <Gold> H ) to obtain help on the WPE keys.  There sF are several screens which provide diagrams of the keys.  You may also : press any key, and receive a description of its functions.  G For advanced functions, you may access the help for the underlying EVE aD and TPU editors.  Press the Do key (or <Gold> [ ).  At the Command:  prompt, type help or help tpu.     Editingp  G WPE works on ASCII text files (including programs, .COM files, etc.).  dI It is capable of working on other types of files, with some restrictions e0 on file organization (see the VAXTPU reference).  E The functions implemented on the main keyboard are a subset of those rK included in the WPS-PLUSTM editor, as well as several useful extensions.   J A list of the few WPS-PLUSTM features not implemented in WPE is provided  later in this document.   G Special functions are called "Gold" functions - to use them, you press .I the <Gold> key (the PF1 key on the keypad), and then press another key.  mG The other key may be either upper or lower case (<Gold> T and <Gold> t   both do the same thing).    
 Entering Text   E WPE is similar to most word-processing editors, in that you will not hF have to press Return if you are editing normal text.  The editor will E automatically "wrap" your text to the next line for you.  Your right iH margin is normally set at column 79.  WPE works with an eight-character G "hot zone"; new words will not begin past column 71.  However, you may  I construct lines longer than this default by inserting text in the middle  C of an existing line (this pushes the end of the line to the right).r  J Of course, you will press Return to leave space between your paragraphs.  I You may use the Tab key to move over to another column.  WPE has default  D tab settings every 8 spaces, and this setting may be changed if you  wish.   G You may move the cursor throughout your file by using the arrow keys.   A Several other methods for moving the cursor are given in a later s section.  H When you enter WPE, you are in "insert" mode.  This means that any text H you type is placed at the cursor location, and any text to the right is I pushed over to make room.  If you wish, you may use "overstrike" mode by  I pressing F11.  Your current mode is shown on a status line at the bottom aB of the screen.  (You may toggle back to "insert" by pressing F11).     Erasing Text  < There are several methods for deleting portions of the text:H      oo	 Delete words or characters by pressing Del Word or Del Char.  3         The text is erased forward from the cursor.nF      oo	 Press DEL ( <x| ) to delete the character before the cursor.?      oo	 Press F13 to delete the entire word the cursor is on.cE      oo	 Press F20 to Delete to End of Line (right from the cursor).:0      oo	 Delete the entire line by pressing F6.$      oo	 For large amounts of text:@ 	   oo  Move the cursor to the start of the text to be deleted. 	   oo  Press Sel or Select.sD 	   oo  Move the cursor to the end of the text to be deleted.  You C               will notice that the region will be shown in reverse T               video.@ 	   oo  Press Cut or Remove.  All of the selected text will be                deleted.  A The DEL ( <x| ) key deletes the character preceding the cursor.  tI However, if that character is a Tab, an appropriate number of spaces are oI inserted.  (If you really want to delete the Tab, position the cursor to   it and use Del Char).   B Del Word deletes from the current cursor position to the end of a E "word", but does not automatically delete the Return at the end of a a? line.  Also, for convenience, the delete stops when any of the t  characters )]}_ are encountered.  G The WPS-PLUSTM functions Rub Line (delete from cursor to beginning of sI line - <Gold> DEL) and Rub Sentence (<Gold> F13) are also implemented in p WPE.     Oops  G WPE maintains four separate internal buffers for the last text removed e@ by these functions.  If you make an error, you can restore text ! accidentally deleted by pressing:t  ;      oo	 <Gold> PF4 to restore the last Character deleted.tJ      oo	 <Gold> PF3 to restore the last "word" deleted (by Del Word, Rub 6         Line, Delete to End of Line, or Rub Sentence).D      oo	 <Gold> F6 to restore the last Line deleted by Delete Line.;      oo	 Paste to restore text deleted with Cut or Remove.t  J The contents of these buffers is not destroyed by the restore operation.  G Therefore, you may use these operations repetitively to place the same  $ text at many places in you document.     Correcting Texti  ) To interchange two transposed characters:h1      oo	 Move the cursor to the first character.,$      oo	 Press <Gold> Enter (Swap).   To change characters or words:=      oo	 Move the cursor to the start of the incorrect text.uF      oo	 Delete words or characters by pressing Del Word or Del Char.       oo	 Type the correct text.   Or:oK      oo	 Move the cursor to somewhere in the word, and press F13 to ERASE g
         WORD.        oo	 Type the correct text.   Or, for large amounts of text:A      oo	 Move the cursor to the start of the text to be deleted.s      oo	 Press Sel or Select.J      oo	 Move the cursor to the end of the text to be deleted.  You will >         notice that the region will be shown in reverse video.I      oo	 Press Cut or Remove.  All of the selected text will be deleted.      Selecting Regions of Textt  G You will frequently need to designate an area of text for use by a WPE  5 operation (such as Cut).  To select a region of text:C  B      oo	 Move the cursor to the start of the text to be selected.      oo	 Press Sel or Select.J      oo	 Move the cursor to the end of the text to be deleted.  You will D         notice that the region will be shown in reverse video.  The 7         region in reverse video is the "select region".b  G The select region may be constructed in either direction; that is, you sA may move either forward or backward from the place you press Sel.e  E To cancel a select region, if you decide not to use it, press Sel or o> Select again.  The reverse video highlighting will be removed.     Moving the Cursor   E You will be moving the cursor around a lot, and just using the arrow  G keys would take a long time.  WPE provides many other ways to move the d cursor.u  G Several of these methods travel in small steps, moving in the "current cG direction".  This is either Forward or Reverse.  The current direction cH is shown in the status line at the bottom of the screen.  To change it, B press F11 (which toggles the direction).  You may also change the 8 current direction by using the Advance and Back Up keys.     Short-Range Movementse  4      Word	  Moves one word in the current direction.  C      Line	  Moves one line in the current direction.  (The F12 key i8                   - Move by Line - has the same effect).  8      Sent	  Moves one sentence in the current direction.  9      Para	  Moves one paragraph in the current direction.t  9      Page	  Moves one page in the current direction (see l2                   discussion of page marks below).  D      Tab Pos	  Moves to the next Tab Position, if one exists on the B                   current line; otherwise, moves to the next line.  E      Gold <= 	  (Arrow key) Moves the cursor to the beginning of the e                   line.   D      Gold => 	  (Arrow key) Moves the cursor to the end of the line.  C      Next Screen  Moves down in the file by one "screen" (about 21 r                   lines).e  7      Prev Screen  Moves up in the file by one "screen".e     Long-Range Movements  J The Ends of the File:  To go to the top of the document, press <Gold> T.  C To go to the bottom, press <Gold> B.  (<Gold> Prev Screen and Next p  Screen have the same functions).  F Scrolling:  To continuously scroll through the document, press <Gold> F UpArrow or <Gold> DownArrow.  (<Gold> Back Up and <Gold> Advance have H the same functions).  To stop the scrolling at any point, press Ctrl/C  0 (the Ctrl key and the 'C' key at the same time).     The Paste Buffer  D The Paste buffer can contain large amounts of text, and is used for I several purposes.  One of the uses is to move large amounts of text from cC one place in the file to another place.  This is called a "Cut and Y Paste" operation.o  D You put text into the Paste buffer by first selecting the region of  text.  Then press:  @      Cut	  To remove (delete) the text from the file, and place H                   it in the Paste buffer.  The Remove key does the same                    thing.  A      <Gold> Cut	  To place the text in the Paste buffer, without sI                   deleting it from its current place.  This is useful if  ?                   you want to make a Copy of the text to place  @                   elsewhere.  <Gold> Remove does the same thing.  I You can then copy the contents of the Paste buffer anywhere in your file g& (one or many times) by pressing Paste.  E If you should need to clear the Paste buffer, press Sel and then Cut.u     Searching & Replacing   E WPEs searching and replacement operations are an enhanced version of   those in WPS-PLUSTM.  g     Find (Srch)o  I To search your file for a text string, press Find.  You will be prompted nF to enter the text you wish to find.  If you enter text in lower case, B WPE will consider either lower or upper case text to be a match.  I Anything you enter in upper case must be matched exactly.  For instance, oE xYz will match XYZ but not xyz.  (<Gold> Comma - labeled Srch on the  4 WPS-PLUSTM keyboard - will also do this operation).  I The find operation looks in the current direction (Forward or Reverse).   D If the string is not found in that direction, it looks in the other G direction (but asks if it should go in that direction).  If a match is  . found, WPE will position you to that location.  I Note:  If you are presently at the only matching string in the file, WPE o' will not "find" it.  This is a feature..  G After doing Find, you may wish to repeat the operation with a slightly 	I different text string.  Press Find, and then the up-arrow key, to recall iI the previous command.  You may then edit the command and press Return to i execute it.o     Find Again (Cont Srch)  D To continue to search (for the next occurrence of the same string), K press <Gold> Period - labeled Cont Srch on the WPS-PLUSTM keyboard.  (You  A may also press <Gold> Find, or press Find twice, to continue the . search).     Continue Search & Select  F The Cont Srch function can be automatically combined with a Select of H the matching text by pressing <Gold> / - labeled Cont Srch & Sel on the I WPS-PLUSTM keyboard.  After the matching text is selected, you may then  H press <Gold> ' (quote) to replace the select region with whatever is in G the Paste buffer.  (This is labeled Replc on the WPS-PLUSTM keyboard).u     Global Search and Replace   G To search for and optionally replace all matching strings in the file,  G press <Gold> ; - you will be asked for the search string, and then for e the replacement string.  t  I In WPS-PLUSTM this function is somewhat annoying: you can't see what is aD being done, and all matching strings are replaced.  In WPE, as each B match is found, you are asked whether or not to replace it.  Your G choices are yes, no, all, last, and quit.  Last means "do this one and e? then quit".  All means "do all the rest of them in the current  I direction".  You will also be asked if you wish to change directions, at l the end of the file.  G Pressing <Gold> ; followed by up-arrow will recall the previous search  < string.  You may edit this string, and repeat the operation.     Find >  B Pressing the Enter key will search for the next occurrence of the 3 character '>'.  You might use this as a "bookmark".f     Page Markers and Pagination   K There is only one type of page marker in WPE (WPS-PLUSTM has 2).  It is a oE true "form feed", and is displayed as two Fs in one column.  You can  C insert this marker in your file by pressing <Gold> N or <Gold> P.  rF Although WPE will automatically place this marker at the left margin, ' you may move it elsewhere in your file.e  G To nicely paginate your file for printing, you sometimes want to count lI the lines and put page markers at appropriate places.  Press <Gold> Page  F (PF2).  WPE will first back up to the last page marker, and will then / move forward 60 lines and insert a page marker.   H If this is not an appropriate place, you can delete the page marker and G move up to an appropriate location and insert it there.  Then continue P& on through your file with <Gold> Page.  I If WPE finds an existing page marker before it gets to 60 lines, it will eE ask you whether you want the existing marker removed.  If you answer h" "no", WPE will stop at that point.  F The number of lines in a page (60 by default) is controlled by the CT G (Current Text length) parameter.  To change this number you must use a sI WPE command.  First, press the Do key.  You will get a Command: prompt.   G Type CT, and you will be asked for the new number.  (You may also type r1 CT nn, where nn is the number of lines you want).      Carriage Returns (Return)c  G Although you can't see it, there is an implicit carriage return at the  F end of each WPE line.  It may be there because you pressed the Return 8 key, or because WPE "wrapped" your text to another line.  F It is useful to think of the Return as being located between lines of E text.  You can delete it by either: going to the end of one line and  B pressing Del Char; or going to the beginning of the next line and G pressing DEL ( <x| ).  In either case, the two lines will be made into h	 one line.h     Wrapping Paragraphs   I If you are entering normal text, you will sometimes add or delete things tH until your paragraph looks "messy" - some lines are too short, and some I are too long.  You can fix this by deleting, cutting, etc. but WPE has a lC wrap function to make life easier.  If you press <Gold> Para, your tD paragraph of text will be adjusted so that all of the lines fit the I current margin.  The cursor can be anywhere in the paragraph you want to i wrap.h  I Have several paragraphs to wrap?  You can press <Gold> Para repetitively eD to do them one after the other, or you can first establish a Select H Region so that <Gold> Para will wrap them all in one operation.  (Hint: C <Gold> T, Sel, <Gold> B, <Gold> Para will re-wrap your whole file).f    	 Bookmarksr  H It is sometimes helpful to place invisible "bookmarks" in your text, so ' that you may return to a place quickly.<  A To insert a bookmark at the current location, press KP9 (labeled g; UnderLine).  You will be asked for a name for the bookmark.i  H Return to a bookmark by pressing <Gold> KP9.  You will be asked for the E name of the mark you wish to go to.  This function even works across a) multiple windows and buffers (see below).     	 WindowingW  G Two Windows (F18) splits the screen, but (initially) displays the same wC file in both windows.  Since it's the same file, any change in one eC window affects the file and MAY be displayed in the other window.   D However, you can scroll each window independently, cut from one and  paste in the other, etc.  I Other Window (F19) puts your cursor in the other window, so you may edit e there.  G One Window (F17) expands the window your cursor is in, and "hides" the p window where your cursor isn't.l  I Get File (<Gold> F18) replaces your current buffer with a new file (with  G a new buffer name).  The old buffer is still around somewhere, and you rH may switch back to it with the BUFFER command.  GET FILE is most useful I in the two-window mode, as it lets you copy stuff from one file (window)   into another file.  D Buffer (<Gold> F19) changes the name (and contents) of your current I window.  Since you may have several buffers in WPE, your editing changes  I are not lost unless you exit without saving them.  If you are working on cA BUFFER B.TXT, you may change back to BUFFER A.TXT by issuing the D appropriate command.     Two-Window Editing  ? As an example, if you wish to copy some material from document e3 SECOND.TXT to document FIRST.TXT, do the following:   .      WPE FIRST.TXT	  - starts editing the file>      TWO WINDOWS (F18)	  - you now have two views of FIRST.TXT@      OTHER BUFFER (F19)	  - your cursor is now in the top window(      GET FILE (<Gold> F18) - SECOND.TXT 0      			  the top window now contains SECOND.TXT1      Select and cut material from the top window;uC      OTHER BUFFER (F19)	  - your cursor is now in the bottom windowg)      Paste material in the bottom window.       etc..................     Working with Multiple Fileso  F Two-Window editing provides an easy way to work with multiple files.  H You may have as many buffers as you wish, created using the Get File or G Buffer commands.  The only restriction is that each buffer must have a   unique name.  I You use Get File to create a new buffer and fill it with the contents of kH a file.  Buffer is used to switch between existing buffers (and also to  create empty buffers).  G You may be viewing a buffer full-screen, or may be viewing two buffers rI in separate half-screen windows.  You could also be looking at two parts r% of the same buffer using two windows.h  I Move your cursor between the two windows using the Other Buf (F19) key.  <H Change buffers using the Buffer (<Gold> F19) key, or by using bookmarks.  F If you want to include the contents of one file in the buffer you are F editing, use the <Gold> G command to copy the file into the buffer at  the current location.a  G Of course, you may select and cut portions of a buffer, and paste them   in a different buffer.     The Buffer Command  C The Buffer command will switch your editing context to a different .E buffer (if it exists), or will create an empty buffer if the one you   name doesn't exist.c  G If you are using a VT-2xx terminal, after pressing <Gold> F19, you may iI press the up-arrow key to see a list of your available buffers.  You may  F use the arrow keys to position to the name of a different buffer, and H press Sel, Select, or Return to change buffers.  (Note that the Message  buffer is always listed).e     Multiple Files and MOREa  I If you use MORE with a wildcard file specification (e.g. MORE *.for), it nF is possible to retain all of the files in the editor.  When you press E an Exit key, the current file will be retained if: (1) you are using  H two-window editing at the time, or (2) you are in a system buffer (such  as the Messages buffer).  I This is useful for comparing the contents of files, as well as for other t	 purposes.o    
 Tab Positions   B You may check the tab positions by pressing <Gold> R to receive a G message.  Tab positions affect only how the text is displayed, and not  H necessarily how it might look when printer, etc.  If you wish to change 8 the tab positions, press Do (or <Gold> [) and then type:        set tabs every nn		    or      set tabs at n nn nn nnR    	 Wide Text   G If there are lines longer than about 80 characters in your input file, -E you will be asked if you want to use 132-column mode.  If you answer  I yes, your terminal will be switched to wide screen (and will be returned EH to regular mode when you exit).  This automatic function is not perfect F - it counts characters only, so Tab characters are a confusion factor.  H If your file is wider than the screen, you can still edit it.  Press Do D and then type Shift Left nn or Shift Right nn until you can see the  desired part of the text.O     The Message Buffer  H If a message is sent to you by VMS, you will only see one line of it at H the bottom of the screen.  To read the entire message, press Buffer and H type Message.  This will place you in the message buffer.  When you are G finished, return to editing by using Buffer and the file name you were f editing.    
 Writing Filesc  F WPE saves the results of your editing session when you exit (and also = keeps a journal file for recovery from a "crash").  However, eG occasionally you will want to save intermediate results, or copy parts e* of a file you are editing to another file.  E Pressing <Gold> W will write the entire current buffer to a file you  I name.  If you want to recall (and use) the full name of the file you are gC editing, press up-arrow when you are prompted for the file name to O write.  H To write only a portion of the buffer, establish a Select Region before  pressing <Gold> W.     Inserting Special Characters  F If you press F7, you will be prompted to press a key to be inserted.  D This may be used to insert control and special characters into your  text.  For instance:        Pressing	     Inserts        Ctrl/G	       Bellf        Ctrl/H	       Backspace        Ctrl/J	       Line Feed        Ctrl/[	       Escapee  C Some characters cannot be inserted by this method (Ctrl/S, Ctrl/Q, eI Ctrl/Y, etc.).  For these, press Do (or <Gold> [) and then type (for the r example of Ctrl/Y):u      tpu copy_text (ascii(25))3 using the ASCII decimal equivalent of the key code.s  H The Escape character is used frequently in terminal control.  To insert   this character, press <Gold> F7.    * Functions Available Only from Command Mode  C In addition to the EVE and TPU functions, which are available from l8 command mode, the following WPE commands are available:    Press Do and enter the Command:h  G Command: CT nn	      Changes the Current Text length (for the paginate i                       command).w  C Command: Print	      Prints a copy of the current buffer or select MC                       range, with control characters translated to sG                       printable form.  This command will let you print  E                       files which have form feeds, and "unprintable" iG                       characters.  When you use this command, a buffer tH                       named "Translate" is created for further editing, "                       saving, etc.  D Command: Fix	      Creates a copy of the current buffer with CR and G                       LF characters properly removed.  This command is iA                       often used to convert .MEM files to a more  E                       reasonable format for further editing, saving, nI                       etc.  The buffer containing the fixed copy will be i?                       named either filename.LIS or filename.TXTs  E Command: Numeric      Places the keypad in Numeric mode.  The keypad nF                       keys will now enter numbers, rather than having E                       the functions shown in this document.  This is uD                       useful if you need to enter many numbers in a !                       table, etc.n  E Command: Application  Returns the keypad to Application mode (keypad l?                       keys have functions as indicated in this n                        document).     Miscellaneous Functionsn    " Capitalizing (Uppercase/Lowercase)  D The following keys are available to change the case of text in your  file:f  @      Bold	  Changes the current character to Uppercase.  May be I                   used with a Select Region to change the case of larger o"                   amounts of text.  F      <Gold> Bold  Changes the current character to Lowercase.  May be I                   used with a Select Region to change the case of larger r"                   amounts of text.  <      F8		  Cap Word - makes the first character of the word B                   Uppercase, and all other characters in the word                    Lowercase.  C      <Gold> F8	  Uppercase Word - makes all characters in the word y                   Uppercase.  B Note carefully that the '3' key on the keypad is not used for the F Uppercase function (although it may be labeled Upper Case).  Instead, C the '3' key is used for "exit", and will cause your document to be eJ filed.  This incompatibility with WPS-PLUSTM is deliberate - it enhances 5 compatibility with DM (also available through DECUS).f  H Note also that the '9' key on the keypad (Underline) is not implemented B in as underline in WPE.  It is implemented as the "Mark" function.     Paired Charactersi  F Pressing <Gold> ( inserts a pair of parentheses (), and positions the / cursor to insert text between them.  Similarly:o'      <Gold> ( or )  - Inserts paired ()i'      <Gold> { or }  - Inserts paired [] %      <Gold> "	    - Inserts paired ""o     <Gold> C  ! Centers the current line of text.a     <Gold> \  " Inserts the current date and time.     Insert/Overstrike Mode  E Change from Insert to Overstrike (strikeover) mode by pressing F14.  M4 Pressing this key again changes back to Insert mode.     <Gold> I (Interrupt)  F Prompts you for ONE DCL command.  The screen goes to two-window mode, G and the results of the DCL command appear in the second window.  Among  I other things, this lets you copy the results of a DCL command to another   file (by cut and paste).     <Gold> V (View)h  H Allows you to see Tab (HT) characters on the screen.  Pressing <Gold> V ! again returns to the normal mode.h  H If you want to see the screen appearance of line graphics, press Do and I then type tpu set (text, current_window, no_translate).  Pressing <Gold>   V returns to the normal mode.e    $ <Gold> X (Find matching parenthesis)  B Positioning the cursor to a ( and pressing <Gold> X will find and 1 highlight the matching ) in a complex expression.      <Gold> ? (What character?)  C Positioning the cursor to any character and pressing <Gold> ? will  C display the name of the character, the numerical codes in decimal,  ; octal, and hexadecimal, and (if appropriate) the Ctrl/code.      <Gold> | (What line?)l  G Pressing <Gold> | will display the current line number, and ask if you n$ want to go directly to another line.     <Gold> $  C This takes you out of WPE into VMS.  You can do any reasonable DCL dI command (including A1).  You are actually in a "spawned" sub-process, so iB YOU MUST LOGOUT ($ LO) to get back to WPE.  Your ORIGINAL editing  environment is preserved.c     <Gold> Z  ! Shows the STATUS of your buffers.      Command Recall  H Use the up-arrow to recall the previous commands after you press Do, or > the previous single command when using Find or Global Replace.  ? Press Ctrl/B to immediately recall the last Command: you typed.b     Ctrl/W  G Pressing Ctrl/W will refresh the screen, in case extraneous characters  5 have appeared due to communications line errors, etc.e     Ctrl/F  F Some EVE and TPU functions leave you in a non-editing buffer (such as C the SHOW buffer).  Pressing Ctrl/F will return to the last editing p buffer.r     Special File Types  H WPE provides special handling for some common types of files.  They are  recognized by the file "type".     .TPU  D Source files for the TPU text utility are recognized.  When editing C these files, pressing <Gold> Return will insert a TPU comment line.i     .HLP  G Help files are recognized, and you are asked if you want WPE to tailor tH for them.  If you answer Yes, the margins are set at columns 2 and 66.  C When editing these files, pressing <Gold> Return will insert a HLP  C comment line.  To add a topic line (which must begin in column 1),  D position to column 2 and use the left-arrow key to move to column 1.     .FOR  I FORTRAN files are recognized.  When editing these files, pressing Return dI will insert a line beginning with a Tab.  (To add a statement label, use  ? <Gold> left-arrow, type the label, and then press right-arrow).   : Pressing <Gold> Return will insert a FORTRAN Comment line.    
 Long Lines  H If a file has lines longer than 80 characters, you will be asked if you E want to go to 132-column mode.  When WPE changes to 132-column mode, r< there is no way to change back (except to exit an re-enter).    
 .COM Files  H WPE automatically tailors itself when the buffer contains a .COM file.  0 Several functions are different for these files:  = Del Word stops deleting when the characters )]}"'_/;:.,- are ( encountered.  I Return inserts a line beginning with $ and a Tab (and Delete will delete eC this first tab, if desired).  Continuation lines are also properly e handled.  ) <Gold> Return inserts a DCL comment line.x     /Recovery of WPE sessions)  @ WPE journals your input every few keystrokes.  Should you be so @ unfortunate as to suffer a "crash" while editing (or should you D accidentally press Ctrl/Y), there is a good chance that the editing  results are not lost.>  G When you enter WPE, a check is made for the existence of an applicable gC .TJL (journal) file.  If one exists, WPE will automatically try to dG recover the results of your interrupted edit session (probably missing oI the last few keystrokes).  You will be informed of this automatic action eG if it occurs.  The recovery applies only if you edit the same file you  ) were editing at the time of interruption.o  H If you do not want recovery to take place, delete the journal file from I your directory.  If you were editing the file TEST.TXT, the journal file t3 will be named TEST.TJL (or, infrequently, TPU.TJL).v  D Your first keystroke after a recovery will be "eaten" by WPE.  This " action appears to be a bug in TPU.  ! Recovery is not provided by MORE.D     Features Not Implemented in WPEh  K There are several WPS-PLUSTM functions which are not implemented in WPE.   I They either don't make sense for ASCII files, or they would be extremely ,& difficult to implement.  Examples are:  !      BOLD and UNDERLINE functionsr      "Strange" HYPHEN functionsE
      DEAD KEYo      SUBSCRIPT and SUPERSCRIPT      GOLD L, M, S, U, ]b      GOLD Space   H If you try to use functions which are not implemented, you will receive  an explanatory message.n  G You are welcome to define these keys in any manner you wish.  The Help yE for EVE, and the associated documentation, explain how to use Learn,  : Remember, and Define_Key to add your own functions to WPE.    ! Using WPE as your VMS Mail editore  H It is possible to use WPE as the editor for messages you send using VMS G Mail (VAXMail).  Some additions will need to be made to your LOGIN.COM n- file.  See the system manager for assistance.l    
 Extending WPEo  A WPE uses the capabilities of TPU and EVE, as supplied by Digital oF Equipment Corporation.  Ideas (and some code) were also borrowed from H the EVE_PLUS capabilities.  Of course, the basic user interface is from " the de-facto standard WPS-PLUSTM.  C If you write a TPU Command File to extend the capabilities of WPE, pE we believe that plagiarism is the sincerest form of flattery (credit l would be appreciated).  G WPE was designed to be extended.  You could either edit the source, or y
 start with9 Edit/tpu/section=wpe.tpu$section/command=your_command.tpugH WPE will issue a call to your procedure "WPE$LOCAL_INIT" during startup. e       MORE  D MORE is a read-only version of WPE.  It is designed to allow you to G "examine" files, without fear of changing something you didn't mean to   change.s  " The command is:   MORE filename(s)  E MORE has every feature of WPE, except that MORE will not write out a TH changed version of the file when you exit, and it does not remember the H last file edited.  There is one added capability: you can use MORE with 1 multiple files in a single command.  For example:a        MORE X.FOR,X.LIS,A.*,B%%.C   > You can use wild-cards (e.g., MORE *.*) and lists (e.g., MORE G x.y,a%.b,c.*) in which case, when you exit (<Gold> K or <Gold> F), you a@ will get the next file.  Only the latest version of the file is D presented, unless you use a wild-card specification for the version  (like x.x;*)  0 Switches may be used with the list of filenames:        MORE *.*/SINCE=TODAYs  F Any switches which can be used with the DIRectory command may be used H with MORE.  The switches must be applied to the end of the filename(s), F not to the MORE command.  When switches are used, the effect is as if / you had typed MORE once for each selected file.l  B Everything which can be done in WPE can be done in MORE.  This is I sometimes convenient (e.g., when a line extends beyond the right edge of  I the screen, just insert a <CR> somewhere to break it up - and then don't   save the changed file).   G However, the similarity to WPS and WPE sometimes causes us to think we pH are really editing - when we're in "read-only" mode.  Sometimes we make D a lot of changes to the buffer while in MORE, and then press EXIT.  D Although MORE will not automatically save these changes, all is not G lost.  There is a way out:  If you have made any "changes" while using  3 MORE, when you try to exit you will get a message: L  :      Changes will not be saved.  Continue quitting? (y/n).  G If you want to quit, just answer "y" -- but if you really want to save  A the changes, answer "n"; then press <Gold> W to write the buffer  F contents to a file.  You will be prompted for the name of the file to E write - you can use the same (or another) file name.  If you want to  B recall (and use) the full name of the file you are editing, press I up-arrow when you are prompted for the name of the file.  This is useful  C to prevent confusion about rooted directories, and also saves time.e  I If you use MORE with a wildcard file specification (e.g. MORE *.for), it dI is possible to retain all of the files in the editor.  When you press an eB Exit key, the current file will be retained if: (1) you are using H two-window editing at the time, or (2) you are in a system buffer (such H as the Messages buffer).  Note: This applies only to a single item in a 1 list of files, and only if switches are not used.e (       Summary of <Gold> Commands  * Press <Gold> (PF1) and then another key...        <Gold> B  - Bottom of file       <Gold> C  - Center text      <Gold> F  - File (Exit)#      <Gold> G  - Get file (Include)r      <Gold> H  - Help"*      <Gold> I  - 1 DCL Command (Interrupt)      <Gold> K  - Quit (Kill)      <Gold> N  - New Page mark      <Gold> P  - New Page mark*      <Gold> R  - Show tab settings (Ruler)      <Gold> T  - Top of file      <Gold> V  - View tabs      <Gold> W  - Write fileh+      <Gold> X  - Find the ) matching this (o      <Gold> <  - Prev Screen d      <Gold> >  - Next Screen      <Gold> ,  - Search        <Gold> .  - Continue Search'      <Gold> /  - Continue Search Selectm3      <Gold> ?  - Display facts about this character.      <Gold> ;  - Global Replace.      <Gold> '  - Replace      <Gold> \  - Insert Date h#      <Gold> |  - What line is this?l      <Gold> $  - Spawn      <Gold> [  - DO Commandt)      <Gold> <X] - Erase to Start Of Line    &      <Gold> ( or )  - Insert paired ()&      <Gold> { or }  - Insert paired []$      <Gold> "	    - Insert paired ""  ;      <Gold> Return  - (.FOR, .COM, .TPU, .HLP) Comment Linet h    e   Summary of Ctrl/ Commandsi  E Press Ctrl simultaneously with another key (upper and lower case are o equivalent):  m Ctrl/ B - Recall last Command:4 Ctrl/ F - Return to editing buffer (from Show, etc.)) Ctrl/ R - Remember (after Command: Learn)o+ Ctrl/ V - Quote (Press the key to be added)e' Ctrl/ W - Refresh (repaint) the screen.d Ctrl/ Z - Exit.t  g Seldom used:( Ctrl/ H - Move to start of current line.) Ctrl/ U - Erase to start of current line.d    % Using WPE and MORE on VT100 Terminalsa  C Since VT100 terminals don't have a DO key, you must press <Gold> [ rE before entering special (EVE) commands.  You will receive a Command: f& prompt.  Type the appropriate command:  @      Command: buffer test.txt - Change to buffer with this name.8      Command: get file test.txt - New file & new buffer.7      Command: one window - One window editing (from 2).e8      Command: two windows - Two window editing (from 1).2      Command: other - Move cursor to other window.4      Command: forward - Change direction to Forward.4      Command: reverse - Change direction to Reverse.2      Command: insert mode - Change to Insert mode.5      Command: overstrike - Change to Overstrike mode.r8      Command: CT nn - To change the Current Text length.F      Command: print - To print the file, with controls made printable.;      Command: fix - To remove CRs and LFs from a file copy.e8      Command: numeric - Sets the keypad to Numeric mode.C      Command: application - Returns the keypad to Application mode..>      Command: help - For HELP on these and other EVE commands.  WI Press CTRL/V to invoke the QUOTE function.  You will be prompted: "Press   the key to be added:"e i       KEYPAD FUNCTIONS  4 Press the "HELP" key to display the keypad diagrams.  H The inner keypad (with the arrow keys) works as it is labeled (Remove =  Cut, etc.).  Also:  ;      Gold <- moves the cursor to the beginning of the line.F5      Gold -> moves the cursor to the end of the line.f  - The main keypad works mostly like WPS-PLUSTM   G Note that some WPS-PLUSTM functions are not present, and that the KP3 lE (Upper Case) key has been re-defined to be "Exit" (for compatibility KC with DM).  Bold will Uppercase a selected range of characters, and  : <Gold> Bold will lowercase a selected range of characters.  & +--------+--------+--------+---------+& |        |  Page  |  Del   |  Del    |& |  GOLD  |        |  Word  |  Char   |& |        |Paginate|Undelete|Undel. C |J +--------+--------+--------+---------+ Cut deletes a select range (puts it? |        |  Tab   |  Mark  |   Cut   |    in the Paste buffer).lD |  Sent  |  Pos   |        |         | Gold Cut puts in Paste buffer; |        |        | Go To  |Gold Cut |    without deleting.o& +--------+--------+--------+---------+& |        |  Para  | Upper  |         |& |  Word  |        | Case   |  Paste  |I |        |  Wrap  | Lower  |         | Wrap wraps a paragraph to margins.e& +--------+--------+--------+---------+& |Back Up |        |        |  Go To  |& |        |  Line  |  Exit  |  Next   |& |  Top   |        |        |    >    |& +--------+--------+--------+         |& |     Advance     |        |         |& |                 | Select |         |K |      Bottom     |(Toggle)|Gold Swap| Gold Swap exchanges current and nexte< +-----------------+--------+---------+           characters.        D Function keys F6, F7, F8, and F10 thru F20 have useful functions as $ described in the following diagrams.  8       F6          F7          F8         F9          F10= +-----------+-----------+-----------+-----------+-----------+'O |Delete Line|   Quote   | Cap Word  |           |           | (Normal FunctionssO +-----------+-----------+-----------+           |    Exit   | -----------------CN |Undelete Ln|   Escape  |Upper Word |           |           | (Gold Functions)= +-----------+-----------+-----------+-----------+-----------+-  >      Quote     Lets you enter any "strange" key (e.g., CTRL G)7      Escape    Inserts an ESC character in the document 2      Cap Word  Capitalize WORD (first letter only)7      Upper     Uppercase WORD (does not require select)i      Exit      Just like GOLD FeP                                                                                .P                                                                                .,      F11         F12         F13         F141 +-----------+-----------+-----------+-----------+ 1 |  Forward  |   Move    |Erase Word |  Insert/  |e1 |  Reverse  |    by     +-----------+Overstrike | 1 |  Toggle   |   Line    | Rub Sent. |  Toggle   |m1 +-----------+-----------+-----------+-----------+d=                           Erase Word is not exactly like WPS+   # +-----------+---------------------+:# |           |                     |sM |   Help    |         Do          |  Do lets you directly enter EVE commands.a# |           |                     |m# +-----------+---------------------+l    ,      F17         F18         F19         F201 +-----------+-----------+-----------+-----------+ D |           | 2 Windows | Other Buf.|  Delete   | (Normal Functions)D | 1 Window  +-----------+-----------+    to     | ------------------B |           | Get File  |  Buffer   |End of Line| (Gold Functions)1 +-----------+-----------+-----------+-----------+a&       See the discussion of Windowing. a   KEY LABELS FOR VT2xx TERMINALS  $ The WPE labels are reproduced here.   ? Reduce this page to 74% to properly fit the key strip on VT2xx |
 terminals.  = +-----------+-----------+-----------+-----------+-----------+-= |Delete Line|   Quote   | Cap Word  |           |           |aH +-----------+-----------+-----------+           |    Exit   |    F6 -F10= |Undelete Ln|   Escape  |Upper Word |           |           | = +-----------+-----------+-----------+-----------+-----------+-  1 +-----------+-----------+-----------+-----------+ 1 |  Forward  |   Move    |Erase Word |  Insert/  | H |  Reverse  |    by     +-----------+Overstrike |                F11-F141 |  Toggle   |   Line    | Rub Sent. |  Toggle   | 1 +-----------+-----------+-----------+-----------+   1 +-----------+-----------+-----------+-----------+ D |           | 2 Windows | Other Buf.|  Delete   | (Normal Functions)H | 1 Window  +-----------+-----------+    to     | -------------- F17-F20B |           | Get File  |  Buffer   |End of Line| (Gold Functions)1 +-----------+-----------+-----------+-----------+   