I work with PHP and Perl alot during the day. I've been internally bewailing the fact that there is no POD like documentation format for PHP. At least none that comes standard, as POD and javadoc do for Perl/Java. Then I was looking closely at one of the PHP class files I was editing and noticed that someone (it had to be petdance) had done this:
/*
=head1 NAME
Page - A base class for all HTML pages.
=cut
*/
class Page {
/*
=head2 Page()
The constructor for the Page object. Pass in the args, etc, etc.
=cut
*/
function Page() { ... do PHP stuff here... }
...
