Anonymous avatar Anonymous committed 6030fa9

Update to package standard 1.0

Comments (0)

Files changed (7)

+1998-01-24  SL Baur  <steve@altair.xemacs.org>
+
+	* Makefile (VERSION): Update to package standard 1.0.
+
 1998-01-17  SL Baur  <steve@altair.xemacs.org>
 
-	* Makefile (binkit): Create infod directory if necessary.
+	* Makefile (binkit): Create info directory if necessary.
 	From Charles G Waldman <cgw@pgt.com>
 
 1997-07-02  Steven L Baur  <steve@altair.xemacs.org>
 
 # remove the MULE_ELCS line for building without Mule.
 
-VERSION = 1.03
+VERSION = 1.04
+AUTHOR_VERSION = 9.7p
+MAINTAINER = XEmacs Development Team <xemacs-beta@xemacs.org>
 PACKAGE = auctex
 PKG_TYPE = regular
 REQUIRES = xemacs-base
 
 all:: $(ELCS) $(MULE_ELCS) auto-autoloads.elc custom-load.elc texi
 
+clean::
+	rm -f texi/*.info*
+
 texi:
 	$(MAKE) -C texi info
 
 	-mkdir -p $(STAGING)/etc/$(PACKAGE)/style
 	-rm -rf $(STAGING)/info/auctex.info*
 	-mkdir -p $(STAGING)/info
-	cp -a ChangeLog *.el* $(STAGING)/lisp/$(PACKAGE)
-	cp -a etc/* $(STAGING)/etc/$(PACKAGE)/style
-	cp -a texi/*.info* $(STAGING)/info
+	$(RCOPY) ChangeLog *.el* $(STAGING)/lisp/$(PACKAGE)
+	$(RCOPY) etc/* $(STAGING)/etc/$(PACKAGE)/style
+	$(RCOPY) texi/*.info* $(STAGING)/info
 	(cd $(STAGING); \
 	rm -f $(PACKAGE)-$(VERSION)-pkg.tar*; \
 	tar cf $(PACKAGE)-$(VERSION)-pkg.tar lisp/$(PACKAGE) \
 (auctex
-  (version VERSION
+  (standards-version 1.0
+   version VERSION
+   author-version AUTHOR_VERSION
+   date DATE
+   build-date BUILD_DATE
+   maintainer MAINTAINER
+   distribution stable
+   priority medium
+   category CATEGORY
+   dump nil
    description "Basic TeX/LaTeX support."
    filename FILENAME
    md5sum MD5SUM

texi/auctex.info

-This is Info file ./auctex.info, produced by Makeinfo version 1.68 from
-the input file auc-tex.texi.
-
-
-Indirect:
-auctex.info-1: 102
-auctex.info-2: 45656
-auctex.info-3: 95455
-
-Tag Table:
-(Indirect)
-Node: Top102
-Node: Copying2671
-Node: Introduction4618
-Node: Frequently Used Commands11645
-Node: Quotes12414
-Node: Font Specifiers14600
-Node: Sectioning16474
-Node: Environments20826
-Node: Floats23128
-Node: Itemize-like24288
-Node: Tabular-like24794
-Node: Customizing environments25073
-Node: Advanced Features25304
-Node: Mathematics25984
-Node: Completion27387
-Node: Commenting30818
-Node: Marking and formatting32042
-Node: Outline35758
-Node: Formatting37543
-Node: Commands38179
-Node: Debugging42440
-Node: Checking43642
-Node: Control44953
-Node: Multifile45656
-Node: Parsing Files50110
-Node: I18n54238
-Node: European54765
-Node: Japanese58850
-Node: Automatic59581
-Node: Automatic Global61941
-Node: Automatic Private63108
-Node: Automatic Local64350
-Node: Style Files65428
-Node: Simple Style66226
-Node: Adding Macros67387
-Node: Adding Environments72970
-Node: Adding Other75548
-Node: Hacking the Parser76124
-Node: Installation80200
-Node: History84516
-Node: Projects84785
-Node: Credit93931
-Node: Key Index95455
-Node: Function Index97652
-Node: Variable Index101559
-Node: Concept Index104888
-
-End Tag Table

texi/auctex.info-1

-This is Info file ./auctex.info, produced by Makeinfo version 1.68 from
-the input file auc-tex.texi.
-
-
-File: auctex.info,  Node: Top,  Next: Copying,  Prev: (dir),  Up: (dir)
-
-AUC TeX
-*******
-
-   AUC TeX is an integrated environment for editing LaTeX and TeX files.
-
-   This file documents AUC TeX version 9.7.
-
-   Although AUC TeX contains a large number of features, there are no
-reasons to despair.  You can continue to write TeX and LaTeX documents
-the way you are used to, and only start using the multiple features in
-small steps.  AUC TeX is not monolithic, each feature described in this
-manual is useful by itself, but together they provide an environment
-where you will make very few LaTeX errors, and makes it easy to find
-the errors that may slip through anyway.
-
-   If you want to make AUC TeX aware of style files and multi-file
-documents right away, insert the following in your `.emacs' file.
-     (setq TeX-auto-save t)
-     (setq TeX-parse-self t)
-     (setq-default TeX-master nil)
-
-   NOTE: This documentation is preliminary.  It should however cover
-most important points.  Corrections or perhaps rewrites of sections are
-VERY WELCOME.
-
-   Kresten Krab Thorup (6.0)
-Per Abrahamsen (later updates)
-
-   There is a mailing list for discussion about AUC TeX and announcement
-of alpha releases, write to `auc-tex-request@sunsite.auc.dk' to join
-it.  Send contributions to `auc-tex@sunsite.auc.dk'.
-
-   Bug reports, suggestions for new features, and pleas for help should
-go to either `auc-tex_mgr@iesd.auc.dk' (the AUC TeX managers), or to
-`auc-tex@sunsite.auc.dk' (the mailing list) if they might have general
-interest.  Please use the command `M-x TeX-submit-bug-report' to report
-bugs if possible.
-
-* Menu:
-
-* Copying::                     Copying
-* Introduction::                Why AUC TeX is good for you.
-* Frequently Used Commands::    Inserting Frequently Used Commands
-* Advanced Features::           Advanced Editing Features
-* Formatting::                  Formatting and Printing
-* Multifile::                   Multifile Documents
-* Parsing Files::               Automatic Parsing of TeX files.
-* I18n::                        Internationalization
-* Automatic::                   Automatic Customization
-* Style Files::                 Writing Your own Style Support
-* Installation::                How to install AUC TeX
-* History::                     The History of AUC TeX
-* Projects::                    Wishlist
-* Credit::                      Credit
-* Key Index::                   Key Index
-* Function Index::              Function Index
-* Variable Index::              Variable Index
-* Concept Index::               Concept Index
-
-
-File: auctex.info,  Node: Copying,  Next: Introduction,  Prev: Top,  Up: Top
-
-Copying
-*******
-
-   (This text stolen from the TeXinfo 2.16 distribution).
-
-   The programs currently being distributed that relate to AUC TeX
-include lisp files for GNU Emacs.  These programs are "free"; this
-means that everyone is free to use them and free to redistribute them on
-a free basis.  The AUC TeX related programs are not in the public
-domain; they are copyrighted and there are restrictions on their
-distribution, but these restrictions are designed to permit everything
-that a good cooperating citizen would want to do.  What is not allowed
-is to try to prevent others from further sharing any version of these
-programs that they might get from you.
-
-   Specifically, we want to make sure that you have the right to give
-away copies of the programs that relate to AUC TeX, that you receive
-source code or else can get it if you want it, that you can change these
-programs or use pieces of them in new free programs, and that you know
-you can do these things.
-
-   To make sure that everyone has such rights, we have to forbid you to
-deprive anyone else of these rights.  For example, if you distribute
-copies of the AUC TeX related programs, you must give the recipients all
-the rights that you have.  You must make sure that they, too, receive or
-can get the source code.  And you must tell them their rights.
-
-   Also, for our own protection, we must make certain that everyone
-finds out that there is no warranty for the programs that relate to AUC
-TeX.  If these programs are modified by someone else and passed on, we
-want their recipients to know that what they have is not what we
-distributed, so that any problems introduced by others will not reflect
-on our reputation.
-
-   The precise conditions of the licenses for the programs currently
-being distributed that relate to AUC TeX are found in the General
-Public Licenses that accompany them.
-
-
-File: auctex.info,  Node: Introduction,  Next: Frequently Used Commands,  Prev: Copying,  Up: Top
-
-Introduction to AUC TeX
-***********************
-
-   This section of the AUC TeX manual gives a brief overview of what AUC
-TeX is, and the section is also available as a `README' file.  It is
-*not* an attempt to document AUC TeX.  Real documentation for AUC TeX
-is available in the rest of the manual, which you can find in the `doc'
-directory.
-
-   Read the `INSTALLATION' file for information about how to install
-AUC TeX.  It is identical to the Installation chapter in the AUC TeX
-manual.
-
-   If you are upgrading from the previous version of AUC TeX, the
-latest changes can be found in the `CHANGES' file.  If you are
-upgrading from an older version, read the History chapter in the AUC
-TeX manual.
-
-   AUC TeX is a comprehensive customizable integrated environment for
-writing input files for LaTeX using GNU Emacs.
-
-   AUC TeX lets you run TeX/LaTeX and other LaTeX-related tools, such
-as a output filters or post processor from inside Emacs.  Especially
-`running LaTeX' is interesting, as AUC TeX lets you browse through the
-errors TeX reported, while it moves the cursor directly to the reported
-error, and displays some documentation for that particular error.  This
-will even work when the document is spread over several files.
-
-   AUC TeX automatically indents your `LaTeX-source', not only as you
-write it -- you can also let it indent and format an entire document.
-It has a special outline feature, which can greatly help you `getting an
-overview' of a document.
-
-   Apart from these special features, AUC TeX provides an large range of
-handy Emacs macros, which in several different ways can help you write
-your LaTeX documents fast and painless.
-
-   All features of AUC TeX are documented using the GNU Emacs online
-documentation system.  That is, documentation for any command is just a
-key click away!
-
-   AUC TeX is written entirely in Emacs-Lisp, and hence you can easily
-add new features for your own needs.  It was not made as part of any
-particular employment or project (apart from the AUC TeX project
-itself).  AUC TeX is distributed under the `GNU Emacs General Public
-License' and may therefore almost freely be copied and redistributed.
-
-   The next sections are a short introduction to some `actual' features.
-For further information, refer to the build-in online documentation of
-AUC TeX.
-
-Indentation and formatting
-==========================
-
-   AUC TeX may automatically indent your document as you write it. By
-pressing <lfd> instead of <ret> at the end of a line, the current line
-is indented by two spaces according to the current environment level,
-and the cursor is moved down one line.  By pressing <tab>, the current
-line is indented, and the cursor stays where it is.  The well-known
-Emacs feature `format-paragraph' (`M-q') is reimplemented especially
-for AUC TeX to follow the indentation.  A special command
-`LaTeX-fill-buffer' lets you indent an entire document like the
-well-known C utility indent (this time, only according to the LaTeX
-structure :-).
-
-Completion
-==========
-
-   By studying your `\documentstyle' command (in the top of your
-document), and consulting a precompiled list of (La)TeX symbols from a
-large number of TeX and LaTeX files, AUC TeX is aware of the LaTeX
-commands you should able to use in this particular document.  This
-`knowledge' of AUC TeX is used for two purposes.
-
-  1. To make you able to `complete' partly written LaTeX commands. You
-     may e.g. write `\renew' and press `M-<tab>'
-     (`TeX-complete-symbol'), and then AUC TeX will complete the word
-     `\renewcommand' for you. In case of ambiguity it will display a
-     list of possible completions.
-
-  2. To aid you inserting environments, that is \begin - \end pairs.
-     This is done by pressing C-c C-e (LaTeX-environment), and you will
-     be prompted for which `environment' to insert.
-
-Editing your document
-=====================
-
-   A number of more or less intelligent keyboard macros have been
-defined to aid you editing your document.  The most important are
-listed here below.
-
-`LaTeX-environment'
-     (`C-c C-e') Insert a `\begin{}' -- `\end{}' pair as described
-     above.
-
-`LaTeX-section'
-     (`C-c C-s') Insert one of `\chapter', `\section', etc.
-
-`TeX-font'
-     (`C-c C-f C-r', `C-c C-f C-i', `C-c C-f C-b') Insert one of
-     `{\textrm }'), `{\textit \/}' `{\textbf }' etc.
-
-   A number of additional functions are available.  But it would be far
-too much to write about here.  Refer to the rest of the AUC TeX
-documentation for further information.
-
-Running LaTeX
-=============
-
-   When invoking on of the commands `TeX-command-master' (`C-c C-c') or
-`TeX-command-region' (`C-c C-r') LaTeX is run on either the entire
-current document or a given region of it.  The Emacs view is split in
-two, and the output of TeX is printed in the second half of the screen,
-as you may simultaneously continue editing your document.  In case TeX
-found any errors when processing your input you can call the function
-`TeX-next-error' (`C-c `') which will move the cursor to the first
-given error, and display a short explanatory text along with the
-message TeX gave.  This procedure may be repeated until all errors have
-been displayed.  By pressing `C-c C-w' (`TeX-toggle-debug-boxes') you
-can toggle whether the browser also should notify over-full/under-full
-boxes or not.
-
-   Once you've successfully formatted your document, you may preview or
-print it by invoking `TeX-command-master' again.
-
-Outlines
-========
-
-   Along with AUC TeX comes support for outline mode for Emacs, which
-lets you browse the sectioning structure of your document, while you
-will still be able to use the full power of the rest of the AUC TeX
-functionality.
-
-Availability
-============
-
-   The most recent version is always available by ftp at
-
-                   `ftp://ftp.iesd.auc.dk/pub/emacs-lisp/auctex.tar.gz'
-
-   In case you don't have access anonymous ftp, you can get it by email
-requests to `<ftpmail@decwrl.dec.com>'.
-
-   WWW users may want to check out the AUC TeX page at
-
-                               `http://www.iesd.auc.dk/~amanda/auctex/'
-
-Contacts
-========
-
-   There has been established a mailing list for help, bug reports,
-feature requests and general discussion about AUC TeX.  You're very
-welcome to join.  Traffic average at an article by day, but they come
-in bursts.  If you are only interested in information on updates, you
-could refer to the newsgroups `comp.text.tex' and `gnu.emacs.sources'.
-
-   If you want to contact the AUC TeX mailing list, send mail to
-`<auc-tex-request@iesd.auc.dk>' in order to join.  Articles should be
-send to `<auc-tex@iesd.auc.dk>'.
-
-   To contact the current maintainers of auc-TeX directly, email
-`<auc-tex_mgr@iesd.auc.dk>'.
-
-             AUC TeX development
-             c/o Kresten Krab Thorup
-     
-             Mathematics and Computer Science
-             University of Aalborg
-             DK 9000 Aalborg
-             Denmark
-
-
-File: auctex.info,  Node: Frequently Used Commands,  Next: Advanced Features,  Prev: Introduction,  Up: Top
-
-Inserting Frequently Used Commands
-**********************************
-
-   The most commonly used commands/macros of AUC TeX are those which
-simply insert templates for often used TeX and/or LaTeX constructs,
-like font changes, handling of environments, etc.  These features are
-very simple, and easy to learn, and help you avoiding stupid mistakes
-like mismatched braces, or `\begin{}'-`\end{}' pairs.
-
-* Menu:
-
-* Quotes::                      Inserting double quotes
-* Font Specifiers::             Inserting Font Specifiers
-* Sectioning::                  Inserting chapters, sections, etc.
-* Environments::                Inserting Environment Templates
-
-
-File: auctex.info,  Node: Quotes,  Next: Font Specifiers,  Prev: Frequently Used Commands,  Up: Frequently Used Commands
-
-Insertion of Quotes, Dollars, and Braces
-========================================
-
-   In TeX literal double quotes `"like this"' are seldom used, instead
-two single quotes are used ```like this'''.  To help you insert these
-efficiently, AUC TeX allows you to continue to press `"' to insert two
-single quotes.  To get a literal double quote, press `"' twice.
-
- - Command: TeX-insert-quote COUNT
-     (`"') Insert the appropriate quote marks for TeX.
-
-     Inserts the value of `TeX-open-quote' (normally ```') or
-     `TeX-close-quote' (normally `''') depending on the context.  With
-     prefix argument, always inserts `"' characters.
-
- - User Option: TeX-open-quote
-     String inserted by typing `"' to open a quotation.
-
- - User Option: TeX-close-quote
-     String inserted by typing `"' to open a quotation.
-
-   If you include the style file `german' `TeX-open-quote' and
-`TeX-close-quote' will both be set to `"'.
-
-   In AUC TeX, dollar signs should match like they do in TeX.  This has
-been partially implemented, we assume dollar signs always match within
-a paragraph.  The first `$' you insert in a paragraph will do nothing
-special.  The second `$' will match the first.  This will be indicated
-by moving the cursor temporarily over the first dollar sign.  If you
-enter a dollar sign that matches a double dollar sign `$$' AUC TeX will
-automatically insert two dollar signs.  If you enter a second dollar
-sign that matches a single dollar sign, the single dollar sign will
-automatically be converted to a double dollar sign.
-
- - Command: TeX-insert-dollar ARG
-     (`$') Insert dollar sign.
-
-     Show matching dollar sign if this dollar sign end the TeX math
-     mode.  Ensure double dollar signs match up correctly by inserting
-     extra dollar signs when needed.
-
-     With optional ARG, insert that many dollar signs.
-
-   To avoid unbalanced braces, it is useful to insert them pairwise.
-You can do this by typing `C-c {'.
-
- - Command: TeX-insert-braces
-     (`C-c {') Make a pair of braces and position the cursor to type
-     inside of them.
-
-
-File: auctex.info,  Node: Font Specifiers,  Next: Sectioning,  Prev: Quotes,  Up: Frequently Used Commands
-
-Inserting Font Specifiers
-=========================
-
-   Perhaps the most used keyboard commands of AUC TeX are the short-cuts
-available for easy insertion of font changing macros.  They all put the
-font change inside a TeX group, a practice that help preventing subtle
-errors.  The most significant advantage of using these command instead
-of typing it in yourself, is that the braces will always match
-correctly.
-
-   If you give an argument (that is, type `C-u') to the font command,
-the innermost font will be replaced, i.e. the font in the TeX group
-around point will be changed.  The following table shows the available
-commands, with `-!-' indicating the position where the text will be
-inserted.
-
-`C-c C-f C-r'
-     Insert roman {\textrm -!-} text.
-
-`C-c C-f C-b'
-     Insert bold face `{\textbf -!-}' text.
-
-`C-c C-f C-i'
-     Insert italics `{\textit -!-\/}' text.
-
-`C-c C-f C-e'
-     Insert emphasized `{\emph -!-\/}' text.
-
-`C-c C-f C-s'
-     Insert slanted `{\textsl -!-\/}' text.
-
-`C-c C-f C-t'
-     Insert typewriter `{\texttt -!-}' text.
-
-`C-c C-f C-c'
-     Insert SMALL CAPS `{\textsc -!-}' text.
-
-`C-c C-f C-d'
-     Delete the innermost font specification containing point.
-
- - Command: TeX-font ARG
-     (`C-c C-f') Insert template for font change command.
-
-     If REPLACE is not nil, replace current font.  WHAT determines the
-     font to use, as specified by `TeX-font-list'.
-
- - User Option: TeX-font-list
-     List of fonts used by TeX-font.
-
-     Each entry is a list with three elements.  The first element is the
-     key to activate the font.  The second element is the string to
-     insert before point, and the third element is the string to insert
-     after point.  An optional fourth element means always replace if
-     not nil.
-
-
-File: auctex.info,  Node: Sectioning,  Next: Environments,  Prev: Font Specifiers,  Up: Frequently Used Commands
-
-Inserting chapters, sections, etc.
-==================================
-
-   Insertion of sectioning macros, that is `\chapter', `\section',
-`\subsection', etc. and accompanying `\label''s may be eased by using
-`C-c C-s'.  This command is highly customizable, the following
-describes the default behavior.
-
-   When invoking you will be asked for a section macro to insert.  An
-appropriate default is automatically selected by AUC TeX, that is
-either: at the top of the document; the top level sectioning for that
-document style, and any other place: The same as the last occurring
-sectioning command.
-
-   Next, you will be asked for the actual name of that section, and
-last you will be asked for a label to be associated with that section.
-The label will be prefixed by the value specified in
-`LaTeX-section-hook'.
-
- - Command: LaTeX-section ARG
-     (`C-c C-s') Insert a sectioning command.
-
-     Determine the type of section to be inserted, by the argument ARG.
-
-        * If ARG is nil or missing, use the current level.
-
-        * If ARG is a list (selected by C-u), go downward one level.
-
-        * If ARG is negative, go up that many levels.
-
-        * If ARG is positive or zero, use absolute level:
-             + 0 : part
-
-             + 1 : chapter
-
-             + 2 : section
-
-             + 3 : subsection
-
-             + 4 : subsubsection
-
-             + 5 : paragraph
-
-             + 6 : subparagraph
-
-     The following variables can be set to customize the function.
-
-    `LaTeX-section-hook'
-          Hooks to be run when inserting a section.
-
-    `LaTeX-section-label'
-          Prefix to all section references.
-
-
-   The precise behavior of `LaTeX-section' is defined by the contents
-of `LaTeX-section-hook'.
-
- - User Option: LaTeX-section-hook
-     List of hooks to run when a new section is inserted.
-
-     The following variables are set before the hooks are run
-
-    LEVEL
-          Numeric section level, default set by prefix arg to
-          `LaTeX-section'.
-
-    NAME
-          Name of the sectioning command, derived from LEVEL.
-
-    TITLE
-          The title of the section, default to an empty string.
-
-    TOC
-          Entry for the table of contents list, default nil.
-
-    DONE-MARK
-          Position of point afterwards, default nil meaning after the
-          inserted text.
-
-     A number of hooks are already defined.  Most likely, you will be
-     able to get the desired functionality by choosing from these hooks.
-
-    `LaTeX-section-heading'
-          Query the user about the name of the sectioning command.
-          Modifies LEVEL and NAME.
-
-    `LaTeX-section-title'
-          Query the user about the title of the section. Modifies TITLE.
-
-    `LaTeX-section-toc'
-          Query the user for the toc entry.  Modifies TOC.
-
-    `LaTeX-section-section'
-          Insert LaTeX section command according to NAME, TITLE, and
-          TOC.  If TOC is nil, no toc entry is inserted.  If TOC or
-          TITLE are empty strings, DONE-MARK will be placed at the
-          point they should be inserted.
-
-    `LaTeX-section-label'
-          Insert a label after the section command.  Controlled by the
-          variable `LaTeX-section-label'.
-
-     To get a full featured `LaTeX-section' command, insert
-
-          (setq LaTeX-section-hook
-                '(LaTeX-section-heading
-                  LaTeX-section-title
-                  LaTeX-section-toc
-                  LaTeX-section-section
-                  LaTeX-section-label))
-
-     in your `.emacs' file.
-
-   The behavior of `LaTeX-section-label' is determined by the variable
-`LaTeX-section-label'.
-
- - User Option: LaTeX-section-label
-     Default prefix when asking for a label.
-
-     If it is a string, it is used unchanged for all kinds of sections.
-     If it is nil, no label is inserted.  If it is a list, the list is
-     searched for a member whose car is equal to the name of the
-     sectioning command being inserted.  The cdr is then used as the
-     prefix.  If the name is not found, or if the cdr is nil, no label
-     is inserted.
-
-     By default, chapters have a prefix of `cha:' while sections and
-     subsections have a prefix of `sec:'.  Labels are not automatically
-     inserted for other types of sections.
-
-
-File: auctex.info,  Node: Environments,  Prev: Sectioning,  Up: Frequently Used Commands
-
-Inserting Environment Templates
-===============================
-
-   A large apparatus is available that supports insertions of
-environments, that is `\begin{}' -- `\end{}' pairs.
-
-   AUC TeX is aware of most of the actual environments available in a
-specific document.  This is achieved by examining your `\documentstyle'
-command, and consulting a precompiled list of environments available in
-a large number of styles.
-
-   You insert an environment with `C-c C-e', and select an environment
-type.  Depending on the environment, AUC TeX may ask more questions
-about the optional parts of the selected environment type.  With `C-u
-C-c C-e' you will change the current environment.
-
- - Command: LaTeX-environment ARG
-     (`C-c C-e')  AUC TeX will prompt you for an environment to insert.
-     At this prompt, you may press <TAB> or <SPC> to complete a
-     partially written name, and/or to get a list of available
-     environments.  After selection of a specific environment AUC TeX
-     may prompt you for further specifications.
-
-     If the optional argument ARG is not-nil (i.e. you have given a
-     prefix argument), the current environment is modified and no new
-     environment is inserted.
-
-   As a default selection, AUC TeX will suggest the environment last
-inserted or, as the first choice the value of the variable
-`LaTeX-default-environment'.
-
- - User Option: LaTeX-default-environment
-     Default environment to insert when invoking `LaTeX-environment'
-     first time.
-
-   If the document is empty, or the cursor is placed at the top of the
-document, AUC TeX will default to insert a `document' environment.
-
-   Most of these are described further in the following sections, and
-you may easily specify more, as described in `Customizing environments'.
-
-* Menu:
-
-* Floats::                      Floats
-* Itemize-like::                Itemize-like
-* Tabular-like::                Tabular-like
-* Customizing environments::    Customizing environments
-
-   You can close the current environment with `C-c ]', but we suggest
-that you use `C-c C-e' to insert complete environments instead.
-
- - Command: LaTeX-close-environment
-     (`C-c ]') Insert an `\end' that matches the current environment.
-
-
-File: auctex.info,  Node: Floats,  Next: Itemize-like,  Prev: Environments,  Up: Environments
-
-Floats
-------
-
-   Figures and tables (i.e., floats) may also be inserted using AUC TeX.
-After choosing either `figure' or `table' in the environment list
-described above, you will be prompted for a number of additional things.
-
-FLOAT-TO
-     This field is the option of float environments that controls how
-     they are placed in the final document.  In LaTeX this is a
-     sequence of the letters `htbp' as described in the LaTeX manual.
-     The value will default to the value of `LaTeX-float'.
-
-CAPTION
-     This is the caption of the float.
-
-LABEL
-     The label of this float.  The label will have a default prefix,
-     which is controlled by the variables `LaTeX-figure-label' and
-     `LaTeX-table-label'.
-
-   Moreover, in the case of a `figure' environment, you will be asked if
-you want to insert a `center' environment inside the figure.
-
- - User Option: LaTeX-float
-     Default placement for floats.
-
- - User Option: LaTeX-figure-label
-     Prefix to use for figure labels.
-
- - User Option: LaTeX-table-label
-     Prefix to use for table labels.
-
-
-File: auctex.info,  Node: Itemize-like,  Next: Tabular-like,  Prev: Floats,  Up: Environments
-
-Itemize-like
-------------
-
-   In an itemize-like environment, nodes (i.e., `\item's) may be
-inserted using `C-c <LFD>'.
-
- - Command: LaTeX-insert-item
-     (`C-c <LFD>') Close the current item, move to the next line and
-     insert an appropriate `\item' for the current environment. That is,
-     `itemize' and `enumerate' will have `\item ' inserted, while
-     `description' will have `\item[]' inserted.
-
-
-File: auctex.info,  Node: Tabular-like,  Next: Customizing environments,  Prev: Itemize-like,  Up: Environments
-
-Tabular-like
-------------
-
-   When inserting Tabular-like environments, that is, `tabular' `array'
-etc., you will be prompted for a template for that environment.
-
-
-File: auctex.info,  Node: Customizing environments,  Prev: Tabular-like,  Up: Environments
-
-Customizing environments
-------------------------
-
-   *Note Adding Environments::, for how to customize the list of known
-environments.
-
-
-File: auctex.info,  Node: Advanced Features,  Next: Formatting,  Prev: Frequently Used Commands,  Up: Top
-
-Advanced Editing Features
-*************************
-
-   The previous chapter described how to write the main body of the text
-easily and with a minimum of errors.  In this chapter we will describe
-some features for entering more specialized sorts of text, and for
-indenting and navigating through the document.
-
-* Menu:
-
-* Mathematics::                 Entering Mathematics
-* Completion::                  Completion
-* Commenting::                  Commenting
-* Marking and formatting::      Marking, Formatting and Indenting
-* Outline::                     Hiding text
-
-
-File: auctex.info,  Node: Mathematics,  Next: Completion,  Prev: Advanced Features,  Up: Advanced Features
-
-Entering Mathematics
-====================
-
-   TeX is written by a mathematician, and has always contained good
-support for formatting mathematical text.  AUC TeX supports this
-tradition, by offering a special minor mode for entering text with many
-mathematic symbols.  You can enter this mode by typing `C-c ~'.
-
- - Command: LaTeX-math-mode
-     (`C-c ~') Toggle LaTeX-math-mode.  This is a minor mode rebinding
-     the key `LaTeX-math-abbrev-prefix' to allow easy typing of
-     mathematical symbols.  ``' will read a character from the keyboard,
-     and insert the symbol as specified in `LaTeX-math-list'.  If given
-     a prefix argument, the symbol will be surrounded by dollar signs.
-
-   You can use another prefix key (instead of ``') by  setting the
-variable LaTeX-math-abbrev-prefix.
-
- - User Option: LaTeX-math-abbrev-prefix
-     A string containing the prefix of `LaTeX-math-mode' commands; This
-     value defaults to ``'.
-
-   The variable `LaTeX-math-list' holds the actual mapping.
-
- - User Option: LaTeX-math-list
-     A list containing key command mappings to use in `LaTeX-math-mode'.
-     The car of each element is the key and the cdr is the macro name.
-
-   The AUC TeX distributions includes a reference card for
-`LaTeX-math-mode' with a list of all math mode commands.
-
-
-File: auctex.info,  Node: Completion,  Next: Commenting,  Prev: Mathematics,  Up: Advanced Features
-
-Completion
-==========
-
-   Emacs lisp programmers probably know the `lisp-complete-symbol'
-command, usually bound to `M-<TAB>'.  Users of the wonderful ispell
-mode know and love the `ispell-complete-word' command from that
-package.  Similarly, AUC TeX has a `TeX-complete-symbol' command,
-usually bound to `M-<TAB>'.  Using `LaTeX-complete-symbol' makes it
-easier to type and remember the names of long LaTeX macros.
-
-   In order to use `TeX-complete-symbol', you should write a backslash
-and the start of the macro.  Typing `M-<TAB>' will now complete as much
-of the macro, as it unambiguously can.  For example, if you type
-``\renewc'' and then ``M-<TAB>', it will expand to ``\renewcommand''.
-
- - Command: TeX-complete-symbol
-     (`M-<TAB>')  Complete TeX symbol before point.
-
-   A more direct way to insert a macro is with `TeX-insert-macro',
-bound to `C-c C-m'.  It has the advantage over completion that it knows
-about the argument of most standard LaTeX macros, and will prompt for
-them.  It also knows about the type of the arguments, so it will for
-example give completion for the argument to `\include'.  Some examples
-are listed below.
-
- - Command: TeX-insert-macro
-     (`C-c C-m') Prompt (with completion) for the name of a TeX macro,
-     and if AUC TeX knows the macro, prompt for each argument.
-
-   As a default selection, AUC TeX will suggest the macro last inserted
-or, as the first choice the value of the variable `TeX-default-macro'.
-
- - User Option: TeX-default-macro
-     Default macro to insert when invoking `TeX-insert-macro' first
-     time.
-
-   A faster alternative is to bind the function `TeX-electric-macro' to
-`\'.  This can be done by setting the variable `TeX-electric-escape'
-
- - User Option: TeX-electric-escape
-     If this is non-nil when AUC TeX is loaded, the TeX escape
-     character `\' will be bound to `TeX-electric-macro'
-
-   The difference between `TeX-insert-macro' and `TeX-electric-macro'
-is that space will complete and exit from the minibuffer in
-`TeX-electric-macro'.  Use <TAB> if you merely want to complete.
-
- - Command: TeX-electric-macro
-     Prompt (with completion) for the name of a TeX macro, and if AUC
-     TeX knows the macro, prompt for each argument.  Space will
-     complete and exit.
-
-   By default AUC TeX will put an empty set braces `{}' after a macro
-with no arguments to stop it from eating the next whitespace.  This can
-be stopped by entering `LaTeX-math-mode', *note Mathematics::., or by
-setting `TeX-insert-braces' to nil
-
- - User Option: TeX-insert-braces
-     If non-nil, append a empty pair of braces after inserting a macro.
-
-   Completions work because AUC TeX can analyze TeX files, and store
-symbols in emacs lisp files for later retrieval.  *Note Automatic::, for
-more information.
-
-   AUC TeX will also make completion for many macro arguments, for
-example existing labels when you enter a `\ref' macro with
-`TeX-insert-macro' or `TeX-electric-macro', and BibTeX entries when you
-enter a `\cite' macro.  For this kind of completion to work, parsing
-must be enabled as described in *note Parsing Files::..  For `\cite'
-you must also make sure that the BibTeX files have been saved at least
-once after you enabled automatic parsing on save, and that the basename
-of the BibTeX file does not conflict with the basename of one of TeX
-files.
-
-
-File: auctex.info,  Node: Commenting,  Next: Marking and formatting,  Prev: Completion,  Up: Advanced Features
-
-Commenting
-==========
-
-   It is often necessary to comment out temporarily a region of TeX or
-LaTeX code.  This can be done with the commands `C-c ;' and `C-c %'.
-`C-c ;' will comment out all lines in the current region, while `C-c %'
-will comment out the current paragraph.  To uncomment, simply type `C-u
-- C-c ;' to uncomment all lines in the region, or `C-u - C-c %'
-uncomment all comment lines around point.
-
-   By default, these commands will insert or remove a single `%'.  To
-insert more than one, give an argument. `C-u 5 C-c %' will add five `%'
-to each line, while `C-u - 5 C-c %' will remove up to 5 `%' from each
-line.
-
- - Command: TeX-comment-region COUNT
-     (`C-c ;') Add or remove `%' from the beginning of each line in the
-     current region, as specified by COUNT.
-
- - Command: TeX-comment-paragraph COUNT
-     (`C-c %') Add or remove `%' from the beginning of each line in the
-     current paragraph, as specified by COUNT.  When removing `%''s the
-     paragraph is considered to consist of all preceding and succeeding
-     lines starting with a `%', until the first non-comment line.
-
-
-File: auctex.info,  Node: Marking and formatting,  Next: Outline,  Prev: Commenting,  Up: Advanced Features
-
-Marking, Formatting and Indenting
-=================================
-
-   AUC TeX contains very advanced handling of indentation and
-reformatting of the LaTeX source.  If you have already tried AUC TeX
-with `auto-fill-mode' enabled, you may have noted that the source is
-automatically indented and formatted as you write it.  More over, AUC
-TeX is able to format sections of text on demand.
-
-   It is important to realize, that AUC TeX comes with `formatting' in
-two fashions.  Either letting TeX format the file, or letting AUC TeX
-make the ASCII document look better.
-
-   Indentation is done by LaTeX environments and by TeX groups, that is
-the body of an environment is indented by the value of
-`LaTeX-indent-level' (default 2).  Also, items of an `itemize-like'
-environment are indented by the value of `LaTeX-item-indent', default
--2.  This indentation makes it easier to see the structure of the
-document, and to catch errors such as a missing close brace.  Thus, the
-indentation is done for precisely the same reasons that you would
-indent ordinary computer programs.
-
-   The following is a short sample of an itemize environment indented by
-AUC TeX.  If more environment are nested, they are indented
-`accumulated' just like most programming languages usually are seen
-indented in nested constructs.
-
-     \begin{itemize}
-     \item Insertion of templates for logical-structural compositions such as
-       environments and sections.
-     \item Hot-keys for easy access to certain often used constructs, e.g.,
-       font changes, accented letters, and mathematical symbols.
-     \item Running application programs (such as \TeX), and then parsing
-       the output so that errors in the document may be located
-       easily.
-     \item Support for multi-file documents.
-     \item Online help for \AllTeX\ error messages.
-     \item Outlining\Dash i.e., manipulating the document as a composition
-       of nested/sequential logical constructs.
-     \item Instant formatting and indentation of the \ascii-document in
-       order to make it easier to read.
-     \item `Completion' (and thereby spell-checking) of partially written
-       control sequences.
-     \end{itemize}
-
-   You can format and indent single lines, paragraphs, environments, or
-sections.
-
-`<TAB>'
-     `LaTeX-indent-line' will indent the current line.
-
-`<LFD>'
-     `reindent-then-newline-and-indent' indents the current line, and
-     then inserts a new line (much like <RET>) and move the cursor to an
-     appropriate position by the left margin.
-
-`M-q'
-     Alias for `C-c C-q C-p'
-
-`C-c C-q C-p'
-     `LaTeX-fill-paragraph' will reformat or `fill' the current
-     paragraph.
-
-`C-c C-q C-e'
-     `LaTeX-fill-environment' will reformat or `fill' the current
-     environment.  This may e.g. be the `document' environment, in
-     which case the entire document will be formatted.
-
-`C-c C-q C-s'
-     `LaTeX-fill-section' will reformat or `fill' the current logical
-     sectional unit.
-
-`M-g'
-     Alias for `C-c C-q C-r'
-
-`C-c C-q C-r'
-     `LaTeX-fill-region' will format or `fill' the current region.
-
-   *Warning:* The formatting cannot handle tabular-like environments.
-Those will be completely messed-up if you try to format them.
-
- - User Option: LaTeX-indent-level
-     Number of spaces to add to the indentation for each `\begin' not
-     matched by a `\end'.
-
- - User Option: LaTeX-item-indent
-     Number of spaces to add to the indentation for `\item''s in list
-     environments.
-
- - User Option: TeX-brace-indent-level
-     Number of spaces to add to the indentation for each `{' not
-     matched by a `}'.
-
-
-File: auctex.info,  Node: Outline,  Prev: Marking and formatting,  Up: Advanced Features
-
-Outlining the Document
-======================
-
-   GNU Emacs earlier than version 19.19 does not have a useful outline
-mode.  If you want to use outlines with old versions of emacs, please
-get the file `outln-18.el' from
-`sunsite.auc.dk:/packages/auctex/outln-18.el'.  It is a port of the
-Emacs 19.19 outline mode to Emacs 18 and Lucid Emacs.
-
-   AUC TeX supports the standard outline minor mode using LaTeX
-sectioning commands as header lines.  *Note Outline Mode:
-(emacs)Outline Mode.  By default `outline-minor-mode' will use the
-prefix key `C-c' which is also used by AUC TeX, so it is suggested that
-you choose another prefix key by inserting
-
-       (setq outline-minor-mode-prefix "\C-c\C-o") ; Or whatever...
-
-   in your `.emacs' file.
-
-   You can add your own headings by setting the variable
-`TeX-outline-extra'.
-
- - Variable: TeX-outline-extra
-     List of extra TeX outline levels.
-
-     Each element is a list with two entries.  The first entry is the
-     regular expression matching a header, and the second is the level
-     of the header.  A `^' is automatically prepended to the regular
-     expressions in the list, so they must match text at the beginning
-     of the line.
-
-     See `LaTeX-section-list' for existing header levels.
-
-   The following example add `\item' and `\bibliography' headers, with
-`\bibliography' at the same outline level as `\section', and `\item'
-being below `\subparagraph'.
-
-     (setq TeX-outline-extra
-           '(("[ \t]*\\\\\\(bib\\)?item\\b" 7)
-             ("\\\\bibliography\\b" 2)))
-
-   You may want to check out the unbundled `out-xtra' package for even
-better outline support.  It is available from your favorite emacs lisp
-archive.
-
-
-File: auctex.info,  Node: Formatting,  Next: Multifile,  Prev: Advanced Features,  Up: Top
-
-Formatting and Printing
-***********************
-
-   The most powerful features of AUC TeX may be those allowing you to
-run (La)TeX and other external commands like BibTeX and `makeindex'
-from within Emacs, viewing and printing the results, and moreover
-allowing you to *debug* your documents.
-
-* Menu:
-
-* Commands::                    Invoking external commands.
-* Debugging::                   Debugging TeX and LaTeX output.
-* Checking::                    Checking the document.
-* Control::                     Controlling the processes.
-
-
-File: auctex.info,  Node: Commands,  Next: Debugging,  Prev: Formatting,  Up: Formatting
-
-Executing Commands
-==================
-
-   Formatting the document with TeX or LaTeX, viewing with a previewer,
-printing the document, running BibTeX, making an index, or checking the
-document with `lacheck' or `chktex' all require running an external
-command.
-
-   There are two ways to run an external command, you can either run it
-on all of the current documents with `TeX-command-master', or on the
-current region with `TeX-command-region'.
-
- - Command: TeX-command-master
-     (`C-c C-c')  Query the user for a command, and run it on the master
-     file associated with the current buffer.  The name of the master
-     file is controlled by the variable `TeX-master'.  The available
-     commands are controlled by the variable `TeX-command-list'.
-
-   *Note Installation:: for a discussion about `TeX-command-list' and
-*Note Multifile:: for a discussion about `TeX-master'.
-
- - Command: TeX-command-region
-     (`C-c C-r') Query the user for a command, and run it on the "region
-     file".  Some commands (typically those invoking TeX or LaTeX) will
-     write the current region into the region file, after extracting the
-     header and tailer from the master file.  If mark is not active,
-     use the old region.  The name of the region file is controlled by
-     the variable `TeX-region'.  The name of the master file is
-     controlled by the variable `TeX-master'.  The header is all text
-     up to the line matching the regular expression `TeX-header-end'.
-     The trailer is all text from the line matching the regular
-     expression `TeX-trailer-start'.  The available commands are
-     controlled by the variable `TeX-command-list'.
-
-   AUC TeX will allow one process for each document, plus one process
-for the region file to be active at the same time.  Thus, if you are
-editing N different documents, you can have N plus one processes
-running at the same time.  If the last process you started was on the
-region, the commands described in *Note Debugging:: and *Note Control::
-will work on that process, otherwise they will work on the process
-associated with the current document.
-
- - User Option: TeX-region
-     The name of the file for temporarily storing the text when
-     formatting the current region.
-
- - User Option: TeX-header-end
-     A regular expression matching the end of the header.  By default,
-     this is `\begin{document}' in LaTeX mode and `%**end of header' in
-     TeX mode.
-
- - User Option: TeX-trailer-start
-     A regular expression matching the start of the trailer.  By
-     default, this is `\end{document}' in LaTeX mode and `\bye' in TeX
-     mode.
-
-   AUC TeX will try to guess what command you want to invoke, but by
-default it will assume that you want to run TeX in TeX mode and LaTeX
-in LaTeX mode.  You can overwrite this by setting the variable
-`TeX-command-default'.
-
- - User Option: TeX-command-default
-     The default command to run in this buffer.  Must be an entry in
-     `TeX-command-list'.
-
-   If you want to overwrite the values of `TeX-header-end',
-`TeX-trailer-start', or `TeX-command-default', you can do that for all
-files by setting them in either `TeX-mode-hook', `plain-TeX-mode-hook',
-or `LaTeX-mode-hook'.  To overwrite them for a single file, define them
-as file variables (*note File Variables: (emacs)File Variables.).  You
-do this by putting special formatted text near the end of the file.
-
-     % Local Variables:
-     % TeX-header-end: "% End-Of-Header"
-     % TeX-trailer-start: "% Start-Of-Trailer"
-     % TeX-command-default: "SliTeX"
-     % End:
-
-   AUC TeX will try to save any buffers related to the document, and
-check if the document needs to be reformatted.  If the variable
-`TeX-save-query' is non-nil, AUC TeX will query before saving each
-file.  By default AUC TeX will check emacs buffers associated with
-files in the current directory, in one of the `TeX-macro-private'
-directories, and in the `TeX-macro-global' directories.  You can change
-this by setting the variable `TeX-check-path'.
-
- - User Option: TeX-check-path
-     Directory path to search for dependencies.
-
-     If nil, just check the current file.  Used when checking if any
-     files have changed.
-
-
-File: auctex.info,  Node: Debugging,  Next: Checking,  Prev: Commands,  Up: Formatting
-
-Catching the errors
-===================
-
-   Once you've formatted your document you may `debug' it, i.e. browse
-through the errors (La)TeX reported.
-
- - Command: TeX-next-error
-     (`C-c `')  Go to the next error reported by TeX.  The view will be
-     split in two, with the cursor placed as close as possible to the
-     error in the top view.  In the bottom view, the error message will
-     be displayed along with some explanatory text.
-
-   Normally AUC TeX will only report real errors, but you may as well
-ask it to report `bad boxes' as well.
-
- - Command: TeX-toggle-debug-bad-boxes
-     (`C-c C-w')  Toggle whether AUC TeX should stop at bad boxes (i.e.
-     over/under full boxes) as well as at normal errors.
-
-   As default, AUC TeX will display that special `*help*' buffer
-containing the error reported by TeX along with the documentation.
-There is however an `expert' option, which allows you to display the
-real TeX output.
-
- - User Option: TeX-display-help
-     When non-nil AUC TeX will automatically display a help text
-     whenever an error is encountered using `TeX-next-error' (`C-c `').
-
-
-File: auctex.info,  Node: Checking,  Next: Control,  Prev: Debugging,  Up: Formatting
-
-Checking for problems
-=====================
-
-   Running TeX or LaTeX will only find regular errors in the document,
-not examples of bad style.  Furthermore, description of the errors may
-often be confusing.  The utility `lacheck' can be used to find style
-errors, such as forgetting to escape the space after an abbreviation or
-using `...' instead of `\ldots' and many other problems like that.  You
-start `lacheck' with `C-c C-c C h e c k <RET>'.  The result will be a
-list of errors in the `*compilation*' buffer.  You can go through the
-errors with `C-x `' (`next-error', *note Compilation:
-(emacs)Compilation.), which will move point to the location of the next
-error.
-
-   Another newer program which can be used to find errors is `chktex'.
-It is much more configurable than `lacheck', but doesn't find all the
-problems `lacheck' does, at least in its default configuration.  You
-must install the programs before using them, and for `chktex' you must
-also modify `TeX-command-list'.  You can get `lacheck' from
-`<URL:ftp://sunsite.auc.dk/pub/text/lacheck/>' or alternatively
-`chktex' from `<URL:ftp://ftp.dante.de/pub/tex/support/chktex/>'.
-Search for `chktex' in `tex.el' to see how to switch between them. They
-are
-
-
-File: auctex.info,  Node: Control,  Prev: Checking,  Up: Formatting
-
-Controlling the output
-======================
-
-   A number of commands are available for controlling the output of an
-application running under AUC TeX
-
- - Command: TeX-kill-job
-     (`C-c C-k')  Kill currently running external application.  This
-     may be either of TeX, LaTeX, previewer BibTeX etc.
-
- - Command: TeX-recenter-output-buffer
-     (`C-c C-l')  Recenter the output buffer so that the bottom line is
-     visible.
-
- - Command: TeX-home-buffer
-     (`C-c ^') Go to the `master' file in the document associated with
-     the current buffer, or if already there, to the file where the
-     current process was started.
-

texi/auctex.info-2

-This is Info file ./auctex.info, produced by Makeinfo version 1.68 from
-the input file auc-tex.texi.
-
-
-File: auctex.info,  Node: Multifile,  Next: Parsing Files,  Prev: Formatting,  Up: Top
-
-Multifile Documents
-*******************
-
-   You may wish spread a document over many files (as you are likely to
-do if there are multiple authors, or if you have not yet discovered the
-power of the outline commands (*note Outline::.)).  This can be done by
-having a "master" file in which you include the various files with the
-TeX macro `\input' or the LaTeX macro `\include'.  These files may also
-include other files themselves.  However, to format the document you
-must run the commands on the top level master file.
-
-   When you, for example, ask AUC TeX to run a command on the master
-file, it has no way of knowing the name of the master file.  By default,
-it will assume that the current file is the master file.  If you insert
-the following in your `.emacs' file AUC TeX will use a more advanced
-algorithm.
-
-     (setq-default TeX-master nil) ; Query for master file.
-
-   If AUC TeX finds the line indicating the end of the header in a
-master file (`TeX-header-end'), it can figure out for itself that this
-is a master file.  Otherwise, it will ask for the name of the master
-file associated with the buffer.  To avoid asking you again, AUC TeX
-will automatically insert the name of the master file as a file
-variable (*note File Variables: (emacs)File Variables.).  You can also
-insert the file variable yourself, by putting the following text at the
-end of your files.
-
-     % Local Variables:
-     % TeX-master: "master"
-     % End:
-
-   You should always set this variable to the name of the top level
-document.  If you always use the same name for your top level
-documents, you can set `TeX-master' in your `.emacs' file.
-
-     (setq-default TeX-master "master") ; All master files called "master".
-
- - User Option: TeX-master
-     The master file associated with the current buffer.  If the file
-     being edited is actually included from another file, then you can
-     tell AUC TeX the name of the master file by setting this variable.
-     If there are multiple levels of nesting, specify the top level
-     file.
-
-     If this variable is `nil', AUC TeX will query you for the name.
-
-     If the variable is `t', then AUC TeX will assume the file is a
-     master file itself.
-
-     If the variable is `shared', then AUC TeX will query for the name,
-     but will not change the file.
-
-     It is suggested that you use the File Variables (*note File
-     Variables: (emacs)File Variables.) to set this variable permanently
-     for each file.
-
- - User Option: TeX-one-master
-     Regular expression matching ordinary TeX files.
-
-     You should set this variable to match the name of all files, for
-     which it is a good idea to append a `TeX-master' file variable
-     entry automatically.  When AUC TeX adds the name of the master
-     file as a file variable, it does not need to ask next time you
-     edit the file.
-
-     If you dislike AUC TeX automatically modifying your files, you can
-     set this variable to `"<none>"'.  By default, AUC TeX will modify
-     any file with an extension of `.tex'.
-
-   AUC TeX keeps track of macros, environments, labels, and style files
-that are used in a given document.  For this to work with multifile
-documents, AUC TeX has to have a place to put the information about the
-files in the document.  This is done by having an `auto' subdirectory
-placed in the directory where your document is located.  Each time you
-save a file, AUC TeX will write information about the file into the
-`auto' directory.  When you load a file, AUC TeX will read the
-information in the `auto' directory about the file you loaded *and the
-master file specified by `TeX-master'*.  Since the master file (perhaps
-indirectly) includes all other files in the document, AUC TeX will get
-information from all files in the document.  This means that you will
-get from each file, for example, completion for all labels defined
-anywhere in the document.
-
-   AUC TeX will create the `auto' directory automatically if
-`TeX-auto-save' is non-nil.  Without it, the files in the document will
-not know anything about each other, except for the name of the master
-file.  *Note Automatic Local::.
-
- - Command: TeX-save-document
-     (`C-c C-d') Save all buffers known to belong to the current
-     document.
-
- - User Option: TeX-save-query
-     If non-nil, then query the user before saving each file with
-     `TeX-save-document'.
-
-
-File: auctex.info,  Node: Parsing Files,  Next: I18n,  Prev: Multifile,  Up: Top
-
-Automatic Parsing of TeX files.
-*******************************
-
-   AUC TeX depends heavily on being able to extract information from the
-buffers by parsing them.  Since parsing the buffer can be somewhat slow,
-the parsing is initially disabled.  You are encouraged to enable them by
-adding the following lines to your `.emacs' file.
-
-     (setq TeX-parse-self t) ; Enable parse on load.
-     (setq TeX-auto-save t) ; Enable parse on save.
-
-   The later command will make AUC TeX store the parsed information in
-an `auto' subdirectory in the directory each time the TeX files are
-stored, *note Automatic Local::..  If AUC TeX finds the pre-parsed
-information when loading a file, it will not need to reparse the buffer.
-The information in the `auto' directory is also useful for multifile
-documents *note Multifile::., since it allows each file to access the
-parsed information from all the other files in the document.  This is
-done by first reading the information from the master file, and then
-recursively the information from each file stored in the master file.
-
-   The variables can also be done on a per file basis, by changing the
-file local variables.
-
-     % Local Variables:
-     % TeX-parse-self: t
-     % TeX-auto-save: t
-     % End:
-
-   Even when you have disabled the automatic parsing, you can force the
-generation of style information by pressing `C-c C-n'.  This is often
-the best choice, as you will be able to decide when it is necessary to
-reparse the file.
-
- - User Option: TeX-parse-self
-     Parse file after loading it if no style hook is found for it.
-
- - User Option: TeX-auto-save
-     Automatically save style information when saving the buffer.
-
- - Command: TeX-normal-mode ARG
-     (`C-c C-n') Remove all information about this buffer, and apply the
-     style hooks again.  Save buffer first including style information.
-     With optional argument, also reload the style hooks.
-
-   When AUC TeX saves your buffer, it will by default convert all tabs
-in your buffer into spaces.  To disable this behaviour, insert the
-following in your `.emacs' file.
-
-     (setq TeX-auto-untabify nil)
-
- - User Option: TeX-auto-untabify
-     Automatically remove all tabs from a file before saving it.
-
-   Instead of disabling the parsing entirely, you can also speed it
-significantly up by limiting the information it will search for (and
-store) when parsing the buffer.  You can do this by setting the default
-values for the buffer local variables `TeX-auto-regexp-list' and
-`TeX-auto-parse-length' in your `.emacs' file.
-
-     ;; Only parse \documentstyle information.
-     (setq-default TeX-auto-regexp-list 'LaTeX-auto-minimal-regexp-list)
-     ;; The documentstyle command is usually near the beginning.
-     (setq-default TeX-auto-parse-length 2000)
-
-   This example will speed the parsing up significantly, but AUC TeX
-will no longer be able to provide completion for labels, macros,
-environments, or bibitems specified in the document, nor will it know
-what files belong to the document.
-
-   These variables can also be specified on a per file basis, by
-changing the file local variables.
-
-     % Local Variables:
-     % TeX-auto-regexp-list: TeX-auto-full-regexp-list
-     % TeX-auto-parse-length: 999999
-     % End:
-
- - User Option: TeX-auto-regexp-list
-     List of regular expressions used for parsing the current file.
-
- - User Option: TeX-auto-parse-length
-     Maximal length of TeX file that will be parsed.
-
-   The pre-specified lists of regexps are defined below.  You can use
-these before loading AUC TeX by quoting them, as in the example above.
-
- - Constant: TeX-auto-empty-regexp-list
-     Parse nothing
-
- - Constant: LaTeX-auto-minimal-regexp-list
-     Only parse documentstyle.
-
- - Constant: LaTeX-auto-label-regexp-list
-     Only parse LaTeX labels.
-
- - Constant: LaTeX-auto-regexp-list
-     Parse common LaTeX commands.
-
- - Constant: plain-TeX-auto-regexp-list
-     Parse common plain TeX commands.
-
- - Constant: TeX-auto-full-regexp-list
-     Parse all TeX and LaTeX commands that AUC TeX can use.
-
-
-File: auctex.info,  Node: I18n,  Next: Automatic,  Prev: Parsing Files,  Up: Top
-
-Internationalization
-********************
-
-   There are several problems associated with editing non-English TeX
-with GNU Emacs.  Modern versions of GNU Emacs and TeX are usable for
-European (Latin, Cyrillic, Greek) based languages, but special versions
-of TeX and Emacs are needed for Korean, Japanese, and Chinese.
-
-* Menu:
-
-* European::                    Using AUC TeX for European languages.
-* Japanese::                    Japanese TeX
-
-
-File: auctex.info,  Node: European,  Next: Japanese,  Prev: I18n,  Up: I18n
-
-Using AUC TeX for European languages.
-=====================================
-
-   First you will need a way to write non-ASCII characters.  You can
-either use macros, or teach TeX about the ISO character sets.  I prefer
-the later, it has the advantage that the usual the standard emacs word
-movement and case change commands will work.
-
-   With LaTeX2e, just add `\usepackage[latin1]{inputenc}'.  With older
-LaTeX versions, try:
-
-`isolatin1.sty'
-     Support for ISO 8859 Latin 1.  Available by ftp from the host
-     ftp.uni-stuttgart.de as
-     `/pub/tex/macros/latex/contrib/misc/isolatin1.sty'.
-
-`latin2.sty'
-     Support for ISO 8859 Latin 2.  Available by ftp from the host
-     ftp.uni-stuttgart.de as `/pub/tex/macros/latex/contrib/latin2.sty'.
-
-   To be able to display non-ASCII characters you will need an
-appropriate font and a version of GNU Emacs capable of displaying 8-bit
-characters.  I believe all emacs versions except plain Emacs 18 are
-capable of this.  For GNU Emacs 19, *note European Display:
-(emacs)European Display..  Other relevant packages are:
-
-`remap'
-     Supports lots of different 7-bit and 8-bit character sets for GNU
-     Emacs 19.  Mostly useful if you have seldomly used character sets,
-     or need to use different character set for keyboard, buffer, and
-     display.  An overkill if you just need ISO 8859 Latin 1.
-     Currently in alpha test, but available by ftp from the host
-     ftp.iesd.auc.dk in `/packages/auctex/'.
-
-     To get dead keys for TeX, install remap and insert the following in
-     your `.emacs' or `site-start.el' file.
-
-          (require 'remap)
-          
-          (defvar all-dead-keys "~'`^"
-            "Dead keys used by remap")
-          
-          (remap-define-map "Dead Key"
-            (apply 'append (mapcar 'remap-dead-map all-dead-keys)))
-          
-          (remap-define-map "TeX Dead Key"
-            (remap-map "Dead Key" (remap-add "Ascii" "~TeX")))
-          
-          (setq remap-setup-alist
-                '(("7-bit"  "Raw"          "L1" "US" "Ctrl" "~TeX")
-                  ("8-bit"  "Raw"          "L1" "L1" "Ctrl" "Raw")
-                  ("Dead/7" "Dead Key"     "L1" "US" "Ctrl" "~TeX")
-                  ("Dead/8" "Dead Key"     "L1" "L1" "Ctrl" "Raw")
-                  ("TeX"    "TeX Dead Key" "L1" "US" "Ctrl" "Raw")))
-
-     You can now enable TeX dead keys with
-          M-x remap-setup-choose RET TeX RET
-
-   A compromise is to use use an European character set when editing the
-file, and convert to TeX macros when reading and writing the files.
-
-`iso-tex.el'
-     This file automatically converts between ISO 8859 Latin 1 encoding
-     and LaTeX encodings of West European characters.  It is available
-     by ftp from aida.intellektik.informatik.th-darmstadt.de in the
-     directory `/pub/gene/Emacs'.
-
-`iso-cvt.el'
-     Much like `iso-tex.el' but is bundled with Emacs 19.23 and later.
-
-`x-compose.el'
-     Similar package bundled with new versions of XEmacs.
-
-   AUC TeX supports style files for several languages.  Each style file
-may modify some AUC TeX to better support the language, and will run a
-language specific hook that will allow you to for example change ispell
-dictionary, or run code to change the keyboard remapping.  The
-following will for example choose a Danish dictionary for documents
-including the `dk.sty' file.  This requires parsing to be enabled,
-*note Parsing Files::..
-
-     (add-hook 'TeX-language-dk-hook
-               (function (lambda () (ispell-change-dictionary "danish"))))
-
-   The following style files are recognized.
-`dk'
-     Runs style hook `TeX-language-dk-hook'.
-
-`dutch'
-     Runs style hook `TeX-language-nl-hook'.
-
-`german'
-     Runs style hook `TeX-language-de-hook'.  Gives  `"' word syntax
-     and makes the <"> key insert a literal `"'.
-
-`plfonts'
-`plhb'
-     Runs style hook `TeX-language-pl-hook'.  Gives  `"' word syntax
-     and makes the <"> key insert a literal `"'.  Pressing <"> twice
-     will insert `"<' or `">' depending on context.
-
-
-File: auctex.info,  Node: Japanese,  Prev: European,  Up: I18n
-
-Japanese TeX
-============
-
-   To write Japanese text with AUC TeX you need to have versions of TeX
-and Emacs that support Japanese.  There exist at least two variants of
-TeX for Japanese text, and AUC TeX can be used with both, as well as
-with the two Japanese-aware Emacses, NEMACS and MULE.
-
-   To use the Japanese TeX variants, simply enter `japanese-tex-mode',
-`japanese-latex-mode', or `japanese-slitex-mode', and everything should
-work.  If not, send mail to Shinji Kobayashi
-(`<koba@flab.fujitsu.co.jp>', who kindly donated the code for
-supporting Japanese in AUC TeX.  None of the primary AUC TeX
-maintainers understand Japanese, so they can not help you.
-
-
-File: auctex.info,  Node: Automatic,  Next: Style Files,  Prev: I18n,  Up: Top
-
-Automatic Customization
-***********************
-
-   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.
-
-* Menu:
-
-* Automatic Global::            Automatic Customization for the Site
-* Automatic Private::           Automatic Customization for a User
-* Automatic Local::             Automatic Customization for a Directory
-
-   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.
-
- - User Option: TeX-style-path
-     List of directories to search for AUC TeX style files.  Each must
-     end with a slash.
-
-   By default, when AUC TeX searches a directory for files, it will
-recursively search through subdirectories.
-
- - User Option: TeX-file-recurse
-     If not nil, search TeX directories recursively.
-
-   By default, AUC TeX will ignore files name `.', `..', `SCCS', `RCS',
-and `CVS'.
-
- - User Option: TeX-ignore-file
-     Regular expression matching file names to ignore.
-
-     These files or directories will not be considered when searching
-     for TeX files in a directory.
-
-
-File: auctex.info,  Node: Automatic Global,  Next: Automatic Private,  Prev: Automatic,  Up: Automatic
-
-Automatic Customization for the Site
-====================================
-
-   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.
-
- - User Option: TeX-macro-global
-     Directories containing the site's TeX style files.
-
- - User Option: TeX-style-global
-     Directory containing hand generated TeX information.  Must end
-     with a slash.
-
-     These correspond to TeX macros shared by all users of a site.
-
- - User Option: TeX-auto-global
-     Directory containing automatically generated information.
-
-     For storing automatic extracted information about the TeX macros
-     shared by all users of a site.
-
-
-File: auctex.info,  Node: Automatic Private,  Next: Automatic Local,  Prev: Automatic Global,  Up: Automatic
-
-Automatic Customization for a User
-==================================
-
-   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.
-
- - User Option: TeX-macro-private
-     Directories where you store your personal TeX macros.  Each must
-     end with a slash.
-
-     This defaults to the directories listed in the `TEXINPUTS' and
-     `BIBINPUTS' environment variables.
-
- - User Option: TeX-auto-private
-     List of directories containing automatically generated information.
-     Must end with a slash.
-
-     These correspond to the personal TeX macros.
-
- - Command: TeX-auto-generate TEX AUTO
-     (`M-x TeX-auto-generate') Generate style hook for TEX and store it
-     in AUTO.  If TEX is a directory, generate style hooks for all
-     files in the directory.
-
- - User Option: TeX-style-private
-     List of directories containing hand generated information.  Must
-     end with a slash.
-
-     These correspond to the personal TeX macros.
-
-
-File: auctex.info,  Node: Automatic Local,  Prev: Automatic Private,  Up: Automatic
-
-Automatic Customization for a Directory
-=======================================
-
-   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.
-
- - User Option: TeX-style-local
-     Directory containing hand generated TeX information.  Must end
-     with a slash.
-
-     These correspond to TeX macros found in the current directory.
-
- - User Option: TeX-auto-local
-     Directory containing automatically generated TeX information.
-     Must end with a slash.
-
-     These correspond to TeX macros found in the current directory.
-
-
-File: auctex.info,  Node: Style Files,  Next: Installation,  Prev: Automatic,  Up: Top
-
-Writing Your own Style Support
-******************************
-
-   *Note Automatic:: for a discussion about automatically generated
-global, private, and local style files.  The hand generated style files
-are equivalent, except that they by default are found in `style'
-directories instead of `auto' directories.
-
-* Menu:
-
-* Simple Style::                A Simple Style File
-* Adding Macros::               Adding Support for Macros
-* Adding Environments::         Adding Support for Environments
-* Adding Other::                Adding Other Information
-* Hacking the Parser::          Automatic Extraction of New Things
-
-   If you write some useful support for a public TeX style file, please
-send it to us.
-
-
-File: auctex.info,  Node: Simple Style,  Next: Adding Macros,  Prev: Style Files,  Up: Style Files
-
-A Simple Style File
-===================
-
-   Here is a simple example of a style file.
-
-     ;;; book.el - Special code for book style.
-     
-     (TeX-add-style-hook "book"
-      (function (lambda () (setq LaTeX-largest-level
-                                 (LaTeX-section-level ("chapter"))))))
-
-   This file specifies that the largest kind of section in a LaTeX
-document using the book document style is chapter.  The interesting
-thing to notice is that the style file defines an (anonymous) function,
-and adds it to the list of loaded style hooks by calling
-`TeX-add-style-hook'.
-
-   The first time the user indirectly tries to access some style
-specific information, such as the largest sectioning command available,
-the style hooks for all files directly or indirectly read by the
-current document is executed.  The actual files will only be evaluated
-once, but the hooks will be called for each buffer using the style file.
-
- - Function: TeX-add-style-hook STYLE HOOK
-     Add HOOK to the list of functions to run when we use the TeX file
-     STYLE.
-
-
-File: auctex.info,  Node: Adding Macros,  Next: Adding Environments,  Prev: Simple Style,  Up: Style Files
-
-Adding Support for Macros
-=========================
-
-   The most common thing to define in a style hook is new symbols (TeX
-macros).  Most likely along with a description of the arguments to the
-function, since the symbol itself can be defined automatically.
-
-   Here are a few examples from `latex.el'.
-
-     (TeX-add-style-hook "latex"
-      (function
-       (lambda ()
-          (TeX-add-symbols
-          '("arabic" TeX-arg-counter)
-          '("label" TeX-arg-define-label)
-          '("ref" TeX-arg-label)
-          '("newcommand" TeX-arg-define-macro [ "Number of arguments" ] t)
-          '("newtheorem" TeX-arg-define-environment
-            [ TeX-arg-environment "Numbered like" ]
-            t [ TeX-arg-counter "Within counter" ])))))
-
- - Function: TeX-add-symbols SYMBOL ...
-     Add each SYMBOL to the list of known symbols.
-
-   Each argument to `TeX-add-symbols' is a list describing one symbol.
-The head of the list is the name of the symbol, the remaining elements
-describe each argument.
-
-   If there are no additional elements, the symbol will be inserted with
-point inside braces.  Otherwise, each argument of this function should
-match an argument of the TeX macro.  What is done depends on the
-argument type.
-
-   If a macro is defined multiple times, AUC TeX will chose the one with
-the longest definition (i.e. the one with the most arguments).
-
-   Thus, to overwrite
-             '("tref" 1) ; one argument
-   you can specify
-             '("tref" TeX-arg-label ignore) ; two arguments
-
-   `ignore' is a function that does not do anything, so when you insert
-a `tref' you will be prompted for a label and no more.
-
-`string'
-     Use the string as a prompt to prompt for the argument.
-
-`number'
-     Insert that many braces, leave point inside the first.
-
-`nil'
-     Insert empty braces.
-
-`t'
-     Insert empty braces, leave point between the braces.
-
-`other symbols'
-     Call the symbol as a function.  You can define your own hook, or
-     use one of the predefined argument hooks.
-
-`list'
-     If the car is a string, insert it as a prompt and the next element
-     as initial input.  Otherwise, call the car of the list with the
-     remaining elements as arguments.
-
-`vector'
-     Optional argument.  If it has more than one element, parse it as a
-     list, otherwise parse the only element as above.  Use square
-     brackets instead of curly braces, and is not inserted on empty user
-     input.
-
-   A lot of argument hooks have already been defined.  The first
-argument to all hooks is a flag indicating if it is an optional
-argument.  It is up to the hook to determine what to do with the
-remaining arguments, if any.  Typically the next argument is used to
-overwrite the default prompt.
-
-`TeX-arg-conditional'
-     Implements if EXPR THEN ELSE.  If EXPR evaluates to true, parse
-     THEN as an argument list, else parse ELSE as an argument list.
-
-`TeX-arg-literal'
-     Insert its arguments into the buffer.  Used for specifying extra
-     syntax for a macro.
-
-`TeX-arg-free'
-     Parse its arguments but use no braces when they are inserted.
-
-`TeX-arg-eval'
-     Evaluate arguments and insert the result in the buffer.
-
-`TeX-arg-file'
-     Prompt for a tex or sty filename, and use it without the
-     extension. Run the file hooks defined for it.
-
-`TeX-arg-label'
-     Prompt for a label completing with known labels.
-
-`TeX-arg-macro'
-     Prompt for a TeX macro with completion.
-
-`TeX-arg-environment'
-     Prompt for a LaTeX environment with completion.
-
-`TeX-arg-cite'
-     Prompt for a BibTeX citation.
-
-`TeX-arg-counter'
-     Prompt for a LaTeX counter.
-
-`TeX-arg-savebox'
-     Prompt for a LaTeX savebox.
-
-`TeX-arg-file'
-     Prompt for a filename in the current directory, and use it without
-     the extension.
-
-`TeX-arg-input-file'
-     Prompt for a filename in the current directory, and use it without
-     the extension.  Run the style hooks for the file.
-
-`TeX-arg-define-label'
-     Prompt for a label completing with known labels.  Add label to
-     list of defined labels.
-
-`TeX-arg-define-macro'
-     Prompt for a TeX macro with completion.  Add macro to list of
-     defined macros.
-
-`TeX-arg-define-environment'
-     Prompt for a LaTeX environment with completion.  Add environment to
-     list of defined environments.
-
-`TeX-arg-define-cite'
-     Prompt for a BibTeX citation.
-
-`TeX-arg-define-counter'
-     Prompt for a LaTeX counter.
-
-`TeX-arg-define-savebox'
-     Prompt for a LaTeX savebox.
-
-`TeX-arg-corner'
-     Prompt for a LaTeX side or corner position with completion.
-
-`TeX-arg-lr'
-     Prompt for a LaTeX side with completion.
-
-`TeX-arg-tb'
-     Prompt for a LaTeX side with completion.
-
-`TeX-arg-pagestyle'
-     Prompt for a LaTeX pagestyle with completion.
-
-`TeX-arg-verb'
-     Prompt for delimiter and text.
-
-`TeX-arg-pair'
-     Insert a pair of numbers, use arguments for prompt. The numbers are
-     surrounded by parentheses and separated with a comma.
-
-`TeX-arg-size'
-     Insert width and height as a pair.  No arguments.
-
-`TeX-arg-coordinate'
-     Insert x and y coordinates as a pair.  No arguments.
-
-   If you add new hooks, you can assume that point is placed directly
-after the previous argument, or after the macro name if this is the
-first argument.  Please leave point located after the argument you are
-inserting.  If you want point to be located somewhere else after all
-hooks have been processed, set the value of `exit-mark'.  It will point
-nowhere, until the argument hook sets it.
-
-
-File: auctex.info,  Node: Adding Environments,  Next: Adding Other,  Prev: Adding Macros,  Up: Style Files
-
-Adding Support for Environments
-===============================
-
-   Adding support for environments is very much like adding support for
-TeX macros, except that each environment normally only takes one
-argument, an environment hook.  The example is again a short version of
-`latex.el'.
-
-     (TeX-add-style-hook "latex"
-      (function
-       (lambda ()
-         (LaTeX-add-environments
-          '("document" LaTeX-env-document)
-          '("enumerate" LaTeX-env-item)
-          '("itemize" LaTeX-env-item)
-          '("list" LaTeX-env-list)))))
-
-   The only hook that is generally useful is `LaTeX-env-item', which is
-used for environments that contain items.  It is completely up to the
-environment hook to insert the environment, but the function
-`LaTeX-insert-environment' may be of some help.  The hook will be
-called with the name of the environment as its first argument, and extra
-arguments can be provided by adding them to a list after the hook.
-
-   For simple environments with arguments, for example defined with
-`\newenvironment', you can make AUC TeX prompt for the arguments by
-giving the prompt strings in the call to `LaTeX-add-environments'.  For
-example, if you have defined a `loop' environment with the three
-arguments FROM, TO, and STEP, you can add support for them in a style
-file.
-
-     %% loop.sty
-     
-     \newenvironment{loop}[3]{...}{...}
-
-     ;; loop.el
-     
-     (TeX-add-style-hook "loop"
-      (function
-       (lambda ()
-         (LaTeX-add-environments
-          '("loop" "From" "To" "Step")))))
-
-   If an environment is defined multiple times, AUC TeX will chose the
-one with the longest definition.  Thus, if you have an enumerate style
-file, and want it to replace the standard LaTeX enumerate hook above,
-you could define an `enumerate.el' file as follows, and place it in the
-appropriate style directory.
-
-     (TeX-add-style-hook "latex"
-      (function
-       (lambda ()
-         (LaTeX-add-environments
-          '("enumerate" LaTeX-env-enumerate foo)))))
-     
-     (defun LaTeX-env-enumerate (environment &optional ignore) ...)
-
-   The symbol `foo' will be passed to `LaTeX-env-enumerate' as the
-second argument, but since we only added it to overwrite the definition
-in `latex.el' it is just ignored.
-
- - Function: LaTeX-add-environments ENV ...
-     Add each ENV to list of loaded environments.
-
- - Function: LaTeX-insert-environment ENV [ EXTRA ]
-     Insert environment of type ENV, with optional argument EXTRA.
-
-
-File: auctex.info,  Node: Adding Other,  Next: Hacking the Parser,  Prev: Adding Environments,  Up: Style Files
-
-Adding Other Information
-========================
-
-   You can also specify bibliographical databases and labels in the
-style file.  This is probably of little use, since this information will
-usually be automatically generated from the TeX file anyway.
-
- - Function: LaTeX-add-bibliographies BIBLIOGRAPHY ...
-     Add each BIBLIOGRAPHY to list of loaded bibliographies.
-
- - Function: LaTeX-add-labels LABEL ...
-     Add each LABEL to the list of known labels.
-
-
-File: auctex.info,  Node: Hacking the Parser,  Prev: Adding Other,  Up: Style Files
-
-Automatic Extraction of New Things
-==================================
-
-   The automatic TeX information extractor works by searching for
-regular expressions in the TeX files, and storing the matched
-information.  You can add support for new constructs to the parser,
-something that is needed when you add new commands to define symbols.
-
-   For example, in the file `macro.tex' I define the following macro.
-
-     \newcommand{\newmacro}[5]{%
-     \def#1{#3\index{#4@#5~cite{#4}}\nocite{#4}}%
-     \def#2{#5\index{#4@#5~cite{#4}}\nocite{#4}}%
-     }
-
-   AUC TeX will automatically figure out that `newmacro' is a macro
-that takes five arguments.  However, it is not smart enough to
-automatically see that each time we use the macro, two new macros are
-defined.  We can specify this information in a style hook file.
-
-     ;;; macro.el - Special code for my own macro file.
-     
-     ;;; Code:
-     
-     (defvar TeX-newmacro-regexp
-       '("\\\\newmacro{\\\\\\([a-zA-Z]+\\)}{\\\\\\([a-zA-Z]+\\)}"
-         (1 2) TeX-auto-multi)
-       "Matches \newmacro definitions.")
-     
-     (defvar TeX-auto-multi nil
-       "Temporary for parsing \\newmacro definitions.")
-     
-     (defun TeX-macro-cleanup ()
-       ;; Move symbols from `TeX-auto-multi' to `TeX-auto-symbol'.
-       (mapcar (function (lambda (list)
-                 (mapcar (function (lambda (symbol)
-                           (setq TeX-auto-symbol
-                                 (cons symbol TeX-auto-symbol))))
-                         list)))
-               TeX-auto-multi))
-     
-     (defun TeX-macro-prepare ()
-       ;; Clear `Tex-auto-multi' before use.
-       (setq TeX-auto-multi nil))
-     
-     (add-hook 'TeX-auto-prepare-hook 'TeX-macro-prepare)
-     (add-hook 'TeX-auto-cleanup-hook 'TeX-macro-cleanup)
-     
-     (TeX-add-style-hook "macro"
-      (function
-       (lambda ()
-         (TeX-auto-add-regexp TeX-newmacro-regexp)
-         (TeX-add-symbols '("newmacro"
-                            TeX-arg-macro
-                            (TeX-arg-macro "Capitalized macro: \\")
-                            t
-                            "BibTeX entry: "
-                            nil)))))
-     
-     ;;; macro.el ends here
-
-   When this file is first loaded, it adds a new entry to
-`TeX-newmacro-regexp', and defines a function to be called before the
-parsing starts, and one to be called after the parsing is done.  It
-also declares a variable to contain the data collected during parsing.
-Finally, it adds a style hook which describes the `newmacro' macro, as
-we have seen it before.
-
-   So the general strategy is: Add a new entry to `TeX-newmacro-regexp'.
-Declare a variable to contain intermediate data during parsing.  Add
-hook to be called before and after parsing.  In this case, the hook
-before parsing just initializes the variable, and the hook after parsing
-collects the data from the variable, and adds them to the list of
-symbols found.
-
- - Variable: TeX-auto-regexp-list
-     List of regular expressions matching TeX macro definitions.
-
-     The list has the following format ((REGEXP MATCH TABLE) ...), that
-     is, each entry is a list with three elements.
-
-     REGEXP.  Regular expression matching the macro we want to parse.
-
-     MATCH.  A number or list of numbers, each representing one
-     parenthesized subexpression matched by REGEXP.
-
-     TABLE.  The symbol table to store the data.  This can be a
-     function, in which case the function is called with the argument
-     MATCH.  Use `TeX-match-buffer' to get match data.  If it is not a
-     function, it is presumed to be the name of a variable containing a
-     list of match data.  The matched data (a string if MATCH is a
-     number, a list of strings if MATCH is a list of numbers) is put in
-     front of the table.
-
- - Variable: TeX-auto-prepare-hook nil
-     List of functions to be called before parsing a TeX file.
-
- - Variable: TeX-auto-cleanup-hook nil
-     List of functions to be called after parsing a TeX file.
-
-
-File: auctex.info,  Node: Installation,  Next: History,  Prev: Style Files,  Up: Top
-
-Installation of AUC TeX
-***********************
-
-Compiling
-=========
-
-   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
-
-     (require 'tex-site)
-
-   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
-
-   to 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)
-
-Customizing
-===========
-
-   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.
-
- - User Option: TeX-lisp-directory
-     The directory where you want to install the AUC TeX lisp files.
-
-   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.
-
- - User Option: TeX-macro-global
-     Directories containing the site's TeX style 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