AW: Handling nested =open directives

2011-06-26 Thread Marek Rouchal
I agree, too and would like to add that any formatter should flag that as an error, especially podchecker. -Marek -Ursprüngliche Nachricht- Von: David E. Wheeler [mailto:da...@kineticode.com] Gesendet: Sonntag, 26. Juni 2011 06:19 An: Marc Green Cc: pod-people@perl.org Betreff: Re:

AW: Z in =item

2011-06-26 Thread Marek Rouchal
Right - some POD formatters use heuristics like /^\d+/ on what follows =item to detect whether this is a numbered list. In the specific case of HTML output, you have 2 choices: 1. always use the full text behind =item and generate a definition list (dl,dt,dd), except with =item * which should

Re: Z in =item

2011-06-26 Thread Karl Williamson
On 06/26/2011 05:34 AM, Shawn H Corey wrote: On 11-06-25 11:53 PM, Karl Williamson wrote: In perldiag.pod, there is a line like this =item Z500 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

Re: Z in =item

2011-06-26 Thread Russ Allbery
Karl Williamson pub...@khwilliamson.com writes: On 06/26/2011 05:34 AM, Shawn H Corey wrote: They all should be treated as a definition but seldom are. That means, an `=item Z anything` should be treated like a definition. So then, does the attached patch look ok? I wholeheartedly approve,