branch master updated: * doc/texinfo.texi (Inserting Math): Do not state that LaTeX commands can be used inside @math/@displaymath. Use @ not \ for Texinfo commands. Reference T4H_MATH_CONVERSION for LaTeX output.

[Gavin D. Smith]

This is an automated email from the git hooks/post-receive script.

gavin pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 2bdd206ad2 * doc/texinfo.texi (Inserting Math): Do not state that 
LaTeX commands can be used inside @math/@displaymath. Use @ not \ for Texinfo 
commands.  Reference T4H_MATH_CONVERSION for LaTeX output.
2bdd206ad2 is described below

commit 2bdd206ad2cd4024cf9a1f7d1fccd7144c5a126a
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Sun Oct 16 20:28:00 2022 +0100

    * doc/texinfo.texi (Inserting Math): Do not state that
    LaTeX commands can be used inside @math/@displaymath.
    Use @ not \ for Texinfo commands.  Reference
    T4H_MATH_CONVERSION for LaTeX output.
---
 ChangeLog        |  7 +++++++
 doc/texinfo.texi | 17 +++++++++++------
 2 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 152a8a641b..c41f61bdec 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2022-10-16  Gavin Smith  <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (Inserting Math): Do not state that
+       LaTeX commands can be used inside @math/@displaymath.
+       Use @ not \ for Texinfo commands.  Reference
+       T4H_MATH_CONVERSION for LaTeX output.
+
 2022-10-16  Gavin Smith  <gavinsmith0123@gmail.com>
 
        * info/man.c (check_manpage_node, get_manpage_from_formatter):
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 308075c0ff..4fbf0032ef 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -10082,16 +10082,21 @@ f(x) = {1\over\sigma\sqrt{2\pi}}
 e^{-{1\over2}\left({x-\mu\over\sigma}\right)^2}
 @end displaymath
 
+In general, the contents of @code{@@math} or @code{@@displaymath}
+should be plain @TeX{} only, with no interspersed Texinfo commands.
+If you do use any Texinfo commands, then you should mark these with
+@samp{@@} as usual, rather than @samp{\} (e.g. @samp{@@var} rather than
+@samp{\var}), but we do not guarantee which Texinfo commands will work.
+
 Although @code{@@sub} and @code{@@sup} may work inside math mode in
 some contexts, it is better to use @TeX{}'s @samp{_} and @samp{^}
 characters to denote subscripts and superscripts within mathematical
-expressions.  In general, the contents of @code{@@math} or
-@code{@@displaymath} should be plain @TeX{} or @LaTeX{} only, with no
-interspersed Texinfo commands.
+expressions.
 
-In general, plain @TeX{} will be correctly output in @LaTeX{},
-while @LaTeX{} specific math code will not be correctly output when
-processed with @TeX{}.
+@LaTeX{}-specific code will only work when the output format is @LaTeX{},
+and with the @code{HTML_MATH} options (although @command{tex4ht} needs
+@code{T4H_MATH_CONVERSION} to be set to @samp{latex};
+@pxref{@command{tex4ht} Customization Variables}).
 
 @ignore
 @findex @sortas{\} \ @r{(literal \ in @code{@@math})}