Front page | perl.pod-people |
Postings from April 2012
Re: =item 1. Error
Thread Previous
|
Thread Next
From:
Shawn H Corey
Date:
April 26, 2012 09:20
Subject:
Re: =item 1. Error
Message ID:
4F9975C3.9000203@gmail.com
On 12-04-26 12:08 PM, Russ Allbery wrote:
> Shawn H Corey<shawnhcorey@gmail.com> writes:
>> On 12-04-26 11:57 AM, Russ Allbery wrote:
>
>>> 1. If the =item tags are numeric, ignore the value of the numbers and just
>>> renumber them. This is similar to what other markup languages do, but
>>> it has the significant problem of making it a bit more annoying to
>>> document, say, a list of exit status returns, where several numbers are
>>> skipped.
>
>> =over
>
>> =item Z<>42
>
>> The answer to the Ultimate Question.
>
>> =back
>
> Which is why I said "a bit more annoying" rather than "impossible."
> However, I still think it's not in the spirit of POD to require that ugly
> hack.
>
The problem is that =item is trying to do three things: unordered lists
<ul>, ordered lists <ol>, and definition lists <dl>. In order to sort
things out correctly, you need an escape mechanism.
--
Just my 0.00000002 million dollars worth,
Shawn
Programming is as much about organization and communication
as it is about coding.
[updated for today's programmers]
"Show me your code and conceal your interfaces, and I shall continue
to be mystified. Show me your interfaces, and I won't usually need
your code; it'll be obvious."
-- Fred Brooks
Don't be clever; being great is good enough.
Thread Previous
|
Thread Next