2 EVEX

EVEX is an extension of DEC's EVE text editor.  See the following
topics for further information.

3 CONTACT
Contact H. Howe at HOWE@ORN on the MFE nework or by VMS Mail with 
problems or suggestions.

3 FEATURES

Some of the additional editing features available with EVEX are:

1.  An enhanced EDT-like keypad of EVE commands
2.  A procedure to run the fortran compiler on the file being edited
    if it is a fortran file or to run TeX or LaTeX if the file is a tex
    file without exiting EVE.  Error messages, if any, are automatically
    displayed in a second window while the source file may be edited in
    the original window. 
3.  A pattern-find procedure which allows constained searches for text
    strings.
4.  A set of procedures which facilitates editing of Fortran, TeX, or
    LaTeX source files.
5.  An automatic position marker and an automatic delimiter matcher.
6.  A procedure to move between buffers without repeatedly typing
    buffer names.
7.  A procedure to cut and paste blocks of text (such as columns in
      a table).
8.  A procedure to make the same change to multiple files.
9.  Readable non-printing control characters.
10. A CMS FETCH procedure
11. A modified subset of EVEPLUS procedures
 
3 SETUP

To access the EVEX interface, first add this line to your 
login.com file:

$ setup evex

In order to be automatically notified of EVEX updates when logging in, 
type this line at the monitor level (after leaving HELP):

  setreadnew_evex

This line only needs to be typed once to set up the BULLETIN utility.

3 RUNNING

To edit a file named "filename.ext", type "eve filename.ext".

To learn how EVEX works, enter "eve" and then press pf1 followed
by pf2 to obtain the keypad diagram. On the VT200 or Graphon, the
"help" key will give an additional key diagram for the Eve keypad and
the function keys. 

A complete list of additional EVEX commands may be obtained from
within EVEX by entering DO-help and then moving to the bottom of
the resulting command list. 

3 NEWS

To find the EVEX version number, press the DO key and then enter the
command: VERSION

Version 1.6 November 21, 1987
Add FETCH procedure
Remove SEARCH setup from RUN

Version 1.5 November 16, 1987
Remove key definitions for GOLD-RETURN, GOLD-DELETE
Change OPEN_LINE (GOLD-KP0) to split the line (like EDT)
CTRL/N no longer toggles between matched delimiters or block corners

Version 1.4 November 10, 1987
Remove EXTRA_WINDOW and NEXT_WINDOW
GOLD-KP. is LIST_BUFFERS
Added explicit keymap for LIST_BUFFERS => user defined keys in ini file
  should go explictly to EVE$USER_KEYS keymap.
TOGGLE_TABS => SET [NO]VISIBLE
BLOCK now a DO command (in addition to CTRL/B)

Version 1.3 October 20, 1987
Add generic HELP keypad diagrams; TERM_TYPE no longer needed.

Version 1.2  August 23, 1987
Keypad Change: Replace FPATTERN with SEARCH on PF2 (see below).
New Key Defs: F9 is ALTERNATE KEY
              F20 is GFILE
              GOLD-F20 is LIST FILES
              GOLD-SELECT (on EVE keypad) is LIST BUFFERS
Command Changes: Replace FORTRAN MODE with SET FORTRAN MODE
                 Replace NORMAL MODE with SET NO FORTRAN MODE
New Routines from EVEPLUS:
   SEARCH - FIND with wildcards
   LIST [ALL] BUFFERS - List and goto or remove active buffers
   SORT BUFFER - Alphabetize a buffer
   DISPLAY CHARACTER - Display ascii number and abbreviation of 
                       character under cursor
   DESCRIBE KEY - Give short description of next key pressed
   RELEASE BUFFERS - Write and delete all modified buffers
Other new routines:
   LIST FILES - List files in specified directory and GET one file
   GFILE - GET file under cursor
   ASCII CHARACTER - Insert a character by ascii number

Version 1.1  August 17, 1987
-Add call to evx$local_init at end of tpu$local_init to allow user
 extensions

Version 1.0  July 28, 1987
First version with a version number.

3 INITIALIZATION_FILE

The EVEX interface may be customized by placing define_key commands or
any other VAXTPU procedures or statements in the file
[USER.COM]EVEX_INI.TPU where USER is the user name.  When EVEX is
invoked, it will automatically compile and include any VAXTPU statements
which are in this file. 

3 DEFINE_KEY

EVEX procedures may be bound to keys by placing define_key commands in the
file [USER.COM]EVEX_INI.TPU where USER is the user name.  When EVEX is
invoked, it will automatically include any key definitions which are in 
this file.

Examples:

1.  To bind the alternate_key procedure to the CTRL/D key on a VT100 or 
    MAC, add the following lines to the ini file:

define_key ("eve_alternate_key('')", key_name(ctrl_d_key),
	"alternate_key", "eve$user_keys");

2.  To bind the write_file procedure to the GOLD-w key, add to ini file:

define_key ("eve_write_file('')", key_name("w",shift_key),
	"write_file", "eve$user_keys");

where "shift_key" denotes the GOLD key.

3 PRESS_OPTION

All EVEX routines which prompt for a single-letter response do not
require a carriage-return after the response is typed; that is,
the action occurs immediately when the proper key is pressed.  For
example, for the CHANGE CASE routine, the prompt is: 

Press Option:
Change case to (u)pper or (l)ower or (i)nvert.

Pressing "u" will change the select range to upper case; NO carriage
return is required.  The prompt "Press Option:" appears whenever a
single key press is required. 

