Re: Announcing the Perl 5 Documentation Team

[email protected] (Ævar Arnfjörð Bjarmason) Fri, 2 Jul 2010 14:27:23 +0000
Newsgroups perl.perl5.porters,perl.documentation
Message-ID <[email protected]>
On Fri, Jul 2, 2010 at 13:56, Horsley, Tom <[email protected]> wrote:
> Good luck with this. I'll just mention one thing that has bothered me since
> the documentation got all improved when moving from perl4 to perl5:
>
> The perl4 doc was all one giant man page, which made it really simple
> to search. It would be nice if there was a single document designed
> to be searched easily that at least had pointers to the right document
> where you'll find details of what you are searching for (in particular
> I never have any idea if something like -M is a "function" or a "operator" :-).

On my infinite todo list I have an item for adding a perl5 POD -> GNU
Texinfo conversion script. Then you can generate indexed docs you can
easily search through, dump the whole thing as a big man/HTML/PDF etc.

Or you could just concat all the existing core manpages now to get some of that.