diff options
author | Joel E. Denny <joeldenny@joeldenny.org> | 2010-08-04 20:17:40 -0400 |
---|---|---|
committer | Joel E. Denny <joeldenny@joeldenny.org> | 2010-08-04 20:18:26 -0400 |
commit | 93d7dde97a383a41223a3f19e807bac758dcef5f (patch) | |
tree | 351773ceff43bbe69897be2f396f99c64ca3dc53 | |
parent | 2bfcac9a2be3778d9ee6915f1e615f7daaf10880 (diff) | |
download | bison-93d7dde97a383a41223a3f19e807bac758dcef5f.tar.gz |
doc: fix -W and %expect documentation some.
* NEWS (2.4.3): Mention that there are documentation fixes.
* doc/bison.texinfo (Expect Decl): Make it clear that %expect
turns conflicts into errors not warnings.
(Shift/Reduce): Likewise.
(Bison Options): Don't mention -Wsyntax. It doesn't exist.
(cherry picked from commit 3ffdd5f1254fd9403a5a1d31dbdc5b2756c22775)
-rw-r--r-- | ChangeLog | 9 | ||||
-rw-r--r-- | NEWS | 2 | ||||
-rw-r--r-- | doc/bison.texinfo | 14 |
3 files changed, 19 insertions, 6 deletions
@@ -1,3 +1,12 @@ +2010-08-04 Joel E. Denny <joeldenny@joeldenny.org> + + doc: fix -W and %expect documentation some. + * NEWS (2.4.3): Mention that there are documentation fixes. + * doc/bison.texinfo (Expect Decl): Make it clear that %expect + turns conflicts into errors not warnings. + (Shift/Reduce): Likewise. + (Bison Options): Don't mention -Wsyntax. It doesn't exist. + 2010-08-01 Joel E. Denny <joeldenny@joeldenny.org> -Werror: fix for rules useless in parser after conflicts. @@ -299,6 +299,8 @@ Bison News errors in Bison 2.5. They will remain warnings, which should be sufficient for POSIX while avoiding backward compatibility issues. +** Minor documentation fixes. + * Changes in version 2.4.2 (2010-03-20): ** Some portability problems that resulted in failures and livelocks diff --git a/doc/bison.texinfo b/doc/bison.texinfo index d6e56a93..209bc5ce 100644 --- a/doc/bison.texinfo +++ b/doc/bison.texinfo @@ -4695,8 +4695,8 @@ number which Bison printed. With @acronym{GLR} parsers, add an @code{%expect-rr} declaration as well. @end itemize -Now Bison will warn you if you introduce an unexpected conflict, but -will keep silent otherwise. +Now Bison will report an error if you introduce an unexpected conflict, +but will keep silent otherwise. @node Start Decl @subsection The Start-Symbol @@ -6705,8 +6705,10 @@ This particular ambiguity was first encountered in the specifications of Algol 60 and is called the ``dangling @code{else}'' ambiguity. To avoid warnings from Bison about predictable, legitimate shift/reduce -conflicts, use the @code{%expect @var{n}} declaration. There will be no -warning as long as the number of shift/reduce conflicts is exactly @var{n}. +conflicts, use the @code{%expect @var{n}} declaration. +There will be no warning as long as the number of shift/reduce conflicts +is exactly @var{n}, and Bison will report an error if there is a +different number. @xref{Expect Decl, ,Suppressing Conflict Warnings}. The definition of @code{if_stmt} above is solely to blame for the @@ -8415,8 +8417,8 @@ Treat warnings as errors. @end 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. +instance, @option{-Wno-yacc} will hide the warnings about +@acronym{POSIX} Yacc incompatibilities. @end table @noindent |