WEVE - WONDERFUL EVE EDITOR (V00279)

                                      WEVE


                                   Disclaimer

                    This software  has  been  developed  for
                    internal  use by the Saskatchewan Cancer
                    Foundation, who assume no responsibility
                    for its use, misuse or maintenance.

                                   ----------

     WEVE (Wonderful EVE Editor) is an EVE editor interface that  has  been
     enhanced  with  several user written VAXTPU procedures.  The editor is
     VT220 and VT100 compatible.  This software is intended to give current
     EDT  users  an  interface that emulates EDT, but also incorporates the
     more powerful features of VAXTPU, such as windowing, multiple  buffers
     intimately related to specific files, spawn, and dcl command.  Several
     functions were also written to do things such as automatic  indenting,
     jump  to  previous buffer, delete buffer, clear buffer, automatic jump
     to file that cursor points to, show current line  number,  join  line,
     begin  of  line  only find, alternate cursor behavior option, show all
     buffer names, and  automatic  documentation  template  insertion.   As
     well,  several  procedures  needed  to be written to emulate different
     aspects of EDT function editing behavior.

          To install WEVE, please consult weve_install.doc.

          If your installation is not interested in altering this editor at
     all,  then  you  have  all  you need to know.  For those interested in
     altering the editor, you need to read on.

          It is simple for users to modify this  editor  to  suit  personal
     preferences.   This  may  be  done  at two levels.  Firstly the system
     manager may incorporate new features into the  system-wide  editor  to
     reflect  general  needs.  Secondly inidividual users may indulge their
     own whims as they see fit.

          In either  case  an  introduction  to  modifying  the  editor  is
     contained  in  the  help  feature (PF2 key).  Gold-KP2 will give you a
     comprehensive summary and description of all available EVE commands.

          If you write additional procedures at your site, you may want  to
     install  documentation  as  to what procedures are currently available
     that have been already written.  Tpu.exe is run  from  tpu.com,  which
     parses  rebuild_weve.tpu  in the same directory and extracts all lines
     beginning with a '!'  before  the  line  beginning  with  'procedure'.
     Thus,  those  lines  should  serve  as  an  introductory  text  to the
     procedure.     Tpu.hlp    is    produced     and     inserted     into
     sys$help:helplib.hlb.   Through  the  VMS  help  facility one can then
     access 'User_TPU' and determine exactly what procedures are  available
     and  what  they do.  Users would then be encouraged to add to the list
     of already defined procedures.  This should  be  done  by  the  system
     manager.
                                                                Page 2


          If the system-wide editor is ever changed, please note that  file
     evemodhelp.hlp  should be modified to reflect any new key definitions.
     The command '@evemodhelp' will update  the  system-wide  help  library
     sys$help:evemodhelp.hlb,  after  the changes have been made.  The help
     file (accessed from help key and KP2) contains the keypad and all  key
     definitions,  as  well  as  other  features  of EVE a user may want to
     access.

          If the individual user wishes to modify his editor, he will  need
     to create his own section file, rebuild_weve.gbl, and his own helpfile
     to reflect the changes he has made to  his  keys.   He  will  need  to
     extract  ks_evedefs  and  ks_help  out  of rebuild_weve.tpu and modify
     accordingly.  Ks_evedefs is where all new key definitons  are  defined
     and  ks_help  calls  up  the appropriate help library.  Usually a user
     with his own private version of the editor will have a local  copy  of
     rebuild_weve.tpu  and  add/change  procedures  within  as  he desires.
     However, tpu.com should only be run  on  the  global  rebuild_weve.tpu
     file,  so  only  routines that are available in the general version of
     the editor appear in the dcl help facility.   Note  that  ctrl-G  will
     create  your own section file, sys$login:myeve.gbl, which will contain
     all your current key definitions, procedures and variables.

          Rebuild_weve.gbl was named  this  way  because  when  we  had  to
     upgrade  our operating system from v4.3 to v4.4, all section files had
     to be rebuilt, so that was when we combined all  necessary  procedures
     into one large file.  It was decided to keep it in this format, as one
     could readily determine the names of the procedures  within  from  the
     help  facility.  Be forewarned that you may need to recompile the .tpu
     file to form a new .gbl section file when  your  operating  system  is
     upgraded.
Click on FTP to download from the FTP archives.