Update doc and CHANGES for PR #11281

2 files changed, 27 insertions, 0 deletions

diff --git a/CHANGES b/CHANGES
index 7aa23a61c..e0b098db5 100644
--- a/CHANGES
+++ b/CHANGES
@@ -50,6 +50,8 @@ Features added
 * LaTeX: support elliptical corners in rounded boxes. (refs: #11254)
 * #11150: Include source location in highlighting warnings, when lexing fails.
   Patch by Jeremy Maitin-Shepard
+* #11281: Support for :confval:`imgmath_latex` ``= 'tectonic'`` or
+  ``= 'xelatex'``.  Patch by Dimitar Dimitrov
 
 Bugs fixed
 ----------
diff --git a/doc/usage/extensions/math.rst b/doc/usage/extensions/math.rst
index 9ce3efe4f..df4fc6b84 100644
--- a/doc/usage/extensions/math.rst
+++ b/doc/usage/extensions/math.rst
@@ -82,12 +82,37 @@ are built:
 
    .. hint::
 
+      To use `OpenType Math fonts`__ with ``unicode-math``, via a custom
+      :confval:`imgmath_latex_preamble`, you can set :confval:`imgmath_latex`
+      to ``'dvilualatex'``, but must then set :confval:`imgmath_image_format`
+      to ``'svg'``.  Note: this has only been tested with ``dvisvgm 3.0.3``.
+      It significantly increases image production duration compared to using
+      standard ``'latex'`` with traditional TeX math fonts.
+
+      __ https://tex.stackexchange.com/questions/425098/which-opentype-math-fonts-are-available
+
+
+   .. hint::
+
       Some fancy LaTeX mark-up (an example was reported which used TikZ to add
       various decorations to the equation) require multiple runs of the LaTeX
       executable.  To handle this, set this configuration setting to
       ``'latexmk'`` (or a full path to it) as this Perl script reliably
       chooses dynamically how many latex runs are needed.
 
+   .. versionchanged:: 6.2.0
+
+      Using ``'xelatex'`` (or a full path to it) is now supported.  But you
+      must then add ``'-no-pdf'`` to the :confval:`imgmath_latex_args` list of
+      the command options.  The ``'svg'`` :confval:`imgmath_image_format` is
+      required.  Also, you may need the ``dvisvgm`` binary to be relatively
+      recent (testing was done only with its ``3.0.3`` release).
+
+      .. note::
+
+         Regarding the previous note, it is currently not supported to use
+         ``latexmk`` with option ``-xelatex``.
+
 .. confval:: imgmath_latex_args
 
    Additional arguments to give to latex, as a list.  The default is an empty