| Index: bison/src/bison/2.4.1/bison-2.4.1-src/doc/bison.1
|
| ===================================================================
|
| --- bison/src/bison/2.4.1/bison-2.4.1-src/doc/bison.1 (revision 0)
|
| +++ bison/src/bison/2.4.1/bison-2.4.1-src/doc/bison.1 (revision 0)
|
| @@ -0,0 +1,212 @@
|
| +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36.
|
| +.TH BISON "1" "December 2008" "bison 2.4.1
|
| +" "User Commands"
|
| +.SH NAME
|
| +bison \- GNU Project parser generator (yacc replacement)
|
| +.SH SYNOPSIS
|
| +.B j:\Devel\bison\2.4.1\bison-2.4.1\src\bison.exe
|
| +[\fIOPTION\fR]... \fIFILE\fR
|
| +.SH DESCRIPTION
|
| +.I Bison
|
| +is a parser generator in the style of
|
| +.IR yacc (1).
|
| +It should be upwardly compatible with input files designed
|
| +for
|
| +.IR yacc .
|
| +.PP
|
| +Input files should follow the
|
| +.I yacc
|
| +convention of ending in
|
| +.BR .y .
|
| +Unlike
|
| +.IR yacc ,
|
| +the generated files do not have fixed names, but instead use the prefix
|
| +of the input file.
|
| +Moreover, if you need to put
|
| +.I 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
|
| +.B parse.yxx
|
| +would produce the generated parser in a file named
|
| +.BR parse.tab.cxx ,
|
| +instead of
|
| +.IR yacc 's
|
| +.B y.tab.c
|
| +or old
|
| +.I Bison
|
| +version's
|
| +.BR parse.tab.c .
|
| +.PP
|
| +This description of the options that can be given to
|
| +.I bison
|
| +is adapted from the node
|
| +.B Invocation
|
| +in the
|
| +.B bison.texinfo
|
| +manual, which should be taken as authoritative.
|
| +.PP
|
| +.I Bison
|
| +supports both traditional single-letter options and mnemonic long
|
| +option names. Long option names are indicated with
|
| +.B \-\-
|
| +instead of
|
| +.BR \- .
|
| +Abbreviations for option names are allowed as long as they
|
| +are unique. When a long option takes an argument, like
|
| +.BR \-\-file-prefix ,
|
| +connect the option name and the argument with
|
| +.BR = .
|
| +.PP
|
| +Generate LALR(1) and GLR parsers.
|
| +.PP
|
| +
|
| +Mandatory arguments to long options are mandatory for short options too.
|
| +The same is true for optional arguments.
|
| +.PP
|
| +
|
| +Operation modes:
|
| +.TP
|
| +\fB\-h\fR, \fB\-\-help\fR
|
| +display this help and exit
|
| +.TP
|
| +\fB\-V\fR, \fB\-\-version\fR
|
| +output version information and exit
|
| +.TP
|
| +\fB\-\-print\-localedir\fR
|
| +output directory containing locale\-dependent data
|
| +.TP
|
| +\fB\-\-print\-datadir\fR
|
| +output directory containing skeletons and XSLT
|
| +.TP
|
| +\fB\-y\fR, \fB\-\-yacc\fR
|
| +emulate POSIX Yacc
|
| +.TP
|
| +\fB\-W\fR, \fB\-\-warnings\fR=\fI[CATEGORY]\fR
|
| +report the warnings falling in CATEGORY
|
| +.PP
|
| +
|
| +Parser:
|
| +.TP
|
| +\fB\-L\fR, \fB\-\-language\fR=\fILANGUAGE\fR
|
| +specify the output programming language
|
| +(this is an experimental feature)
|
| +.TP
|
| +\fB\-S\fR, \fB\-\-skeleton\fR=\fIFILE\fR
|
| +specify the skeleton to use
|
| +.TP
|
| +\fB\-t\fR, \fB\-\-debug\fR
|
| +instrument the parser for debugging
|
| +.TP
|
| +\fB\-\-locations\fR
|
| +enable locations computation
|
| +.TP
|
| +\fB\-p\fR, \fB\-\-name\-prefix\fR=\fIPREFIX\fR
|
| +prepend PREFIX to the external symbols
|
| +.TP
|
| +\fB\-l\fR, \fB\-\-no\-lines\fR
|
| +don't generate `#line' directives
|
| +.TP
|
| +\fB\-k\fR, \fB\-\-token\-table\fR
|
| +include a table of token names
|
| +.PP
|
| +
|
| +Output:
|
| +.TP
|
| +\fB\-\-defines\fR[=\fIFILE\fR]
|
| +also produce a header file
|
| +.TP
|
| +\fB\-d\fR
|
| +likewise but cannot specify FILE (for POSIX Yacc)
|
| +.TP
|
| +\fB\-r\fR, \fB\-\-report\fR=\fITHINGS\fR
|
| +also produce details on the automaton
|
| +.TP
|
| +\fB\-\-report\-file\fR=\fIFILE\fR
|
| +write report to FILE
|
| +.TP
|
| +\fB\-v\fR, \fB\-\-verbose\fR
|
| +same as `\-\-report=state'
|
| +.TP
|
| +\fB\-b\fR, \fB\-\-file\-prefix\fR=\fIPREFIX\fR
|
| +specify a PREFIX for output files
|
| +.TP
|
| +\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
|
| +leave output to FILE
|
| +.TP
|
| +\fB\-g\fR, \fB\-\-graph\fR[=\fIFILE\fR]
|
| +also output a graph of the automaton
|
| +.TP
|
| +\fB\-x\fR, \fB\-\-xml\fR[=\fIFILE\fR]
|
| +also output an XML report of the automaton
|
| +(the XML schema is experimental)
|
| +.PP
|
| +
|
| +Warning categories include:
|
| +.TP
|
| +`midrule\-values'
|
| +unset or unused midrule values
|
| +.TP
|
| +`yacc'
|
| +incompatibilities with POSIX YACC
|
| +.TP
|
| +`all'
|
| +all the warnings
|
| +.TP
|
| +`no\-CATEGORY'
|
| +turn off warnings in CATEGORY
|
| +.TP
|
| +`none'
|
| +turn off all the warnings
|
| +.TP
|
| +`error'
|
| +treat warnings as errors
|
| +.PP
|
| +
|
| +THINGS is a list of comma separated words that can include:
|
| +.TP
|
| +`state'
|
| +describe the states
|
| +.TP
|
| +`itemset'
|
| +complete the core item sets with their closure
|
| +.TP
|
| +`lookahead'
|
| +explicitly associate lookahead tokens to items
|
| +.TP
|
| +`solved'
|
| +describe shift/reduce conflicts solving
|
| +.TP
|
| +`all'
|
| +include all the above information
|
| +.TP
|
| +`none'
|
| +disable the report
|
| +.PP
|
| +
|
| +.SH AUTHOR
|
| +Written by Robert Corbett and Richard Stallman.
|
| +.PP
|
| +
|
| +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.
|
| +.SH "REPORTING BUGS"
|
| +Report bugs to <bug\-bison@gnu.org>.
|
| +.SH "SEE ALSO"
|
| +.BR lex (1),
|
| +.BR flex (1),
|
| +.BR yacc (1).
|
| +.PP
|
| +The full documentation for
|
| +.B bison
|
| +is maintained as a Texinfo manual. If the
|
| +.B info
|
| +and
|
| +.B bison
|
| +programs are properly installed at your site, the command
|
| +.IP
|
| +.B info bison
|
| +.PP
|
| +should give you access to the complete manual.
|
|
|