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:
Ricardo Signes
Date:
April 5, 2010 07:38
Subject:
Re: RFC: Perl manual pages -- update to follow the perlstyle.podguidelinesDate: Mon, 5 Apr 2010 11:36:15 +0000 (UTC)
Message ID:
20100405143841.GA17922@cancer.codesimply.com

This thread has grown counter-productive.  Obviously, there is more than one
way to do it.  There are even reasonable people who disagree about which ones
are awful.

Can we just move forward with changes to which there are not very loud
objections?  For example, I bet almost everyone will favor using three-arg open
except when documenting two-arg open.  Maybe there will be a general consensus
that "for my $x" is better than "for $x" and that can be updated as well.
Having a mostly-consistent bracing and indenting style also seems like a good
win.

If it takes more than a few messages to find a common ground for something
(like 'and' versus '&&') maybe it's best to leave the docs as they are on that
point so progress can be made on others.

The last thing we want is for the people who really want to get these
improvements made to give up just because they can only agree on 80% of
matters.

-- 
rjbs

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