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.
Remember, anywhere you could use '=begin' and '=end' as above, you could instead write:
=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.
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.
Package Version | Update ID | Released | Package Hub Version | Platforms | Subpackages |
---|---|---|---|---|---|
0.100006-bp156.2.1 info | GA Release | 2023-07-22 | 15 SP6 |
|
|
0.100006-bp155.1.4 info | GA Release | 2023-05-17 | 15 SP5 |
|
|
0.100005-bp154.1.17 info | GA Release | 2022-05-09 | 15 SP4 |
|
|
0.100005-bp153.1.12 info | GA Release | 2021-03-06 | 15 SP3 |
|
|
0.100005-bp152.3.14 info | GA Release | 2020-04-17 | 15 SP2 |
|
|
0.100005-bp151.3.1 info | GA Release | 2019-07-16 | 15 SP1 |
|
|
0.100005-bp151.2.11 info | GA Release | 2019-05-18 | 15 SP1 |
|
|
0.100005-bp150.2.4 info | GA Release | 2018-07-30 | 15 |
|
|