Installation of AUC TeX

Before you do anything else, make sure that you have the latest version of TeXinfo installed. It is available by ftp from `prep.ai.mit.edu'. You need at least version 2.16.

First, you should edit the file `tex-site.el' to fit your local site. You do this by looking at the customization section in the beginning of `tex.el' and copy the definitions that are wrong for your site to `tex-site.el'. Do not edit `tex.el' directly, or you will have to do all the work over again when you upgrade AUC TeX. Be sure to get the following two variables right, or you will not be able to complete the installation procedure:

User Option: TeX-lisp-directory

The directory where you want to install the AUC TeX lisp files.

User Option: TeX-macro-global

Directories containing the site's TeX style files.

You probably also need to change TeX-command-list to make sure that the commands used for starting TeX, printing, etc. work on your system.

Finally, edit TeX-printer-list to contain the printers available at your site.

The best way to change TeX-macro-global, TeX-command-list, TeX-printer-list and the other customization variables is to copy their definitions from `tex.el' to `tex-site.el' and change them there. This way, when you upgrade AUC TeX you can keep the old `tex-site.el' file so you don't need to customize it again.

Now copy `tex-site.el' to somewhere where emacs can find it, the best place is in the `.../emacs/site-lisp/' which is automatically searched in newer emacsen. Alternatively, you can insert the code from `tex-site.el' directly into your `.emacs' or `site-start.el' file, if you want to save the overhead of opening another file.

Next, edit the file `Makefile' in the AUC TeX directory to set up paths for installation of the files. Be sure that

bindir

Is set to the directory where you want the LaCheck binary to be installed.

infodir

Is set to the directory where you want the AUC TeX "info" documentation to be installed.

aucdir

Is set to the directory where you want the lisp files for AUC TeX to be installed. This must be the same directory as you specified for TeX-lisp-directory in `tex-site.el'. If you unpacked AUC TeX in that directory (TeX-lisp-directory), you should set aucdir to `.' in order to avoid copying the byte compiled lisp files. If you already have an old version of AUC TeX in that directory, you must delete it before installing the new version. Otherwise the wrong version of the files may be loaded during the byte compilation.

mandir

Is set to the directory where you want to install the (unformatted) man page for LaCheck.

CC

Is the compiler you want to use for compiling the LaCheck program. Is set to `gcc' by default. Change this is `cc' or whatever your system compiler is called if you do not have GCC installed.

Then type make all, and the whole thing will be `made'. If this succeeds, type make install, and it will be installed.

Now, tell the users to insert

        (require 'tex-site)

in their `.emacs' files if they want to use AUC TeX. If you use a modern emacs, you can do this for them by inserting the above line in the `.../emacs/site-lisp/site-start.el' file.

To extract information from your sites TeX macros, type M-x TeX-auto-generate-global in your emacs. This will only work if you have set TeX-macro-global correctly in `tex-site.el'.