The following describes how to install AUC TeX under Unix. You may also be able to do use these instructions under some other operating systems, if you have already installed the proper GNU tools, such as `make'.
To install AUC TeX for an entire site (which may just be your own personal Linux box), issue the following two commands as root:
make make lispdir=/usr/local/share/emacs/site-lisp install
except that instead of /usr/local/... you should use the location of your sites emacs installation. AUC TeX will then be installed in a subdirectory named `auctex' of the `site-lisp' directory, and the file `tex-site.el' will be stored directly in the `site-lisp'. You can now tell your users to enable AUC TeX by adding
to their `.emacs' file.
If you use xemacs instead, or if your emacs binary is named something else than `emacs', specify this by using the commands
make EMACS=xemacs make lispdir=/usr/local/share/emacs/site-lisp install
If you want to install AUC TeX in your personal account, you should chose a directory for all your emacs add-ons, for example an `elisp' subdirectory in your home directory. You can then install AUC TeX with the commands
make make lispdir=$HOME/elisp install
You will then need to add the following lines to your `.emacs' file:
(setq load-path (cons "~/elisp" load-path)) (require 'tex-site)
Next, 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. AUC TeX will not overwrite your old `tex-site.el' file next time you install, so you will be able to keep all your customizations.
There are two variables with a special significance.
This variable is set automatically by the
make install command.
If you don't issue a
make install, for example if you don't want
to install AUC TeX in a different place, you will have to set this
variable manually to the location of the compiled files.
Normally, AUC TeX will only allow you to complete a short list of build-in macros and environments and on the macros you define yourself. If you issue the M-x TeX-auto-generate-global command after loading AUC TeX, you will be able to complete on all macros available in the standard style files used by your document. To do this, you must set this variable to a list of directories where the standard style files are located. The directories will be searched recursively, so there is no reason to list subsirectories explicitly.
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. Copy the definition from `tex.el' to `tex-site.el'
and edit the command names appropriately.
Finally, copy and edit
TeX-printer-list to contain the printers
available at your site.
To extract information from your sites TeX macros, type M-x
TeX-auto-generate-global in your emacs. This will only work if you
TeX-macro-global correctly in `tex-site.el'.
There are several files that are not part of AUC TeX proper, but included in the distribution in case they are useful.
Read the comments in the start of each file for more information about how to install, what they do, and who wrote and maintains them.