INSTALLATION INSTRUCTIONS WPE Editor Version 2.4 (WPS+ for ASCII files) Includes the MORE utility November, 1987 The WPE editor is similar to WPS-PLUS(TM), but is intended for general use in editing ASCII files (e.g., LOGIN.COM, documentation, etc.). It matches WPS-PLUS(TM) where practical, and provides several extended capabilities including two-window editing. 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 WPE.COM Command file for WPE. MORE.COM Command file for MORE. BUILD_WPE.COM Command file for re-building WPE.TPU$SECTION from WPE.TPU INSTALL_FRAGMENT.COM How to install WPE.TPU$SECTION global, if desired. INSTALL_WPE_ON_CLUSTER.COM Automatic installation across a cluster. INSTALL_WPETPU Companion to the above. SYSDEFS_FRAGMENT.COM Definitions to execute at SYLOGIN. LOGIN_FRAGMENT.COM Addition to LOGIN.COM for users who wish to use WPE as their VMS Mail editor. MAILEDIT.COM Companion to LOGIN_FRAGMENT.COM SPECIAL.CHARS Test file (includes characters 0-255). PARENTHESES.TST Test file for X. VARIOUS DOCUMENTATION Described below. As might be expected, all of the .COM files contain a LOCAL definition for the location of WPE. Trying WPE without installation The following command will test-drive WPE without installing it, but without the checks and features provided by WPE.COM. Note that a full disk-and-directory path is required for the TPU$SECTION (TPU otherwise assumes a location). Note also that on-line Help will not be available. edit/tpu/section=disk:[directory]wpe.tpu$section test.filename Installing WPE and MORE These instructions are valid for VMS 4.5 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]. 2. Use your previously-favorite editor to edit WPE.COM and MORE.COM. In both files, bracketed by LOCAL/END LOCAL, you will find: $ ! 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. 3. Set your default to SYS$COMMON:[SYSHLP] and do the following: Lib/Replace TPUHELP.HLB WPE.HLP The first time you do this, a new module (WPE.HLP) will be added to the help library for TPU. 4. In your SYLOGIN.COM sequence, add the following lines (modified to point to your chosen location): $ MORE :== @LANL$UTILITY:[WPE]MORE $ WPE*DIT :== @LANL$UTILITY:[WPE]WPE $ WPE_LASTFILE :== "" 5. Optionally, for efficiency, you may install the global section associated with WPE and MORE. Modify the following to point to the appropriate location. LANL$UTILITY:[WPE]WPE.TPU$SECTION/OPEN/SHARE/HEADER The command may be issued to INSTALL, and should also be put in your SYSTARTUP.COM sequence. 6. Test the installation by typing WPE filename and/or MORE filename(s). Previous and future versions of VMS The WPE.TPU$SECTION supplied will work on VMS versions 4.4, 4.5, and 4.6, and possibly future versions. When Digital decides to change TPU (again), it may be necessary to re-compile WPE. If you are still using VMS version 4.3 or 4.2, you will certainly need to re-compile (and may want to change the name to WPE.GBL to conform to earlier Digital convention). Of course, when you want to make modifications to WPE, you will need to re-compile. The procedure BUILD_WPE.COM is provided to do this. It assumes that you want the saved section file to be placed in your current directory. Options in the WPE source There are at least 3 WPE "behaviors" which you might choose to change. All of these are documented in the WPE.TPU source, and can be found by searching for the word LOCAL (in upper case): 1. The KP3 key is defined as "Exit" for compatibility with DM (which is also on this distribution). You may wish to define KP3 as "Upper Case" (which is now available as KP6). In addition, PF3 ("Delete Word") has some special characteristics - you may prefer the standard meaning. 2. Scrolling is defined so that the cursor stays near the middle of the screen, and the screen scrolls only every few lines. If you prefer to have the screen scroll a line at a time, this feature may be removed. 3. The cursor now remains within the confines of existing lines. This causes the cursor to sometimes jump around when you move up or down in a file. An option is provided for a "free" cursor. Documentation Both a users' guide and an installer's guide are available. The documentation in this directory is available in three forms: .TXT files should be printable on any printer. .WPL files can be imported into WPS-PLUS (TM). .LN03 files print nicely on LN03 printers. Using WPE as a VMS Mail editor For users wishing to use WPE as their VMS Mail (VAXMail) editor, you can provide the following: Add to user's LOGIN.COM: $ Mail := mail/edit $ define mail$edit disk:[directory]mailedit.com $ define tpusecini lanl$utility:[wpe]wpe.tpu$section MAILEDIT.COM could be in the user's SYS$LOGIN, or provided for system-wide use. A prototype is provided in this distribution. It contains the usual line which must be changed for your system. Defining tpusecini sets the user's default editor to WPE. If the user types edit/tpu, the WPE editor will be invoked. Of course, change the directory path as appropriate. Emulating WPE as a VAX NOTES editor: The file NOTES$COMMAND.TPU is provided to add many functions of WPE to the WPS editor interface of VAX NOTES. Refer to the NOTES documentation. Comments, Bugs, Suggestions: Dale E. Coy or Karl Nielsen Los Alamos National Laboratory Group MEE-5, MS/J572 PO Box 1663 Los Alamos, NM 87545 (505) 667-3270 or 667-4277 FTS 843-3270 or 843-4277