NeXTEmacs

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.