In message <[EMAIL PROTECTED]>, 
Gerhard Fiedler <[EMAIL PROTECTED]> writes
>conclusion for me: they must not like self-documenting code... :)

Oh dear. So if the code is wrong it is self documenting?

Comments document what the code should do.
The code shows what the code actually does.

Also from a maintenance perspective reading comments is a lot faster 
than reading the code. For a whitespace significant language this can be 
very helpful when the formatting gets mangled for some reason.

There is no such thing as self-documenting code.

People that say they don't need to document their code because its self 
documenting - no hire. I've been writing and selling software for 23 
years now and I still keep hearing this bull about self documenting 
code. Sigh.

Stephen
-- 
Stephen Kellett
Object Media Limited    http://www.objmedia.demon.co.uk/software.html
Computer Consultancy, Software Development
Windows C++, Java, Assembler, Performance Analysis, Troubleshooting
-- 
http://mail.python.org/mailman/listinfo/python-list

Reply via email to