Perl subroutine documentation [duplicate]

This question already has answers here: Closed 11 years ago.

Possible Duplicates:

Does Perl have something like Java/PHP Docs?

What's the best way to document P开发者_运维百科erl code?

is there a way to write a subroutine docs?

such as

sub add {

#docs: this subroutine adds two numbers

}

and extract that info later?

---

The standard method for writing Perl documentation is with POD. The perldoc command will extract POD and display it nicely for you. You can also use various tools like pod2html to turn it into HTML.

---

There is a javadoc like setup called pod. You can learn more about it via: perldoc perlpod or here: http://perldoc.perl.org/perlpod.html