Handling nested =open directives
Hello Pod People, Given the following erroneous POD, should the formatter interpret the bold line as the start of a text paragraph and indent it (and therefore each line afterwards would also be treated as a text paragraph), or should the formatter keep the bold line at the same indent level as the prior italicized line, and treat the "=item *" as a bulleted list instead of a text paragraph? I believe that it should treat it as the former because the bold line is after the nested =open, but the test case for htmlview.pod disagrees -- it treats it as the latter. Thank you, Marc >From ext/Pod-Html/t/htmlview.pod: > =over 4 > > =item foo > > The foo item. > > =item bar > > *The bar item.* > > =over 4 > > *This is a list within a list * > > =item * > > The wiz item. > > =item * > > The waz item. > > =back > > =item baz > > The baz item. > > =back >
Re: Handling nested =open directives
On 11-06-25 04:19 PM, Marc Green wrote: From ext/Pod-Html/t/htmlview.pod: > =over 4 > > =item foo > > The foo item. > > =item bar > > *The bar item.* > > =over 4 > > *This is a list within a list * This paragraph should not be here. There should be nothing between the =over and the first =item. Is it in the original? > > =item * > > The wiz item. > > =item * > > The waz item. > > =back > > =item baz > > The baz item. > > =back > -- Just my 0.0002 million dollars worth, Shawn Confusion is the first step of understanding. Programming is as much about organization and communication as it is about coding. The secret to great software: Fail early & often. Eliminate software piracy: use only FLOSS.
Re: Handling nested =open directives
> > From ext/Pod-Html/t/htmlview.pod: >> >> > =over 4 >>> > >>> > =item foo >>> > >>> > The foo item. >>> > >>> > =item bar >>> > >>> > *The bar item.* >>> > >>> > =over 4 >>> > >>> > *This is a list within a list * >>> >> > This paragraph should not be here. There should be nothing between the > =over and the first =item. Is it in the original? > > Yes, it is in the original.
Z<> in =item
In perldiag.pod, there is a line like this =item Z<>500 Server error All the other items form a definition list. My guess is that this is to make sure that the 500 isn't mistaken for a numbered =item in the list. However, with html, anyway, I don't see any difference in the output with and without the Z<>, and podchecker ignores the Z<> and says that the list has mismatched item types. Can someone explain?
Re: Handling nested =open directives
On Jun 25, 2011, at 1:19 PM, Marc Green wrote: > Given the following erroneous POD, should the formatter interpret the bold > line as the start of a text paragraph and indent it (and therefore each line > afterwards would also be treated as a text paragraph), or should the > formatter keep the bold line at the same indent level as the prior italicized > line, and treat the "=item *" as a bulleted list instead of a text paragraph? > > I believe that it should treat it as the former because the bold line is > after the nested =open, but the test case for htmlview.pod disagrees -- it > treats it as the latter. I agree with you. Best, David