Re: maint: doc: fix documentation of YYERROR

[Akim Demaille]

Le 3 avr. 2012 à 13:19, Akim Demaille a écrit :

> Here is my proposal.
> 
> Subject: [PATCH] doc: fix index.
> 
> http://lists.gnu.org/archive/html/bison-patches/2012-04/msg00006.html
> 
> * doc/bison.texinfo: Avoid using @def* variant with more
> than the defined entity as main entity, as it results in
> an incorrect index.  For instance, don't document
> {return YYERROR;}, which results in a single index entry
> "return YYERROR;", but rather as typed function whose
> return type is "type", and whose argument list is ";".

Installed.   I also installed what follows.  I am basically
done with 2.5.1, except:

- document %printer
- allocate some time to Autoconf issues wrt flex and bison
  if time permits
- show a warning about the future removal of K&R support.

From 466b4cf2017646239984467733e63a2cfb98fd8f Mon Sep 17 00:00:00 2001
From: Akim Demaille <address@hidden>
Date: Wed, 4 Apr 2012 10:09:30 +0200
Subject: [PATCH] maint: update NEWS.

* NEWS: Fix entry about __attribute__.
Reorder by "decreasing" order of importance.
---
 NEWS |   38 +++++++++++++++++++++-----------------
 1 file changed, 21 insertions(+), 17 deletions(-)

diff --git a/NEWS b/NEWS
index f552c32..544478a 100644
--- a/NEWS
+++ b/NEWS
@@ -3,28 +3,14 @@ Bison News
 
 * Changes in version 2.5.1 (????-??-??):
 
-** Several portability problems in the test suite have been fixed:
-
-  This includes warnings with some compilers, unexpected behavior of
-  tools such as diff, warning messages from the test suite itself,
-  etc.
+** glr.c: __attribute__ is preserved:
 
   __attribute__ is not longer disabled when __STRICT_ANSI__ is defined
   (i.e., when -std is passed to GCC).
 
-** Warnings during the build procedure have been eliminated.
-
-** Many minor improvements have been made to the manual:
-
-  The layout for grammar has changed to a more compact scheme.  Named
-  references are motivated.  The description of the automaton
-  description file is updated.
-
-** YYBACKUP works as expected.
+** yacc.c: YYBACKUP works as expected.
 
-** liby is no longer asking for "rpl_fprintf" on some platforms.
-
-** Several Java fixes:
+** lalr1.java: several fixes:
 
   The Java parser no longer throws ArrayIndexOutOfBoundsException if
   the first token leads to a syntax error.  Some minor clean ups.
@@ -40,6 +26,24 @@ Bison News
   methods) accept new arguments for line and column.  Several issues
   in the documentation were fixed.
 
+** liby is no longer asking for "rpl_fprintf" on some platforms.
+
+** Several improvements have been made to the manual:
+
+  The layout for grammar excerpts was changed to a more compact
+  scheme.  Named references are motivated.  The description of the
+  automaton description file (*.output) is updated to the current
+  format.  Incorrect index entries were fixed.  Some other errors were
+  fixed.
+
+** Warnings during the build procedure have been eliminated.
+
+** Several portability problems in the test suite have been fixed:
+
+  This includes warnings with some compilers, unexpected behavior of
+  tools such as diff, warning messages from the test suite itself,
+  etc.
+
 * Changes in version 2.5 (2011-05-14):
 
 ** Grammar symbol names can now contain non-initial dashes:
-- 
1.7.9.5