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

doc: simplify the cross references

Browse Source 
* doc/bison.texi: here.
This commit is contained in:
Akim Demaille
2020-02-15 09:59:50 +01:00
parent d9b2270bed
commit b0e11f4523
1 changed files with 14 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
doc/bison.texi
View File

@@ -3860,8 +3860,7 @@ For example:
This says that the two alternative types are @code{double} and @code{symrec This says that the two alternative types are @code{double} and @code{symrec
*}. They are given names @code{val} and @code{tptr}; these names are used *}. They are given names @code{val} and @code{tptr}; these names are used
in the @code{%token}, @code{%nterm} and @code{%type} declarations to pick in the @code{%token}, @code{%nterm} and @code{%type} declarations to pick
one of the types for a terminal or nonterminal symbol (@pxref{Type Decl, one of the types for a terminal or nonterminal symbol (@pxref{Type Decl}).
,Nonterminal Symbols}).
As an extension to POSIX, a tag is allowed after the @code{%union}. For As an extension to POSIX, a tag is allowed after the @code{%union}. For
example: example:
@@ -5615,8 +5614,7 @@ Decl}).
@end deffn @end deffn
@deffn {Directive} %type @deffn {Directive} %type
Declare the type of semantic values for a symbol (@pxref{Type Decl, Declare the type of semantic values for a symbol (@pxref{Type Decl}).
,Nonterminal Symbols}).
@end deffn @end deffn
@deffn {Directive} %start @deffn {Directive} %start
@@ -5700,10 +5698,9 @@ header also contains their code.
@cindex Header guard @cindex Header guard
The generated header is protected against multiple inclusions with a C The generated header is protected against multiple inclusions with a C
preprocessor guard: @samp{YY_@var{PREFIX}_@var{FILE}_INCLUDED}, where preprocessor guard: @samp{YY_@var{PREFIX}_@var{FILE}_INCLUDED}, where
@var{PREFIX} and @var{FILE} are the prefix (@pxref{Multiple Parsers, @var{PREFIX} and @var{FILE} are the prefix (@pxref{Multiple Parsers}) and
,Multiple Parsers in the Same Program}) and generated file name turned generated file name turned uppercase, with each series of non alphanumerical
uppercase, with each series of non alphanumerical characters converted to a characters converted to a single underscore.
single underscore.
For instance with @samp{%define api.prefix @{calc@}} and @samp{%defines For instance with @samp{%define api.prefix @{calc@}} and @samp{%defines
"lib/parse.h"}, the header will be guarded as follows. "lib/parse.h"}, the header will be guarded as follows.
@@ -6567,8 +6564,7 @@ token aliases is not portable.
@item @code{custom} @item @code{custom}
The user is in charge of generating the syntax error message by defining the The user is in charge of generating the syntax error message by defining the
@code{yyreport_syntax_error} function. @xref{Syntax Error Reporting @code{yyreport_syntax_error} function. @xref{Syntax Error Reporting
Function, ,The Syntax Error Reporting Function Function}.
@code{yyreport_syntax_error}}.
@end itemize @end itemize
@item Default Value: @item Default Value:
@@ -6607,10 +6603,9 @@ syntax error handling. @xref{LAC}.
@xref{Tracing}. @xref{Tracing}.
In C/C++, define the macro @code{YYDEBUG} (or @code{@var{prefix}DEBUG} with In C/C++, define the macro @code{YYDEBUG} (or @code{@var{prefix}DEBUG} with
@samp{%define api.prefix @{@var{prefix}@}}), see @ref{Multiple Parsers, @samp{%define api.prefix @{@var{prefix}@}}), see @ref{Multiple Parsers}) to
,Multiple Parsers in the Same Program}) to 1 in the parser implementation 1 in the parser implementation file if it is not already defined, so that
file if it is not already defined, so that the debugging facilities are the debugging facilities are compiled.
compiled.
@item Accepted Values: Boolean @item Accepted Values: Boolean
@@ -9397,10 +9392,9 @@ Here we assume that @code{yylex} looks at the value of @code{hexflag}; when
it is nonzero, all integers are parsed in hexadecimal, and tokens starting it is nonzero, all integers are parsed in hexadecimal, and tokens starting
with letters are parsed as integers if possible. with letters are parsed as integers if possible.
The declaration of @code{hexflag} shown in the prologue of the grammar The declaration of @code{hexflag} shown in the prologue of the grammar file
file is needed to make it accessible to the actions (@pxref{Prologue, is needed to make it accessible to the actions (@pxref{Prologue}). You must
,The Prologue}). You must also write the code in @code{yylex} to obey also write the code in @code{yylex} to obey the flag.
the flag.
@node Tie-in Recovery @node Tie-in Recovery
@section Lexical Tie-ins and Error Recovery @section Lexical Tie-ins and Error Recovery
@@ -14201,8 +14195,7 @@ file. @xref{Decl Summary}.
@end deffn @end deffn
@deffn {Directive} %type @deffn {Directive} %type
Bison declaration to declare symbol value types. @xref{Type Decl, Bison declaration to declare symbol value types. @xref{Type Decl}.
,Nonterminal Symbols}.
@end deffn @end deffn
@deffn {Symbol} $undefined @deffn {Symbol} $undefined
@@ -14252,8 +14245,7 @@ lookahead token. @xref{Error Recovery}.
@end deffn @end deffn
@deffn {Macro} YYDEBUG @deffn {Macro} YYDEBUG
Macro to define to equip the parser with tracing code. @xref{Tracing, Macro to define to equip the parser with tracing code. @xref{Tracing}.
,Tracing Your Parser}.
@end deffn @end deffn
@deffn {Variable} yydebug @deffn {Variable} yydebug