Re: example macro prototype is somewhat malformed

[Eric Blake]

On 05/13/2014 06:54 AM, Marijn Schouten (hkBst) wrote:
> On
> https://www.gnu.org/savannah-checkouts/gnu/m4/manual/m4-1.4.17/html_node/Manual.html#Manual
> 
> the example macro prototype is somewhat malformed:
> 
> ===
> 
> Composite: example (string, [count = ‘1’]
> 
>     [argument]This is a sample prototype. There is not really a macro

Thanks for the report.

> In the first line, [argument] fell off the line, there is no closing paren.

I'm suspecting a bug in texinfo (hence the added cc); this is the source
code for that line:

@deffn Composite example (@var{string}, @dvar{count, 1}, @
  @address@hidden)
This is a sample prototype.  There is not really a macro named

and the texinfo manual documents that a lone @ at the end of a line of a
definition command is supposed to do line wrapping.  Looking at the info
page, I see:

 -- Composite: example (STRING, [COUNT = `1'], [ARGUMENT]...)
     This is a sample prototype.  There is not really a macro named

which looks correct.  So the problem appears to be in the conversion
from info to html, which was done as part of the gendocs.sh script
shipped by the texinfo project.  But I have no idea where to go from
that analysis, so I'm hoping the texinfo folks will step in and figure
out what went wrong.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

signature.asc
Description: OpenPGP digital signature