Hosting Doxygen docs (Re: [sldev] Doxygen & Comments)

Nicholaz Beresford nicholaz at blueflash.cc
Thu Jun 7 11:24:06 PDT 2007


> Also, the comments should not simply restate the code or 
 > what is obvious form the code, they should add some insight
 > as to what the code is doing, otherwise they are a waste
 > of resources.

Absolutely.  I only use comments to give an idea what a larger
part of the source is doing on an abstract level.  This is
also something I like in the function headers.


Nick


More information about the SLDev mailing list