debian man page for pod::coverage::trustpod

Pod::Coverage::TrustPod(3pm)				User Contributed Perl Documentation			      Pod::Coverage::TrustPod(3pm)

NAME
       Pod::Coverage::TrustPod - allow a module's pod to contain Pod::Coverage hints

VERSION
       version 0.100002

DESCRIPTION
       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

AUTHOR
       Ricardo SIGNES <rjbs@cpan.org>

COPYRIGHT AND LICENSE
       This software is copyright (c) 2012 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.

perl v5.14.2							    2012-04-21					      Pod::Coverage::TrustPod(3pm)