Slash Boxes
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.
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 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 [] 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


        =item *


        =item *

        0 is a number



      • Looks like someone is testing the string following the bullet with something like if ( $headline ) as opposed to if ( defined $headline and length $headline ). Check what happens if you say =item * Z<>0.

        (In 5.12, the need for the defined will go away because length undef will silently return undef rather than warning and returning 0.)

        But I agree with David that you should not put a bullet and headline on the =item line.

  • From a Strawberry perspective, I don't have any custom code, I just bundle what comes in the core and the very latest versions of everything at each release time.

    As an aside though, I am going to be removing all man/html doc pre-generation once I work out how to abuse the Makefile properly.

    So this problem on Strawberry will be moved from install time to run-time (inside of Pod::POM::Web for example.