Re: maint: doc: fix documentation of YYERROR

[Hans Aberg]

On 3 Apr 2012, at 13:19, Akim Demaille wrote:

>>>> I was thinking about the API, like in
>>>> http://www.gnu.org/software/guile/manual/guile.html#Initialization
>>>> Actually, I was looking at the PDF, where it looks like:
>>>> void * scm_with_guile (void *(*func)(void *), void *data)    [C Function]
>>> 
>>> There are special commands in Texinfo to support functions,
>>> indeed, but here the case is different.
>>> 
>>> I may "cheat" with Texinfo and let it think that "return" is
>>> the return type, and the ";" are the arguments:
>> 
>> Ideally, Texinfo might be need some changes, but I'm not sure it is being 
>> developed.
> 
> yes, it is, but in this case, I don't want to have to wait
> for them to release something for us.

Perhaps something for the future.

> Here is my proposal.


I think it is OK:

I patched what was patchable on 2.5 and checked the PDF. It looks a bit unusual 
with the extra space before ';', but the semicolon should probably be there, to 
indicate correct usage.

Hans