Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add some missing perldoc pages from 5.22.0 #1

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

tm604
Copy link

@tm604 tm604 commented Oct 3, 2015

There's some pages in perl5.22.0 that aren't listed in Perldoc::Section. I suspect this will be an incomplete list: my quick hack to generate this list used:

perl -Ilib -E'use Perldoc::Section; my %seen = map {; $_ => 1 } map @{$_->{pages}}, @Perldoc::Section::section_data; say for keys %seen' | sort 

then compared against

for i in $(find ~/perl5/perlbrew/perls/perl-5.22.0/lib/5.22.0/ -name "perl*.pod"); do basename $i; done | sort > modules.lst

using comm(1):

comm -13 sections.lst modules.lst > missing.lst

this is probably something that could be automated, although there's a few false positives (perl_delta, perltw/perljp, perlfaq_).

A second issue that this doesn't resolve: the perldoc.perl.org pages do not have some of the core modules, such as IO::Socket::IP. This would require using the correct Perl version when running the build_.pl scripts, I suspect pre-5.18 was used. Since modules can be added or removed, I think each build-_.pl run needs to use a perlbrew (or equivalent) clean install for the relevant version, rather than trying to run them all from a single perl install?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
1 participant