@math in manual

[Patrice Dumas]

Hello,

In my opinion, the manual is confusing for @math with respect with what
is really accepted as syntax, and done. To understand that to implement
it in  texi2html, I had to feed makeinfo and texi2dvi with various
patterns until I understand what happens.

It says that makeinfo 'reproduces the input' while it is untrue,
since it takes @-command into account as usual.

I also find that 'it does not try to interpret the mathematics in any
way' is not right, since it is not a mathematical software and it may only
deal with mathematics formatting. In my opinion it should better be
along
'it does not try to interpret the mathematics formatting in any special
way'.

Moreover it is untrue, since makeinfo removes matching braces { }.
In my opinion this should be documented.

I also think that address@hidden' implies address@hidden' is not that correct, 
because
@-commands are used in @math. You could respond that it is what
"implies"
means, but I think that it would be clearer not to mention @tex to
avoid confusion, and instead have something simpler (but longer)
like:

 In @math, TeX commands and symbols are also allowed and have the same
 meaning that in mathematics TeX environments. This not only....

Tell me what you like and what you dislike in these proposals and I'll
do a patch to the texinfo.txi manual file.

--
Pat