>>>>> "Blake" == Blake  <blake at kingdomrpg.com> writes:

Blake> I also thought it was telling that in the last couple of weeks there
Blake> was a  correction to the Time class comment--because the existing one
Blake> was wrong  (and misleading)!

And that's also why everyone shouldn't just "pick a class and comment it".
A misleading comment is worse than *no* comment.

I'd probably have to stare at a class for quite a while before I felt
confident enough to provide a class comment.  After all, the class
comment is about the "why", which is the piece that *isn't*
discernable from the code!

-- 
Randal L. Schwartz - Stonehenge Consulting Services, Inc. - +1 503 777 0095
<merlyn at stonehenge.com> <URL:http://www.stonehenge.com/merlyn/>
Perl/Unix/security consulting, Technical writing, Comedy, etc. etc.
See PerlTraining.Stonehenge.com for onsite and open-enrollment Perl training!