是否有任何为Perl编写POD注释的约定?

Tho*_*ens 8 perl perl-pod

我能够从Safari Books Online找到一个提供模板的页面,但是从未写过POD评论,我不确定它有多好,或者它是否遗漏了任何可能被认为包含的惯例.

为Perl脚本编写POD注释时要遵循的约定是什么?是否有类似Sun的Javadoc约定,但对于POD评论?

ire*_*ses 6

Perl最佳实践中有一组建议.第7章的内容涵盖了使用POD的文档,以及模块,大型项目等文档的最佳方法.它还讨论了CPAN约定.这可能是你最好的选择.


Tel*_*hus 6

这不是详细说明,但我非常喜欢Juerd的perlpodtut介绍.

作者提到了他认为的共同部分以及它们将包含的内容.