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. --SteffenThread Previous | Thread Next