あーなるほど、そういえばPerlにはPodだっけ？なんて書き方がありますな。
（ソースのコメントを元にドキュメント生成できる）

ところで、PHPにはそういうのはないんでしょか？