in reply to Automatic documentation stubs for .pl source

Erm, perhaps perldoc perlpod or perltidy would be helpful?

In Section Seekers of Perl Wisdom