use Perl

• What to do next (Score:1)

  by dagolden (6584)

  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
  • Re: (Score:2)

    by jonasbn (1153)

    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
    
           
    • Re: (Score:1)

      by dagolden (6584)

      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
    • Re: (Score:1)

      by Aristotle (5147)

      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.
• WRT Strawberry (Score:1)

  by Alias (5735)

  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.