From 98a345a21936699f675d53a90e0b93bdb5e18e37 Mon Sep 17 00:00:00 2001 From: "Joel E. Denny" Date: Fri, 1 May 2009 02:51:31 -0400 Subject: [PATCH] Declare %code to be a permanent feature. * NEWS (2.4.2): Here. * doc/bison.texinfo (Prologue Alternatives): Don't say it's experimental. (Decl Summary): Likewise. (cherry picked from commit cefb18280b83ea19b742a22f7be8661b518874b5) --- ChangeLog | 8 ++++++++ NEWS | 23 +++++++++++++++++++++++ doc/bison.texinfo | 11 ----------- 3 files changed, 31 insertions(+), 11 deletions(-) diff --git a/ChangeLog b/ChangeLog index bfab04cd..6ac849da 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2009-05-01 Joel E. Denny + + Declare %code to be a permanent feature. + * NEWS (2.4.2): Here. + * doc/bison.texinfo (Prologue Alternatives): Don't say it's + experimental. + (Decl Summary): Likewise. + 2009-04-30 Joel E. Denny Convert underscores to dashes in some %define variable names. diff --git a/NEWS b/NEWS index b9ce898c..fe80c6ff 100644 --- a/NEWS +++ b/NEWS @@ -93,6 +93,29 @@ Bison News * Changes in version 2.4.2 (????-??-??): +** %code is now a permanent feature. + + A traditional Yacc prologue directive is written in the form: + + %{CODE%} + + To provide a more flexible alternative, Bison 2.3b introduced the + %code directive with the following forms for C/C++: + + %code {CODE} + %code requires {CODE} + %code provides {CODE} + %code top {CODE} + + These forms are now considered permanent features of Bison. See the + %code entries in the section "Bison Declaration Summary" in the Bison + manual for a summary of their functionality. See the section + "Prologue Alternatives" for a detailed discussion including the + advantages of %code over the traditional Yacc prologue directive. + + Bison's Java feature as a whole including its current usage of %code + is still considered experimental. + * Changes in version 2.4.1 (2008-12-11): ** In the GLR defines file, unexpanded M4 macros in the yylval and yylloc diff --git a/doc/bison.texinfo b/doc/bison.texinfo index 6ec83ade..30b69995 100644 --- a/doc/bison.texinfo +++ b/doc/bison.texinfo @@ -2706,9 +2706,6 @@ feature test macros can affect the behavior of Bison-generated @findex %code requires @findex %code provides @findex %code top -(The prologue alternatives described here are experimental. -More user feedback will help to determine whether they should become permanent -features.) The functionality of @var{Prologue} sections can often be subtle and inflexible. @@ -4753,10 +4750,6 @@ Thus, @code{%code} replaces the traditional Yacc prologue, For a detailed discussion, see @ref{Prologue Alternatives}. For Java, the default location is inside the parser class. - -(Like all the Yacc prologue alternatives, this directive is experimental. -More user feedback will help to determine whether it should become a permanent -feature.) @end deffn @deffn {Directive} %code @var{qualifier} @{@var{code}@} @@ -4834,10 +4827,6 @@ before any class definitions. @end itemize @end itemize -(Like all the Yacc prologue alternatives, this directive is experimental. -More user feedback will help to determine whether it should become a permanent -feature.) - @cindex Prologue For a detailed discussion of how to use @code{%code} in place of the traditional Yacc prologue for C/C++, see @ref{Prologue Alternatives}. -- 2.45.2