http://www.perlmonks.org?node_id=637918


in reply to Re: What makes a comment "obnoxious"?
in thread What makes a comment "obnoxious"?

Your subs should be separated by meaningful comments that detail what the function does, what it expects as arguments, and what it returns

Or (even better!)

(guess who is thoroughly sick of lying comments in legacy code :-)