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

%param: documentation.

Browse Source 
* NEWS (2.6): Document %param, %lex-param, and %parse-param
	changes.
	* doc/bison.texinfo: Document that %lex-param and %parse-param
	are n-ary.
	Changes some examples to demonstrate it.
	(Calc++ Parser): Use %param.
This commit is contained in:
Akim Demaille
2009-09-07 08:05:43 +02:00
parent dd875058b2
commit 2055a44ed2
3 changed files with 76 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
ChangeLog
View File

@@ -1,3 +1,13 @@
2009-09-09 Akim Demaille <demaille@gostai.com>
%param: documentation.
* NEWS (2.6): Document %param, %lex-param, and %parse-param
changes.
* doc/bison.texinfo: Document that %lex-param and %parse-param
are n-ary.
Changes some examples to demonstrate it.
(Calc++ Parser): Use %param.
2009-09-09 Akim Demaille <demaille@gostai.com> 2009-09-09 Akim Demaille <demaille@gostai.com>
Regen. Regen.

17
NEWS
View File

@@ -3,7 +3,22 @@ Bison News
* Changes in version ?.? (????-??-??): * Changes in version ?.? (????-??-??):
** Java skeleton improvements: ** Additional yylex/yyparse arguments
The new directive %param declare additional argument to both yylex
and yyparse. The %lex-param, %parse-param, and %param directive
support one or more arguments. Instead of
%lex-param {arg1_type *arg1}
%lex-param {arg2_type *arg2}
%parse-param {arg1_type *arg1}
%parse-param {arg2_type *arg2}
one may now declare
%param {arg1_type *arg1} {arg2_type *arg2}
** Java skeleton improvements
The constants for token names were moved to the Lexer interface. The constants for token names were moved to the Lexer interface.
Also, it is possible to add code to the parser's constructors using Also, it is possible to add code to the parser's constructors using

85
doc/bison.texinfo
View File

@@ -5550,10 +5550,10 @@ If you use a reentrant parser, you can optionally pass additional
parameter information to it in a reentrant way. To do so, use the parameter information to it in a reentrant way. To do so, use the
declaration @code{%parse-param}: declaration @code{%parse-param}:
@deffn {Directive} %parse-param @{@var{argument-declaration}@} @deffn {Directive} %parse-param @{@var{argument-declaration}@} @dots{}
@findex %parse-param @findex %parse-param
Declare that an argument declared by the braced-code Declare that one or more
@var{argument-declaration} is an additional @code{yyparse} argument. @var{argument-declaration} are additional @code{yyparse} arguments.
The @var{argument-declaration} is used when declaring The @var{argument-declaration} is used when declaring
functions or prototypes. The last identifier in functions or prototypes. The last identifier in
@var{argument-declaration} must be the argument name. @var{argument-declaration} must be the argument name.
@@ -5562,8 +5562,7 @@ functions or prototypes. The last identifier in
Here's an example. Write this in the parser: Here's an example. Write this in the parser:
@example @example
%parse-param @{int *nastiness@} %parse-param @{int *nastiness@} @{int *randomness@}
%parse-param @{int *randomness@}
@end example @end example
@noindent @noindent
@@ -5859,46 +5858,57 @@ textual locations, then the type @code{YYLTYPE} will not be defined. In
this case, omit the second argument; @code{yylex} will be called with this case, omit the second argument; @code{yylex} will be called with
only one argument. only one argument.
If you wish to pass additional arguments to @code{yylex}, use
If you wish to pass the additional parameter data to @code{yylex}, use
@code{%lex-param} just like @code{%parse-param} (@pxref{Parser @code{%lex-param} just like @code{%parse-param} (@pxref{Parser
Function}). Function}). To pass additional arguments to both @code{yylex} and
@code{yyparse}, use @code{%param}.
@deffn {Directive} lex-param @{@var{argument-declaration}@} @deffn {Directive} %lex-param @{@var{argument-declaration}@} @dots{}
@findex %lex-param @findex %lex-param
Declare that the braced-code @var{argument-declaration} is an Specify that @var{argument-declaration} are additional @code{yylex} argument
additional @code{yylex} argument declaration. declarations. You may pass one or more such declarations, which is
equivalent to repeating @code{%lex-param}.
@end deffn
@deffn {Directive} %param @{@var{argument-declaration}@} @dots{}
@findex %param
Specify that @var{argument-declaration} are additional
@code{yylex}/@code{yyparse} argument declaration. This is equivalent to
@samp{%lex-param @{@var{argument-declaration}@} @dots{} %parse-param
@{@var{argument-declaration}@} @dots{}}. You may pass one or more
declarations, which is equivalent to repeating @code{%param}.
@end deffn @end deffn
For instance: For instance:
@example @example
%parse-param @{int *nastiness@} %lex-param @{scanner_mode *mode@}
%lex-param @{int *nastiness@} %parse-param @{parser_mode *mode@}
%parse-param @{int *randomness@} %param @{environment_type *env@}
@end example @end example
@noindent @noindent
results in the following signature: results in the following signature:
@example @example
int yylex (int *nastiness); int yylex (scanner_mode *mode, environment_type *env);
int yyparse (int *nastiness, int *randomness); int yyparse (parser_mode *mode, environment_type *env);
@end example @end example
If @samp{%define api.pure} is added: If @samp{%define api.pure} is added:
@example @example
int yylex (YYSTYPE *lvalp, int *nastiness); int yylex (YYSTYPE *lvalp, scanner_mode *mode, environment_type *env);
int yyparse (int *nastiness, int *randomness); int yyparse (parser_mode *mode, environment_type *env);
@end example @end example
@noindent @noindent
and finally, if both @samp{%define api.pure} and @code{%locations} are used: and finally, if both @samp{%define api.pure} and @code{%locations} are used:
@example @example
int yylex (YYSTYPE *lvalp, YYLTYPE *llocp, int *nastiness); int yylex (YYSTYPE *lvalp, YYLTYPE *llocp,
int yyparse (int *nastiness, int *randomness); scanner_mode *mode, environment_type *env);
int yyparse (parser_mode *mode, environment_type *env);
@end example @end example
@node Error Reporting @node Error Reporting
@@ -8818,15 +8828,14 @@ global variables.
@comment file: calc++-parser.yy @comment file: calc++-parser.yy
@example @example
// The parsing context. // The parsing context.
%parse-param @{ calcxx_driver& driver @} %param @{ calcxx_driver& driver @}
%lex-param @{ calcxx_driver& driver @}
@end example @end example
@noindent @noindent
Then we request the location tracking feature, and initialize the Then we request location tracking, and initialize the
first location's file name. Afterwards new locations are computed first location's file name. Afterwards new locations are computed
relatively to the previous locations: the file name will be relatively to the previous locations: the file name will be
automatically propagated. propagated.
@comment file: calc++-parser.yy @comment file: calc++-parser.yy
@example @example
@@ -8839,7 +8848,7 @@ automatically propagated.
@end example @end example
@noindent @noindent
Use the two following directives to enable parser tracing and verbose Use the following two directives to enable parser tracing and verbose
error messages. error messages.
@comment file: calc++-parser.yy @comment file: calc++-parser.yy
@@ -9304,8 +9313,8 @@ which initialize them automatically.
@deftypeop {Constructor} {YYParser} {} YYParser (@var{lex_param}, @dots{}, @var{parse_param}, @dots{}) @deftypeop {Constructor} {YYParser} {} YYParser (@var{lex_param}, @dots{}, @var{parse_param}, @dots{})
Build a new parser object with embedded @code{%code lexer}. There are Build a new parser object with embedded @code{%code lexer}. There are
no parameters, unless @code{%parse-param}s and/or @code{%lex-param}s are no parameters, unless @code{%param}s and/or @code{%parse-param}s and/or
used. @code{%lex-param}s are used.
Use @code{%code init} for code added to the start of the constructor Use @code{%code init} for code added to the start of the constructor
body. This is especially useful to initialize superclasses. Use body. This is especially useful to initialize superclasses. Use
@@ -9314,11 +9323,12 @@ body. This is especially useful to initialize superclasses. Use
@deftypeop {Constructor} {YYParser} {} YYParser (Lexer @var{lexer}, @var{parse_param}, @dots{}) @deftypeop {Constructor} {YYParser} {} YYParser (Lexer @var{lexer}, @var{parse_param}, @dots{})
Build a new parser object using the specified scanner. There are no Build a new parser object using the specified scanner. There are no
additional parameters unless @code{%parse-param}s are used. additional parameters unless @code{%param}s and/or @code{%parse-param}s are
used.
If the scanner is defined by @code{%code lexer}, this constructor is If the scanner is defined by @code{%code lexer}, this constructor is
declared @code{protected} and is called automatically with a scanner declared @code{protected} and is called automatically with a scanner
created with the correct @code{%lex-param}s. created with the correct @code{%param}s and/or @code{%lex-param}s.
Use @code{%code init} for code added to the start of the constructor Use @code{%code init} for code added to the start of the constructor
body. This is especially useful to initialize superclasses. Use body. This is especially useful to initialize superclasses. Use
@@ -10290,8 +10300,8 @@ Bison declaration to assign precedence and left associativity to token(s).
@xref{Precedence Decl, ,Operator Precedence}. @xref{Precedence Decl, ,Operator Precedence}.
@end deffn @end deffn
@deffn {Directive} %lex-param @{@var{argument-declaration}@} @deffn {Directive} %lex-param @{@var{argument-declaration}@} @dots{}
Bison declaration to specifying an additional parameter that Bison declaration to specifying additional arguments that
@code{yylex} should accept. @xref{Pure Calling,, Calling Conventions @code{yylex} should accept. @xref{Pure Calling,, Calling Conventions
for Pure Parsers}. for Pure Parsers}.
@end deffn @end deffn
@@ -10330,10 +10340,15 @@ Bison declaration to set the name of the parser file. @xref{Decl
Summary}. Summary}.
@end deffn @end deffn
@deffn {Directive} %parse-param @{@var{argument-declaration}@} @deffn {Directive} %param @{@var{argument-declaration}@} @dots{}
Bison declaration to specifying an additional parameter that Bison declaration to specify additional arguments that both
@code{yyparse} should accept. @xref{Parser Function,, The Parser @code{yylex} and @code{yyparse} should accept. @xref{Parser Function,, The
Function @code{yyparse}}. Parser Function @code{yyparse}}.
@end deffn
@deffn {Directive} %parse-param @{@var{argument-declaration}@} @dots{}
Bison declaration to specify additional arguments that @code{yyparse}
should accept. @xref{Parser Function,, The Parser Function @code{yyparse}}.
@end deffn @end deffn
@deffn {Directive} %prec @deffn {Directive} %prec