[AUCTeX-diffs] GNU AUCTeX branch, master, updated. a6b12a2721e32b46ef70852d0e7c11408a71dcaf

[Ikumi Keita]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU AUCTeX".

The branch, master has been updated
       via  a6b12a2721e32b46ef70852d0e7c11408a71dcaf (commit)
      from  393fb214d2bfb3b3174fee587a794001476a228b (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit a6b12a2721e32b46ef70852d0e7c11408a71dcaf
Author: Ikumi Keita <ikumi@ikumi.que.jp>
Date:   Tue Jun 16 01:27:08 2020 +0900

    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'

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{}}

-----------------------------------------------------------------------

Summary of changes:
 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(-)


hooks/post-receive
-- 
GNU AUCTeX