1Pod::Coverage::TrustPodU(s3e)r Contributed Perl DocumentaPtoido:n:Coverage::TrustPod(3)
2
3
4

NAME

6       Pod::Coverage::TrustPod - allow a module's pod to contain Pod::Coverage
7       hints
8

VERSION

10       version 0.100006
11

DESCRIPTION

13       This is a Pod::Coverage subclass (actually, a subclass of
14       Pod::Coverage::CountParents) that allows the POD itself to declare
15       certain symbol names trusted.
16
17       Here is a sample Perl module:
18
19         package Foo::Bar;
20
21         =head1 NAME
22
23         Foo::Bar - a bar at which fooes like to drink
24
25         =head1 METHODS
26
27         =head2 fee
28
29         returns the bar tab
30
31         =cut
32
33         sub fee { ... }
34
35         =head2 fie
36
37         scoffs at bar tab
38
39         =cut
40
41         sub fie { ... }
42
43         sub foo { ... }
44
45         =begin Pod::Coverage
46
47           foo
48
49         =end Pod::Coverage
50
51         =cut
52
53       This file would report full coverage, because any non-empty lines
54       inside a block of POD targeted to Pod::Coverage are treated as
55       "trustme" patterns.  Leading and trailing whitespace is stripped and
56       the remainder is treated as a regular expression anchored at both ends.
57
58       Remember, anywhere you could use "=begin" and "=end" as above, you
59       could instead write:
60
61         =for Pod::Coverage foo
62
63       In some cases, you may wish to make the entire file trusted.  The
64       special pattern "*EVERYTHING*" may be provided to do just this.
65
66       Keep in mind that Pod::Coverage::TrustPod sets up exceptions using the
67       "trust" mechanism rather than the "privacy" mechanism in Pod::Coverage.
68       This is unlikely ever to matter to you, but it's true.
69

PERL VERSION

71       This library should run on perls released even a long time ago.  It
72       should work on any version of perl released in the last five years.
73
74       Although it may work on older versions of perl, no guarantee is made
75       that the minimum required version will not be increased.  The version
76       may be increased for any reason, and there is no promise that patches
77       will be accepted to lower the minimum required perl.
78

AUTHOR

80       Ricardo SIGNES <cpan@semiotic.systems>
81

CONTRIBUTORS

83       •   Andreas Marienborg <andreas.marienborg@gmail.com>
84
85       •   Ricardo Signes <rjbs@semiotic.systems>
86

88       This software is copyright (c) 2022 by Ricardo SIGNES.
89
90       This is free software; you can redistribute it and/or modify it under
91       the same terms as the Perl 5 programming language system itself.
92
93
94
95perl v5.38.0                      2023-07-21        Pod::Coverage::TrustPod(3)
Impressum