       INSTALLATION INSTRUCTIONS      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.  F These installation instructions are intended for the system manager.  ( Separate user documentation is provided.    & Contents of the Distribution Directory  ; WPE.TPU			       The source file of .TPU code for building  #                                WPE.   : WPE.TPU$SECTION		       The compiled section file for WPE.  , WPE.HLP			       Help module to be added to =                                SYS$COMMON:[SYSHLP]TPUHELP.HLB   4 WPE.COM	                       Command file for WPE.  ' MORE.COM		       Command file for MORE.   3 BUILD_WPE.COM		       Command file for re-building  ;                                WPE.TPU$SECTION from WPE.TPU   I INSTALL_FRAGMENT.COM           How to install WPE.TPU$SECTION global, if  '                                desired.   G INSTALL_WPE_ON_CLUSTER.COM     Automatic installation across a cluster.   . INSTALL_WPETPU		       Companion to the above.  > SYSDEFS_FRAGMENT.COM	       Definitions to execute at SYLOGIN.  C LOGIN_FRAGMENT.COM	       Addition to LOGIN.COM for users who wish  C                                to use WPE as their VMS Mail editor.   4 MAILEDIT.COM		       Companion to LOGIN_FRAGMENT.COM  < SPECIAL.CHARS		       Test file (includes characters 0-255).  / PARENTHESES.TST		       Test file for <Gold> X.   - VARIOUS DOCUMENTATION	       Described below.   G As might be expected, all of the .COM files contain a LOCAL definition   for the location of WPE.     Trying WPE without installation   E The following command will test-drive WPE without installing it, but  G without the checks and features provided by WPE.COM.  Note that a full  G disk-and-directory path is required for the TPU$SECTION (TPU otherwise  H assumes a location).  Note also that on-line Help will not be available.  C      edit/tpu/section=disk:[directory]wpe.tpu$section test.filename      Installing WPE and MORE   ( These instructions are valid for VMS 4.5  H 1.  Place all of these files in a directory of your choice.  It will be @ assumed that you place a copy of WPE.HLP in SYS$COMMON:[SYSHLP].  G 2.  Use your previously-favorite editor to edit WPE.COM and MORE.COM.   ; In both files, bracketed by LOCAL/END LOCAL, you will find:     A $ ! LOCAL - LOCAL - LOCAL - LOCAL - LOCAL - LOCAL - LOCAL - LOCAL  $ ! * $        define wpe_dir lanl$utility:[wpe] $ ! = $ ! END LOCAL - END LOCAL - END LOCAL - END LOCAL - END LOCAL   @ Change this line in both files to point to your chosen location.  A 3.  Set your default to SYS$COMMON:[SYSHLP] and do the following:    Lib/Replace TPUHELP.HLB WPE.HLP   H The first time you do this, a new module (WPE.HLP) will be added to the  help library for TPU.   G 4.  In your SYLOGIN.COM sequence, add the following lines (modified to   point to your chosen location):d  " $ MORE :== @LANL$UTILITY:[WPE]MORE$ $ WPE*DIT :== @LANL$UTILITY:[WPE]WPE $ WPE_LASTFILE :== ""n  C 5.  Optionally, for efficiency, you may install the global section aD associated with WPE and MORE.  Modify the following to point to the  appropriate location.a  3 LANL$UTILITY:[WPE]WPE.TPU$SECTION/OPEN/SHARE/HEADERa  E The command may be issued to INSTALL, and should also be put in your o SYSTARTUP.COM sequence.   = 6.  Test the installation by typing WPE filename and/or MORE e filename(s).    # Previous and future versions of VMS   H The WPE.TPU$SECTION supplied will work on VMS versions 4.4 and 4.5, and G possibly future versions.  When Digital decides to change TPU (again),  & it may be necessary to re-compile WPE.  G If you are still using VMS version 4.3 or 4.2, you will certainly need 	H to re-compile (and may want to change the name to WPE.GBL to conform to  earlier Digital convention).  H Of course, when you want to make modifications to WPE, you will need to  re-compile.t  I The procedure BUILD_WPE.COM is provided to do this.  It assumes that you  C want the saved section file to be placed in your current directory.r     Options in the WPE sourcem  H There are at least 3 WPE "behaviors" which you might choose to change.  G All of these are documented in the WPE.TPU source, and can be found by h- searching for the word LOCAL (in upper case):   I 1.  The KP3 key is defined as "Exit" for compatibility with DM (which is GH also on this distribution).  You may wish to define KP3 as "Upper Case" G (which is now available as KP6).  In addition, PF3 ("Delete Word") has OC some special characteristics - you may prefer the standard meaning.i  I 2.  Scrolling is defined so that the cursor stays near the middle of the tG screen, and the screen scrolls only every few lines.  If you prefer to nE have the screen scroll a line at a time, this feature may be removed..  H 3.  The cursor now remains within the confines of existing lines.  This I causes the cursor to sometimes jump around when you move up or down in a n1 file.  An option is provided for a "free" cursor.e    
 Documentationo  A Both a users' guide and an installer's guide are available.  The a< documentation in this directory is available in three forms:  3      .TXT files should be printable on any printer.a3      .WPL files can be imported into WPS-PLUS (TM).s/      .LN03 files print nicely on LN03 printers.      Using WPE as a VMS Mail editor  I For users wishing to use WPE as their VMS Mail (VAXMail) editor, you can O provide the following:   Add to user's LOGIN.COM:      $ Mail := mail/edit4      $ define mail$edit disk:[directory]mailedit.com9      $ define tpusecini lanl$utility:[wpe]wpe.tpu$sectiont  ? MAILEDIT.COM could be in the user's SYS$LOGIN, or provided for MD system-wide use.  A prototype is provided in this distribution.  It > contains the usual line which must be changed for your system.  G Defining tpusecini sets the user's default editor to WPE.  If the user dG types edit/tpu, the WPE editor will be invoked.  Of course, change the   directory path as appropriate.     Coming Attractions  D We plan to add a calculator function (<Gold> #) to WPE for the next 7 release.  Other functions may be added by user request.      Comments, Bugs, Suggestions:         Dale E. Coy or Karl Nielsen! 	  Los Alamos National Laboratory$ 	  Group MEE-8, MS/J957a 	  PO Box 1663 	  Los Alamos, NM 87545    	  (505) 667-3270 or 667-7159  	  FTS 843-3270 or 843-7159.