http://qs321.pair.com?node_id=307577


in reply to flower box comments

A lot of monks here (and good programmers in general) favour terse comments directly in the code, along with substantial POD. They likely have the same doubts you do.

I've used a style much like that for a long time, though. I was first exposed to it in a C-shop, and I have seen several advantages with it:

That said, the better I get at Perl programming, the more my comments tend towards brevity, so I'm pretty sure those wiser monks who dislike this style are on to something.

-Tats