[elpa] externals/auctex c892ed8 1/7: Prepare for upcoming release

[Tassilo Horn]

branch: externals/auctex
commit c892ed81857e0bd74085cc392c52839f7362ff87
Author: Mosè Giordano <mose@gnu.org>
Commit: Mosè Giordano <mose@gnu.org>

    Prepare for upcoming release
---
 RELEASE           | 125 +++++++++++++++++++++++-------------------------------
 configure.ac      |   2 +-
 doc/changes.texi  |   3 ++
 doc/tex-ref.tex   |   8 ++--
 latex/preview.dtx |   4 +-
 5 files changed, 63 insertions(+), 79 deletions(-)

diff --git a/RELEASE b/RELEASE
index 7ad98bf..1b194d2 100644
--- a/RELEASE
+++ b/RELEASE
@@ -1,4 +1,4 @@
-Release notes for AUCTeX 12.2 with preview-latex
+Release notes for AUCTeX 12.3 with preview-latex
 ================================================
 
 AUCTeX provides by far the most wide-spread and sophisticated
@@ -24,73 +24,53 @@ sleuth work, testing.
 New features and fixed bugs in this release
 -------------------------------------------
 
-AUCTeX reflects the changes in LaTeX2e 2019-10-01 release.
-'filecontents' environment now takes an optional argument and can
-be used anywhere in a document.  The macros '\Ref' and
-'\labelformat' are moved from 'varioref.sty' to LaTeX kernel.
-amsmath has a new macro '\overunderset'.
-
-A new method is implemented in preview-latex to adjust the
-foreground colors of generated images to those of Emacs, when the
-LaTeX command produces PDF.  The traditional method became invalid
-because of the change introduced in Ghostscript 9.27.
-Unfortunately, the new method doesn't work due to a bug in
-Ghostscript 9.27 and is valid only for Ghostscript > 9.27.  There
-is also a fallback method for gs 9.27 users which displays plain
-"black on white" images.  For successful function of preview-latex,
-the users are encouraged to set up the new user option
-'preview-pdf-color-adjust-method' to choose appropriate option
-among the three: new, traditional and fallback method.
-
-AUCTeX has support for the Flymake package in Emacs 26 or newer.
-To enable, call 'M-x flymake-mode RET' or add this to your '.emacs'
-file:
-     (add-hook 'LaTeX-mode-hook #'flymake-mode)
-
-The way the option 'TeX-record-buffer' is used was corrected.  It
-was used in just the opposite way as the document says.  Erase the
-customization if you have customized this option since it now acts
-in reverse to your expectation.
-
-A former customize option 'japanese-TeX-command-list' is removed.
-Use 'japanese-TeX-engine-default', or if it's really necessary,
-customize 'TeX-command-list' directly if the task which the option
-used to carry is required.
-
-Support for standard LaTeX without e-TeX extension is now very
-limited.  It doesn't work if raw TeX code is put on the command
-line to invoke latex command.  It also fails for region compilation
-('C-c C-r' and so on) with documents of non-ascii file name.  In
-addition, it no longer works with preview-latex.  We consider this
-incompatibility is permissible because e-TeX extension is enabled
-for standard LaTeX by default long ago.  LaTeX variants such as
-XeLaTeX and LuaLaTeX are not affected.
-
-Key binds in Texinfo mode are improved.  Typing '$', '^', '_' and
-'\' now just self-inserts without pointless side effects in Texinfo
-mode.
-
-In addition, the option 'TeX-electric-escape' is now effective in
-Texinfo mode.  When it is enabled, typing '@' will invoke
-'TeX-electric-macro' offering completion in similar style with
-other TeX modes of AUCTeX.
-
-Fontification support for 'biblatex' package is improved and
-updated to macros provided by package version 3.12.  For qualified
-lists, at least 2 mandatory arguments are fontified.
-
-Support for column specifiers 'w' and 'W' provided by 'array'
-package is added to 'array.el'.  The correct counting of columns
-only works when the 'align' parameter is enclosed in braces, e.g.,
-'w{l}{3cm}'.  The short version 'wl{3cm}' is not supported.
-
-Entries for 'PDF Tools' are added in
-'TeX-view-program-list-builtin' for Windows and macOS. This viewer
-can be configured under these operating systems with an entry like
-this in an init file:
-     (setq TeX-view-program-selection '((output-pdf "PDF Tools")))
-
-Several other bugs were fixed, many minor features were added.
+Support for 'PSTricks' is now PDF-oriented.  AUCTeX no longer turns
+off PDF mode for 'PSTricks' documents even without 'pst-pdf'.  It
+now sets up 'TeX-PDF-from-DVI' option so that PDF output is
+generated when 'TeX-PDF-mode' is enabled (default).  Users who want
+DVI output should disable PDF mode explicitly by file local
+variable, or customize 'TeX-PDF-mode' to 'nil'.
+
+The function 'font-latex-update-font-lock' has been obsoleted in
+order to fix 'bug#37945'.  That function was used by several style
+files in order to refresh fontification after adding new symbols or
+verbatim constructs.  It is better to call 'font-lock-flush' in the
+former case and 'font-latex-set-syntactic-keywords' in the latter
+case.  The function 'font-latex-update-font-lock' still exists as a
+no-op which only shows a warning explaining how to update font-lock
+as mentioned above.
+
+Math expression highlighting was improved.  Highlighting for
+documents with a lot of inline math expressions '$...$' won't get
+scrambled now ('bug#33139').
+
+There is small incompatibility due to this fix.  When odd number of
+dollar signs are in a comment, the subsequent lines are highlighted
+as math until another '$' appears.  You can insert a commented
+dollar sign ('%$') at the next suitable end of line as a
+workaround.
+
+In addition, it is no longer recommended to customize
+'font-latex-math-environments'.  Use 'texmathp-tex-commands'
+instead.
+
+AUCTeX tracks changes in LaTeX2e 2020-02-02 release.  AUCTeX
+supports the improvements to LaTeX font selection mechanism (NFSS).
+New macros like '\textsw' or '\textulc' are added to font insertion
+keyboard commands.  See the section for inserting font specifiers
+for details.  Further, the entries in the menu LaTeX, Insert Font
+are reorganized and adjusted accordingly.
+
+Macros previously provided by 'textcomp.sty' are now part of LaTeX
+kernel.  AUCTeX tracks this change as well and support for the new
+macro '\legacyoldstylenums' is added.
+
+Insertion of environments in LaTeX documents (i.e.  'C-c C-e') was
+improved.  The former code had a few bugs, which sometimes resulted
+in either spurious empty line or spurious comment prefix, or both,
+especially when the region is active.  Those bugs are now fixed.
+
+More bugs fixed, other minor features implemented.
 
 Requirements
 ------------
@@ -149,10 +129,11 @@ Jobst Hoffmann, Tassilo Horn, Yvon Hevel, Orlando Iovino, 
Mads Jensen,
 Arne J�rgensen, David Kastrup, Ikumi Keita, Philip Kime, Oleh Krehel,
 Joost Kremers, Frank K�ster, Jan-�ke Larsson, Matthew Leach, Antoine
 Levitt, Leo Liu, Vladimir Lomov, Stefan Monnier, Dan Nicolaescu, Piet
-van Oostrum, 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.)
+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:
 
diff --git a/configure.ac b/configure.ac
index a31b049..b102be4 100644
--- a/configure.ac
+++ b/configure.ac
@@ -21,7 +21,7 @@ dnl along with AUCTeX; see the file COPYING.  If not, write 
to the Free
 dnl Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 dnl MA 02110-1301, USA.
 
-AC_INIT(auctex,12.2,bug-auctex@gnu.org)
+AC_INIT(auctex,12.3,bug-auctex@gnu.org)
 
 AC_CHECK_PROGS_REQUIRED(MAKECMD, make, [make not found, aborting!])
 AC_PROG_MAKE_SET
diff --git a/doc/changes.texi b/doc/changes.texi
index 942daa4..febe9ce 100644
--- a/doc/changes.texi
+++ b/doc/changes.texi
@@ -73,6 +73,9 @@ Insertion of environments in @LaTeX{} documents (i.e. 
@kbd{C-c C-e}) was
 improved.  The former code had a few bugs, which sometimes resulted in
 either spurious empty line or spurious comment prefix, or both,
 especially when the region is active.  Those bugs are now fixed.
+
+@item
+More bugs fixed, other minor features implemented.
 @end itemize
 
 @heading News in 12.2
diff --git a/doc/tex-ref.tex b/doc/tex-ref.tex
index b022df9..c16f312 100644
--- a/doc/tex-ref.tex
+++ b/doc/tex-ref.tex
@@ -1,4 +1,4 @@
-% Reference Card for AUCTeX version 12.1
+% Reference Card for AUCTeX version 12.3
 %**start of header
 \newcount\columnsperpage
 
@@ -42,8 +42,8 @@
 % Paul Rubin, Bob Chassell, Len Tower, and Richard Mlynarik
 % for creating the GNU Emacs Reference Card from which this was mutated
 
-\def\versionnumber{12.2}
-\def\year{2019}
+\def\versionnumber{12.3}
+\def\year{2020}
 \def\version{October \year\ v\versionnumber}
 
 \def\shortcopyrightnotice{\vskip 1ex plus 2 fill
@@ -53,7 +53,7 @@
 \def\copyrightnotice{%
 \vskip 1ex plus 2 fill\begingroup\small
 \centerline{Copyright \copyright\ 1987, 1992-1994, 2004-2006, 2008, 2010,}
-\centerline{2012, 2014-2017, 2019 Free Software Foundation, Inc.}
+\centerline{2012, 2014-2017, 2019-2020 Free Software Foundation, Inc.}
 \centerline{for AUC\TeX\ version \versionnumber}
 
 Permission is granted to make and distribute copies of
diff --git a/latex/preview.dtx b/latex/preview.dtx
index 2563bcd..080996b 100644
--- a/latex/preview.dtx
+++ b/latex/preview.dtx
@@ -3,7 +3,7 @@
 %%    Developed as part of AUCTeX <URL:https://www.gnu.org/software/auctex/>.
 %
 %     Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006,
-%                   2010, 2017-2019 Free Software Foundation
+%                   2010, 2017-2020 Free Software Foundation
 %
 %     This program is free software; you can redistribute it and/or modify
 %     it under the terms of the GNU General Public License as published by
@@ -439,7 +439,7 @@
 \NeedsTeXFormat{LaTeX2e} \def\reserved@a #1#2$#3:
 #4${\xdef#1{\reserved@c #2#4 $}} \def\reserved@c #1 #2${#1}
 \begingroup \catcode`\_=12
-\reserved@a\pr@version $Name: release_12_2 $ \ifx\pr@version\@empty
+\reserved@a\pr@version $Name: release_12_3 $ \ifx\pr@version\@empty
 \reserved@a\pr@version CVS-$Revision: 1.126 $ \endgroup \else
   \def\next release_{} \lccode`\_=`.
   \edef\next{\lowercase{\endgroup