bison
- Version:
3.8.2
- Category:
lang
- Cluster:
Vali
Description
Bison is a general-purpose parser generator that converts an annotated context-free grammar into a deterministic LR or generalized LR (GLR) parser employing LALR(1) parser tables.
Documentation
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
Examples/Usage
List bison modules:
$ module avail bison
Load the Anaconda module:
$ module load bio/Bismark/0.22.3
Check the loaded modules:
$ module list
Unload the bison module:
$ module unload bio/Bismark/0.22.3
Output version information and exit:
$ bison -V
Apply fixes to the source grammar file and exit:
$ bison -U
Installation
Source code is obtained from Bison