Hi Tadziu, > I remember reading somewhere that comments are unnecessary because the > code is "obvious":
I think there's an underlying truth here. I strive to have the code be obvious through clarity of structure and identifiers that stress their purpose and would much rather spend time editing to improve that than add a comment. Even if sitting there trying to think of a better name can be hard. It's a bit like the BUGS section in man pages; IIRC they found fixing a shortcoming was less tedious than documenting it. Non-local type definitions and variables I tend to comment though; typically how the values are to be interpreted. > www.usm.uni-muenchen.de/~hoffmann/roff/tmp/rpdup.pdf I enjoyed reading that for the first time in quite a few years. Cheers, Ralph.
