Sean M. Burke <[EMAIL PROTECTED]> wrote:

> Joseph Brenner wrote:

> >own pod is pretty sketchy.  If anyone can tell me that they
> >personally have used one of these methods (and gotten it
> >working without spending more than a few hours on it), I
> >will gladly go back and look at it again.
> 
> Pod::Simple::HTMLBatch is used at several sites, including 
> search.cpan.org.  It works.  Sorry about the meager state of its docs tho.

Well, thanks for speaking up, maybe you can correct any 
misconceptions on my part about how it works...

  http://obsidianrook.com/data/Testing-Pod-Simple-HTMLBatch.tar

Pretty much, all I'm doing is this:

   use Pod::Simple::HTMLBatch;
   my $batchconv = Pod::Simple::HTMLBatch->new;
   $batchconv->verbose(3);
   $batchconv->batch_convert( [ $in_dir ], $out_dir );

The input location has some dummy modules:

   Whatever::Useless
   Whatever::Useless::Express
   Whatever::Useless::TwelveSteps

and these have pod containing L<> links, e.g. 
Whatever::Useless::Express has:

    =head1 SEE ALSO

      L<Whatever::Useless::TwelveSteps>

But in the output html, it appears like so, rather than 
as an html link:

  <pre lang='und' xml:lang='und'>  L&#60;Whatever::Useless::TwelveSteps&#62;</pre>

If you'd like to try and repro this, here's a tar ball of
the test code and dummy files that I'm using:

  http://obsidianrook.com/data/Testing-Pod-Simple-HTMLBatch.tar

The messages I see during a run are:

   T+0s: = Thu Nov  4 19:14:20 2004
   T+0s: Starting batch conversion to 
"/home/doom/End/Cave/DoomfileTools/P2H/Trials/Pod-Simple-HTMLBatch/t/output_html.6215"
   T+0s: 1 dirs to scan: 
/home/doom/End/Cave/DoomfileTools/P2H/Trials/Pod-Simple-HTMLBatch/t/input_pod
   #0: Scanning 
/home/doom/End/Cave/DoomfileTools/P2H/Trials/Pod-Simple-HTMLBatch/t/input_pod/Whatever/Useless/Express.pm
   ... #1: Scanning 
/home/doom/End/Cave/DoomfileTools/P2H/Trials/Pod-Simple-HTMLBatch/t/input_pod/Whatever/Useless/TwelveSteps.pm
   ... #2: Scanning 
/home/doom/End/Cave/DoomfileTools/P2H/Trials/Pod-Simple-HTMLBatch/t/input_pod/Whatever/Useless.pm
   Noted 3 Pod files total
   T+0s: Found 3 modules.
   T+0s: Done scanning.
   T+0s: Now converting pod files to HTML.
   #0/3: Rendering Whatever::Useless
   ... #1/3: Rendering Whatever::Useless::Express
   ... #2/3: Rendering Whatever::Useless::TwelveSteps
   Done converting 3 files.
   T+0s: Preparing list of modules for ToC
   T+0s: Writing contents file 
/home/doom/End/Cave/DoomfileTools/P2H/Trials/Pod-Simple-HTMLBatch/t/output_html.6215/index.html
   T+0s: Done with batch conversion.  3 files done.
   T+0s: = Thu Nov  4 19:14:20 2004
   All done!

Reply via email to