 +++    Welcome to KED version 3.2    8 KED is a Kept EDitor.  It is started by typing KED/LOGIN  : You can then edit any files with KED  <filenmaes> - or see( the help file for other ways of calling.  4 When finished you can shut it down with KED/SHUTDOWN    C Included are all the additional enhancements I have written in TPU. C Most of them work ok without being in a kept editor, so if you wish D you can pull out the good bits you like, and leave the rest unused. B Alternatively, KED will run in non-kept mode, by using the command EDIT /SECTION=KED_TPU_SECTION.    ; Below are the instructions for building and installing KED.     B For those of you who are familiar with TPU, and want to do lots ofA clever things with this, I have a file called TECHNICAL_INFO.TXT, . which you are welcome to peruse at your peril.   +++     D To create KED, you need to unzip the contents of the zipfile into anC installation directory (in fact, you have probably already done so, C since you are reading this file). Then customise the files you need  as follows:     @ Building KED is a 4 stage procedure.  (Steps 1, 2, and 3 are allA optional if you are content to use exactly the same functionality D level, defaults and configuration that I use - but are worth reading3 through anyway, to help gain familiarity with KED.)       " Stage 1.   Prepare KED_MASTER.FILE" ----------------------------------    C The file that controls which features are to be included in the TPU B section, is called KED_MASTER.FILE. I have set up a typical masterA file, which includes all the bits that seem useful to me. You can  change this as you like.     EDIT KED_MASTER.FILE  H Edit this file, if you wish, in order to include any additional modules,G or to remove any of the entries already present, that you regard as too 5 gross or abstruse.  The ones included by default are:    Firstly the 2 mandatory ones:   >   KED_BUILD_OPTIONS.TPU  - this must be there for KED to work.>   KED_CORE.TPU           - the core of KED, must also be there  E All the rest are optional. There is an explanation at the top of each H file, so you can decide if you want to include them. Have a read of each7 file in turn, so you can include exactly what you want:   E   BED.TPU                - The procedures for using KED in batch mode L   KED_SUNDRIES.TPU       - Various sundry items that don't fit anywhere elseK   KED_MOVEMENT.TPU       - Some enhancements to controlling the movement of 7                            the cursor around the screen ;   KED_BOX_COMMANDS.TPU   - Additional box handling commands B   KED_BRACKETS.TPU       - Commands to find matching bracket pairsH   KED_AMBIG_CMD.TPU      - An enhancement to the way that EVE deals with-                            ambiguous commands I   KED_DIFFERENCE.TPU     - Some commands to check the differences between $                            two files  F There are some other TPU files included in the package, which are not H added by default into the master file, as they include the more obscure,= baroque commands that most people do not want to bother with:   H   KED_DEBUG              - If you plan to make changes, or add your own J                            stuff to ked, these procedures may prove usefulF   KED_TYPING_CHECK       - A way of re-typing a file, to check for any                             typosH   KED_COLOURS            - A way of colouring C-programs, to try to makeJ                            them easier to follow (only works if you have aG                            terminal emulator that translates attributes (                            into colours)  H Add these if you want them.  Note that I have not (yet) written any helpE for these 3 last optional ones, so you will have to excavate your way . through the code, to find out how to use them.    I You can also add any other TPU procedures that other people have written, K if you hunt around the web for them. (I do not re-distribute anybody else's B copyrighted stuff, as I have never asked for permission to do so).  K e.g. If you can find them, things I find useful, and have put in mine, are:   C   KHF$COLUMN.TPU          - Ken Faifield's sundry wonderful goodies    KHF$RULER.TPU           -  "   KHF$FIND_ALL.TPU        -  "   KHF$INDENT.TPU          -  "F   JUSTIFY.TPU             - Hunter Goatley's text justifying procedureJ   SHOW_CONTROL.TPU        - Ed James' technique to show control characters7   SORT.TPU                - Dave Pampreen's sort module   .      or anything else you find hanging around.    G Once you have decided what you want to keep in KED_MASTER.FILE, ensure  E that all the files mentioned in it are in the installation directory.   K If you have any help about anything you are including, you can put the help J file in the installation directory under the name <xxxx>.HLP, where <xxxx>H matches the module name <xxxx>.TPU.  The build procedure, MAKE_KED, will then automatically pick it up.        ( Stage 2.   Prepare KED_BUILD_OPTIONS.TPU( ----------------------------------------    I This file contains all the customizable parameters that KED needs, so you  can run it in the way you like.      EDIT KED_BUILD_OPTIONS.TPU  H This TPU procedure contains lots of comments explaining what each of theI parameters does, so it should be straightforward. If any of it is unclear 7 let me know, and I will re-write it to be even simpler.         1 Stage 3.   Customise the defaults in the CLD file 1 -------------------------------------------------     F If you wish, you can change the default values set in the CLD file, to" change them in any way you prefer.   EDIT KED_CLITABLE.CLD   F For instance, if you want WRAP to be on by default, change the line in& the LOGIN SYNTAX (line 92) that reads:     Qualifier WRAP to read    Qualifier WRAP, default   G Now, wrap will be on by default, and if you want it off, you would have  to specify:  KED /LOGIN /NOWRAP     H Or, if you want KEEP on by default, when starting and shutting, you need to change the lines:     Qualifier KEEP  E to include 'default' - in *both* the login and the shutdown syntaxes. G (lines 93 and 131).  KEEP will then be on by default, and if you do not / want it, you would then need to specify /NOKEEP     E Beware if you change any of these, to change the documentation in the % help files to match the new defaults.        Stage 4.   Build KED --------------------    D The build process creates the compiled files in a directory, with a F default name of KED_DIR.  If you have created a logical name with thisB value, it will use it, otherwise it will ask for a directory name.  3 By default, the build process uses 3 logical names:   7   KED_DIR         - The directory to hold the KED files   8   KED$HELP        - The file to contain the help for KEDE                                       (default KED_DIR:KED$HELP.HLB ) $   KED_TPU_SECTION - The section fileG                                       (default KED_DIR:KED.TPU$SECTION)     F If you use these defaults, the MAKE_KED process will put all the filesE in place. Otherwise, you will need to rename the created files to the - destination directories that you wish to use.   E You also need to decide where to put the DCL help information for the B KED command, so that users can type HELP KED at the $-prompt. The C default value is HLP$LIBRARY.  If you do not use this logical name, C then, if you have sufficient privilege, you can use the system-wide D helpfile SYS$HELP:HELPLIB.  Alternatively you can select any name of your own choosing.    F After unpacking, and optionally customising as described above, in the' installation directory, run the command      @MAKE_KED   @ This will lead you through the build process.  It runs the link,A the section build, and the help build processes, and puts the DCL % help entry into the required library.   F The installation package is supplied with object files for each of theD architectures that VMS runs on, named KED.OBJ_VAX, KED.OBJ_ALPHA andD KED.OBJ_IA64, so you can install this even without a c-compiler.  IfC you prefer, and have a compiler, you can include the compile in the  make process by entering:      @MAKE_KED ALL   . This will additionally compile the KED.C file.  E (If you are using the GNU C compiler, which requires an options file, C and the syntax to compile is different, you can manually compile it D yourself by whatever means that compiler requires, then run MAKE_KED without the ALL specifier).      --  I Once installed, you can enter into your LOGIN.COM file a line of the form H $ KED :== $KED_DIR:KED  (or ensure that KED_DIR is in the path DCL$PATH,@                         so this will be picked up automatically)   and you are ready to use KED.        Running KED  -----------   H If you use KED regularly, you can also add a KED/LOGIN command into your LOGIN.COM file  G When you have finished using KED, you can enter KED /SHUTDOWN.  If you  E just log out without running KED/SHUTDOWN, the KED subprocess will be G terminated.  However, this will leave TPU journal files hanging around. # It is tidier to shutdown KED first.   G One useful technique you can do is to subvert the LOGOUT command with a  line in the LOGIN.COM such as:  7 $ LO*GOUT == "PIPE KED /SHUTDOWN /NOWARNING && LOGOUTX    D This will ensure that logout shuts down the KED subprocess, and onlyE logs out if this was successful.  It also affords you the opportunity E to save any half-completed buffers you were editing, if you decide to < log out and forget you were half way through an edit in KED.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            