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