eyepopslikeamosquito has asked for the wisdom of the Perl Monks concerning the following question:

What is the best way to do bullet lists and numbered lists in POD?

Given the following pod file, test.pod:

=head1 This is a test of bullet points =over 4 =item * this is bullet point 1 =item * this is bullet point 2 =back =over 4 =item 1 this is numbered point 1 =item 1 this is numbered point 2 =back
when I run:
pod2html test.pod >f.html
the generated f.html looks fine in Internet Explorer but not in Firefox, where the text of the bullet point seems to be on the next line to the bullet point mark (at least that's what I see).

Replies are listed 'Best First'.
Re: How to do bullet lists and numbered lists in POD?
by jhourcle (Prior) on Jun 28, 2005 at 14:09 UTC

    Pod::Html does quite a few bad things with lists. (for instance, you can't start an item with a number, or it'll assume it's a numbered list, and trash the number entirely .... and it does really horrible things with nested lists, and even the lists it builds for the table of contents)

    I tried mailing a patch to Tom Christiansen a few months back, but I don't know if some spam filter ate it, or if there's some better way to submit it, so it was ignored for not following proper procedures (I looked through the perl.org site, and couldn't find any mention of how to submit fixes, so I just mailed the listed author on the module)

    Anyway, here's the patch and what it's supposed to fix

Re: How to do bullet lists and numbered lists in POD?
by dragonchild (Archbishop) on Jun 28, 2005 at 12:49 UTC
    =over 4 =item * This is bullet point 1 This is supporting text for bullet point 1 =item * This is bullet point 2 This is supporting text for bullet point 2 =item * This is bullet point 3 =item * This is bullet point 4 =back

    My criteria for good software:
    1. Does it work?
    2. Can someone else come in, make a change, and be reasonably certain no bugs were introduced?

      I tried that originally. Though it gives correctly formatted bullet points, they are rendered in bold and in this case I want simple bullet points without the bolding. Is there any way to get rid of the bold?

Re: How to do bullet lists and numbered lists in POD?
by rev_1318 (Chaplain) on Jun 28, 2005 at 10:32 UTC
    Firefox et al. are wright, IE is wrong! Have a look as the HTML source and you see why: the list items are generated wrongly:
    ... <li></li> this is ...
    should read:
    <li>this is ...</li>
    to get the expected result. You have indeed proven that IE is a bad idea :) (and that pod2html doesn't quite what you expect)

    Paul