Handling nested =open directives

[Marc Green]

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

[Shawn H Corey]

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

[Marc Green]

>
>   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

[Karl Williamson]

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

[David E. Wheeler]

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