NAME

Pod::Coverage::Careful - more careful subclass of Pod::Coverage

SYNOPSIS

            

              
              
use Test::Pod::Coverage 1.08;
use Pod::Coverage::Careful;
pod_coverage_ok(
    "Some::Module",
    {
       coverage_class => "Pod::Coverage::Careful",
    },
    "improved pod coverage on Some::Module",
);
            
          

DESCRIPTION

This module carefully subclasses Pod::Coverage to override its idea of which subs need to be documented. This catches several important cases that it misses.

The Pod::Coverage module doesn't count subs that appear to be imported as ones needing documentation. However, this also exempts subs that were generated dynamically, such as:

            

              
              
for my $color (qw(red blue green)) {
    no strict "refs";
    *$color = sub { print "I like $color.\n" };
}
            
          

By supplying "pod_coverage_ok" in Test::Pod::Coverage with a coverage_class of "Pod::Coverage::Careful", those generated functions will now show up as in need of pod.

It also finds cases where subs are created by aliasing an old one of a different name:

            

              
              
*new_sub = \&old_sub;
            
          

This is true whether the alias is created form a sub in this same package, or if you're importing one of a different name.

One imports that are the same name as what they import are still exempted from pod requirements.

BUGS AND RESTRICTIONS

None noted.

SEE ALSO

Pod::Coverage

Checks if the documentation of a module is comprehensive.

Test::Pod::Coverage

Check for pod coverage in your distribution.

AUTHOR

Tom Christiansen <tchrist@perl.com>

LICENCE AND COPYRIGHT

Copyright (c) 2016, Tom Christiansen <tchrist@perl.com>. All Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.