This is the README file for the AUCTeX distribution.

     Copyright (C) 2008 Free Software Foundation, Inc.

     Copying and distribution of this file, with or without
     modification, are permitted in any medium without royalty provided
     the copyright notice and this notice are preserved.

Introduction to AUCTeX
**********************

This file gives a brief overview of what AUCTeX is.  It is *not* an
attempt to document AUCTeX.  Real documentation for AUCTeX is available
in the manual, which should be available as an info file after
installation.

AUCTeX is a comprehensive customizable integrated environment for
writing input files for TeX, LaTeX, ConTeXt, Texinfo, and docTeX using
Emacs or XEmacs.

It supports you in the insertion of macros, environments, and sectioning
commands by providing completion alternatives and prompting for
parameters.  It automatically indents your text as you type it and lets
you format a whole file at once.  The outlining and folding facilities
provide you with a focused and clean view of your text.

AUCTeX lets you process your source files by running TeX and related
tools (such as output filters, post processors for generating indices
and bibliographies, and viewers) from inside Emacs.  AUCTeX 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.

One component of AUCTeX that LaTeX users will find attractive is
preview-latex, a combination of folding and in-source previewing that
provides true "What You See Is What You Get" experience in your
sourcebuffer, while letting you retain full control.  For more
information, see further below.

More detailed information about the features and usage of AUCTeX can be
found in the AUCTeX manual.  You can access it from within Emacs by
typing ‘C-h i d m auctex <RET>’.  If you prefer the standalone info
reader, issue the command ‘info auctex’ in a terminal.

AUCTeX is written entirely in Emacs Lisp, and hence you can easily add
new features for your own needs.  It is a GNU project and distributed
under the 'GNU General Public License Version 3'.

The most recent version is always available at
<http://ftp.gnu.org/pub/gnu/auctex/>.

WWW users may want to check out the AUCTeX page at
<http://www.gnu.org/software/auctex/>.

For comprehensive information about how to install AUCTeX read the file
‘INSTALL’ or ‘INSTALL.windows’, respectively.

If you are considering upgrading AUCTeX, the recent changes are
described in the ‘CHANGES’ file.

If you want to discuss AUCTeX with other users or its developers, there
are several mailing lists you can use.

Send a mail with the subject "subscribe" to <auctex-request@gnu.org> in
order to join the general discussion list for AUCTeX.  Articles should
be sent to <auctex@gnu.org>.  In a similar way, you can subscribe to the
<info-auctex@gnu.org> list for just getting important announcements
about AUCTeX.  The list <bug-auctex@gnu.org> is for bug reports which
you should usually file with the ‘M-x TeX-submit-bug-report <RET>’
command.  If you want to address the developers of AUCTeX themselves
with technical issues, they can be found on the discussion list
<auctex-devel@gnu.org>.
