perldocumentationperl-pod

How can I check if a function has POD (perl in-file documentation)?


Is there any library that can tell me if a specific function has POD? I want to add that into our build system.

As in, the convention as established in the docs on POD,

=item stuff()

This function does stuff.

=cut

sub stuff {
  ...
}

I want to write something like this

my @functions = get_functions_with_PPI($file);

foreach my $func (@functions) {
  unless ( file_has_POD_for_func($file,$func) ) {
    say "The function $func is undocumented!";
  }
}

I need something that does file_has_POD_for_func as documented above.


Solution

  • Pod::Coverage

    Pod::Coverage does what you want. Devel::Cover uses it internally.