Since AUC TeX is so highly customizable, it makes sense that it is able to customize itself. The automatic customization consists of scanning TeX files and extracting symbols, environments, and things like that.
The automatic customization is done on three different levels. The global level is the level shared by all users at your site, and consists of scanning the standard TeX style files, and any extra styles added locally for all users on the site. The private level deals with those style files you have written for your own use, and use in different documents. You may have a `~/lib/TeX/' directory where you store useful style files for your own use. The local level is for a specific directory, and deals with writing customization for the files for your normal TeX documents.
If compared with the environment variable TEXINPUTS, the
global level corresponds to the directories built into TeX. The
private level corresponds to the directories you add yourself, except for
`.', which is the local level.
By default AUC TeX will search for customization files in all the
global, private, and local style directories, but you can also set the
path directly. This is useful if you for example want to add another
person's style hooks to your path. Please note that all matching files
found in TeX-style-path are loaded, and all hooks defined in the
files will be executed.
By default, when AUC TeX searches a directory for files, it will recursively search through subdirectories.
By default, AUC TeX will ignore files name `.', `..', `SCCS', `RCS', and `CVS'.
These files or directories will not be considered when searching for TeX files in a directory.
Assuming that the automatic customization at the global level was done when AUC TeX was installed, your choice is now: will you use it? If you use it, you will benefit by having access to all the symbols and environments available for completion purposes. The drawback is slower load time when you edit a new file and perhaps too many confusing symbols when you try to do a completion.
You can disable the automatic generated global style hooks by setting
the variable TeX-auto-global to nil.
These correspond to TeX macros shared by all users of a site.
For storing automatic extracted information about the TeX macros shared by all users of a site.
You should specify where you store your private TeX macros, so AUC
TeX can extract their information. The extracted information will go
to the directories listed in TeX-auto-private
Use M-x TeX-auto-generate to extract the information.
This defaults to the directories listed in the `TEXINPUTS' and `BIBINPUTS' environment variables.
These correspond to the personal TeX macros.
These correspond to the personal TeX macros.
AUC TeX can update the style information about a file each time you
save it, and it will do this if the directory TeX-auto-local
exist. TeX-auto-local is by default set to `"auto/"', so
simply creating an `auto' directory will enable automatic saving of
style information.
The advantage of doing this is that macros, labels, etc. defined in any
file in a multifile document will be known in all the files in the
document. The disadvantage is that saving will be slower. To disable,
set TeX-auto-local to nil.
These correspond to TeX macros found in the current directory.
These correspond to TeX macros found in the current directory.