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.