"Perl for Perl Newbies" - Part 5 - Good Programming PracticesUsing POD for DocumentationTesting and Verifying POD

7.2. Testing and Verifying POD

The CPAN module Test-Pod allows one to check for POD errors in files. Its use is recommended to avoid writing POD with errors.

The CPAN module Test-Pod-Coverage tries to make sure that all the public API functions in one's Perl modules have corresponding POD documentation. Its use is also recommended.

Generally, Module-Starter and similar modules will generate such tests for you automatically as part of the skeleton of your CPAN distribution.


Written by Shlomi Fish