mirror of
https://git.savannah.gnu.org/git/bison.git
synced 2026-03-09 20:33:03 +00:00
doc: add anchors for warnings
Unfortunately Texinfo somewhat mangles anchors such as `-Werror` into `g_t_002dWerror`, so let's not include the dash. * doc/bison.texi (Diagnostics): here.
This commit is contained in:
@@ -11015,7 +11015,7 @@ The exit status of @command{bison} is:
|
|||||||
@item 0 (success)
|
@item 0 (success)
|
||||||
when there were no errors. Warnings, which are diagnostics about dubious
|
when there were no errors. Warnings, which are diagnostics about dubious
|
||||||
constructs, do not change the exit status, unless they are turned into
|
constructs, do not change the exit status, unless they are turned into
|
||||||
errors (@pxref{-Werror,,@option{-Werror}}).
|
errors (@pxref{Werror,,@option{-Werror}}).
|
||||||
|
|
||||||
@item 1 (failure)
|
@item 1 (failure)
|
||||||
when there were errors. No file was generated (except the reports generated
|
when there were errors. No file was generated (except the reports generated
|
||||||
@@ -11252,22 +11252,22 @@ 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 conflicts-sr
|
@item @anchor{Wconflicts-sr}conflicts-sr
|
||||||
@itemx conflicts-rr
|
@itemx @anchor{Wconflicts-rr}conflicts-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 counterexamples
|
@item @anchor{Wcounterexamples}counterexamples
|
||||||
@itemx cex
|
@itemx cex
|
||||||
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 dangling-alias
|
@item @anchor{Wdangling-alias}dangling-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
|
||||||
@@ -11313,16 +11313,16 @@ foo: "baz" @{@}
|
|||||||
| @dwarning{^~~~~}
|
| @dwarning{^~~~~}
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@item deprecated
|
@item @anchor{Wdeprecated}deprecated
|
||||||
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 empty-rule
|
@item @anchor{Wempty-rule}empty-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 midrule-values
|
@item @anchor{Wmidrule-values}midrule-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:
|
||||||
@@ -11342,7 +11342,7 @@ 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 precedence
|
@item @anchor{Wprecedence}precedence
|
||||||
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:
|
||||||
@@ -11403,20 +11403,20 @@ One would get the exact same parser with the following directives instead:
|
|||||||
@end group
|
@end group
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@item yacc
|
@item @anchor{Wyacc}yacc
|
||||||
Incompatibilities with POSIX Yacc.
|
Incompatibilities with POSIX Yacc.
|
||||||
|
|
||||||
@item other
|
@item @anchor{Wother}other
|
||||||
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 all
|
@item @anchor{Wall}all
|
||||||
All the warnings except @code{dangling-alias} and @code{yacc}.
|
All the warnings except @code{dangling-alias} and @code{yacc}.
|
||||||
|
|
||||||
@item none
|
@item @anchor{Wnone}none
|
||||||
Turn off all the warnings.
|
Turn off all the warnings.
|
||||||
|
|
||||||
@item error
|
@item error
|
||||||
@@ -11427,8 +11427,7 @@ 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 -Werror
|
@item @anchor{Werror}-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}}.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user