1 @c This is part of the AUCTeX manual.
2 @c Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
3 @c 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
4 @c See file auctex.texi for copying conditions.
7 @chapheading Changes and New Features in @AUCTeX{}
11 @heading News in 11.86
15 Parsing of @LaTeX{} output was improved. It is now less likely that
16 @AUCTeX{} opens a non-existent file upon calling @code{TeX-next-error};
17 a problem for example encountered when using MiK@TeX{} 2.8. In addition
18 quoted file names as emitted by MiK@TeX{} are now supported.
21 A new framework for the definition and selection of viewers was
22 implemented. If you have customizations regarding viewers you will have
23 to redo them in this new framework or reenable the old one.
25 See the section on viewers in the manual for details.
28 @xref{Starting Viewers}, for details.
32 Comprehensive editing support for PSTricks was added.
35 Support for various @LaTeX{} packages was added, e.g. @samp{tabularx},
36 @samp{CJK}, and @samp{hyperref}.
39 An easy way to switch between @TeX{} engines (PDF@TeX{}, Lua@TeX{},
40 Xe@TeX{}, Omega) was added.
43 Support for Sync@TeX{} was added. This involves the command line
44 options for @LaTeX{} and the viewer.
47 Folding can now be customized to use macro arguments as replacement
51 @samp{preview.sty} now works with Xe@TeX{}.
54 A lot of smaller and larger bugs have been squashed.
57 @heading News in 11.85
62 Font locking has been improved significantly. It is now less prone to
63 color bleeding which could lead to high resource usage. In addition it
64 now includes information about @LaTeX{} macro syntax and can indicate
65 syntactically incorrect macros in @LaTeX{} mode.
68 The license was updated to GPLv3.
71 Support for the nomencl, flashcards and comment @LaTeX{} packages as
72 well as the Icelandic language option of babel were added.
75 Support for folding of math macros was added.
78 Lots of minor bugs in features and documentation fixed.
81 @heading News in 11.84
86 There have been problems with the @samp{-without-texmf-dir} option to
87 @samp{configure} when the value of @samp{-with-kpathsea-sep} was set or
88 determined for an installation system with a default different from that
89 of the runtime system. @code{with-kpathsea-sep} has been removed; the
90 setting is now usually determined at runtime.
92 Due to this and other problems, preview-latex in the released XEmacs
93 package failed under Windows or with anything except recent 21.5
97 @AUCTeX{} and @previewlatex{} have been changed in order to accommodate
98 file names containing spaces. @previewlatex{} now tolerates bad
99 PostScript code polluting the stack (like some Omega fonts).
102 @samp{preview.sty} had in some cases failed to emit PostScript header
106 Support for folding of comments was added.
109 The @code{polish} language option of the babel LaTeX package as well as
110 the polski LaTeX package are now supported. Most notably this means
111 that AUCTeX will help to insert quotation marks as defined by polish.sty
112 (@code{"`..."'}) and polski.sty (@code{,,...''}).
115 The @TeX{} tool bar is now available and enabled by default in plain
118 @xref{Processing Facilities}.
122 Bug fix in the display of math subscripts and superscripts.
125 Bug fix @code{TeX-doc} for Emacs 21.
128 There has been quite a number of other bug fixes to various features and
129 documentation across the board.
133 @heading News in 11.83
137 The new function @code{TeX-doc} provides easy access to documentation
138 about commands and packages or information related to @TeX{} and friends
141 It is accessible with the key binding @kbd{C-c ?} or the
142 @samp{Find Documentation...} entry in the mode menus.
145 @xref{Documentation}.
149 You can now get rid of generated intermediate and output files by means
150 of the new @samp{Clean} and @samp{Clean All} entries in
151 @code{TeX-command-list} accessible with @kbd{C-c C-c} or the Command
158 Support for forward search with PDF files was added. That means you can
159 jump to a place in the output file corresponding to the position in the
162 Currently this only works if you use the pdfsync @LaTeX{} package and
163 xpdf as your PDF viewer. The accuracy is in the range of +/-1 page.
169 Adding support for this feature required the default value of the
170 variable @code{TeX-output-view-style} to be changed. Please make sure
171 you either remove any customizations overriding the new default or
172 incorporate the changes into your customizations if you want to use this
176 @TeX{} error messages of the @code{-file-line-error} kind are now
177 understood in @AUCTeX{} and @previewlatex{} (parsers are still
181 Bug fix in XyM@TeX{} support.
184 The @LaTeX{} tool bar is now enabled by default.
186 @xref{Processing Facilities}.
191 @heading News in 11.82
195 Support for the MinionPro LaTeX package was added.
198 Warnings and underfull/overfull boxes are now being indicated in the
199 echo area after a @LaTeX{} run, if the respective debugging options are
200 activated with @code{TeX-toggle-debug-warnings} (@kbd{C-c C-t C-w}) or
201 @code{TeX-toggle-debug-bad-boxes} (@kbd{C-c C-t C-b}). In this case
202 @code{TeX-next-error} will find these warnings in addition to normal
205 The key binding @kbd{C-c C-w} for @code{TeX-toggle-debug-bad-boxes}
206 (which was renamed from @code{TeX-toggle-debug-boxes}) now is
210 @AUCTeX{} now can automatically insert a pair of braces after typing
211 @key{_} or @key{^} in math constructs if the new variable
212 @code{TeX-electric-sub-and-superscript} is set to a non-nil value.
215 Some language-specific support for French was added. There now is
216 completion support for the commands provided by the @samp{frenchb} (and
217 @samp{francais}) options of the babel @LaTeX{} package and easier input
218 of French quotation marks (@code{\\og ...\\fg}) which can now be
219 inserted by typing @key{"}.
222 Completion support for options of some LaTeX packages was added.
225 @cindex @file{auctex.el}
226 @cindex @file{tex-site.el}
227 Already in version 11.81 the way to activate @AUCTeX{} changed
228 substantially. This should now be done with @code{(load "auctex.el" nil
229 t t)} instead of the former @code{(require 'tex-site)}. Related to this
230 change @file{tex-mik.el} does not load @file{tex-site.el} anymore. That
231 means if you used only @code{(require 'tex-mik)} in order to activate
232 @AUCTeX{}, you have to add @code{(load "auctex.el" nil t t)} before the
235 More detailed information can be found in the installation instructions
239 @xref{Loading the package}.
243 Handling of verbatim constructs was consolidated across AUCTeX. This
244 resulted in the @fontlatex{}-specific variables
245 @code{font-latex-verb-like-commands}, @code{font-latex-verbatim-macros},
246 and @code{font-latex-verbatim-environments} being removed and the more
247 general variables @code{LaTeX-verbatim-macros-with-delims},
248 @code{LaTeX-verbatim-macros-with-braces}, and
249 @code{LaTeX-verbatim-environments} being added.
252 The output of a Bib@TeX{} run is now checked for warnings and errors,
253 which are reported in the echo area.
256 The aliases for @code{font-latex-title-fontify} were removed. Use
257 @code{font-latex-fontify-sectioning} instead.
260 The problem that Japanese macros where broken across lines was fixed.
266 @heading News in 11.81
270 @code{LaTeX-mark-section} now marks subsections of a given section as
271 well. The former behavior is available via the prefix argument.
274 @previewlatex{} which was previously available separately became a
275 subsystem of @AUCTeX{}. There is no documented provision for building
276 or installing @previewlatex{} separately. It is still possible to use
277 and install @AUCTeX{} without @previewlatex{}, however.
280 The installation procedures have been overhauled and now also install
281 startup files as part of the process (those had to be copied manually
282 previously). You are advised to remove previous installations of
283 @AUCTeX{} and @previewlatex{} before starting the installation
284 procedure. A standard installation from an unmodified tarball no longer
285 requires Makeinfo or Perl.
287 Also note that the way @AUCTeX{} is supposed to be activated changed.
288 Instead of @code{(require 'tex-site)} you should now use @code{(load
289 "auctex.el" nil t t)}. While the former method may still work, the new
290 method has the advantage that you can deactivate a preactivated
291 @AUCTeX{} with the statement @code{(unload-feature 'tex-site)} before
292 any of its modes have been used. This may be important especially for
293 site-wide installations.
296 Support for the babel @LaTeX{} package was added.
299 Folding a buffer now ensures that the whole buffer is fontified before
300 the actual folding is carried out. If this results in unbearably long
301 execution times, you can fall back to the old behavior of relying on
302 stealth font locking to do this job in the background by customizing the
303 variable @code{TeX-fold-force-fontify}.
306 Folded content now reveals part of its original text in a tooltip or the
307 echo area when hovering with the mouse pointer over it.
310 The language-specific insertion of quotation marks was generalized. The
311 variables @code{LaTeX-german-open-quote},
312 @code{LaTeX-german-close-quote}, @code{LaTeX-german-quote-after-quote},
313 @code{LaTeX-italian-open-quote}, @code{LaTeX-italian-close-quote}, and
314 @code{LaTeX-italian-quote-after-quote} are now obsolete. If you are not
315 satisfied with the default settings, you should customize
316 @code{TeX-quote-language-alist} instead.
319 Similar to language-specific quote insertion, @AUCTeX{} now helps you
320 with hyphens in different languages as well.
322 @xref{European}, for details.
326 Fill problems in Japanese text introduced in @AUCTeX{} 11.55 were fixed.
327 @AUCTeX{} tries not to break lines between 1-byte and 2-byte chars.
328 These features will work in Chinese text, too.
331 The scaling factor of the fontification of sectioning commands can now
332 be customized using the variable @code{font-latex-fontify-sectioning}.
333 This variable was previously called @code{font-latex-title-fontify}; In
334 this release we provide an alias but this will disappear in one of the
335 the next releases. The faces for the sectioning commands are now called
336 @code{font-latex-sectioning-@var{N}-face} (@var{N}=0@dots{}5) instead of
337 @code{font-latex-title-@var{N}-face} (@var{N}=1@dots{}4). Analogously
338 the names of the variables holding the related keyword lists were
339 changed from @code{font-latex-title-@var{N}-keywords} to
340 @code{font-latex-sectioning-@var{N}-keywords}.
342 @xref{Font Locking}, for details.
344 Make sure to adjust your customizations.
347 Titles in beamer slides marked by the ``\frametitle'' command are know
348 displayed with the new face @code{font-latex-slide-title-face}. You can
349 add macros to be highlighted with this face to
350 @code{font-latex-match-slide-title-keywords}.
353 Of course a lot of bugs have been fixed.
356 @heading News in 11.55
360 A bug was fixed which lead to the insertion of trailing whitespace
361 during filling. In particular extra spaces were added to sentence
362 endings at the end of lines. You can make this whitespace visible by
363 setting the variable @code{show-trailing-whitespace} to @code{t}. If
364 you want to delete all trailing whitespace in a buffer, type @kbd{M-x
365 delete-trailing-whitespace RET}.
368 A bug was fixed which lead to a @samp{*Compile-Log*} buffer popping up
369 when the first @LaTeX{} file was loaded in an Emacs session.
372 On some systems the presence of an outdated Emacspeak package lead to
373 the error message @samp{File mode specification error: (error "Variable
374 binding depth exceeds max-specpdl-size")}. Precautions were added which
375 prevent this error from happening. But nevertheless, it is advised to
376 upgrade or uninstall the outdated Emacspeak package.
379 The value of @code{TeX-macro-global} is not determined during
380 configuration anymore but at load time of @AUCTeX{}. Consequently the
381 associated configuration option @samp{--with-tex-input-dirs} was
385 Support for the @LaTeX{} Japanese classes @samp{jsarticle} and
386 @samp{jsbook} was added.
389 @heading News in 11.54
393 The parser (used e.g. for @code{TeX-auto-generate-global}) was extended
394 to recognize keywords common in @LaTeX{} packages and classes, like
395 ``\DeclareRobustCommand'' or ``\RequirePackage''. Additionally a bug
396 was fixed which led to duplicate entries in @AUCTeX{} style files.
399 Folding can now be done for paragraphs and regions besides single
400 constructs and the whole buffer. With the new @code{TeX-fold-dwim}
401 command content can both be hidden and shown with a single key binding.
402 In course of these changes new key bindings for unfolding commands where
403 introduced. The old bindings are still present but will be phased out
407 Info files of the manual now have a .info extension.
410 There is an experimental tool bar support now. It is not activated by
411 default. If you want to use it, add
413 (add-hook 'LaTeX-mode-hook 'LaTeX-install-toolbar)
418 The manual now contains a new chapter ``Quick Start''. It explains the
419 main features and how to use them, and should be enough for a new user
420 to start using @AUCTeX{}.
423 A new section ``Font Locking'' was added to the manual which explains
424 syntax highlighting in @AUCTeX{} and its customization. Together with
425 the sections related to folding and outlining, the section is part of
426 the new chapter ``Display''.
429 Keywords for syntax highlighting of @LaTeX{} constructs to be typeset in
430 bold, italic or typewriter fonts may now be customized. Besides the
431 built-in classes, new keyword classes may be added by customizing the
432 variable @samp{font-latex-user-keyword-classes}. The customization
433 options can be found in the customization group
434 @samp{font-latex-keywords}.
437 Verbatim content is now displayed with the @samp{fixed-pitch} face. (GNU
441 Syntax highlighting should not spill out of verbatim content
442 anymore. (GNU Emacs only)
445 Verbatim commands like @samp{\verb|...|} will not be broken anymore
449 You can customize the completion for graphic files with
450 @code{LaTeX-includegraphics-read-file}.
453 Support for the @LaTeX{} packages @samp{url}, @samp{listings},
454 @samp{jurabib} and @samp{csquotes} was added with regard to command
455 completion and syntax highlighting.
458 Performance of fontification and filling was improved.
461 Insertion of nodes in Texinfo mode now supports completion of existing
465 Setting the variable @code{LaTeX-float} to @code{nil} now means that you
466 will not be prompted for the float position of figures and tables. You
467 can get the old behaviour of @code{nil} by setting the variable to
468 @code{""}, i.e. an empty string.
470 See also @ref{Floats}.
474 The XEmacs-specific bug concerning @code{overlays-at} was fixed.
480 @heading News in 11.53
484 The @LaTeX{} math menu can include Unicode characters if your Emacs
485 built supports it. See the variable
487 @code{LaTeX-math-menu-unicode}.
490 @code{LaTeX-math-menu-unicode}, @ref{Mathematics}.
494 Bug fixes for XEmacs.
496 @c The following items weren't present at release time of 11.53:
498 Completion for graphic files in the TeX search path has been added.
501 @command{start} is used for the viewer for MiK@TeX{} and fp@TeX{}.
504 The variable @code{TeX-fold-preserve-comments} can now be customized to
505 deactivate folding in comments.
508 @heading News in 11.52
509 @c Not present at release time of 11.52.
513 Installation and menus under XEmacs work again (maybe for the first
517 Fontification of subscripts and superscripts is now disabled when the
518 fontification engine is not able to support it properly.
521 Bug fixes in the build process.
524 @heading News in 11.51
525 @c Not present at release time of 11.51.
529 PDFTeX and Source Special support did not work with ConTeXt,
530 this has been fixed. Similar for Source Special support under Windows.
533 Omega support has been added.
536 Bug fixes in the build process.
539 @code{TeX-fold} now supports folding of environments in Texinfo mode.
542 @heading News in 11.50
546 The use of source specials when processing or viewing the document can
547 now be controlled with the new @code{TeX-source-specials} minor mode
548 which can be toggled via an entry in the Command menu or the key binding
549 @kbd{C-c C-t C-s}. If you have customized the variable
550 @code{TeX-command-list}, you have to re-initialize it for this to work.
551 This means to open a customization buffer for the variable by typing
552 @code{M-x customize-variable RET TeX-command-list RET}, selecting
553 ``Erase Customization'' and do your customization again with the new
557 The content of the command menu now depends on the mode (plain @TeX{},
558 @LaTeX{}, @ConTeXt{} etc.). Any former customization of the variable
559 @code{TeX-command-list} has to be erased. Otherwise the command menu
560 and the customization will not work correctly.
563 Support for hiding and auto-revealing macros, e.g. footnotes or
564 citations, and environments in a buffer was
569 added, @ref{Folding}.
573 You can now control if indentation is done upon typing @key{RET} by
574 customizing the variable
576 @code{TeX-newline-function}.
579 @code{TeX-newline-function}, @ref{Indenting}.
583 Limited support for @code{doc.sty} and @code{ltxdoc.cls} (@samp{dtx}
584 files) was added. The new doc@TeX{} mode provides functionality for
585 editing documentation parts. This includes formatting (indenting and
586 filling), adding and completion of macros and environments while staying
587 in comments as well as syntax highlighting. (Please note that the mode
588 is not finished yet. For example syntax highlighting does not work yet
592 For macro completion in doc@TeX{} mode the @AUCTeX{} style files
593 @file{doc.el}, @file{ltxdoc.el} and @file{ltx-base.el} were included.
594 The latter provides general support for low-level @LaTeX{} macros and
595 may be used with @LaTeX{} class and style files as well. It is
596 currently not loaded automatically for those files.
599 Support for @ConTeXt{} with a separate @ConTeXt{} mode is now included.
600 Macro definitions for completion are available in Dutch and English.
603 The filling and indentation code was overhauled and is now able to
604 format commented parts of the source syntactically correct. Newly
605 available functionality and customization options are explained in the
609 Filling and indentation in XEmacs with preview-latex and activated
610 previews lead to the insertion of whitespace before multi-line previews.
611 @AUCTeX{} now contains facilities to prevent this problem.
614 If @code{TeX-master} is set to @code{t}, @AUCTeX{} will now query for a
615 master file only when a new file is opened. Existing files will be left
616 alone. The new function @code{TeX-master-file-ask} (bound to @kbd{C-c
617 _} is provided for adding the variable manually.
620 Sectioning commands are now shown in a larger font on display devices
621 which support such fontification. The variable
622 @code{font-latex-title-fontify} can be customized to restore the old
623 appearance, i.e. the usage of a different color instead of a change in
627 Support for @code{alphanum.sty}, @code{beamer.cls}, @code{booktabs.sty},
628 @code{captcont.sty}, @code{emp.sty}, @code{paralist.sty},
629 @code{subfigure.sty} and @code{units.sty}/@code{nicefrac.sty} was added.
630 Credits go to the authors mentioned in the respective @AUCTeX{} style
634 Inserting graphics with @kbd{C-c RET \includegraphics RET} was improved.
635 See the variable @code{LaTeX-includegraphics-options-alist}.
636 @c FIXME: Document this in the main part of the manual
639 If @code{LaTeX-default-position} is @code{nil}, don't prompt for
640 position arguments in Tabular-like
645 environments, see @ref{Tabular-like}.
649 Completion for available packages when using @kbd{C-c RET \usepackage
650 RET} was improved on systems using the kpathsea library.
653 The commenting functionality was fixed. The separate functions for
654 commenting and uncommenting were unified in one function for paragraphs
655 and regions respectively which do both.
658 Syntax highlighting can be customized to fontify quotes delimited by
659 either >>German<< or <<French>> quotation marks by changing the variable
660 @code{font-latex-quotes}.
663 Certain @TeX{}/@LaTeX{} keywords for functions, references, variables
664 and warnings will now be fontified specially. You may add your own
665 keywords by customizing the variables
666 @code{font-latex-match-function-keywords},
667 @code{font-latex-match-reference-keywords},
668 @code{font-latex-match-variable-keywords} and
669 @code{font-latex-match-warning-keywords}.
672 If you include the style files @file{german} or @file{ngerman} in a
673 document (directly or via the @samp{babel} package), you should now
674 customize @code{LaTeX-german-open-quote},
675 @code{LaTeX-german-close-quote} and
676 @code{LaTeX-german-quote-after-quote} instead of @code{TeX-open-quote},
677 @code{TeX-close-quote} and @code{TeX-quote-after-quote} if you want to
678 influence the type of quote insertion.
681 Upon viewing an output file, the right viewer and command line options
682 for it are now determined automatically by looking at the extension of
683 the output file and certain options used in the source file. The
684 behavior can be adapted or extended respectively by customizing the
685 variable @code{TeX-output-view-style}.
688 You can control whether @code{TeX-insert-macro} (@kbd{C-c RET}) ask for
689 all optional arguments by customizing the variable
691 @code{TeX-insert-macro-default-style}.
694 @code{TeX-insert-macro-default-style}, @ref{Completion}.
698 @code{TeX-run-discard} is now able to completely detach a process that
702 The build process was enhanced and is now based on @code{autoconf}
703 making installing AUC@TeX{} a mostly automatic process. See
705 the files @file{INSTALL} and @file{INSTALL.windows}
708 @ref{Installation} and @ref{Installation under MS Windows}
713 @heading News in 11.14
717 Many more LaTeX and LaTeX2e commands are supported.
718 Done by Masayuki Ataka <ataka@@milk.freemail.ne.jp>
721 @heading News in 11.12
725 Support for the KOMA-Script classes.
726 Contributed by Mark Trettin <Mark.Trettin@@gmx.de>.
729 @heading News in 11.11
733 Support for @file{prosper.sty}, see @url{http://prosper.sourceforge.net/}.
734 Contributed by Phillip Lord <p.lord@@russet.org.uk>.
737 @heading News in 11.10
741 @code{comment-region} now inserts @t{%%} by default.
742 Suggested by "Davide G. M. Salvetti" <salve@@debian.org>.
745 @heading News in 11.06
749 You can now switch between using the @file{font-latex} (all emacsen),
750 the @file{tex-font} (Emacs 21 only) or no special package for font
751 locking. Customize @code{TeX-install-font-lock} for this.
754 @heading News in 11.04
758 Now use @t{-t landscape} by default when landscape option appears.
759 Suggested by Erik Frisk <frisk@@isy.liu.se>.
762 @heading News in 11.03
766 Use @file{tex-fptex.el} for fpTeX support.
767 Contributed by Fabrice Popineau <Fabrice.Popineau@@supelec.fr>.
770 @heading News in 11.02
774 New user option @code{LaTeX-top-caption-list} specifies environments
775 where the caption should go at top.
776 Contributed by ataka@@milk.freemail.ne.jp (Masayuki Ataka).
779 Allow explicit dimensions in @file{graphicx.sty}.
780 Contributed by ataka@@milk.freemail.ne.jp (Masayuki Ataka).
783 Limited support for @file{verbatim.sty}.
784 Contributed by ataka@@milk.freemail.ne.jp (Masayuki Ataka).
787 Better support for asmmath items.
788 Patch by ataka@@milk.freemail.ne.jp (Masayuki Ataka).
791 More accurate error parsing.
792 Added by David Kastrup <David.Kastrup@@t-online.de>.
795 @heading News in 11.01