Pod::Coverage::TrustPod - allow a module's pod to contain Pod::Coverage hints
version 0.100005
This is a Pod::Coverage subclass (actually, a subclass of Pod::Coverage::CountParents) that allows the POD itself to declare certain symbol names trusted.
Here is a sample Perl module:
package Foo::Bar; =head1 NAME Foo::Bar - a bar at which fooes like to drink =head1 METHODS =head2 fee returns the bar tab =cut sub fee { ... } =head2 fie scoffs at bar tab =cut sub fie { ... } sub foo { ... } =begin Pod::Coverage foo =end Pod::Coverage =cut
This file would report full coverage, because any non-empty lines inside a block of POD targeted to Pod::Coverage are treated as trustme patterns. Leading and trailing whitespace is stripped and the remainder is treated as a regular expression anchored at both ends.
trustme
Remember, anywhere you could use =begin and =end as above, you could instead write:
=begin
=end
=for Pod::Coverage foo
In some cases, you may wish to make the entire file trusted. The special pattern *EVERYTHING* may be provided to do just this.
*EVERYTHING*
Keep in mind that Pod::Coverage::TrustPod sets up exceptions using the "trust" mechanism rather than the "privacy" mechanism in Pod::Coverage. This is unlikely ever to matter to you, but it's true.
Ricardo SIGNES <rjbs@cpan.org>
Andreas Marienborg <andreas.marienborg@gmail.com>
This software is copyright (c) 2018 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Pod::Coverage::TrustPod, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Pod::Coverage::TrustPod
CPAN shell
perl -MCPAN -e shell install Pod::Coverage::TrustPod
For more information on module installation, please visit the detailed CPAN module installation guide.