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

Re: perldoc improvements for map

Thread Previous | Thread Next
From:
Steffen Mueller
Date:
February 12, 2011 11:42
Subject:
Re: perldoc improvements for map
Message ID:
4D56E2B9.3090806@cpan.org
Hi Tom, hi Ruud,

On 02/12/2011 08:25 PM, Tom Christiansen wrote:
>>> I've tried to improve the docs for the map function with some help by
>>> castaway and the people on #catalyst because there was not a single
>>> example that uses block syntax and assignment to an array.
>
>> Should it mention that the block is optimized to an expression if
>> and when that can safely be done?
>
>      Con: Risks making people overly concerned with miniscule
>           performance tweaks, needless exacerbating a problem
>           with a long history.  Risks further complicating
> 	 the documetation simply by making it longer.
>
>      Pro: Seems to removes the only possible reason for using
>           the less readable, braceless version.
>
> I vote for the Pro alternative.

Nice summary. While it's a reference documentation, I still think the 
cons outweigh the pro.

--Steffen

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