in reply to Documenting Perl Scripts

I recommend getting a copy of the book Perl Medic, by Peter Scott.

In Section Seekers of Perl Wisdom