Re: Proper place for interface comments: .h or .cpp?

Tech-Archive recommends: Fix windows errors by optimizing your registry



"Abdo Haji-Ali" wrote:

> Wrong... Intelisense does show your cpp comments that appear before every
> function (I'm talking about VC 7.0), that is if the cpp does exist (Not in a
> library) and there are no comments before the function declaration… However
> I guess the right place for such comments is in the cpp, after all it
> wouldn't be nice to give the user any instructions in a non-searchable,
> non-indexable, non-bookmarkable interface; Wouldn't it be better if such
> usage instructions are given to the user through a CHM file (Like many
> programs does) or may be through an advanced html pages (Like MSDN online),
> especially that there are many tools made to import in-code comment into
> nice-looking HTML/CHM pages (Visual studio 2003 already have one for C#)
The best example of comments in .h i have found is GNOME. However, even in
that case there is some other documentation in addition to .h files. So looks
like each org does it's own thing.
I think i'll settle for interface comments in .h files though.
.