>>> "JED" == Joel E Denny <[EMAIL PROTECTED]> writes:
> 1. The "Bison Options" section omits the --warnings option.
I installed this.
Index: ChangeLog
from Akim Demaille <[EMAIL PROTECTED]>
* 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.
[EMAIL PROTECTED] -W
[EMAIL PROTECTED] --warnings
+Output warnings falling in @var{category}. @var{category} can be one
+of:
[EMAIL PROTECTED] @code
[EMAIL PROTECTED] 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
[EMAIL PROTECTED] in:
+
[EMAIL PROTECTED]
+exp: '1' @{ $$ = 1; @} '+' exp @{ $$ = $1 + $4; @};
[EMAIL PROTECTED] 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:
+
[EMAIL PROTECTED]
+ exp: '1' @{ $1 = 1; @} '+' exp @{ $$ = $2 + $4; @};
[EMAIL PROTECTED] example
+
+These warnings are not enabled by default since they sometimes prove to
+be false alarms in existing grammars employing the Yacc constructs
[EMAIL PROTECTED] or @[EMAIL PROTECTED] (where @var{n} is some positive
integer).
+
+
[EMAIL PROTECTED] yacc
+Incompatibilities with @acronym{POSIX} Yacc.
+
[EMAIL PROTECTED] all
+all the warnings
[EMAIL PROTECTED] none
+turn off all the warnings
[EMAIL PROTECTED] error
+treat warnings as errors
[EMAIL PROTECTED] 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
