102 lines
4.8 KiB
Plaintext
102 lines
4.8 KiB
Plaintext
bison (GNU Bison) 3.8.2
|
|
Written by Robert Corbett and Richard Stallman.
|
|
|
|
Copyright (C) 2021 Free Software Foundation, Inc.
|
|
This is free software; see the source for copying conditions. There is NO
|
|
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
Usage: bison [OPTION]... FILE
|
|
Generate a deterministic LR or generalized LR (GLR) parser employing
|
|
LALR(1), IELR(1), or canonical LR(1) parser tables.
|
|
|
|
Mandatory arguments to long options are mandatory for short options too.
|
|
The same is true for optional arguments.
|
|
|
|
Operation Modes:
|
|
-h, --help display this help and exit
|
|
-V, --version output version information and exit
|
|
--print-localedir output directory containing locale-dependent data
|
|
and exit
|
|
--print-datadir output directory containing skeletons and XSLT
|
|
and exit
|
|
-u, --update apply fixes to the source grammar file and exit
|
|
-f, --feature[=FEATURES] activate miscellaneous features
|
|
|
|
FEATURES is a list of comma separated words that can include:
|
|
caret, diagnostics-show-caret
|
|
show errors with carets
|
|
fixit, diagnostics-parseable-fixits
|
|
show machine-readable fixes
|
|
syntax-only do not generate any file
|
|
all all of the above
|
|
none disable all of the above
|
|
|
|
Diagnostics:
|
|
-W, --warnings[=CATEGORY] report the warnings falling in CATEGORY
|
|
--color[=WHEN] whether to colorize the diagnostics
|
|
--style=FILE specify the CSS FILE for colorizer diagnostics
|
|
|
|
Warning categories include:
|
|
conflicts-sr S/R conflicts (enabled by default)
|
|
conflicts-rr R/R conflicts (enabled by default)
|
|
counterexamples, cex
|
|
generate conflict counterexamples
|
|
dangling-alias string aliases not attached to a symbol
|
|
deprecated obsolete constructs
|
|
empty-rule empty rules without %empty
|
|
midrule-values unset or unused midrule values
|
|
precedence useless precedence and associativity
|
|
yacc incompatibilities with POSIX Yacc
|
|
other all other warnings (enabled by default)
|
|
all all the warnings except 'counterexamples', 'dangling-alias' and 'yacc'
|
|
no-CATEGORY turn off warnings in CATEGORY
|
|
none turn off all the warnings
|
|
error[=CATEGORY] treat warnings as errors
|
|
|
|
WHEN can be one of the following:
|
|
always, yes colorize the output
|
|
never, no don't colorize the output
|
|
auto, tty colorize if the output device is a tty
|
|
|
|
Tuning the Parser:
|
|
-L, --language=LANGUAGE specify the output programming language
|
|
-S, --skeleton=FILE specify the skeleton to use
|
|
-t, --debug instrument the parser for tracing
|
|
same as '-Dparse.trace'
|
|
--locations enable location support
|
|
-D, --define=NAME[=VALUE] similar to '%define NAME VALUE'
|
|
-F, --force-define=NAME[=VALUE] override '%define NAME VALUE'
|
|
-p, --name-prefix=PREFIX prepend PREFIX to the external symbols
|
|
deprecated by '-Dapi.prefix={PREFIX}'
|
|
-l, --no-lines don't generate '#line' directives
|
|
-k, --token-table include a table of token names
|
|
-y, --yacc emulate POSIX Yacc
|
|
|
|
Output Files:
|
|
-H, --header=[FILE] also produce a header file
|
|
-d likewise but cannot specify FILE (for POSIX Yacc)
|
|
-r, --report=THINGS also produce details on the automaton
|
|
--report-file=FILE write report to FILE
|
|
-v, --verbose same as '--report=state'
|
|
-b, --file-prefix=PREFIX specify a PREFIX for output files
|
|
-o, --output=FILE leave output to FILE
|
|
-g, --graph[=FILE] also output a graph of the automaton
|
|
--html[=FILE] also output an HTML report of the automaton
|
|
-x, --xml[=FILE] also output an XML report of the automaton
|
|
-M, --file-prefix-map=OLD=NEW replace prefix OLD with NEW when writing file paths
|
|
in output files
|
|
|
|
THINGS is a list of comma separated words that can include:
|
|
states describe the states
|
|
itemsets complete the core item sets with their closure
|
|
lookaheads explicitly associate lookahead tokens to items
|
|
solved describe shift/reduce conflicts solving
|
|
counterexamples, cex
|
|
generate conflict counterexamples
|
|
all include all the above information
|
|
none disable the report
|
|
|
|
Report bugs to <bug-bison@gnu.org>.
|
|
GNU Bison home page: <https://www.gnu.org/software/bison/>.
|
|
General help using GNU software: <https://www.gnu.org/gethelp/>.
|
|
For complete documentation, run: info bison.
|