>>> "Satya" == Satya <[EMAIL PROTECTED]> writes:
> I sent out the mail for papers; while I am waiting for them, here is a
> little patch; pls take a good look at it when you can and let me know
> if you'd like it any different.
Very much what I had in mind, thanks!
> -/* DERIVES[SYMBOL - NTOKENS] points to a vector of the rules that
> - SYMBOL derives, terminated with NULL. */
> +/** DERIVES[SYMBOL - NTOKENS] points to a vector of the rules that
> + * SYMBOL derives, terminated with NULL.
> + */
You should rather use indirections that Doxygen understands here, no
longer the CAPITALIZED name convention. Something like
#derives[#symbols - #ntokens]
I guess.
> --- gram.h 6 Jun 2006 16:40:06 -0000 1.59
> +++ gram.h 1 Jul 2006 13:26:45 -0000
> @@ -1,3 +1,4 @@
> +
Nope.
> /* Data definitions for internal representation of Bison's input.
> Copyright (C) 1984, 1986, 1989, 1992, 2001, 2002, 2003, 2004, 2005, 2006
> @@ -20,90 +21,96 @@
> the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
> Boston, MA 02110-1301, USA. */
> +/**
> + * Representation of the grammar rules:
> + *
> + * NTOKENS is the number of tokens, and NVARS is the number of
> + * variables (nonterminals). NSYMS is the total number, ntokens +
> + * nvars.
There is certainly a proper use of addtogroup that would make sense
here, but I have not checked in depth.
