in reply to flower box comments

You're not missing anything, your group is misguided.
=head2 get_records my @foo = get_records( $dbh , "select * from BAR..." ); =cut sub get_records { # ... }
Now you run it through perldoc, pod2man, pod2text, pod2html ...

Comments are not documentation ;)

*links here*

MJD says "you can't just make shit up and expect the computer to know what you mean, retardo!"
I run a Win32 PPM repository for perl 5.6.x and 5.8.x -- I take requests (README).
** The third rule of perl club is a statement of fact: pod is sexy.