[RFC] Stop putting function comments in foo.h

[Joel Brobecker]

> I'd like to start a discussion.
> With doxygen is there still as much value to putting function comments
> in foo.h instead of foo.c?
> 
> I ask because every time I find a "See foo.h." comment I get depressed
> and disappointed.  They're just getting in my way, and I'm wondering
> if it's just me.

I have a preference, but only a slight one, towards putting the comments
in the .c file.

-- 
Joel