perlperl-pod

Are there any conventions for writing POD comments for Perl?


I was able to find a page from Safari Books Online that provides a template, but having never written POD comments, I'm not sure how good it is or if it is missing anything that might be considered convention to include.

What are the conventions to follow when writing POD comments for Perl scripts? Is there anything like Sun's Javadoc Conventions, but for POD comments?


Solution

  • It's not elaborate, but I like Juerd's perlpodtut introduction a lot.

    The author mentions what he considers common sections and what they would include.