NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.
All the Perl that's Practical to Extract and Report
use Perl Log In
gnat (29)
gnat
(email not shown publicly)
(email not shown publicly)
Wednesday September 10, 2003
12:00 PM
POD modules
Rael asked today how to convert a POD file to HTML from his program. He couldn't believe that he had to write and read temporary files. I checked and that's still the case, even on 5.8. I was surprised at how bastard-redhaired-stepchild the POD support has been. I now take back every single eye roll and tolerant sigh I quietly gave when Brad Appleton, Matt Sergeant, and TorgoX submitted patches to P5P.
At the same time, of course, I did basically say to Rael that he should suck it up and stop being a wuss. Temporary files are nothing to be ashamed of. "Consider it a harkening back to the roots of Unix," I said. Judging from his tight-lipped silence, he's not feeling particularly nostalgic right now
--Nat
POD modules
More |
Login
| Reply
The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
--Larry Wall in stab.c from the perl source code
Stories, comments, journals, and other submissions on use Perl; are Copyright 1998-2006, their respective owners.
POD - HTML (Score:3, Interesting)
pod2html is just a wrapper around Pod::Html, and it shows. The entire module is really a shell script. Look at the script and you'll see. Flag-parsing is part of the module. :-(
It may have been fine years ago, but now we want to do those sorts of translations on the fly, instead of converting great masses of docs. It's time for that change.
Speaking of changing Pod to HTML on the fly, see my update to Apache::Pod. I got a mighty swell patch to have it support stylesheets.
--
xoa
Reply to This
Pod::Simple::HTML (Score:4, Informative)
my $p = Pod::Simple::HTML->new;
my $html = $p->parse_file(...);
# or
my $html = $p->parse_string_document(...);
Reply to This
Pod::Simple::HTML (Score:3, Informative)
In Combust [develooper.com] we use Pod::Simple to parse a POD document as provided by Template Toolkit and parse it into a Template Toolkit document [xrl.us]. Certainly no tmp files and it works very well.
- ask
-- ask bjoern hansen [askbjoernhansen.com], !try; do();
Reply to This
Re:Pod::Simple::HTML (Score:2)
He could ship blosxom with Pod::Simple and Pod::Simple::HTML but
Re:Pod::Simple::HTML (Score:2)
- ask
-- ask bjoern hansen [askbjoernhansen.com], !try; do();
Re: POD Modules (Score:3, Funny)
I've had a lot of success with Pod::POM [cpan.org] and TT [tt2.org].
/me realises that's something else we forgot to cover in the book :-/
Reply to This
Re: POD Modules (Score:2)
--
DO NOT LEAVE IT IS NOT REAL.
Coming into this late... (Score:3, Insightful)
Unfortunately people didn't like Pod::SAX because it a) made people think of XML, and b) wasn't very well documented. So along came Pod::Simple which mostly fixes those two bugs.
Plus I think people didn't really understand the benefits of using something like SAX - the multitude of modules you could then use for generating different format content. Shame really.
Reply to This