Version: (using KDE Devel) Installed from: Compiled sources OS: FreeBSD I like using Konqueror to browse system documentation using the "man:/" IO Slave. I would like to be able to browse the Perl documentation on the system like as well. I usually access this through "perldoc" on the command line, and the information is stored in POD format, so a new IO Slave for this might be named "pod:/" or "perldoc:/". This might be really easy since "pod2man" is a standard tool. You could run the perl documentation through "pod2man" and then recycle the "man:/" IO Slave.
I suppose this bug could technically be marked as "Resolved" because this has been implemented in KDE 3.2.2. However, if it is, I'll be tempted to open a new bug report about /how well/ it works. :) - If the 'perldoc' command is not installed, a white screen is shown instead of a useful message that it needs to be installed. - "perldoc:/" should do something useful by default, it doesn't for me. I get an error: "Can't enter folder /". This gives me no clue how to address the issue. - Using the IO slave on a known-to-exist module doesn't work for me: "perldoc:/Fatal" returns "The only existing directories are functions and faq". - Based on that message, you might think these syntaxes would return some result, but they don't: "perldoc:/faq/" or "perldoc:/functions/" - The only variation that worked for me was this, and I had to guess at the syntax: perldoc:/functions/push - Even when a result comes up, the results are not formatted. The function name, arguments and description are all run together. Looking at the page source, I see that a simple "blockquote" is used. It should be quite easy to generate some nicely formatted HTML. This would work for the above case: perldoc -uf push | pod2html That just passes the unformatted POD to an HTML formatter. I'm glad to see some progress has been made here and I look forward to a higher quality implementation of it.
*** Bug 84324 has been marked as a duplicate of this bug. ***
*** Bug 70540 has been marked as a duplicate of this bug. ***
To comment #1: where is the KIO slave? As for supporting by the standard way, it means supporting the man output given by the corresponding Perl tool (which perldoc uses). However there is a problem supporting this man output with the current man: KIO slave. Have a nice day!
*** This bug has been confirmed by popular vote. ***
I have imported the Perldoc ioslave I wrote back in December into playground/ioslaves. Once I have moved it to kdesdk (probably when the 4.2 window opens) I will close this bug but until then this is probably what you want...
kio_perldoc is available from kdesdk, and will be released with KDE 4.2.