True it needs to be documented properly, but also if in the future the function is extended to add a new value, e.g. 'repeat' we have again potential confusion. I incline to meaningfulness over abbreviation
On 7 February 2014 08:51, Peter Bowers <pbow...@pobox.com> wrote: > > On Fri, Feb 7, 2014 at 4:36 PM, Simon <nzsk...@gmail.com> wrote: > >> why not accept both 'return' and 'r' as valid options? >> >> Because it could lead to confusion, where 'r' (or 'R') and 'return' may >> be perceived as offering differing functionality. >> > > As long as the documentation is not ambiguous, having aliases for the same > functionality is nice. (One person prefers the short form for > speed/efficiency, one person prefers the long form for clarity - now > everybody is happy.) There's no reason why someone would assume different > functionality as long as the documentation is clear... > > -Peter > -- ____ http://kiwiwiki.co.nz
_______________________________________________ pmwiki-devel mailing list pmwiki-devel@pmichaud.com http://www.pmichaud.com/mailman/listinfo/pmwiki-devel