Re: Interactive parsing with Bison

[Satya]

>  > -/* 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.

I have run thru doxygen's documentation pages; I cant see any such
facility. If you know a place where I can read about this, please let
me know

>  > + * 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.

At this point I think we should be commit minimal doxygenation; we can
add bells and whistles after the initial commit; every time someone
commits a patch, I am getting conflicts here; I signed and sent back
the assignment papers and the first batch of .h files are ready to be
committed; (minimum doxygenation only); Let me know when I can post
the patch;

Thanks,
./satya