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