Hm, für Perl gibt es POD. perlpod sollte dir da weiterhelfen.
Kommentare aus POD kannst du dir dann als Textfile, Manpage, HTML usw. umsetzen lassen.