Future/bison
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/bison.git synced 2026-03-09 12:23:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: fix -W and %expect documentation some.

Browse Source 
* 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 3ffdd5f125)
This commit is contained in:
Joel E. Denny
2010-08-04 20:17:40 -04:00
parent 2bfcac9a2b
commit 93d7dde97a
3 changed files with 19 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
doc/bison.texinfo
View File

@@ -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