[elpa] externals/auctex a6b12a2 16/27: Update documents

[Tassilo Horn]

branch: externals/auctex
commit a6b12a2721e32b46ef70852d0e7c11408a71dcaf
Author: Ikumi Keita <ikumi@ikumi.que.jp>
Commit: Ikumi Keita <ikumi@ikumi.que.jp>

    Update documents
    
    * doc/auctex.texi (Fontification of math):
    * doc/changes.texi (News in 12.3):
    * font-latex.el (font-latex-math-environments):
    Document that variable `font-latex-math-environments' is no longer
    suitable for personal customization and recommend to use
    `texmathp-tex-commands' instead.
    * tests/latex/fontification-general.tex: Mention new function
    `font-latex-extend-region-backwards-math'
---
 doc/auctex.texi                       | 7 ++++++-
 doc/changes.texi                      | 7 +++++++
 font-latex.el                         | 8 +++++++-
 tests/latex/fontification-general.tex | 2 +-
 4 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/doc/auctex.texi b/doc/auctex.texi
index 0fc1948..4886840 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -2260,6 +2260,8 @@ fontified.
 
 @vindex font-latex-match-math-command-keywords
 @vindex font-latex-math-environments
+@vindex texmathp-tex-commands
+@vindex texmathp-tex-commands-default
 In @LaTeX{} mathematics can be indicated by a variety of different
 methods: toggles (like dollar signs), macros and environments.  Math
 constructs known by @fontlatex{} are displayed with the face
@@ -2267,7 +2269,10 @@ constructs known by @fontlatex{} are displayed with the 
face
 like @samp{\(...\)} or @samp{\[...\]} is built-in and not customizable.
 Support for other math macros and environments can be adapted by
 customizing the variables @code{font-latex-match-math-command-keywords}
-and @code{font-latex-math-environments} respectively.
+and @code{texmathp-tex-commands} respectively. It is no longer
+recommended to customize @code{font-latex-math-environments}, which
+is initialized according to @code{texmathp-tex-commands} and
+@code{texmathp-tex-commands-default} by default.
 
 In order to make math constructs more readable, @fontlatex{} displays
 subscript and superscript parts in a smaller font and raised or lowered
diff --git a/doc/changes.texi b/doc/changes.texi
index 1f50613..08ea18a 100644
--- a/doc/changes.texi
+++ b/doc/changes.texi
@@ -23,6 +23,13 @@ math until another $ appears. You can insert a commented 
dollar sign
 @ifclear rawfile
 @xref{Known problems}.
 @end ifclear
+
+In addition, it is no longer recommended to customize
+@code{font-latex-math-environments}. Use @code{texmathp-tex-commands}
+instead.
+@ifclear rawfile
+@xref{Fontification of math}.
+@end ifclear
 @item
 @AUCTeX{} tracks changes in @LaTeX{}2e 2020-02-02 release.  @AUCTeX{}
 supports the improvements to @LaTeX{} font selection mechanism (NFSS).
diff --git a/font-latex.el b/font-latex.el
index 9db623e..449c2d1 100644
--- a/font-latex.el
+++ b/font-latex.el
@@ -1783,7 +1783,13 @@ except starred forms."
 
 (defcustom font-latex-math-environments
   (font-latex-math-environments-from-texmathp texmathp-tex-commands1)
-  "List of math environment names for font locking."
+  "List of math environment names for font locking.
+It is no longer recommended to customize this option. You should
+customize `texmathp-tex-commands' instead because it is important for
+stable operation of font lock that this option is coherent with that
+option in addition to `texmathp-tex-commands-default'.
+Actually, the default value of this option is now taken from those
+variables."
   :type '(repeat string)
   :group 'font-latex)
 
diff --git a/tests/latex/fontification-general.tex 
b/tests/latex/fontification-general.tex
index 4866e4f..c016f6a 100644
--- a/tests/latex/fontification-general.tex
+++ b/tests/latex/fontification-general.tex
@@ -237,7 +237,7 @@ or
 The relevant functions is \verb|font-latex.el| are
 \begin{quote}
 \verb|font-latex-match-math-envII|\quad and \\
-\verb|font-latex-extend-region-backwards-math-envII|
+\verb|font-latex-extend-region-backwards-math|
 \end{quote}
 
 \subsubsection{Standard \protect\LaTeX{}}