Future/bison
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/bison.git synced 2026-03-14 14:53:03 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: minor fixes

Browse Source 
* doc/bison.texi: Use stderr for error messages.
Meta-variables are usually spelled in lower case.
Use @code for function names.
This commit is contained in:
Akim Demaille
2012-11-29 14:35:48 +01:00
parent 371f1b2b7b
commit 511dd971ba
1 changed files with 11 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
doc/bison.texi
View File

@@ -2452,7 +2452,7 @@ function that initializes the symbol table. Here it is, and
void void
yyerror (char const *s) yyerror (char const *s)
@{ @{
printf ("%s\n", s); fprintf (stderr, "%s\n", s);
@} @}
@end group @end group
@@ -5379,8 +5379,9 @@ The value may be omitted: this is equivalent to specifying @code{true}, as is
the case for Boolean values. the case for Boolean values.
When @code{%define api.pure full} is used, the parser is made reentrant. This When @code{%define api.pure full} is used, the parser is made reentrant. This
changes the signature for yylex (@pxref{Pure Calling}), and also that of changes the signature for @code{yylex} (@pxref{Pure Calling}), and also that of
yyerror when the tracking of locations has been activated, as shown below. @code{yyerror} when the tracking of locations has been activated, as shown
below.
The @code{true} value is very similar to the @code{full} value, the only The @code{true} value is very similar to the @code{full} value, the only
difference is in the signature of @code{yyerror} on Yacc parsers without difference is in the signature of @code{yyerror} on Yacc parsers without
@@ -7363,9 +7364,9 @@ mysterious behavior altogether. You simply need to activate a more powerful
parser table construction algorithm by using the @code{%define lr.type} parser table construction algorithm by using the @code{%define lr.type}
directive. directive.
@deffn {Directive} {%define lr.type} @var{TYPE} @deffn {Directive} {%define lr.type} @var{type}
Specify the type of parser tables within the LR(1) family. The accepted Specify the type of parser tables within the LR(1) family. The accepted
values for @var{TYPE} are: values for @var{type} are:
@itemize @itemize
@item @code{lalr} (default) @item @code{lalr} (default)
@@ -7552,9 +7553,9 @@ split the parse instead.
To adjust which states have default reductions enabled, use the To adjust which states have default reductions enabled, use the
@code{%define lr.default-reductions} directive. @code{%define lr.default-reductions} directive.
@deffn {Directive} {%define lr.default-reductions} @var{WHERE} @deffn {Directive} {%define lr.default-reductions} @var{where}
Specify the kind of states that are permitted to contain default reductions. Specify the kind of states that are permitted to contain default reductions.
The accepted values of @var{WHERE} are: The accepted values of @var{where} are:
@itemize @itemize
@item @code{most} (default for LALR and IELR) @item @code{most} (default for LALR and IELR)
@item @code{consistent} @item @code{consistent}
@@ -7592,7 +7593,7 @@ that solves these problems for canonical LR, IELR, and LALR without
sacrificing @code{%nonassoc}, default reductions, or state merging. You can sacrificing @code{%nonassoc}, default reductions, or state merging. You can
enable LAC with the @code{%define parse.lac} directive. enable LAC with the @code{%define parse.lac} directive.
@deffn {Directive} {%define parse.lac} @var{VALUE} @deffn {Directive} {%define parse.lac} @var{value}
Enable LAC to improve syntax error handling. Enable LAC to improve syntax error handling.
@itemize @itemize
@item @code{none} (default) @item @code{none} (default)
@@ -7688,9 +7689,9 @@ resolution because they are useless in the generated parser. However,
keeping unreachable states is sometimes useful when trying to understand the keeping unreachable states is sometimes useful when trying to understand the
relationship between the parser and the grammar. relationship between the parser and the grammar.
@deffn {Directive} {%define lr.keep-unreachable-states} @var{VALUE} @deffn {Directive} {%define lr.keep-unreachable-states} @var{value}
Request that Bison allow unreachable states to remain in the parser tables. Request that Bison allow unreachable states to remain in the parser tables.
@var{VALUE} must be a Boolean. The default is @code{false}. @var{value} must be a Boolean. The default is @code{false}.
@end deffn @end deffn
There are a few caveats to consider: There are a few caveats to consider: