OLD | NEW |
(Empty) | |
| 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. |
| 2 .TH BISON "1" "December 2008" "bison 2.4.1 |
| 3 " "User Commands" |
| 4 .SH NAME |
| 5 bison \- GNU Project parser generator (yacc replacement) |
| 6 .SH SYNOPSIS |
| 7 .B j:\Devel\bison\2.4.1\bison-2.4.1\src\bison.exe |
| 8 [\fIOPTION\fR]... \fIFILE\fR |
| 9 .SH DESCRIPTION |
| 10 .I Bison |
| 11 is a parser generator in the style of |
| 12 .IR yacc (1). |
| 13 It should be upwardly compatible with input files designed |
| 14 for |
| 15 .IR yacc . |
| 16 .PP |
| 17 Input files should follow the |
| 18 .I yacc |
| 19 convention of ending in |
| 20 .BR .y . |
| 21 Unlike |
| 22 .IR yacc , |
| 23 the generated files do not have fixed names, but instead use the prefix |
| 24 of the input file. |
| 25 Moreover, if you need to put |
| 26 .I C++ |
| 27 code in the input file, you can end his name by a C++-like extension |
| 28 (.ypp or .y++), then bison will follow your extension to name the |
| 29 output file (.cpp or .c++). |
| 30 For instance, a grammar description file named |
| 31 .B parse.yxx |
| 32 would produce the generated parser in a file named |
| 33 .BR parse.tab.cxx , |
| 34 instead of |
| 35 .IR yacc 's |
| 36 .B y.tab.c |
| 37 or old |
| 38 .I Bison |
| 39 version's |
| 40 .BR parse.tab.c . |
| 41 .PP |
| 42 This description of the options that can be given to |
| 43 .I bison |
| 44 is adapted from the node |
| 45 .B Invocation |
| 46 in the |
| 47 .B bison.texinfo |
| 48 manual, which should be taken as authoritative. |
| 49 .PP |
| 50 .I Bison |
| 51 supports both traditional single-letter options and mnemonic long |
| 52 option names. Long option names are indicated with |
| 53 .B \-\- |
| 54 instead of |
| 55 .BR \- . |
| 56 Abbreviations for option names are allowed as long as they |
| 57 are unique. When a long option takes an argument, like |
| 58 .BR \-\-file-prefix , |
| 59 connect the option name and the argument with |
| 60 .BR = . |
| 61 .PP |
| 62 Generate LALR(1) and GLR parsers. |
| 63 .PP |
| 64 |
| 65 Mandatory arguments to long options are mandatory for short options too. |
| 66 The same is true for optional arguments. |
| 67 .PP |
| 68 |
| 69 Operation modes: |
| 70 .TP |
| 71 \fB\-h\fR, \fB\-\-help\fR |
| 72 display this help and exit |
| 73 .TP |
| 74 \fB\-V\fR, \fB\-\-version\fR |
| 75 output version information and exit |
| 76 .TP |
| 77 \fB\-\-print\-localedir\fR |
| 78 output directory containing locale\-dependent data |
| 79 .TP |
| 80 \fB\-\-print\-datadir\fR |
| 81 output directory containing skeletons and XSLT |
| 82 .TP |
| 83 \fB\-y\fR, \fB\-\-yacc\fR |
| 84 emulate POSIX Yacc |
| 85 .TP |
| 86 \fB\-W\fR, \fB\-\-warnings\fR=\fI[CATEGORY]\fR |
| 87 report the warnings falling in CATEGORY |
| 88 .PP |
| 89 |
| 90 Parser: |
| 91 .TP |
| 92 \fB\-L\fR, \fB\-\-language\fR=\fILANGUAGE\fR |
| 93 specify the output programming language |
| 94 (this is an experimental feature) |
| 95 .TP |
| 96 \fB\-S\fR, \fB\-\-skeleton\fR=\fIFILE\fR |
| 97 specify the skeleton to use |
| 98 .TP |
| 99 \fB\-t\fR, \fB\-\-debug\fR |
| 100 instrument the parser for debugging |
| 101 .TP |
| 102 \fB\-\-locations\fR |
| 103 enable locations computation |
| 104 .TP |
| 105 \fB\-p\fR, \fB\-\-name\-prefix\fR=\fIPREFIX\fR |
| 106 prepend PREFIX to the external symbols |
| 107 .TP |
| 108 \fB\-l\fR, \fB\-\-no\-lines\fR |
| 109 don't generate `#line' directives |
| 110 .TP |
| 111 \fB\-k\fR, \fB\-\-token\-table\fR |
| 112 include a table of token names |
| 113 .PP |
| 114 |
| 115 Output: |
| 116 .TP |
| 117 \fB\-\-defines\fR[=\fIFILE\fR] |
| 118 also produce a header file |
| 119 .TP |
| 120 \fB\-d\fR |
| 121 likewise but cannot specify FILE (for POSIX Yacc) |
| 122 .TP |
| 123 \fB\-r\fR, \fB\-\-report\fR=\fITHINGS\fR |
| 124 also produce details on the automaton |
| 125 .TP |
| 126 \fB\-\-report\-file\fR=\fIFILE\fR |
| 127 write report to FILE |
| 128 .TP |
| 129 \fB\-v\fR, \fB\-\-verbose\fR |
| 130 same as `\-\-report=state' |
| 131 .TP |
| 132 \fB\-b\fR, \fB\-\-file\-prefix\fR=\fIPREFIX\fR |
| 133 specify a PREFIX for output files |
| 134 .TP |
| 135 \fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR |
| 136 leave output to FILE |
| 137 .TP |
| 138 \fB\-g\fR, \fB\-\-graph\fR[=\fIFILE\fR] |
| 139 also output a graph of the automaton |
| 140 .TP |
| 141 \fB\-x\fR, \fB\-\-xml\fR[=\fIFILE\fR] |
| 142 also output an XML report of the automaton |
| 143 (the XML schema is experimental) |
| 144 .PP |
| 145 |
| 146 Warning categories include: |
| 147 .TP |
| 148 `midrule\-values' |
| 149 unset or unused midrule values |
| 150 .TP |
| 151 `yacc' |
| 152 incompatibilities with POSIX YACC |
| 153 .TP |
| 154 `all' |
| 155 all the warnings |
| 156 .TP |
| 157 `no\-CATEGORY' |
| 158 turn off warnings in CATEGORY |
| 159 .TP |
| 160 `none' |
| 161 turn off all the warnings |
| 162 .TP |
| 163 `error' |
| 164 treat warnings as errors |
| 165 .PP |
| 166 |
| 167 THINGS is a list of comma separated words that can include: |
| 168 .TP |
| 169 `state' |
| 170 describe the states |
| 171 .TP |
| 172 `itemset' |
| 173 complete the core item sets with their closure |
| 174 .TP |
| 175 `lookahead' |
| 176 explicitly associate lookahead tokens to items |
| 177 .TP |
| 178 `solved' |
| 179 describe shift/reduce conflicts solving |
| 180 .TP |
| 181 `all' |
| 182 include all the above information |
| 183 .TP |
| 184 `none' |
| 185 disable the report |
| 186 .PP |
| 187 |
| 188 .SH AUTHOR |
| 189 Written by Robert Corbett and Richard Stallman. |
| 190 .PP |
| 191 |
| 192 Copyright (C) 2008 Free Software Foundation, Inc. |
| 193 This is free software; see the source for copying conditions. There is NO |
| 194 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
| 195 .SH "REPORTING BUGS" |
| 196 Report bugs to <bug\-bison@gnu.org>. |
| 197 .SH "SEE ALSO" |
| 198 .BR lex (1), |
| 199 .BR flex (1), |
| 200 .BR yacc (1). |
| 201 .PP |
| 202 The full documentation for |
| 203 .B bison |
| 204 is maintained as a Texinfo manual. If the |
| 205 .B info |
| 206 and |
| 207 .B bison |
| 208 programs are properly installed at your site, the command |
| 209 .IP |
| 210 .B info bison |
| 211 .PP |
| 212 should give you access to the complete manual. |
OLD | NEW |