Vitaliy Margolen schrieb:
Friday, June 2, 2006, 6:27:18 AM, EA Durbin wrote:
There is precious little "Why" in the comments of a lot of projects - Why does this function exist, why would I call it, why does it return what it does, etc.
BS comments like those within the function don't help, obviously - but sometimes a comment block describing WHY a given chunk of code does what it does would be nice.
I don't see any problems here. If anyone needs to know _why_ some function does X - they should look on msdn.
Only that there is no guarantee that the information in MSDN will stay forever ;)
BTW Alexandre, can we preserve references to bug numbers in patch comments?
Indeed that would be nice.