On 12-04-26 12:08 PM, Russ Allbery wrote:
Shawn H Corey<[email protected]> 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.
