bug-texinfo
[Top][All Lists]

## Re: behavior of @math with HTML output

 From: Gavin Smith Subject: Re: behavior of @math with HTML output Date: Thu, 13 Oct 2022 06:48:49 +0100

On Wed, Oct 12, 2022 at 12:40:12AM +0200, Vincent Lefevre wrote:
> The Texinfo manual says
>
>    The '@math' command has no special effect on the Info output or (by
> default) the HTML output, merely outputting the contents verbatim.
>
> However, as said later, the contents are emphasized (with <em>).
> So the description is inconsistent.
>
> Moreover, using <em> is incorrect because things like digits should
> not be in italics. For instance, with the GMP manual, one has about
> mpz_mul_2exp (since r3083): "op1 times 2 raised to op2" entirely in
> italics. There are no reasons to do that. This was added in 2000;
> I don't know what texinfo did at that time...

This is the default if MathJax is not turned on or tex4ht or latex2html
are not used.  The <em> tag marks the text as separate.  There is not
much more that could be done - texi2any does not itself interpret
TeX math notation at all and is not going to format e.g. digits
differently.

My advice is to use MathJax when generating the manual as described in
the same part of the manual.