Posted: Thu Apr 05, 2007 8:38 am
For me, it depended on the code. A printer driver required less commenting because it used a lot of documented values. On the other hand, a BigFloat library required extensive commenting because it was review and tested by others. A big warning comment in boot sector code about not touching do to critical timing issues was always useless ... but done anyway. Of course, when doing disassembly I find comments are extremely useful.feyd wrote:Odd, I rarely commented in my Assembler code.
The biggest change I've seen is how important comments have become over the last thirty years, they've gone from source code to documentation to a tool of project management. Comments are now used as a form of information hiding - no one gets to look at the source code (although we all prefer it) unless they own it - only the API is available through some sort of Doc tool. Comments have become a integral part of project management by enforcing separation of responsibility. Of course, comments also have their down sided too now a days. Let one Public member get published in the API documentation and everybody will be using it before the end of the day causing nothing but problems down the road.
Guilty but that actually helps sometimes were source files are concatenated during building.// Initialize variables