[pmwiki-devel] [pmwiki-users] Proposed change to pmwiki.php: Markup_e

[Simon]

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 <pbowers at pobox.com> wrote:

>
> On Fri, Feb 7, 2014 at 4:36 PM, Simon <nzskiwi at 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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.pmichaud.com/pipermail/pmwiki-devel/attachments/20140207/b59a885b/attachment.html>