mail::srs::guarded(3pm) [debian man page]

Mail::SRS::Guarded(3pm) 				User Contributed Perl Documentation				   Mail::SRS::Guarded(3pm)

NAME

       Mail::SRS::Guarded - A guarded Sender Rewriting Scheme (recommended)

SYNOPSIS

	       use Mail::SRS::Guarded;
	       my $srs = new Mail::SRS::Guarded(...);

DESCRIPTION

       This is the default subclass of Mail::SRS. An instance of this subclass is actually constructed when "new Mail::SRS" is called.

       Note that allowing variable separators after the SRSd token means that we must preserve this separator in the address for a possible
       reversal.  SRS1 does not need to understand the SRS0 address, just preserve it, on the assumption that it is valid and that the host doing
       the final reversal will perform cryptographic tests. It may therefore strip just the string SRS0 and not the separator. This explains the
       appearance of a double separator in SRS1<sep><hostname>=<sep>.

       See Mail::SRS for details of the standard SRS subclass interface.  This module provides the methods compile() and parse(). It operates
       without store, and guards against gaming the shortcut system.

SEE ALSO

       Mail::SRS

perl v5.10.1							    2004-06-23						   Mail::SRS::Guarded(3pm)

Coverage(3pm)						User Contributed Perl Documentation					     Coverage(3pm)

NAME

       Test::Pod::Coverage - Check for pod coverage in your distribution.

VERSION

       Version 1.08

SYNOPSIS

       Checks for POD coverage in files for your distribution.

	   use Test::Pod::Coverage tests=>1;
	   pod_coverage_ok( "Foo::Bar", "Foo::Bar is covered" );

       Can also be called with Pod::Coverage parms.

	   use Test::Pod::Coverage tests=>1;
	   pod_coverage_ok(
	       "Foo::Bar",
	       { also_private => [ qr/^[A-Z_]+$/ ], },
	       "Foo::Bar, with all-caps functions as privates",
	   );

       The Pod::Coverage parms are also useful for subclasses that don't re-document the parent class's methods.  Here's an example from
       Mail::SRS.

	   pod_coverage_ok( "Mail::SRS" ); # No exceptions

	   # Define the three overridden methods.
	   my $trustme = { trustme => [qr/^(new|parse|compile)$/] };
	   pod_coverage_ok( "Mail::SRS::DB", $trustme );
	   pod_coverage_ok( "Mail::SRS::Guarded", $trustme );
	   pod_coverage_ok( "Mail::SRS::Reversable", $trustme );
	   pod_coverage_ok( "Mail::SRS::Shortcut", $trustme );

       Alternately, you could use Pod::Coverage::CountParents, which always allows a subclass to reimplement its parents' methods without redocu-
       menting them.  For example:

	   my $trustparents = { coverage_class => 'Pod::Coverage::CountParents' };
	   pod_coverage_ok( "IO::Handle::Frayed", $trustparents );

       (The "coverage_class" parameter is not passed to the coverage class with other parameters.)

       If you want POD coverage for your module, but don't want to make Test::Pod::Coverage a prerequisite for installing, create the following as
       your t/pod-coverage.t file:

	   use Test::More;
	   eval "use Test::Pod::Coverage";
	   plan skip_all => "Test::Pod::Coverage required for testing pod coverage" if $@;

	   plan tests => 1;
	   pod_coverage_ok( "Pod::Master::Html");

       Finally, Module authors can include the following in a t/pod-coverage.t file and have "Test::Pod::Coverage" automatically find and check
       all modules in the module distribution:

	   use Test::More;
	   eval "use Test::Pod::Coverage 1.00";
	   plan skip_all => "Test::Pod::Coverage 1.00 required for testing POD coverage" if $@;
	   all_pod_coverage_ok();

FUNCTIONS

       All functions listed below are exported to the calling namespace.

       all_pod_coverage_ok( [$parms, ] $msg )

       Checks that the POD code in all modules in the distro have proper POD coverage.

       If the $parms hashref if passed in, they're passed into the "Pod::Coverage" object that the function uses.  Check the Pod::Coverage manual
       for what those can be.

       The exception is the "coverage_class" parameter, which specifies a class to use for coverage testing.  It defaults to "Pod::Coverage".

       pod_coverage_ok( $module, [$parms, ] $msg )

       Checks that the POD code in $module has proper POD coverage.

       If the $parms hashref if passed in, they're passed into the "Pod::Coverage" object that the function uses.  Check the Pod::Coverage manual
       for what those can be.

       The exception is the "coverage_class" parameter, which specifies a class to use for coverage testing.  It defaults to "Pod::Coverage".

       all_modules( [@dirs] )

       Returns a list of all modules in $dir and in directories below. If no directories are passed, it defaults to blib if blib exists, or lib if
       not.

       Note that the modules are as "Foo::Bar", not "Foo/Bar.pm".

       The order of the files returned is machine-dependent.  If you want them sorted, you'll have to sort them yourself.

BUGS

       Please report any bugs or feature requests to "bug-test-pod-coverage at rt.cpan.org", or through the web interface at
       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Pod-Coverage>.  I will be notified, and then you'll automatically be notified of
       progress on your bug as I make changes.

SUPPORT

       You can find documentation for this module with the perldoc command.

	   perldoc Test::Pod::Coverage

       You can also look for information at:

       * AnnoCPAN: Annotated CPAN documentation
	   <http://annocpan.org/dist/Test-Pod-Coverage>

       * CPAN Ratings
	   <http://cpanratings.perl.org/d/Test-Pod-Coverage>

       * RT: CPAN's request tracker
	   <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test-Pod-Coverage>

       * Search CPAN
	   <http://search.cpan.org/dist/Test-Pod-Coverage>

AUTHOR

       Written by Andy Lester, "<andy at petdance.com>".

ACKNOWLEDGEMENTS

       Thanks to Ricardo Signes for patches, and Richard Clamp for writing Pod::Coverage.

COPYRIGHT &; LICENSE
       Copyright 2006, Andy Lester, All Rights Reserved.

       You may use, modify, and distribute this package under the same terms as Perl itself.

perl v5.8.8							    2008-03-04							     Coverage(3pm)