in reply to Documenting Perl Scripts

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