| Subject: | Fwd: Pod::Simple::HTMLBatch |
| Date: | Thu, 11 Nov 2010 20:05:55 -0800 |
| To: | bug-pod-simple [...] rt.cpan.org |
| From: | Allison Randal <allison [...] perl.org> |
Show quoted text
-------- Original Message --------
Subject: Pod::Simple::HTMLBatch
Date: Tue, 06 Jul 2010 16:11:18 -0700
From: Michael Donn <mdonn@harbornet.com>
To: allison@perl.org
Dear Allison;
I wrote the simple little script shown below to use
'Pod::Simple::HTMLBatch', and was quite pleased with the results, even
if the 'index.html' was a little cumbersome.
But then I noticed that 'perldoc' was able to give me documentation for
perl scripts in the '../perl/bin' directory that seemed invisible to
'Pod::Simple::HTMLBatch'. These included '../perl/bin/prove' and
'../perl/bin/AutoSearch' among others. But scripts in '../perl/bin'
whose names ended in '.pl' were handled appropriately, such as
'../perl/bin/exe_update.pl'.
Also, some references within the pod documents were mangled. A
reference to 'prove' (the one in bin) was translated as
'../App/Prove.html' in the 'App::Prove.html' document.
I tried to root out the problems in 'Pod::Simple::HTMLBatch' and the
packages it uses, but, alas, I am not a good enough programmer for that.
I can, of course, live with these restrictions, but I thought you would
like to know, in case you don't already know.
Yours, Mike
PS
Here is my script:
use strict;
use warnings;
use Pod::Simple::HTMLBatch;
unshift @INC , "c:/strawberry/perl/bin";
my $out = 'c:/html';
my $b = Pod::Simple::HTMLBatch->new;
$b->batch_convert(\@INC, $out );