doc: explain how mid-rule actions are translated

[bison.git] / NEWS

diff --git a/NEWS b/NEWS
index 93a1ef54e1cf1f6993a5cdcaf4efec3578a05ac6..d937bea7a74f425527150150bced36f2142709ee 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -2,16 +2,45 @@ GNU Bison NEWS
 
 * Noteworthy changes in release ?.? (????-??-??) [?]
 
+
+* Noteworthy changes in release 2.6.90 (2012-12-07) [beta]
+
+** Bug fixes
+
+  Warnings about uninitialized yylloc in yyparse have been fixed.
+
 ** %language is no longer an experimental feature.
 
   The introduction of this feature, in 2.4, was four years ago. The --language
   option and the %language directive are no longer experimental.
 
+** New format for error reports: carets
+
+  Caret errors have been added to Bison, for example (taken from the
+  documentation):
+
+    input.y:3.20-23: error: ambiguous reference: '$exp'
+     exp: exp '+' exp { $exp = $1 + $3; };
+                        ^^^^
+    input.y:3.1-3:       refers to: $exp at $$
+     exp: exp '+' exp { $exp = $1 + $3; };
+     ^^^
+    input.y:3.6-8:       refers to: $exp at $1
+     exp: exp '+' exp { $exp = $1 + $3; };
+          ^^^
+    input.y:3.14-16:     refers to: $exp at $3
+     exp: exp '+' exp { $exp = $1 + $3; };
+                  ^^^
+
+  The default behaviour for now is still not to display these unless explictly
+  asked with -fall of -fcaret. However, in a later release, it will be made the
+  default behavior (but may still be deactivated with -fno-caret).
+
 ** New value for %define variable: api.pure full
 
   The %define variable api.pure requests a pure (reentrant) parser. However,
   for historical reasons, using it in a location-tracking Yacc parser resulted
-  in an yyerror function that did not take a location as a parameter. With this
+  in a yyerror function that did not take a location as a parameter. With this
   new value, the user may request a better pure parser, where yyerror does take
   a location as a parameter (in location-tracking parsers).
 
@@ -72,17 +101,13 @@ GNU Bison NEWS
 
   Two nodes were added to the documentation: Xml and Graphviz.
 
-* Noteworthy changes in release ?.? (????-??-??) [?]
-
-** Bug fixes
-
-  Warnings about uninitialized yylloc in yyparse have been fixed.
-
 ** Documentation
 
   The sections about shift/reduce and reduce/reduce conflicts resolution
   have been fixed and extended.
 
+  The translation of mid-rule actions is now described.
+
 * Noteworthy changes in release 2.6.5 (2012-11-07) [stable]
 
   We consider compiler warnings about Bison generated parsers to be bugs.