From d397d9f08cc963c5b90ce62549498b82bf499cc1 Mon Sep 17 00:00:00 2001 From: "Joel E. Denny" Date: Sun, 19 Dec 2010 22:15:57 -0500 Subject: [PATCH] doc: cleanup. * NEWS (2.5): Try to sort entries according to how interesting users might find them. --- ChangeLog | 6 +++ NEWS | 146 +++++++++++++++++++++++++++--------------------------- 2 files changed, 79 insertions(+), 73 deletions(-) diff --git a/ChangeLog b/ChangeLog index 488b2801..ba2b3af3 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2010-12-19 Joel E. Denny + + doc: cleanup. + * NEWS (2.5): Try to sort entries according to how interesting + users might find them. + 2010-12-19 Joel E. Denny doc: cleanup. diff --git a/NEWS b/NEWS index 99814004..576d8cd5 100644 --- a/NEWS +++ b/NEWS @@ -157,13 +157,15 @@ Bison News LAC is an experimental feature. More user feedback will help to stabilize it. -** Unrecognized %code qualifiers are now errors not warnings. - -** %define improvements: +** Grammar symbol names can now contain dashes: -*** Unrecognized variables are now errors not warnings. + Consistently with directives (such as %error-verbose) and variables + (e.g. push-pull), grammar symbol names may include dashes in any + position, similarly to periods and underscores. This is GNU + extension over POSIX Yacc whose use is reported by -Wyacc, and + rejected in Yacc mode (--yacc). -*** Multiple invocations for any variable is now an error not a warning. +** %define improvements: *** Can now be invoked via the command line: @@ -210,13 +212,73 @@ Bison News %define api.push-pull push -** Grammar symbol names can now contain dashes: +*** Unrecognized variables are now errors not warnings. - Consistently with directives (such as %error-verbose) and variables - (e.g. push-pull), grammar symbol names may include dashes in any - position, similarly to periods and underscores. This is GNU - extension over POSIX Yacc whose use is reported by -Wyacc, and - rejected in Yacc mode (--yacc). +*** Multiple invocations for any variable is now an error not a warning. + +** Unrecognized %code qualifiers are now errors not warnings. + +** Character literals not of length one: + + Previously, Bison quietly converted all character literals to length + one. For example, without warning, Bison interpreted the operators in + the following grammar to be the same token: + + exp: exp '++' + | exp '+' exp + ; + + Bison now warns when a character literal is not of length one. In + some future release, Bison will start reporting an error instead. + +** Destructor calls fixed for lookaheads altered in semantic actions: + + Previously for deterministic parsers in C, if a user semantic action + altered yychar, the parser in some cases used the old yychar value to + determine which destructor to call for the lookahead upon a syntax + error or upon parser return. This bug has been fixed. + +** C++ parsers use YYRHSLOC: + + Similarly to the C parsers, the C++ parsers now define the YYRHSLOC + macro and use it in the default YYLLOC_DEFAULT. You are encouraged + to use it. If, for instance, your location structure has "first" + and "last" members, instead of + + # define YYLLOC_DEFAULT(Current, Rhs, N) \ + do \ + if (N) \ + { \ + (Current).first = (Rhs)[1].location.first; \ + (Current).last = (Rhs)[N].location.last; \ + } \ + else \ + { \ + (Current).first = (Current).last = (Rhs)[0].location.last; \ + } \ + while (false) + + use: + + # define YYLLOC_DEFAULT(Current, Rhs, N) \ + do \ + if (N) \ + { \ + (Current).first = YYRHSLOC (Rhs, 1).first; \ + (Current).last = YYRHSLOC (Rhs, N).last; \ + } \ + else \ + { \ + (Current).first = (Current).last = YYRHSLOC (Rhs, 0).last; \ + } \ + while (false) + +** YYLLOC_DEFAULT in C++: + + The default implementation of YYLLOC_DEFAULT used to be issued in + the header file. It is now output in the implementation file, after + the user %code sections so that its #ifndef guard does not try to + override the user's YYLLOC_DEFAULT if provided. ** YYFAIL now produces warnings and Java parsers no longer implement it: @@ -250,19 +312,6 @@ Bison News about a missing semicolon where it did not before. Future releases of Bison will cease to append semicolons entirely. -** Character literals not of length one: - - Previously, Bison quietly converted all character literals to length - one. For example, without warning, Bison interpreted the operators in - the following grammar to be the same token: - - exp: exp '++' - | exp '+' exp - ; - - Bison now warns when a character literal is not of length one. In - some future release, Bison will start reporting an error instead. - ** Verbose syntax error message fixes: When %error-verbose or `#define YYERROR_VERBOSE' is specified, @@ -301,55 +350,6 @@ Bison News canonical LR. However, LAC is still experimental and is disabled by default. -** Destructor calls fixed for lookaheads altered in semantic actions: - - Previously for deterministic parsers in C, if a user semantic action - altered yychar, the parser in some cases used the old yychar value to - determine which destructor to call for the lookahead upon a syntax - error or upon parser return. This bug has been fixed. - -** C++ parsers use YYRHSLOC: - - Similarly to the C parsers, the C++ parsers now define the YYRHSLOC - macro and use it in the default YYLLOC_DEFAULT. You are encouraged - to use it. If, for instance, your location structure has "first" - and "last" members, instead of - - # define YYLLOC_DEFAULT(Current, Rhs, N) \ - do \ - if (N) \ - { \ - (Current).first = (Rhs)[1].location.first; \ - (Current).last = (Rhs)[N].location.last; \ - } \ - else \ - { \ - (Current).first = (Current).last = (Rhs)[0].location.last; \ - } \ - while (false) - - use: - - # define YYLLOC_DEFAULT(Current, Rhs, N) \ - do \ - if (N) \ - { \ - (Current).first = YYRHSLOC (Rhs, 1).first; \ - (Current).last = YYRHSLOC (Rhs, N).last; \ - } \ - else \ - { \ - (Current).first = (Current).last = YYRHSLOC (Rhs, 0).last; \ - } \ - while (false) - -** YYLLOC_DEFAULT in C++: - - The default implementation of YYLLOC_DEFAULT used to be issued in - the header file. It is now output in the implementation file, after - the user %code sections so that its #ifndef guard does not try to - override the user's YYLLOC_DEFAULT if provided. - * Changes in version 2.4.3 (2010-08-05): ** Bison now obeys -Werror and --warnings=error for warnings about -- 2.45.2