Release notes for AUCTeX 13.2 with preview-latex ================================================ AUCTeX provides by far the most wide-spread and sophisticated environment for editing LaTeX, TeX, ConTeXt and Texinfo documents with Emacs. 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. 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.[1] AUCTeX needs volunteers in particular for non-programming tasks: documentation writing, tutorials, translations, reference material, sleuth work, testing. New features and fixed bugs in this release ------------------------------------------- AUCTeX no longer refuses to insert dollar sign when you type ‘$’ at point where AUCTeX thinks the current math mode didn’t start with dollar(s). AUCTeX assumes the user knows that it isn’t in math mode actually. You can keep the former behavior by enabling the new customize option ‘TeX-refuse-unmatched-dollar’. AUCTeX supports completion-at-point of macro and environment arguments in LaTeX buffers. The responsible function recognizes the argument position and extracts the corresponding candidates from the variables ‘TeX-symbol-list’ and ‘LaTeX-environment-list’. AUCTeX underlines the argument of macros which produce underlined text in the final product with ‘font-latex-underline-face’. The corresponding keyword class is called ‘underline-command’. See the section for fontification of macros if you dislike this feature and wish to deactivate it. Support for the Sioyek document viewer is added. AUCTeX now requires GNU Emacs 25.1 or higher. AUCTeX tracks the change in Emacs where initial inputs in the minibuffer during queries are getting phased out. Queries for the mandatory arguments of macros and environments are adjusted where applicable. The value which will be used after hitting ‘RET’ without other input is shown in the prompt in parentheses prefixed with ‘default’. For this change the signature of the function ‘TeX-arg-length’ is altered. The old argument list was: (defun TeX-arg-length (optional &optional prompt initial-input definition default) whereas the new one is: (defun TeX-arg-length (optional &optional prompt default initial-input definition) Note the position change of ‘DEFAULT’. Indenting of conditionals is improved. Code inside constructs like ‘\ifx . \else . \fi’ is correctly indented. An interface for style files is also introduced which can add their macros to the indentation engine. Check the file ‘algpseudocode.el’ for an example. You can optionally enable indent inside square brackets ‘[]’ by new user options ‘TeX-indent-open-delimiters’ and ‘TeX-indent-close-delimiters’. Now ‘tex-buf.el’ is merged into ‘tex.el’ and no longer exists. If your personal code has ‘(require 'tex-buf)’, one of the following prescriptions would serve. 1. Remove ‘(require 'tex-buf)’. 2. Replace it with ‘(require 'tex)’. 3. Replace it with ‘(require 'latex)’. When you edit a document divided into multiple files, auto parsed information for all sub files are saved under ‘auto’ subdirectory at master directory when ‘TeX-parse-self’ and ‘TeX-auto-save’ options are enabled. Now you can have support ‘.el’ file saved under ‘auto’ subdirectory of each directory of the sub file when the sub files aren’t located at the master directory. To achieve that, set new user option ‘TeX-auto-save-aggregate’ to ‘nil’. There was another hook where former dynamic free variables could be used. The usage was invalidated at version 13.1, by introduction of lexical binding over AUCTeX. The functions in ‘TeX-region-hook’ could access the free variables ‘master-buffer’ and ‘orig-buffer’. Those are now named ‘TeX-region-master-buffer’ and ‘TeX-region-orig-buffer’, respectively. Requirements ------------ It is required that you use at least GNU Emacs 25.1. The preview-latex subsystem requires image support. You'll also need a working LaTeX installation and Ghostscript. dvipng[2] (version 1.4 or later), a very fast DVI converter, can be used to speed up the conversion. Availability ------------ The easiest way for getting AUCTeX is installing it with GNU ELPA, see for more information. Other download options are available at . At release time, we provide the source tarball. You can also use versions of Emacs that already include AUCTeX or a software package management system for your operating system which provides you with the latest release. 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 3. You'll find more information at the web site of AUCTeX , including its mailing list addresses. Future development and additional information --------------------------------------------- AUCTeX is proceeding as a GNU project with the long-term intent of 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 and ask the rest. Current AUCTeX managers are Arash Esbati, Mosè Giordano, and Tassilo Horn. Everybody is welcome to contribute to the project by reporting bugs and suggesting improvements, but the most effective way of helping AUCTeX development remains volunteering for tasks. The following people contributed to this release series (in alphabetical order): Ivan Andrus, Ralf Angeli, Masayuki Ataka, Mohammad Hossein Bateni, Fabrice Ben Hamouda, Thomas Baumann, Vincent Belaïche, Berend de Boer, Alex Branham, Uwe Brauer, Ken Brown, Joshua Buhl, Jean-François Burnol, Patrice Dumas, Arash Esbati, Werner Fink, Miguel Frasson, Peter S. Galbraith, Mosè Giordano, Andrea Greselin, Patrick Gundlach, Abdul-Lateef Haji-Ali, Jobst Hoffmann, Tassilo Horn, Yvon Hevel, Orlando Iovino, Mads Jensen, Arne Jørgensen, Philip Kaludercic, David Kastrup, Ikumi Keita, Philip Kime, Oleh Krehel, Joost Kremers, Frank Küster, Jan-Åke Larsson, Matthew Leach, Brian Leung, Antoine Levitt, Leo Liu, Vladimir Lomov, Stefan Monnier, Dan Nicolaescu, Piet van Oostrum, Pieter Pareit, Nicolas Richard, Augusto Ritter Stoffel, Florent Rougon, Santiago Saavedra, Davide G. M. Salvetti, Rüdiger Sonderfeld, Holger Sparr, Mike Sperber, Reiner Steib, Christian Schlauer, Shiro Takeda, Mark Trettin (Please accept our apologies if we forgot somebody.) Footnotes: [1] [2] dvipng is available via its project page and from CTAN.