<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
<!-- This manual is for AUCTeX
(version 11.86 from 2010-02-21),
a sophisticated TeX environment for Emacs.
Copyright C 1992, 1993, 1994, 1995, 2001, 2002, 2004, 2005,
2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. A
copy of the license is included in the section entitled "GNU Free
Documentation License."
-->
<!-- Created on July 15, 2012 by texi2html 1.82
texi2html was written by:
Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Many creative people.
Send bugs and suggestions to <texi2html-bug@nongnu.org>
-->
<head>
<title>AUCTeX 11.86: 5.5 Automatic Customization</title>
<meta name="description" content="AUCTeX 11.86: 5.5 Automatic Customization">
<meta name="keywords" content="AUCTeX 11.86: 5.5 Automatic Customization">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html 1.82">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
pre.display {font-family: serif}
pre.format {font-family: serif}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: serif; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: serif; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.roman {font-family:serif; font-weight:normal;}
span.sansserif {font-family:sans-serif; font-weight:normal;}
ul.toc {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Automatic"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="auctex_32.html#Japanese" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="#Automatic-Global" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="auctex_28.html#Customization" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="auctex_28.html#Customization" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="auctex_35.html#Appendices" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="auctex.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="auctex_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="auctex_40.html#Indices" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="auctex_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<a name="Automatic-Customization"></a>
<h2 class="section">5.5 Automatic Customization</h2>
<a name="index-Automatic-Customization"></a>
<a name="index-Extracting-TeX-symbols"></a>
<a name="index-Automatic"></a>
<a name="index-auto-directories_002e"></a>
<a name="index-Parsing-TeX-1"></a>
<a name="index-TeX-parsing"></a>
<a name="index-Generating-symbols"></a>
<p>Since AUCTeX 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.
</p>
<p>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 ‘<tt>~/lib/TeX/</tt>’ 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.
</p>
<p>If compared with the environment variable <code>TEXINPUTS</code>, the
global level corresponds to the directories built into TeX. The
private level corresponds to the directories you add yourself, except for
‘<tt>.</tt>’, which is the local level.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a href="#Automatic-Global">5.5.1 Automatic Customization for the Site</a></td><td> </td><td align="left" valign="top"></td></tr>
<tr><td align="left" valign="top"><a href="#Automatic-Private">5.5.2 Automatic Customization for a User</a></td><td> </td><td align="left" valign="top"></td></tr>
<tr><td align="left" valign="top"><a href="#Automatic-Local">5.5.3 Automatic Customization for a Directory</a></td><td> </td><td align="left" valign="top"></td></tr>
</table>
<p>By default AUCTeX 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 <code>TeX-style-path</code> are loaded, and all hooks defined in the
files will be executed.
</p>
<dl>
<dt><a name="index-TeX_002dstyle_002dpath"></a><u>User Option:</u> <b>TeX-style-path</b></dt>
<dd><p>List of directories to search for AUCTeX style files.
Each must end with a slash.
</p></dd></dl>
<p>By default, when AUCTeX searches a directory for files, it will
recursively search through subdirectories.
</p>
<dl>
<dt><a name="index-TeX_002dfile_002drecurse"></a><u>User Option:</u> <b>TeX-file-recurse</b></dt>
<dd><p>Whether to search TeX directories recursively: nil means do not
recurse, a positive integer means go that far deep in the directory
hierarchy, t means recurse indefinitely.
</p></dd></dl>
<p>By default, AUCTeX will ignore files name ‘<tt>.</tt>’, ‘<tt>..</tt>’,
‘<tt>SCCS</tt>’, ‘<tt>RCS</tt>’, and ‘<tt>CVS</tt>’.
</p>
<dl>
<dt><a name="index-TeX_002dignore_002dfile"></a><u>User Option:</u> <b>TeX-ignore-file</b></dt>
<dd><p>Regular expression matching file names to ignore.
</p>
<p>These files or directories will not be considered when searching for
TeX files in a directory.
</p></dd></dl>
<hr size="6">
<a name="Automatic-Global"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Automatic" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="#Automatic-Private" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="auctex_28.html#Customization" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="#Automatic" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="auctex_35.html#Appendices" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="auctex.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="auctex_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="auctex_40.html#Indices" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="auctex_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<a name="Automatic-Customization-for-the-Site"></a>
<h3 class="subsection">5.5.1 Automatic Customization for the Site</h3>
<a name="index-Global-style-hook-directory"></a>
<a name="index-Global-macro-directory"></a>
<a name="index-Site-macro-directory"></a>
<a name="index-Global-TeX-macro-directory"></a>
<a name="index-Site-TeX-macro-directory"></a>
<a name="index-Global-directories"></a>
<a name="index-Site-information"></a>
<p>Assuming that the automatic customization at the global level was done
when AUCTeX 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.
</p>
<p>You can disable the automatic generated global style hooks by setting
the variable <code>TeX-auto-global</code> to nil.
</p>
<dl>
<dt><a name="index-TeX_002dmacro_002dglobal-1"></a><u>User Option:</u> <b>TeX-macro-global</b></dt>
<dd><p>Directories containing the site’s TeX style files.
</p></dd></dl>
<dl>
<dt><a name="index-TeX_002dstyle_002dglobal"></a><u>User Option:</u> <b>TeX-style-global</b></dt>
<dd><p>Directory containing hand generated TeX information.
Must end with a slash.
</p>
<p>These correspond to TeX macros shared by all users of a site.
</p></dd></dl>
<dl>
<dt><a name="index-TeX_002dauto_002dglobal"></a><u>User Option:</u> <b>TeX-auto-global</b></dt>
<dd><p>Directory containing automatically generated information.
</p>
<p>For storing automatic extracted information about the TeX macros
shared by all users of a site.
</p></dd></dl>
<hr size="6">
<a name="Automatic-Private"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Automatic-Global" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="#Automatic-Local" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="auctex_28.html#Customization" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="#Automatic" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="auctex_35.html#Appendices" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="auctex.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="auctex_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="auctex_40.html#Indices" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="auctex_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<a name="Automatic-Customization-for-a-User"></a>
<h3 class="subsection">5.5.2 Automatic Customization for a User</h3>
<a name="index-Private-style-hook-directory"></a>
<a name="index-Private-macro-directory"></a>
<a name="index-Personal-macro-directory"></a>
<a name="index-Private-TeX-macro-directory"></a>
<a name="index-Personal-TeX-macro-directory"></a>
<a name="index-Private-directories"></a>
<a name="index-Personal-information"></a>
<p>You should specify where you store your private TeX macros, so
AUCTeX can extract their information. The extracted information will
go to the directories listed in <code>TeX-auto-private</code>
</p>
<p>Use <kbd>M-x TeX-auto-generate <RET></kbd> to extract the information.
</p>
<dl>
<dt><a name="index-TeX_002dmacro_002dprivate"></a><u>User Option:</u> <b>TeX-macro-private</b></dt>
<dd><p>Directories where you store your personal TeX macros. The value
defaults to the directories listed in the ‘<samp>TEXINPUTS</samp>’ and
‘<samp>BIBINPUTS</samp>’ environment variables or to the respective directories
in <code>$TEXMFHOME</code> if no results can be obtained from the environment
variables.
</p></dd></dl>
<dl>
<dt><a name="index-TeX_002dauto_002dprivate"></a><u>User Option:</u> <b>TeX-auto-private</b></dt>
<dd><p>List of directories containing automatically generated AUCTeX style
files. These correspond to the personal TeX macros.
</p></dd></dl>
<dl>
<dt><a name="index-TeX_002dauto_002dgenerate"></a><u>Command:</u> <b>TeX-auto-generate</b><i> <var>TEX</var> <var>AUTO</var></i></dt>
<dd><p>(<kbd>M-x TeX-auto-generate <RET></kbd>) Generate style hook for
<var>TEX</var> and store it in <var>AUTO</var>. If <var>TEX</var> is a directory,
generate style hooks for all files in the directory.
</p></dd></dl>
<dl>
<dt><a name="index-TeX_002dstyle_002dprivate"></a><u>User Option:</u> <b>TeX-style-private</b></dt>
<dd><p>List of directories containing hand generated AUCTeX style files.
These correspond to the personal TeX macros.
</p></dd></dl>
<hr size="6">
<a name="Automatic-Local"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Automatic-Private" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="auctex_34.html#Style-Files" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="auctex_28.html#Customization" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="#Automatic" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="auctex_35.html#Appendices" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="auctex.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="auctex_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="auctex_40.html#Indices" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="auctex_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<a name="Automatic-Customization-for-a-Directory"></a>
<h3 class="subsection">5.5.3 Automatic Customization for a Directory</h3>
<a name="index-Local-style-hooks"></a>
<a name="index-Updating-style-hooks"></a>
<a name="index-Automatic-updating-style-hooks"></a>
<a name="index-Local-style-hooks-1"></a>
<a name="index-Local-style-directory"></a>
<p>AUCTeX can update the style information about a file each time you
save it, and it will do this if the directory <code>TeX-auto-local</code>
exist. <code>TeX-auto-local</code> is by default set to ‘<samp>"auto"</samp>’, so
simply creating an ‘<tt>auto</tt>’ directory will enable automatic saving of
style information.
</p>
<p>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 <code>TeX-auto-local</code> to nil.
</p>
<dl>
<dt><a name="index-TeX_002dstyle_002dlocal"></a><u>User Option:</u> <b>TeX-style-local</b></dt>
<dd><p>Directory containing hand generated TeX information.
Must end with a slash.
</p>
<p>These correspond to TeX macros found in the current directory.
</p></dd></dl>
<dl>
<dt><a name="index-TeX_002dauto_002dlocal"></a><u>User Option:</u> <b>TeX-auto-local</b></dt>
<dd><p>Directory containing automatically generated TeX information.
Must end with a slash.
</p>
<p>These correspond to TeX macros found in the current directory.
</p></dd></dl>
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Automatic-Private" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="auctex_34.html#Style-Files" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="auctex_28.html#Customization" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="#Automatic" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="auctex_35.html#Appendices" title="Next chapter"> >> </a>]</td>
</tr></table>
<p>
<font size="-1">
This document was generated on <i>July 15, 2012</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 1.82</i></a>.
</font>
<br>
</p>
</body>
</html>
distrib
>
Momonga
>
development
>
i686
>
media
>
os
>
by-pkgid
>
ef1f89c4296c878b2bca761df11f0c51
>
files
>
33
