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

Re: Recent pod

Thread Previous | Thread Next
From:
David E. Wheeler
Date:
February 25, 2013 23:00
Subject:
Re: Recent pod
Message ID:
3251BB51-A5E3-4EB7-BEB3-1C18644B7366@justatheory.com
On Feb 25, 2013, at 2:58 PM, Mark Overmeer <mark@overmeer.net> wrote:

> In perlpod:
>    ยท   And perhaps most importantly, keep the items consistent:
>        either use "=item *" for all of them, to produce bullets; or
>        use "=item 1.", "=item 2.", etc., to produce numbered lists;
>        or use "=item foo", "=item bar", etc.--namely, things that
>        look nothing like bullets or numbers.
> 
> No idea whether perlpodspec changed or perlpod doesn't tell the whole
> picture with respect to numbered lists.  The manual page always looked
> correct.

perlpodspec describes the spec in great detail. It's for Pod parser writers. perlpod is for Pod users. It's less precise.

> Most releases of Perl introduce new warnings.  Maybe a good thing.  As
> long as it is an on-purpose change.

This was.

David



Thread Previous | Thread Next


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