[elpa] externals/auctex e118a53 64/71: ; Prepare for upcoming release

[Tassilo Horn]

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

    ; Prepare for upcoming release
---
 RELEASE           | 176 ++++++++++++++++++++++++++++++++++++++----------------
 configure.ac      |   2 +-
 doc/changes.texi  |   3 +
 doc/tex-ref.tex   |  10 ++--
 latex/preview.dtx |   4 +-
 5 files changed, 134 insertions(+), 61 deletions(-)

diff --git a/RELEASE b/RELEASE
index daa276a..954fe73 100644
--- a/RELEASE
+++ b/RELEASE
@@ -1,4 +1,4 @@
-Release notes for AUCTeX 12.3 with preview-latex
+Release notes for AUCTeX 13.1 with preview-latex
 ================================================
 
 AUCTeX provides by far the most wide-spread and sophisticated
@@ -24,53 +24,122 @@ sleuth work, testing.
 New features and fixed bugs in this release
 -------------------------------------------
 
-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.
+Now two commands 'Texindex' and 'Texi2dvi' are available when you
+type 'C-c C-c' in Texinfo mode.  The command 'Texindex' runs
+'texindex' on index files and 'Texi2dvi' runs 'pdftexi2dvi' or
+'texi2dvi' according to the value of 'TeX-PDF-mode'.
+
+So you can typeset Texinfo documents into PDF or DVI format from
+within AUCTeX.
+
+AUCTeX's own help messages for LaTeX errors are now shown only for
+LaTeX runs.  AUCTeX shows raw error/warning messages found in
+'.log' files for runs of formats other than LaTeX, such as plain
+TeX, ConTeXt and Texinfo, as it does even for LaTeX runs when it
+can't find a matching entry in its own help message catalogue.
+
+Due to this change, customize option 'TeX-error-description-list'
+can no longer have a fallback entry that matches any error.  If
+your customized value includes such entry, typically '(".*" . "No
+help available")', please remove it.
+
+Two functions 'TeX-split-string' and 'TeX-assoc' are now obsolete
+and will be removed in future release.  If your personal code uses
+these functions, use 'split-string' and 'assoc-string' instead.
+
+The function 'TeX-read-key-val' now accepts a function call as
+second argument.  This change should help AUCTeX style writers who
+use 'TeX-arg-key-val' and have to deal with dynamic key-values.
+Example of usage:
+     (TeX-add-style-hook "foo"
+      (lambda ()
+        (TeX-add-symbols
+         '("bar" (TeX-arg-key-val (function-returning-key-val))))))
+
+Since AUCTeX 12.2, 'C-x C-w' accidentally disabled the parse on
+save in that buffer, even when you enabled 'TeX-auto-save' option.
+This bug was fixed.
+
+AUCTeX now requires GNU Emacs 24.3 or higher.
+
+Old implementations for viewers were discarded, as announced long
+before.  The variables 'TeX-output-view-style' and 'TeX-view-style'
+have no effect now.  The former placeholders '%v' and '%vv' in
+'TeX-command-list' are ignored.
+
+AUCTeX now uses lexical binding which has been introduced in Emacs
+24.  This change should have no user-visible effect and require no
+manual adaptions except in the following cases.
+
+   - Entries added to the customization variable 'TeX-expand-list'
+     also had access to variables 'command' and 'pos'.  Those are
+     now properly declared and named 'TeX-expand-command' and
+     'TeX-expand-pos'.
+
+   - Entries added to the customization variable 'TeX-expand-list'
+     had access to a variable 'file' which was bound to
+     'TeX-active-master', i.e., it evaluated to either the master
+     or region file.  This usage must be replaced with either
+     'TeX-active-master' or 'TeX-active-master-with-quotes'.
+
+   - Viewer entries in 'TeX-view-program-list' also had access to a
+     variable 'file' which was bound to the name of the master or
+     region file without extension.  Instead, the function
+     'TeX-active-master' has to be used now.
+
+   - Macro argument parsing functions could set a variable
+     'exit-mark' to the buffer position where point should be left
+     after all arguments have been read.  This variable is now
+     named 'TeX-exit-mark'.
+
+   - The functions in 'LaTeX-section-hook' had access or modified
+     the previously undeclared variables 'title', 'name', 'level',
+     'done-mark', and 'toc'.  These variables are now properly
+     declared and have the 'LaTeX-' prefix, e.g.,
+     'LaTeX-done-mark'.
+
+   - The functions in 'ConTeXt-numbered-section-hook' and
+     'ConTeXt-unnumbered-section-hook' had access or modified the
+     previously undeclared variables 'title', 'name', 'level',
+     'done-mark', and 'reference'.  These variables are now
+     properly declared and have the 'ConTeXt-' prefix, e.g.,
+     'ConTeXt-title'.
+
+   - The functions in 'TeX-translate-location-hook' could access
+     and modify the free variables 'file', 'line', 'error',
+     'offset', 'context', and 'string'.  Those are now properly
+     declared variables with the prefix 'TeX-translate-location-',
+     e.g., 'TeX-translate-location-file'.
+
+The constant 'LaTeX-dialect' has been renamed to 'TeX-dialect' and
+moved from 'latex.el' to 'tex.el'.  'LaTeX-dialect' now is an
+obsolete alias.
+
+The style 'latexinfo.el' is removed from AUCTeX.  'latexinfo.el'
+was meant to support latexinfo which in return was a LaTeX-2.09
+extension of Texinfo, but didn't manage to replace Texinfo.
+
+The style 'siunitx.el' is updated to support package version 3.
+Key-value options provided by older package versions are removed,
+deprecated macros and units are not supported anymore.
+
+AUCTeX has preliminary support for LaTeX-hooks.  Hooks provided by
+LaTeX kernel are known and available for completion in
+'\AddToHook', '\RemoveFromHook' and '\AddToHookNext'.
+
+AUCTeX is now able to place all generated output files, including
+those that are produced by applications running under AUCTeX,
+temporary files related to region processing and preview-latex
+files, in an output directory.  To use this feature, set the new
+user option 'TeX-output-dir' to the absolute path of the output
+directory or a relative path which would be interpreted as being
+relative to the master file in a multifile document.
+
+Note that this feature doesn't work if the document includes sub
+file placed in sub directory below the main file via '\include'
+command.
+
+Many other bugs were fixed.
 
 Requirements
 ------------
@@ -125,11 +194,12 @@ 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, Patrick Gundlach,
-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, Pieter Pareit, Nicolas Richard, Augusto Ritter Stoffel,
+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
diff --git a/configure.ac b/configure.ac
index f035c77..a435cb8 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.3,bug-auctex@gnu.org)
+AC_INIT(auctex,13.1,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 571f503..a377d45 100644
--- a/doc/changes.texi
+++ b/doc/changes.texi
@@ -149,6 +149,9 @@ file in a multifile document.
 
 Note that this feature doesn't work if the document includes sub file
 placed in sub directory below the main file via @samp{\include} command.
+
+@item
+Many other bugs were fixed.
 @end itemize
 
 @heading News in 12.3
diff --git a/doc/tex-ref.tex b/doc/tex-ref.tex
index 2affa85..d725eb5 100644
--- a/doc/tex-ref.tex
+++ b/doc/tex-ref.tex
@@ -1,4 +1,4 @@
-% Reference Card for AUCTeX version 12.3
+% Reference Card for AUCTeX version 13.1
 %**start of header
 \newcount\columnsperpage
 
@@ -42,9 +42,9 @@
 % Paul Rubin, Bob Chassell, Len Tower, and Richard Mlynarik
 % for creating the GNU Emacs Reference Card from which this was mutated
 
-\def\versionnumber{12.3}
-\def\year{2020}
-\def\version{October \year\ v\versionnumber}
+\def\versionnumber{13.1}
+\def\year{2021}
+\def\version{December \year\ v\versionnumber}
 
 \def\shortcopyrightnotice{\vskip 1ex plus 2 fill
   \centerline{\small \copyright\ \year\ Free Software Foundation, Inc.
@@ -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-2020 Free Software Foundation, Inc.}
+\centerline{2012, 2014-2017, 2019-2021 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 080996b..ff686ce 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-2020 Free Software Foundation
+%                   2010, 2017-2021 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_3 $ \ifx\pr@version\@empty
+\reserved@a\pr@version $Name: release_13_1 $ \ifx\pr@version\@empty
 \reserved@a\pr@version CVS-$Revision: 1.126 $ \endgroup \else
   \def\next release_{} \lccode`\_=`.
   \edef\next{\lowercase{\endgroup