Go to the first, previous, next, last section, table of contents.
You may wish to 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 (see section Outlining the Document)). 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 (see section `File Variables' in The Emacs Editor). 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".
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 (see section `File Variables' in The Emacs Editor) to set this variable permanently for each file.
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
try
automatic
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.
When invoking one 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 find 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.
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.
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/'
There has been establis