Re: html version of the manual

[Paul Eggert]

Ralf Wildenhues <address@hidden> writes:

> - The @insertcopying is not replaced.  Presumably this is
>   why the web page does not link to a copy of the manual
>   (which is very unfortunate, by the way).

Yes, quite true on both counts.

> OK to apply the trivial patch below to fix these and remove the
> corresponding bogus output?

Yes, thanks, please do that.

> - tidy complains that makeinfo does not escape the ampersand in
>   title="Program & Function Index".

That sounds like a bug in makeinfo.

> - makeinfo does a suboptimal job at converting the definition of
>   AT_CHECK, which is unique in that it has an empty default value for
>   @dvar:
>     @dvar{stdout, @samp{}}
>   (texi2html 1.64 moves one of the quotes past the closing bracket, 1.76
>   has this fixed though; makeinfo outputs two different types of quotes).
>   I wonder whether that could be worked around in the definition of @dvar.

Possibly, yes.  I'm not an expert in this area, though.

I briefly scanned the output of makeinfo for other HTML gotchas and
spotted many places where the output doesn't conform to the latest
recommendation for HTML, which I assume would be XHTML 1.0 Strict.
However, I guess this area is controversial, so I'm not sure it's
worth sending in bug reports about it.