develooper Front page | perl.perl5.porters | Postings from April 2010

Re: RFC: Perl manual pages -- update to follow the perlstyle.podguidelinesDate: Mon, 5 Apr 2010 11:36:15 +0000 (UTC)

Thread Previous | Thread Next
From:
Raphael_Manfredi
Date:
April 5, 2010 07:22
Subject:
Re: RFC: Perl manual pages -- update to follow the perlstyle.podguidelinesDate: Mon, 5 Apr 2010 11:36:15 +0000 (UTC)
Message ID:
hpchvf$sp$1@tours.ram.loc
Quoting "H.Merijn Brand" <h.m.brand@xs4all.nl> from ml.lang.perl.porters:
:On Sun, 04 Apr 2010 09:24:39 -0600, Tom Christiansen <tchrist@perl.com> wrote:
:> In-Reply-To: Message from Marvin Humphrey <marvin@rectangular.com>
:> > Wouldn't that usage of "||" instead of "or" be a personal idiosyncrasy,
:> > then?
:> 
:> I doubt it's all that personal.
:
:I agree. Not that I take the same road as Tom everywhere, but the perl
:documentation is not something personal. It is written for ALL users.
:Novices and experts. As this thread already has proven that minds don't
:think alike, there is very clearly not a `better' way to write || or or
:to make things safer or more readable.
:
:I use both. Tom uses parens and ||, and Jari uses or. Lets keep the
:versatility in the docs. The current docs are not wrong.

I think documentation should not be versatile, otherwise newcomers are going
to wonder why one has to use "||" and when "or" is preferable.  Seeing both
used in different contexts could even lead people to believe they are fully
interchangeable, at will.  Which is not true.

Personnally, I've always disliked "and" and "or" and never used them.
I prefer to put parentheses to delimit the argument list visually, so the
precedence never bites me.  Also I prefer to see arithmetical and logical
operators stand out as punctuation signs (i.e. be non-words).

Would you like to have things like "plus" and "minus"?

	$a = 1 plus 2;

Very readable as a sentence, awful as a programming statement.

Cheers,
Raphael

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