Help Update Pod::Perldoc!

Pod::Perldoc needs love. It's the module behind the perldoc command and has been only lightly maintained by p5p for the past couple of years. I needed to fix a minor issue, discovered that I had filed the oldest tickets against the module, and figured I'd clean up the queue. I'll try to do as much work as I can before the code freeze for Perl 5.16, which is really soon.

I'm now the maintainer of the module, and I've gone through each of the tickets and triaged them. I fixed the small, easy things, but the rest of the things take a bit of work. Everything is in my Pod-Perldoc Github repository, so you can easily work and contribute to that. It's up-to-date with the stuff that was applied directly in the perl sources, too.


There's a lot of work to do with Pod::Perldoc::ToMan and pagers and various cross-platfrom issues.

There are virtually no tests for the module, so there's a lot of stuff to do there.
Besides the actual code work, I just need people to use it and find where the various tiny changes have broken things.

And, as if I didn't have enough to do already, if you have other things you need fixed, add them to the Pod-Perldoc RT queue.

3 Comments

The top link requires a login, maybe this would be better:

https://rt.cpan.org/Public/Dist/Display.html?Name=Pod-Perldoc

Re: the issue -Q switch for searching perlfaq answers, doesn't -q already do this?

See https://gist.github.com/1481424 for the errors I got with your new versions.

On the perlcc side I created a testcase for compiled perldoc and fixed it for 5.8 at least. It's 30msec faster for -f wait.
https://github.com/rurban/perl-compiler/blob/master/t/perldoc.t

Still fixing perlcc for newer perls.

Leave a comment

About brian d foy

user-pic I'm the author of Mastering Perl, and the co-author of Learning Perl (6th Edition), Intermediate Perl, Programming Perl (4th Edition) and Effective Perl Programming (2nd Edition).