develooper Front page | perl.perl5.porters | Postings from February 2013

Re: Recent pod

Thread Previous
From:
Russ Allbery
Date:
February 26, 2013 17:16
Subject:
Re: Recent pod
Message ID:
87621f0zdz.fsf@windlord.stanford.edu
Johan Vromans <jvromans@squirrel.nl> writes:

> Just what we need... more obscure trickery.

> Why not replace "=item *" by something friendly like "=bullet" ?

It's an interesting thought, since one can add new POD commands with
backward compatibility.  I think in retrospect it's clear that the
automatic list type detection from the contents of =item wasn't a great
idea, and we would have been better off with =bullet, =number, and =desc.

> Also quite stupid:

>   =over 4

>   =item 1.

>   First item.

>   =item 1.

>   Another item.

>   =back

I think this used to work and now doesn't work in a kind of weird and
annoying way.  I seem to recall that this was discussed before, but the
current state doesn't make sense to me: either auto-number and warn, or
take what the user entered verbatim, but taking what the user entered
verbatim and then warning is strange.  But I probably haven't thought
through it.

-- 
Russ Allbery (rra@stanford.edu)             <http://www.eyrie.org/~eagle/>

Thread Previous


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About