Stories
Slash Boxes
Comments
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

Log In

[ Create a new account ]

ajt (2546)

ajt
  (email not shown publicly)
http://www.iredale.net/

UK based. Perl, XML/HTTP, SAP, Debian hacker.

  • CPAN: ATRICKETT [cpan.org]
  • PerlMonks: ajt [perlmonks.org]
  • Local LUG: AdamTrickett [lug.org.uk]
  • Debian Administration: ajt [debian-adm...ration.org]
  • LinkedIn: drajt [linkedin.com]

Journal of ajt (2546)

Wednesday June 18, 2003
02:48 PM

CPAN Documentation

[ #12927 ]

I must be missing something, but I'm not having fun changing the docs of my XML::RSS::Tools module from HTML to POD. There is probably something out there explaining how it works, and I'll probably be feel very stupid when I find it, but at the moment it seems somewhat elusive.

I have a number of example files, and additional documents, saved as "Unix" format files, in pod with a .pod extension. CPAN doesn't index them the way I had expected, so I must be doing something very stupid. The first time round I thought it was because some of the files had Windows line endings, but that's been fixed, and CPAN still gets it wrong.

I've looked on CPAN in a few places, but I can't find the page that tells me how to include pod files in a module. It must be possible I've looked at modules that have done it, and tried to copy.

Perl/CPAN is great, but sometimes I feel lost in the magnitude of it all.

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • take XML::RSS::Tools (Score:3, Interesting)

    by hfb (74) on 2003.06.18 16:20 (#21216) Homepage Journal

    out of the head section that the indexer parses as the title or put it last and it should likely index the /doc pod properly. You might also use Torgox's fine html2pod [cpan.org].

    • I knew there had to be some easy wasy of doing this. Will give it a try!

      The HTML 2 POD tool looks interesting, but as I've converted everything to POD already, it's not as exctiting, but it's well worth knowing about, and I can still give it a go if I need it.

      --
      -- "It's not magic, it's work..."