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

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.
  • by lbt (4712) on 2003.12.08 17:18 (#26362)
    Don't kid yourself :)

    Coming back to perl after a loooong break I wanted to get myself some local html of my pod - I know, I know, I'm just a crazy dude who wants to use this latest greatest fad (surely that's all html is to the perldoc folk!)

    perldoc perldoc /html -> nothing useful
    perldoc -q html - nothing useful

    perldoc perl2html -> aha!!

    perldoc perlpod ->
      "Translators are available for converting Pod to various formats like plain text, HTML"

    $pod2html --recurse --htmlroot=/perl --infile=/usr/lib/perl5/ --outfile=/www/perl/
    /usr/bin/pod2html: cannot open /www/perl/ file for output: Is a directory

    $ pod2html --recurse --htmlroot=/perl --infile=/usr/lib/perl5/ --outfile=/www/perl/index.html
    /usr/bin/pod2html: no title for /usr/lib/perl5/.

    perldoc perl2html
    says "Converts files from pod format (see perlpod) to HTML format."

    No shit - ONE AT A TIME??? !!!!

    CPAN may be OK - but perldoc sure ain't !!!

    (feeling pretty pissed after wasting *far* too much time trying to read the bloody docs!)