Since you haven't mentioned it, the standard documentation tool for perl modules and scripts is perldoc, which generates documentation from pod.

perldoc perldoc should give the docs for perldoc itself. perldoc perl perl should give the document index for perl. perldoc perlpod should give you an indication of how to write your own documentation in pod.