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 cefb18280b)
This commit is contained in:
Joel E. Denny
2009-05-01 02:51:31 -04:00
parent 812775a039
commit 966aba6583
3 changed files with 31 additions and 11 deletions

View File

@@ -1,3 +1,11 @@
2009-05-01 Joel E. Denny <jdenny@ces.clemson.edu>
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 <jdenny@ces.clemson.edu>
Convert underscores to dashes in some %define variable names.

23
NEWS
View File

@@ -85,6 +85,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

View File

@@ -2704,9 +2704,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.
@@ -4745,10 +4742,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}@}
@@ -4826,10 +4819,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}.