This directory holds the latest distribution version of GNU Emacs.
 The subdirectory `src' holds the C code,
 `lisp' holds the Lisp code for the editing commands,
 `etc' holds various associated documentation files
    and programs that Emacs runs,
 `info' holds the Info documentation tree.
 `man' holds the source of the Emacs manual.
 `gdb' holds the new GNU source-level debugger.
   It runs only on Vaxes and suns now; you are encouraged to port
   it to other machines.
   See etc/DEBUG for info on how to debug Emacs.
 `cpp' holds a C preprocessor for use instead of the installed one
   when the installed one fails to distinguish more than 8 characters
   in a symbol name.
 `shortnames' holds programs and data files for creating files of #define's
   used to convert long symbol names to distinct short ones
   for C compiles that cannot distinguish more than 8 characters.

The file INSTALL in this directory says how to bring up
 GNU Emacs on Unix, once you have loaded the entire subtree of this
 directory.

The files `build-install' and `Makefile' help automate the process of
 building and installing emacs.  The former is a shell script.  See
 INSTALL for more info.

The file PROBLEMS contains information on many common
 problems that occur in building, installing and running Emacs.

The `etc' subdirectory contains several other files,
 named in capital letters, which you should look at
 when installing GNU Emacs.

The file 'emacs.com' in this directory is for VMS.  It defines
 logical names and commands such as `emacs', so you must edit
 it to specify the file and directory names used on your machine.
 This file must be executed in each session to enable you to run
 the installed Emacs.  It should be executed by your `login.com' file,
 or else perhaps it can be executed once at system boot time.

The file `kepteditor.com' in this directory is also for VMS.
 When a user says to run Emacs, it really runs this command file.

See the files VMSINSTALL and VMSNOTES for more information on VMS use.