I think you want to read perlpod. You can use pod2txt or pod2html to produce separate files from the documentation included in your script.

neophyte