Re: preparing for 2.3b

[Akim Demaille]

>>> "JED" == Joel E Denny <address@hidden> writes:

 > 1. The "Bison Options" section omits the --warnings option.

I installed this.

Index: ChangeLog
from  Akim Demaille  <address@hidden>

        * doc/bison.texinfo (Bison Options): Document -W.
        Based on Joel E. Denny's NEWS entry, and Automake's documentation.

Index: doc/bison.texinfo
===================================================================
RCS file: /cvsroot/bison/bison/doc/bison.texinfo,v
retrieving revision 1.252
diff -u -u -r1.252 bison.texinfo
--- doc/bison.texinfo 23 Feb 2008 04:26:14 -0000 1.252
+++ doc/bison.texinfo 28 Feb 2008 16:17:16 -0000
@@ -7776,6 +7776,46 @@
 like @samp{%glr-parser}, Bison might not be Yacc-compatible even if
 this option is specified.
 
address@hidden -W
address@hidden --warnings
+Output warnings falling in @var{category}.  @var{category} can be one
+of:
address@hidden @code
address@hidden midrule-values
+Warn about about mid-rule values that are set but not used within any of
+the actions of the parent rule.  For example, Bison warns about unused
address@hidden in:
+
address@hidden
+exp: '1' @{ $$ = 1; @} '+' exp @{ $$ = $1 + $4; @};
address@hidden example
+
+It also warns about mid-rule values that are used but not set.  For
+example, Bison warns about unset @code{$$} in the mid-rule action in:
+
address@hidden
+ exp: '1' @{ $1 = 1; @} '+' exp @{ $$ = $2 + $4; @};
address@hidden example
+
+These warnings are not enabled by default since they sometimes prove to
+be false alarms in existing grammars employing the Yacc constructs
address@hidden or @address@hidden (where @var{n} is some positive integer).
+
+
address@hidden yacc
+Incompatibilities with @acronym{POSIX} Yacc.
+
address@hidden all
+all the warnings
address@hidden none
+turn off all the warnings
address@hidden error
+treat warnings as errors
address@hidden table
+
+A category can be turned off by prefixing its name with @samp{no-}.  For
+instance, @option{-Wno-syntax} will hide the warnings about unused
+variables.
 @end table
 
 @noindent