Re: [GNU bison 1.75b] testsuite.log: 14 failures

[Paul Eggert]

> Date: Sun, 15 Dec 2002 19:36:13 -0500
> From: Bruce Lilly <address@hidden>
> 
> Indeed, the mechanisms used in those versions still appear to work
> with 1.75b in lieu of %parse-param (which is incompatible with
> earlier versions of bison).

Yes, that was the intent.

You made some good points in your earlier messages, but I don't want
to make any changes to behavior until Akim gets back from vacation and
has time to comment.  In the meantime I think it's better to
temporarily remove mention of %lex-param and %parse-param from the
manual, so that users don't rely on these features.  The features have
never been supported in any non-test version of Bison, so this isn't a
compatibility issue.  I installed the following patch for now.

2002-12-17  Paul Eggert  <address@hidden>

        * NEWS, doc/bison.texinfo (Parser Function, Pure Calling, Error
        Reporting, Table of Symbols): Omit mentions of %lex-param and
        %parse-param from the documentation for now.

Index: NEWS
===================================================================
RCS file: /cvsroot/bison/bison/NEWS,v
retrieving revision 1.82
diff -p -u -r1.82 NEWS
--- NEWS        13 Dec 2002 13:14:11 -0000      1.82
+++ NEWS        18 Dec 2002 00:06:27 -0000
@@ -1,6 +1,12 @@
 Bison News
 ----------
 
+Changes in version 1.75e:
+
+* References to the experimental %lex-param and %parse-param directives
+  have been temporarily removed from the manual, since we don't want
+  users to rely upon these features quite yet.
+
 Changes in version 1.75d, 2002-12-13:
 
 * Semicolons are once again optional at the end of grammar rules.
Index: doc/bison.texinfo
===================================================================
RCS file: /cvsroot/bison/bison/doc/bison.texinfo,v
retrieving revision 1.92
diff -p -u -r1.92 bison.texinfo
--- doc/bison.texinfo   15 Dec 2002 09:39:12 -0000      1.92
+++ doc/bison.texinfo   18 Dec 2002 00:06:29 -0000
@@ -3879,6 +3879,12 @@ Return immediately with value 0 (to repo
 Return immediately with value 1 (to report failure).
 @end defmac
 
address@hidden For now, do not document %lex-param and %parse-param, since it's
address@hidden not clear that the current behavior is stable enough.  For 
example,
address@hidden we may need to add %error-param.
address@hidden documentparam
+
address@hidden documentparam
 If you use a reentrant parser, you can optionally pass additional
 parameter information to it in a reentrant way.  To do so, use the
 declaration @code{%parse-param}:
@@ -3886,8 +3892,8 @@ declaration @code{%parse-param}:
 @deffn {Directive} %parse-param @address@hidden@}
 @findex %parse-param
 Declare that an argument declared by @code{argument-declaration} is an
-additional @code{yyparse} argument.  This argument is also passed to
address@hidden  The @var{argument-declaration} is used when declaring
+additional @code{yyparse} argument.
+The @var{argument-declaration} is used when declaring
 functions or prototypes.  The last identifier in
 @var{argument-declaration} must be the argument name.
 @end deffn
@@ -3917,6 +3923,7 @@ In the grammar actions, use expressions 
 @example
 exp: @dots{}    @{ @dots{}; *randomness += 1; @dots{} @}
 @end example
address@hidden ifset
 
 
 @node Lexical
@@ -4123,6 +4130,7 @@ this case, omit the second argument; @co
 only one argument.
 
 
address@hidden documentparam
 If you wish to pass the additional parameter data to @code{yylex}, use
 @code{%lex-param} just like @code{%parse-param} (@pxref{Parser
 Function}).
@@ -4163,6 +4171,7 @@ and finally, if both @code{%pure-parser}
 int yylex   (YYSTYPE *lvalp, YYLTYPE *llocp, int *nastiness);
 int yyparse (int *nastiness, int *randomness);
 @end example
address@hidden ifset
 
 @node Error Reporting
 @section The Error Reporting Function @code{yyerror}
@@ -4227,6 +4236,7 @@ void yyerror (char const *msg);         
 void yyerror (YYLTYPE *locp, char const *msg);  /* GLR parsers.   */
 @end example
 
address@hidden documentparam
 If @samp{%parse-param @{int address@hidden is used, then:
 
 @example
@@ -4260,6 +4270,7 @@ void yyerror (YYLTYPE *locp,
               int *nastiness, int *randomness,
               char const *msg);
 @end example
address@hidden ifset
 
 @noindent
 The prototypes are only indications of how the code produced by Bison
@@ -6580,11 +6591,13 @@ Bison declaration to assign left associa
 @xref{Precedence Decl, ,Operator Precedence}.
 @end deffn
 
address@hidden documentparam
 @deffn {Directive} %lex-param @address@hidden@}
 Bison declaration to specifying an additional parameter that
 @code{yylex} should accept.  @xref{Pure Calling,, Calling Conventions
 for Pure Parsers}.
 @end deffn
address@hidden ifset
 
 @deffn {Directive} %merge
 Bison declaration to assign a merging function to a rule.  If there is a
@@ -6612,11 +6625,13 @@ Bison declaration to set the name of the
 Summary}.
 @end deffn
 
address@hidden documentparam
 @deffn {Directive} %parse-param @address@hidden@}
 Bison declaration to specifying an additional parameter that
 @code{yyparse} should accept.  @xref{Parser Function,, The Parser
 Function @code{yyparse}}.
 @end deffn
address@hidden ifset
 
 @deffn {Directive} %prec
 Bison declaration to assign a precedence to a specific rule.