| Subject: | Pod::Simple::Search: 'recurse' is undocumented |
As part of an effort to address many (
https://rt.perl.org/Ticket/Display.html?id=112014) issues with the Pod-Html library in the Perl 5 core distribution, I am trying to understand its use of Pod::Simple and its related packages.
In ext/Pod-Html/lib/Pod/Html.pm, I find this comment and code:
#####
# find all pod modules/pages in podpath, store in %Pages
# - callback used to remove Podroot and extension from each file
# - laborious to allow '.' in dirnames (e.g., /usr/share/perl/5.14.1)
Pod::Simple::Search->new->inc(0)->verbose($Verbose)->laborious(1)->callback(\&_save_page)->recurse($Recurse)->survey(@Podpath);
#####
I've been reading 'perldoc Pod::Simple::Search' (v3.28), but the 'recurse' method is not documented there. Can you provide that explanation?
Thank you very much.
Jim Keenan