Re: example macro prototype is somewhat malformed

[Eric Blake]

On 05/13/2014 02:38 PM, Patrice Dumas wrote:

> Ok, I expanded the macros and indeed, the problem is that there are @c
> that swallow the end of lines.  After user-defined @-macro expansion,
> the texinfo indeed reads:
> 
> @deffn Composite example (@var{string}, @address@hidden = @address@hidden@c, @
>   @address@hidden@address@hidden@dots{})
> 
> The @c on the @deffn line swallows the end of line, the @c in the second
> line swallows the "@dots{})"?  The Info output is also incorrect:
> 
>  -- Composite: example (STRING, [COUNT = '1']
>      [ARGUMENT]This is a sample prototype.  There is not really a macro
> 
> My guess is that simply removing the @c in the user @-macro definition
> would fix this issue, in addition to being simpler, as in
> 
> @c @ovar{ARG}
> @c -------------------
> @c The ARG is an optional argument.  To be used for macro arguments in
> @c their documentation (@defmac).
> @macro ovar{varname}
> @address@hidden@r{]}
> @end macro

Thanks.  And in fact, I see that you told me to make the same patch for
the same macros as already copied in autoconf:

git.sv.gnu.org/gitweb/?p=autoconf.git;a=commitdiff;h=a357718

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

signature.asc
Description: OpenPGP digital signature