Installation procedures for GNU Emacs (VMS Version)
  ---------------------------------------------------

  To install VMS version of GNU EMACS, you must have VAXCRTL available
as a shareable image on your system.

  Recommended procedures for installation are as follows:

1.  Load and mount/foreign the EMACS tape (diskette).

2.  Type the commands (assuming the tape drive is defined as $tape1):

	$ set default [0,0]
	$ backup/log $tape1:emacs [*...]
	$ set default [gnuemacs]

    Your current disk must be the one you plan to load emacs onto.
    A top level directory called [GNUEMACS] and subdirectories
    [.SRC], [.LISP], [.ETC] and [.INFO] are created.  You must have
    the proper access.

3.  Invoke the command procedure SETUP.COM.
    When prompted, type in the directory specifications for the
    directory where you want the emacs executable to reside.
    Create this directory if it doesn't exist.

    This will create command procedures EMACSDEFS.COM and EMACSUTDEFS.COM.
    It will also invoke these procedures.  The logicals defined
    in these procedures are required for the rest of the installation.

4.  Invoke LINK.COM.  VAXCRTL should either be in IMAGELIB or
    it should be availble through a LNK$LIBRARY logical name.

5.  Edit file [.ETC]TERMCAP.DAT and make sure the entries for
    all terminals on your system do not contain the \n character
    (for the 'nl' capability, or otherwise).  Find alternate character
    sequences.  NOTE:  Terminal type as known to VMS may be
    different from the type name in this file.  For instance, you
    may need to append a "-80" to indicate number of columns.
    If there are problems with the terminal type, define the
    logical name "EMACSVAR_TERM" to the correct terminal type (case
    sensitive) name as defined in TERMCAP.DAT.  E.g.

	$ define emacsvar_term "concept"

6.  (Optional) Edit the file [.LISP]SITE_INIT.EL.  Current configuration
    is for a system with only vt200's.  If you change it, delete the
    file [.LISP]SITE_INIT.ELC for now -- once you have emacs running,
    you may want to recompile it and run through the next step again.
    Note that in the current configuration, ^Z is bound to macro
    invocation, since suspending emacs is not available on VMS.

7.  Run through INSTALL.COM to make sure this is how you want to
    have emacs installed on your system.
    Enable priviliges SYSPRV,CMKRNL,OPER and run the command file
    INSTALL.COM.  (Note: SYSPRV is only needed to have all files be
    accessible.  If you won't need it, edit the file appropriately.)

    You should be able to use emacs now.


8.  i)   Have users invoke the EMACSDEFS.COM procedure in their login sequence,
	 or,
    ii)  invoke it in SYLOGIN.COM,
	 or,
    iii) Put the logicals in SYSTARTUP.COM as system logicals and
         just put the "emacs" symbol definition in SYLOGIN.COM or
	 users' login.com files.

9.  Modify SYSTARTUP.COM to install emacs (look at INSTALL.COM).

10. Have fun.  If you plan to modify sources, the command files
    DO.COM, MAKE.COM, COMPILE.COM and LINK.COM in [.ETC] should be
    useful.  These command files can run in batch.