Re: RFC: documentation for typed mid-rule actions

[Akim Demaille]

> Le 12 août 2018 à 11:33, Akim Demaille <address@hidden> a écrit :
> 
> Hi all,
> 
> I believe that typed mid-rule actions are ready, except for
> the lack of documentation.  Please find below a proposal of
> documentation, currently in the ad/typed-midrule branch and
> in PDF currently here:
> 
> https://www.lrde.epita.fr/~akim/private/bison/bison.pdf
> 
> I would also like to enforce consistency in Bison which uses
> both midrule and mid-rule.  I am in favor of ‘midrule'
> (shorter, consistent with our move to lookahead instead of
> look-ahead, more consistent between code and doc as there is
> no conversion from dash to underscore, etc.), but I am not
> a native!  To which one should we stick? (FWIW, neither
> appear in the manual of YACC, only ‘An action appearing in the
> middle of a rule […]’ does).
> 
> I must have gotten rotten in Texinfo, as both my @ref to
> {Typed Mid-Rule Actions} appear as
> ‘See ⟨undefined⟩ [Typed Mid-Rule Actions], page ⟨undefined⟩’
> in PDF, and I have no idea why.  It doesn’t appear in the
> table of contents either.  Info and HTML are fine, latest
> gnulib.

I am installing this patch, but please, do not hesitate commenting it.
I’d like to wrap a Bison 3.1 more or less within the month.

I’d be very happy to be told why I have this problem with Texinfo too.