@c This is part of the AUCTeX Manual.
@c Copyright (C) 2004-2014 Free Software Foundation, Inc.
@c See the file auctex.texi for copying conditions.
@ifset rawfile
@include macros.texi
@chapheading Frequently Asked Questions about @AUCTeX{}
@end ifset

@c We should switch to sectioning commands instead of items when this
@c list grows.  Keep in mind to formulate short questions because
@c section headings will not be broken in contrast to items.
@enumerate
@item
Something is not working correctly.  What should I do?

Well, you might have guessed it, the first place to look is in the
available documentation packaged with @AUCTeX{}.  This could be the
release notes (in the @file{RELEASE} file) or the news section of the
manual in case you are experiencing problems after an upgrade, the
@file{INSTALL} file in case you are having problems with the
installation, the section about bugs in the manual in case you
encountered a bug or the relevant sections in the manual for other
related problems.

If this did not help, you can send a bug report to the @AUCTeX{} bug
reporting list by using the command @kbd{M-x TeX-submit-bug-report RET}.
But before you do this, you can try to get more information about the
problem at hand which might also help you locate the cause of the error
yourself.

First, you can try to generate a so-called backtrace which shows the
functions involved in a program error.  In order to do this, start Emacs
with the command line @samp{emacs --debug-init} and/or put the line

@lisp
(setq debug-on-error t)
@end lisp

as the first line into your init file.  XEmacs users might want to add
@code{(setq stack-trace-on-error t)} as well.  After Emacs has started,
you can load a file which triggers the error and a new window should pop
up showing the backtrace.  If you get such a backtrace, please include
it in the bug report.

Second, you can try to figure out if something in your personal or site
configuration triggers the error by starting Emacs without such
customizations.  You can do this by invoking Emacs with the command line
@samp{emacs -q -no-site-file -l auctex}.  The @samp{-l} option
@samp{auctex.el} which you normally do in your init file.  After you
have started Emacs like this, you can load the file triggering the
error.  If everything is working now, you know that you have to search
either in the site configuration file or your personal init file for
statements related to the problem.

@item
What versions of Emacs and XEmacs are supported?

@AUCTeX{} was tested with @w{Emacs 21} and @w{XEmacs 21.4.15}.  Older
versions may work but are unsupported.  Older versions of XEmacs might
possibly made to work by updating the @file{xemacs-base} package through
the XEmacs package system.  If you are looking for a recommendation, it
would appear that the smoothest working platform on all operating
systems at the current point of time would be @w{Emacs 22} or higher.

Our success with XEmacs has been less than convincing.  Code for core
functionality like formatting and syntax highlighting tends to be
different and often older than even @w{Emacs 21.4}, and Unicode support
as delivered is problematic at best, missing on Windows.  Both @AUCTeX{}
and XEmacs developers don't hear much from active users of the
combination.  Partly for that reason, problems tend to go unnoticed for
long amounts of time and are often found, if at all, after releases.  No
experiences or recommendations can be given for beta or developer
versions of XEmacs.

@item
What should I do when @code{./configure} does not find programs like latex?

This is problem often encountered on Windows.  Make sure that the
@env{PATH} environment variable includes the directories containing the
relevant programs, as described in
@ifset rawfile
the file @file{INSTALL.windows}
@end ifset
@ifclear rawfile
@ref{Installation under MS Windows,,,auctex,the @AUCTeX{} manual}.
@end ifclear

@item
Why doesn't the completion, style file, or multi-file stuff work?

It must be enabled first, insert this in your init file:

@lisp
(setq-default TeX-master nil)
(setq TeX-parse-self t)
(setq TeX-auto-save t)
@end lisp

Read also the chapters about parsing and multifile documents in the
manual.

@item
Why doesn't @code{TeX-save-document} work?

@code{TeX-check-path} has to contain "./" somewhere.

@item
Why is the information in @file{foo.tex} forgotten when I save
@file{foo.bib}?

For various reasons, @AUCTeX{} ignores the extension when it stores
information about a file, so you should use unique base names for your
files.  E.g. rename @file{foo.bib} to @file{foob.bib}.

@item
Why doesn't @AUCTeX{} signal when processing a document is done?

If the message in the minibuffer stays "Type `C-c C-l' to display
results of compilation.", you probably have a misconfiguration in your
init file (@file{.emacs}, @file{init.el} or similar).  To track this
down either search in the @samp{*Messages*} buffer for an error message
or put @code{(setq debug-on-error t)} as the first line into your init
file, restart Emacs and open a @LaTeX{} file.  Emacs will complain
loudly by opening a debugging buffer as soon as an error occurs.  The
information in the debugging buffer can help you find the cause of the
error in your init file.

@item
Why does @code{TeX-next-error} (@kbd{C-c `}) fail?

If @code{TeX-file-line-error} is set to nil (not the default), these
sort of failures might be related to the the fact that when writing the
log file, @TeX{} puts information related to a file, including error
messages, between a pair of parentheses.  In this scenario @AUCTeX{}
determines the file where the error happened by parsing the log file and
counting the parentheses.  This can fail when there are other,
unbalanced parentheses present.

Activating so-called file:line:error messages for the log file usually
solves this issue, as these kind of messages are are easier to parse;
however, they may lack some details.  Activation can be done either in
the configuration of your @TeX{} system (consult its manual to see where
this is) or by simply keeping the variable @code{TeX-file-line-error} to
the default value of non-nil.

@item
What does AUC stand for?

@AUCTeX{} came into being at Aalborg University in Denmark.  Back then
the Danish name of the university was Aalborg Universitetscenter; AUC
for short.

@end enumerate
