[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: RFC: documentation for typed mid-rule actions
From: |
Akim Demaille |
Subject: |
Re: RFC: documentation for typed mid-rule actions |
Date: |
Sat, 18 Aug 2018 10:09:27 +0200 |
> 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.