develooper Front page | perl.perl5.porters | Postings from March 2001

Re: pods patched

Thread Previous | Thread Next
From:
Gurusamy Sarathy
Date:
March 16, 2001 12:51
Subject:
Re: pods patched
Message ID:
200103162051.f2GKp1513955@smtp3.ActiveState.com
On Fri, 16 Mar 2001 14:52:58 EST, Ilya Zakharevich wrote:
>On Fri, Mar 16, 2001 at 06:30:59PM +0000, Michael G Schwern wrote:
>> > -=over
>> > +=over 4
>> 
>> Pod::Checker and most pod2* things will warn about an =over without a
>> number.
>
>These are bugs; *they* should be fixed, and not PODs.  IIRC, Larry's
>intent was to have it *Plain*.  In particular, =over was supposed to
>be "the natural indent of the target system".
>
>=over 4 has an absolutely different semantic.
>
>>  Its not required (thus leaving POD Plain), but it is
>> considered a Good Thing.
>
>Well, then those who consider it such need a re-education....

FWIW, I agree with Ilya on this.

At least some of the Pod::Checker warnings appear to need a dose
of optionalism.


Sarathy
gsar@ActiveState.com

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