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.
  • Well, that's a heck of a tricky failure.

    As the culprit (as it were), I would suggest the following:

    • Pod::HTML -- needs to do something smarter with things it doesn't understand. Report that as a bug.
    • Module::Build -- probably shouldn't let HTML errors be fatal. Report that as a bug.
    • Your Pod doesn't render well on search.cpan.org either -- you should probably try a different construct anyway, e.g.:

    =item 0

    This is item 0

    =item 1

    This is item 1

    And so on.

    Use the pod2html preview [cpan.org] to see how it l

    • Hmmm, the POD does not even render as expected viewing perldoc.


              These are the different values:

              =over 4

              =item * 0

              Game is over

              =item * 1

              full card (the default)


      Renders to:

              These are the different values:

              o Game is over

              o 1

             
      • perlpodspec is pretty ambiguous about it. I think it implies that it should work, but it doesn't really say it. It's probably a bug.

        Generally, I think it's best if one uses the "=item X" paragraph *only* for defining "the bullet" part of the list and using a separate paragraph afterwards for the content. E.g.

        # a list of bulleted numbers

        =over

        =item *

        0

        =item *

        0 is a number

        =back

        --dagolden