| Index: bison/man/cat1/bison.1.txt
|
| ===================================================================
|
| --- bison/man/cat1/bison.1.txt (revision 0)
|
| +++ bison/man/cat1/bison.1.txt (revision 0)
|
| @@ -0,0 +1,188 @@
|
| +BISON(1) User Commands BISON(1)
|
| +
|
| +
|
| +
|
| +NAME s
|
| + bison - GNU Project parser generator (yacc replacement)
|
| + n
|
| +SYNOPSIS 2
|
| + j:l. [OPTION]... FILE
|
| + 4
|
| +DESCRIPTION
|
| + Bison is a parser generator in the style of yacc(1). It
|
| + should be upwardly compatible with input files designed
|
| + for yacc.
|
| +
|
| + Input files should follow the yacc convention of ending
|
| + in .y. Unlike yacc, the generated files do not have
|
| + fixed names, but instead use the prefix of the input
|
| + file. Moreover, if you need to put C++ code in the
|
| + input file, you can end his name by a C++-like extension
|
| + (.ypp or .y++), then bison will follow your extension to
|
| + name the output file (.cpp or .c++). For instance, a
|
| + grammar description file named parse.yxx would produce
|
| + the generated parser in a file named parse.tab.cxx,
|
| + instead of yacc's y.tab.c or old Bison version's
|
| + parse.tab.c.
|
| +
|
| + This description of the options that can be given to
|
| + bison is adapted from the node Invocation in the
|
| + bison.texinfo manual, which should be taken as authori-
|
| + tative.
|
| +
|
| + Bison supports both traditional single-letter options
|
| + and mnemonic long option names. Long option names are
|
| + indicated with -- instead of -. Abbreviations for
|
| + option names are allowed as long as they are unique.
|
| + When a long option takes an argument, like --file-pre-
|
| + fix, connect the option name and the argument with =.
|
| +
|
| + Generate LALR(1) and GLR parsers.
|
| +
|
| +
|
| + Mandatory arguments to long options are mandatory for
|
| + short options too. The same is true for optional argu-
|
| + ments.
|
| +
|
| +
|
| + Operation modes:
|
| +
|
| + -h, --help
|
| + display this help and exit
|
| +
|
| + -V, --version
|
| + output version information and exit
|
| +
|
| + --print-localedir
|
| + output directory containing locale-dependent data
|
| +
|
| + --print-datadir
|
| + output directory containing skeletons and XSLT
|
| +
|
| + -y, --yacc
|
| + emulate POSIX Yacc
|
| +
|
| + -W, --warnings=[CATEGORY]
|
| + report the warnings falling in CATEGORY
|
| +
|
| +
|
| + Parser:
|
| +
|
| + -L, --language=LANGUAGE
|
| + specify the output programming language (this is
|
| + an experimental feature)
|
| +
|
| + -S, --skeleton=FILE
|
| + specify the skeleton to use
|
| +
|
| + -t, --debug
|
| + instrument the parser for debugging
|
| +
|
| + --locations
|
| + enable locations computation
|
| +
|
| + -p, --name-prefix=PREFIX
|
| + prepend PREFIX to the external symbols
|
| +
|
| + -l, --no-lines
|
| + don't generate `#line' directives
|
| +
|
| + -k, --token-table
|
| + include a table of token names
|
| +
|
| +
|
| + Output:
|
| +
|
| + --defines[=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
|
| +
|
| + -x, --xml[=FILE]
|
| + also output an XML report of the automaton (the
|
| + XML schema is experimental)
|
| +
|
| +
|
| + Warning categories include:
|
| +
|
| + `midrule-values'
|
| + unset or unused midrule values
|
| +
|
| + `yacc' incompatibilities with POSIX YACC
|
| +
|
| + `all' all the warnings
|
| +
|
| + `no-CATEGORY'
|
| + turn off warnings in CATEGORY
|
| +
|
| + `none' turn off all the warnings
|
| +
|
| + `error'
|
| + treat warnings as errors
|
| +
|
| +
|
| + THINGS is a list of comma separated words that can
|
| + include:
|
| +
|
| + `state'
|
| + describe the states
|
| +
|
| + `itemset'
|
| + complete the core item sets with their closure
|
| +
|
| + `lookahead'
|
| + explicitly associate lookahead tokens to items
|
| +
|
| + `solved'
|
| + describe shift/reduce conflicts solving
|
| +
|
| + `all' include all the above information
|
| +
|
| + `none' disable the report
|
| +
|
| +
|
| +
|
| +AUTHOR
|
| + Written by Robert Corbett and Richard Stallman.
|
| +
|
| +
|
| + Copyright (C) 2008 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.
|
| +
|
| +REPORTING BUGS
|
| + Report bugs to <bug-bison@gnu.org>.
|
| +
|
| +SEE ALSO
|
| + lex(1), flex(1), yacc(1).
|
| +
|
| + The full documentation for bison is maintained as a Tex-
|
| + info manual. If the info and bison programs are prop-
|
| + erly installed at your site, the command
|
| +
|
| + info bison
|
| +
|
| + should give you access to the complete manual.
|
| +
|
| +
|
| +
|
| +bison 2.4.1 December 2008 BISON(1)
|
|
|
| Property changes on: bison\man\cat1\bison.1.txt
|
| ___________________________________________________________________
|
| Added: svn:eol-style
|
| + LF
|
|
|
|
|