Bug 70540 - Support Perl Plain Old Documentation natively
Summary: Support Perl Plain Old Documentation natively
Status: RESOLVED DUPLICATE of bug 50628
Alias: None
Product: konqueror
Classification: Applications
Component: khtml (show other bugs)
Version: 4.0
Platform: unspecified Linux
: NOR wishlist
Target Milestone: ---
Assignee: Konqueror Developers
URL:
Keywords:
: 70541 (view as bug list)
Depends on:
Blocks:
 
Reported: 2003-12-15 23:21 UTC by Kjetil Kjernsmo
Modified: 2004-07-24 20:22 UTC (History)
0 users

See Also:
Latest Commit:
Version Fixed In:
Sentry Crash Report:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Kjetil Kjernsmo 2003-12-15 23:21:30 UTC
Version:           4.0 (using KDE 3.1.4)
Installed from:     (3.0)
Compiler:          gcc version 2.95.4 20011002 (Debian prerelease)
OS:          Linux (i686) release 2.4.23-2003-12-14.1.roo

I use konqi a lot to read documentation, and the ability to read man pages is really neat. Perl PODs can be converted to both man-pages and HTML, so they can be read by konqi, and indeed, my installed Perl modules are easily accessible by writing e.g. man:Perl::Module, and that's neat. Nevertheless, pod2man looses a lot of formatting, and the perl docs are far from as readable as they could be. Also, it would be great to be able to simply point konqi to a .pm file and read the docs that are there.

Therefore, I hereby submit a wish for a native Plain Old Documentation translator in konqi. The POD specs in the perlpod manpage... :-)
Comment 1 George Staikos 2003-12-15 23:28:38 UTC
*** Bug 70541 has been marked as a duplicate of this bug. ***
Comment 2 Stephan Kulow 2004-01-15 14:25:32 UTC
If you've got code that generates HTML out of it, let us know. So long: WONTFIX
Comment 3 Kjetil Kjernsmo 2004-01-15 15:22:45 UTC
Easy enough: pod2html does that:
http://www.perl.com/doc/manual/html/utils/pod2html.html
 
The output of pod2html isn't very pretty, but better than the Manpages in that it at least preserves hyperlinks. The above link shows how it looks with the vanilla pod2html. http://search.cpan.org/ gets prettier output from it, 
http://search.cpan.org/~nwclark/perl-5.8.3/pod/pod2html.PL
but I don't actually now how they do it. But I guess we're interested in KDE-specific looks anyway, so that's perhaps not an issue. 

I think it would be great to have a pod:-"protocol", so that if I point Konqi at any file with POD using pod:/any/file.pm, the pod would be translated on the fly and displayed, as well is searching through the user's @INC if a module name is given rather than a file. 
Comment 4 Kjetil Kjernsmo 2004-05-11 09:10:51 UTC
Still a wish for >3.2.2
Comment 5 George Staikos 2004-07-24 20:22:13 UTC

*** This bug has been marked as a duplicate of 50628 ***