do people really complain about significant whitespace?

[Stephen Kellett]

In message <mailman.9107.1155060736.27775.python-list at python.org>, 
Gerhard Fiedler <gelists at gmail.com> 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