-Release notes for AUCTeX 11.54
+Release notes for AUCTeX 11.84 with preview-latex
AUCTeX provides by far the most wide-spread and sophisticated
environment for editing LaTeX, TeX, ConTeXt and Texinfo documents with
-Emacs or XEmacs. Combined with packages like RefTeX, preview-latex,
-flyspell and others it is pretty much without peer as a comprehensive
-authoring solution for a large variety of operating system platforms
-and TeX distributions. It supports document-dependent completion and
-syntax highlighting, easily accessible menus, jumping to error
-locations in the source file, a number of editing shortcuts, and
-intelligent indentation and filling of the text during entry.
+Emacs or XEmacs. Combined with packages like RefTeX, flyspell and
+others it is pretty much without peer as a comprehensive authoring
+solution for a large variety of operating system platforms and TeX
+distributions. It supports document-dependent completion and syntax
+highlighting, easily accessible menus, jumping to error locations in
+the source file, a number of editing shortcuts, intelligent
+indentation and filling of text during entry, and WYSIWYG previews of
+graphical elements like math formulas right in the Emacs source
+buffer, by virtue of its preview-latex component.
-Interfaces in this release remain a moving target with the
-documentation lagging somewhat. We need volunteers in particular for
-non-programming tasks: documentation writing, tutorials, translations,
-reference material, sleuth work, testing.
+One part of the preview-latex subsystem is the central `preview.sty'
+file that is independently useful for a number of applications and is
+available in unbundled form from CTAN.
+Interfaces and installation procedures in this release remain a moving
+target. If you feel you need to consult third-party installation
+instructions for some reason, be sure that they refer to the same
+version of AUCTeX as you are installing. For installing AUCTeX
+itself, the installation instructions in the AUCTeX package should be
+AUCTeX needs volunteers in particular for non-programming tasks:
+documentation writing, tutorials, translations, reference material,
New features and fixed bugs in this release
-AUCTeX 11.54 is mainly a bug-fix release which takes care of problems
-introduced by new features in the 11.5x series, like the overlays-at
-bug in XEmacs and some performance issues with font locking and
-filling, but also other, long-standing issues, like broken
-fontification of verbatim environments.
+There have been problems with the `-without-texmf-dir' option to
+`configure' when the value of `-with-kpathsea-sep' was set or
+determined for an installation system with a default different from
+that of the runtime system. `with-kpathsea-sep' has been removed; the
+setting is now usually determined at runtime.
-Besides bug-fixes some new features crept in. Font locking can now be
-customized to a great extent and support for the LaTeX packages url,
-listings, jurabib and csquotes was added. The parser now understands
-additional commands common in LaTeX packages and classes, like
+Due to this and other problems, preview-latex in the released XEmacs
+package failed under Windows or with anything except recent 21.5
-Two new sections were added to the manual. The section "Quick Start"
-gives a short introduction for beginners and serves as a starting
-point for diving into the more sophisticated chapters of the manual
-once one is acquainted with the basic workings of AUCTeX. The section
-"Font Locking" describes syntax highlighting in AUCTeX and its
+AUCTeX and preview-latex have been changed in order to accommodate
+file names containing spaces. preview-latex now tolerates bad
+PostScript code polluting the stack (like some Omega fonts).
-IMPORTANT: Many of the new features in the 11.5x series rely on
-special properties in the variable `TeX-command-list' and will not
-work if you customized this variable for a pre-11.5x release of
-AUCTeX. If this is the case for you, please re-initialize the
-variable by erasing the customization, thereby setting the variable to
-the new default, and re-adding your changes afterwards.
+`preview.sty' had in some cases failed to emit PostScript header
+Support for folding of comments was added.
+The `polish' language option of the babel LaTeX package as well as the
+`polski' LaTeX package are now supported. Most notably this means
+that AUCTeX will help to insert quotation marks as defined by
+polish.sty ("`..."') and polski.sty (,,...'').
+There has been quite a number of bug fixes to various features and
+documentation across the board, most critical probably the tool bar.
+IMPORTANT: Many of the new features in the 11.x series rely on special
+properties in the variable `TeX-command-list' and will not work if you
+customized this variable for a pre-11.5x release of AUCTeX. If this
+is the case for you, please re-initialize the variable by erasing the
+customization, thereby setting the variable to the new default, and
+re-adding your changes afterwards.
-It is required that you use at least GNU Emacs 21 or XEmacs 21.4 with
-AUCTeX. Support for Emacs 20 has been dropped in favor of getting
-more important work done. For XEmacs, you need at least version 1.84
-of the xemacs-base package (released on 01/27/2004) or a sumo tarball
-dated 02/02/2004 or newer for compiling AUCTeX because of non-trivial
-changes in easy-mmode.el: please use the XEmacs package system for
-upgrading if necessary. The current developers don't have the
-resources for providing backward compatibility to earlier versions.
+It is required that you use at least GNU Emacs 21 or XEmacs 21.4.
+XEmacs requires at least version 1.84 of the xemacs-base package
+(released on 01/27/2004) or a sumo tarball dated 02/02/2004 or newer
+for compiling AUCTeX: please use the XEmacs package system for
+upgrading if necessary. Warning: release 21.4.16 of XEmacs is
+severely broken. This leads to crashes and hangs; don't use it.
+The preview-latex subsystem requires image support. This is available
+with GNU Emacs 21.3 under the X window system. For Windows, MacOS
+Carbon or native GTK+ toolkit support, a developer version of
+GNU Emacs (to be released as 22.1) is definitely required. A recent
+developer version of GNU Emacs appears like the best choice even on
+X11, however. If you prefer XEmacs-21, it will work in version
+You'll also need a working LaTeX installation and Ghostscript.
+dvipng (version 1.4 or later: teTeX-3.0 works, TeXlive2004 not), a
+very fast dvi converter, can be used to speed up the conversion.
-AUCTeX can be downloaded from <URL:ftp://ftp.gnu.org/pub/gnu/auctex/>.
-There are tarballs, and RPMs for Fedora and SuSE (for Emacs). A
-separate directory contains some stuff from the tarball, such as
-ChangeLog, printable manuals, a reference sheet. The download area is
-mirrored to the directory support/auctex on CTAN. AUCTeX is licensed
-under the GNU General Public License version 2.
+AUCTeX can be downloaded in various formats from
+<URL:ftp://ftp.gnu.org/pub/gnu/auctex/>. At release time, we provide
+the source tarball, source and binary RPMs for Emacs under Fedora and
+SUSE, and a platform-independent XEmacs package file (which you have
+to install yourself using XEmacs' own package system, after using it
+for removing the previous version of AUCTeX). There are also RPMs
+just for installing the LaTeX part of preview (AUCTeX itself does not
+need them, but possibly other applications). The easiest way for
+using AUCTeX, of course, is using versions of Emacs that already
+include AUCTeX (check the footnotes below).
+RPMs with minor version 1 are built from the spec file in the tarball
+which should work on both SUSE as well as Fedora. The source RPMs
+should also work for rebuilding RPMs on other RPM-based distributions.
+(We have only tested SUSE and Fedora, though.)
+The XEmacs package file can be discerned by `pkg' in its name. It is
+usually more recent and functional than what gets distributed from
+XEmacs servers and as part of the Sumo tarball.
+A separate directory for each release contains some stuff from the
+tarball, such as ChangeLog, printable manuals, and a reference sheet.
+The download area is mirrored to the directory support/auctex on CTAN.
+AUCTeX is licensed under the GNU General Public License version 2.
You'll find more information at the web site of AUCTeX
<URL:http://www.gnu.org/software/auctex/>, including its mailing list
Future development and additional information
AUCTeX is proceeding as a GNU project with the long-term intent of
-merging it into Emacs (and merging with preview-latex
-<URL:http://preview-latex.sourceforge.net/> probably next year). For
-that reason, all new contributors need to assign copyright to their
-contributions to the FSF (the usual procedure for Emacs contributors).
-The same holds for past contributors. The principal authors and
-maintainers have already done so, but it would require a diligent and
-diplomatic volunteer to find and ask the rest.
+merging it into Emacs. For that reason, all new contributors need to
+assign copyright to their contributions to the FSF (the usual
+procedure for Emacs contributors). The same holds for past
+contributors. The principal authors and maintainers have already done
+so, but it would require a diligent and diplomatic volunteer to find
-Current project manager is David Kastrup <mailto:firstname.lastname@example.org>. While
-Paypal contributions are appreciated, volunteering for tasks remains
-the most effective way of helping AUCTeX development.
+Current project manager is David Kastrup. Paypal contributions to
+<URL:mailto:email@example.com> would be appreciated in order to
+compensate for time, money and hardware required for presenting AUCTeX
+at conferences. Extensions may be commissioned: enquire on the
+developer list (see above). Other than that, volunteering for tasks
+remains the most effective way of helping AUCTeX development.
The following people contributed to this release series (in
alphabetical order): Ralf Angeli, Masayuki Ataka, Thomas Baumann,
-Berend de Boer, Miguel Frasson, Peter S. Galbraith, Patrick Gundlach,
-Yvon Hevel, David Kastrup, Frank K�ster, Jan-�ke Larsson, Dan
-Nicolaescu, Piet van Oostrum, Davide G. M. Salvetti, Mike Sperber,
-Reiner Steib, Christian Schlauer, Shiro Takeda (Please accept our
-apologies if we forgot somebody.)
+Berend de Boer, Joshua Buhl, Miguel Frasson, Peter S. Galbraith,
+Patrick Gundlach, Yvon Hevel, Arne J�rgensen, David Kastrup, Ikumi
+Keita, Frank K�ster, Jan-�ke Larsson, Dan Nicolaescu, Piet van
+Oostrum, Davide G. M. Salvetti, Mike Sperber, Reiner Steib, Christian
+Schlauer, Shiro Takeda, Mark Trettin (Please accept our apologies if
+ You can get a precompiled version of CVS Emacs for Windows e.g. at
+<URL:http://ourcomments.org/Emacs/EmacsW32.html>. A version with
+AUCTeX preinstalled can be found at
+ Precompiled versions of Emacs for Mac OS X can be found e.g. at
+<URL:http://yaced.sf.net/> (including AUCTeX) and
+ Debian provides precompiled GTK+ Emacs packages in its `unstable'
+distribution (look for `emacs-snapshot-gtk'). Packages for Fedora can
+be found at <URL:http://people.redhat.com/coldwell/bugs/emacs/176171/>.
+ If making use of the precompiled variants is not an option for
+you, instructions for checking out the CVS version straight from the
+GNU's mouth can be found at
+ dvipng is available via its project page
+<URL:http://savannah.nongnu.org/projects/dvipng> and from CTAN.