Sure.. pay me a lot of money and I'll write you a book. There. - Some of us
spend all day at work documenting code. It is also often more useful for
other people to go through the code verifying and commenting in things than
the author. As Mike Shaver has done with RFC1122.
> That's moving too fast. I propose we agree on a comment style sheet first (or
> maybe in parallel with setting up the comment organization), and I refer you
> to the one in "The C Companion" by Allan Holub as a first cut.
Most of the code already has specific comment styles that suit the author, and
are not too different. In the same way as we have pretty close to a common
C coding standard.
Alan