mirror of
https://git.savannah.gnu.org/git/bison.git
synced 2026-03-10 04:43:03 +00:00
doc: improve man page (mostly fonts)
Problems reported by Helge Kreutzmann in: https://lists.gnu.org/r/bug-bison/2026-01/msg00000.html * doc/bison.x: Refontify, mostly. * src/getargs.c (usage): Clarify usage message.
This commit is contained in:
57
doc/bison.x
57
doc/bison.x
@@ -2,48 +2,49 @@
|
|||||||
bison \- GNU Project parser generator (yacc replacement)
|
bison \- GNU Project parser generator (yacc replacement)
|
||||||
|
|
||||||
[description]
|
[description]
|
||||||
.I Bison
|
The
|
||||||
is a parser generator in the style of
|
.B bison
|
||||||
.IR yacc (1).
|
parser generator inputs grammars in the style of
|
||||||
It should be upwardly compatible with input files designed
|
.BR yacc (1)
|
||||||
for
|
and outputs parsers for those grammers.
|
||||||
.IR yacc .
|
|
||||||
.PP
|
.PP
|
||||||
Input files should follow the
|
Input files should follow the
|
||||||
.I yacc
|
.B yacc
|
||||||
convention of ending in
|
convention of ending in
|
||||||
.BR .y .
|
.IR .y .
|
||||||
Unlike
|
Unlike
|
||||||
.IR yacc ,
|
.BR yacc ,
|
||||||
the generated files do not have fixed names, but instead use the prefix
|
the generated files do not have fixed names, but instead use the prefix
|
||||||
of the input file.
|
of the input file.
|
||||||
Moreover, if you need to put
|
Moreover, if you need to put C++
|
||||||
.I C++
|
code in the input file, you can end its name by a C++-like extension
|
||||||
code in the input file, you can end his name by a C++-like extension
|
.RI ( .ypp
|
||||||
(.ypp or .y++), then bison will follow your extension to name the
|
or
|
||||||
output file (.cpp or .c++).
|
.IR .y++ ),
|
||||||
|
and then
|
||||||
|
.B bison
|
||||||
|
will follow your extension to name the
|
||||||
|
output file
|
||||||
|
.RI ( .cpp
|
||||||
|
or
|
||||||
|
.IR .c++ ).
|
||||||
For instance, a grammar description file named
|
For instance, a grammar description file named
|
||||||
.B parse.yxx
|
.I parse.yxx
|
||||||
would produce the generated parser in a file named
|
would produce the generated parser in a file named
|
||||||
.BR parse.tab.cxx ,
|
.IR parse.tab.cxx ,
|
||||||
instead of
|
instead of
|
||||||
.IR yacc 's
|
.BR yacc 's
|
||||||
.B y.tab.c
|
.IR y.tab.c .
|
||||||
or old
|
|
||||||
.I Bison
|
|
||||||
version's
|
|
||||||
.BR parse.tab.c .
|
|
||||||
.PP
|
.PP
|
||||||
This description of the options that can be given to
|
This description of the options that can be given to
|
||||||
.I bison
|
.B bison
|
||||||
is adapted from the node
|
is adapted from the node
|
||||||
.B Invocation
|
.B Invocation
|
||||||
in the
|
in the Bison manual, which should be taken as authoritative.
|
||||||
.B bison.texi
|
|
||||||
manual, which should be taken as authoritative.
|
|
||||||
.PP
|
.PP
|
||||||
.I Bison
|
The
|
||||||
supports both traditional single-letter options and mnemonic long
|
.B bison
|
||||||
|
command supports both traditional single-letter options and mnemonic long
|
||||||
option names. Long option names are indicated with
|
option names. Long option names are indicated with
|
||||||
.B \-\-
|
.B \-\-
|
||||||
instead of
|
instead of
|
||||||
|
|||||||
@@ -422,12 +422,12 @@ Diagnostics:\n\
|
|||||||
Tuning the Parser:\n\
|
Tuning the Parser:\n\
|
||||||
-L, --language=LANGUAGE specify the output programming language\n\
|
-L, --language=LANGUAGE specify the output programming language\n\
|
||||||
-S, --skeleton=FILE specify the skeleton to use\n\
|
-S, --skeleton=FILE specify the skeleton to use\n\
|
||||||
-t, --debug instrument the parser for tracing\n\
|
-t, --debug instrument the parser for tracing;\n\
|
||||||
same as '-Dparse.trace'\n\
|
same as '-Dparse.trace'\n\
|
||||||
--locations enable location support\n\
|
--locations enable location support\n\
|
||||||
-D, --define=NAME[=VALUE] similar to '%define NAME VALUE'\n\
|
-D, --define=NAME[=VALUE] similar to '%define NAME VALUE'\n\
|
||||||
-F, --force-define=NAME[=VALUE] override '%define NAME VALUE'\n\
|
-F, --force-define=NAME[=VALUE] override '%define NAME VALUE'\n\
|
||||||
-p, --name-prefix=PREFIX prepend PREFIX to the external symbols\n\
|
-p, --name-prefix=PREFIX prepend PREFIX to the external symbols;\n\
|
||||||
deprecated by '-Dapi.prefix={PREFIX}'\n\
|
deprecated by '-Dapi.prefix={PREFIX}'\n\
|
||||||
-l, --no-lines don't generate '#line' directives\n\
|
-l, --no-lines don't generate '#line' directives\n\
|
||||||
-k, --token-table include a table of token names\n\
|
-k, --token-table include a table of token names\n\
|
||||||
@@ -443,7 +443,7 @@ Output Files:\n\
|
|||||||
--report-file=FILE write report to FILE\n\
|
--report-file=FILE write report to FILE\n\
|
||||||
-v, --verbose same as '--report=state'\n\
|
-v, --verbose same as '--report=state'\n\
|
||||||
-b, --file-prefix=PREFIX specify a PREFIX for output files\n\
|
-b, --file-prefix=PREFIX specify a PREFIX for output files\n\
|
||||||
-o, --output=FILE leave output to FILE\n\
|
-o, --output=FILE output to FILE\n\
|
||||||
-g, --graph[=FILE] also output a graph of the automaton\n\
|
-g, --graph[=FILE] also output a graph of the automaton\n\
|
||||||
--html[=FILE] also output an HTML report of the automaton\n\
|
--html[=FILE] also output an HTML report of the automaton\n\
|
||||||
-x, --xml[=FILE] also output an XML report of the automaton\n\
|
-x, --xml[=FILE] also output an XML report of the automaton\n\
|
||||||
|
|||||||
Reference in New Issue
Block a user