mirror of
https://git.savannah.gnu.org/git/bison.git
synced 2026-03-16 07:43:03 +00:00
doc: pacify texinfo 7.1
* doc/bison.texi: Don’t put @anchor inside @item, as texinfo 7.1 complains.
This commit is contained in:
@@ -11648,22 +11648,26 @@ Options controlling the diagnostics.
|
|||||||
Output warnings falling in @var{category}. @var{category} can be one
|
Output warnings falling in @var{category}. @var{category} can be one
|
||||||
of:
|
of:
|
||||||
@table @code
|
@table @code
|
||||||
@item @anchor{Wconflicts-sr}conflicts-sr
|
@item conflicts-sr
|
||||||
@itemx @anchor{Wconflicts-rr}conflicts-rr
|
@itemx conflicts-rr
|
||||||
|
@anchor{Wconflicts-sr}
|
||||||
|
@anchor{Wconflicts-rr}
|
||||||
S/R and R/R conflicts. These warnings are enabled by default. However, if
|
S/R and R/R conflicts. These warnings are enabled by default. However, if
|
||||||
the @code{%expect} or @code{%expect-rr} directive is specified, an
|
the @code{%expect} or @code{%expect-rr} directive is specified, an
|
||||||
unexpected number of conflicts is an error, and an expected number of
|
unexpected number of conflicts is an error, and an expected number of
|
||||||
conflicts is not reported, so @option{-W} and @option{--warning} then have
|
conflicts is not reported, so @option{-W} and @option{--warning} then have
|
||||||
no effect on the conflict report.
|
no effect on the conflict report.
|
||||||
|
|
||||||
@item @anchor{Wcounterexamples}counterexamples
|
@item counterexamples
|
||||||
@itemx cex
|
@itemx cex
|
||||||
|
@anchor{Wcounterexamples}
|
||||||
Provide counterexamples for conflicts. @xref{Counterexamples}.
|
Provide counterexamples for conflicts. @xref{Counterexamples}.
|
||||||
Counterexamples take time to compute. The option @option{-Wcex} should be
|
Counterexamples take time to compute. The option @option{-Wcex} should be
|
||||||
used by the developer when working on the grammar; it hardly makes sense to
|
used by the developer when working on the grammar; it hardly makes sense to
|
||||||
use it in a CI.
|
use it in a CI.
|
||||||
|
|
||||||
@item @anchor{Wdangling-alias}dangling-alias
|
@item dangling-alias
|
||||||
|
@anchor{Wdangling-alias}
|
||||||
Report string literals that are not bound to a token symbol.
|
Report string literals that are not bound to a token symbol.
|
||||||
|
|
||||||
String literals, which allow for better error messages, are (too) liberally
|
String literals, which allow for better error messages, are (too) liberally
|
||||||
@@ -11709,16 +11713,19 @@ foo: "baz" @{@}
|
|||||||
| @dwarning{^~~~~}
|
| @dwarning{^~~~~}
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@item @anchor{Wdeprecated}deprecated
|
@item deprecated
|
||||||
|
@anchor{Wdeprecated}
|
||||||
Deprecated constructs whose support will be removed in future versions of
|
Deprecated constructs whose support will be removed in future versions of
|
||||||
Bison.
|
Bison.
|
||||||
|
|
||||||
@item @anchor{Wempty-rule}empty-rule
|
@item empty-rule
|
||||||
|
@anchor{Wempty-rule}
|
||||||
Empty rules without @code{%empty}. @xref{Empty Rules}. Disabled by
|
Empty rules without @code{%empty}. @xref{Empty Rules}. Disabled by
|
||||||
default, but enabled by uses of @code{%empty}, unless
|
default, but enabled by uses of @code{%empty}, unless
|
||||||
@option{-Wno-empty-rule} was specified.
|
@option{-Wno-empty-rule} was specified.
|
||||||
|
|
||||||
@item @anchor{Wmidrule-values}midrule-values
|
@item midrule-values
|
||||||
|
@anchor{Wmidrule-values}
|
||||||
Warn about midrule values that are set but not used within any of the actions
|
Warn about midrule values that are set but not used within any of the actions
|
||||||
of the parent rule.
|
of the parent rule.
|
||||||
For example, warn about unused @code{$2} in:
|
For example, warn about unused @code{$2} in:
|
||||||
@@ -11738,7 +11745,8 @@ These warnings are not enabled by default since they sometimes prove to
|
|||||||
be false alarms in existing grammars employing the Yacc constructs
|
be false alarms in existing grammars employing the Yacc constructs
|
||||||
@code{$0} or @code{$-@var{n}} (where @var{n} is some positive integer).
|
@code{$0} or @code{$-@var{n}} (where @var{n} is some positive integer).
|
||||||
|
|
||||||
@item @anchor{Wprecedence}precedence
|
@item precedence
|
||||||
|
@anchor{Wprecedence}
|
||||||
Useless precedence and associativity directives. Disabled by default.
|
Useless precedence and associativity directives. Disabled by default.
|
||||||
|
|
||||||
Consider for instance the following grammar:
|
Consider for instance the following grammar:
|
||||||
@@ -11799,21 +11807,24 @@ One would get the exact same parser with the following directives instead:
|
|||||||
@end group
|
@end group
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@item @anchor{Wyacc}yacc
|
@item yacc
|
||||||
|
@anchor{Wyacc}
|
||||||
Incompatibilities with POSIX Yacc.
|
Incompatibilities with POSIX Yacc.
|
||||||
|
|
||||||
@item @anchor{Wother}other
|
@item other
|
||||||
|
@anchor{Wother}
|
||||||
All warnings not categorized above. These warnings are enabled by default.
|
All warnings not categorized above. These warnings are enabled by default.
|
||||||
|
|
||||||
This category is provided merely for the sake of completeness. Future
|
This category is provided merely for the sake of completeness. Future
|
||||||
releases of Bison may move warnings from this category to new, more specific
|
releases of Bison may move warnings from this category to new, more specific
|
||||||
categories.
|
categories.
|
||||||
|
|
||||||
@item @anchor{Wall}all
|
@item all
|
||||||
All the warnings except @code{counterexamples}, @code{dangling-alias} and
|
All the warnings except @code{counterexamples}, @code{dangling-alias} and
|
||||||
@code{yacc}.
|
@code{yacc}.
|
||||||
|
|
||||||
@item @anchor{Wnone}none
|
@item none
|
||||||
|
@anchor{Wnone}
|
||||||
Turn off all the warnings.
|
Turn off all the warnings.
|
||||||
|
|
||||||
@item error
|
@item error
|
||||||
@@ -11824,7 +11835,8 @@ A category can be turned off by prefixing its name with @samp{no-}. For
|
|||||||
instance, @option{-Wno-yacc} will hide the warnings about
|
instance, @option{-Wno-yacc} will hide the warnings about
|
||||||
POSIX Yacc incompatibilities.
|
POSIX Yacc incompatibilities.
|
||||||
|
|
||||||
@item @anchor{Werror}-Werror
|
@item -Werror
|
||||||
|
@anchor{Werror}
|
||||||
Turn enabled warnings for every @var{category} into errors, unless they are
|
Turn enabled warnings for every @var{category} into errors, unless they are
|
||||||
explicitly disabled by @option{-Wno-error=@var{category}}.
|
explicitly disabled by @option{-Wno-error=@var{category}}.
|
||||||
|
|
||||||
@@ -11972,7 +11984,8 @@ This is similar to how most shells resolve commands.
|
|||||||
Pretend that @code{%token-table} was specified. @xref{Decl Summary}.
|
Pretend that @code{%token-table} was specified. @xref{Decl Summary}.
|
||||||
|
|
||||||
@item -y
|
@item -y
|
||||||
@itemx @anchor{option-yacc} --yacc
|
@itemx --yacc
|
||||||
|
@anchor{option-yacc}
|
||||||
Act more like the traditional @command{yacc} command:
|
Act more like the traditional @command{yacc} command:
|
||||||
@itemize
|
@itemize
|
||||||
@item
|
@item
|
||||||
|
|||||||
Reference in New Issue
Block a user