Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:84330
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 74.125.82.53 as permitted sender)
User-Agent: K-9 Mail for Android
In-Reply-To: <CAGa2bXbVaFdqi-f-T8Ar4RvXrEipbCb1NvJGRKC+bieFndGueQ@mail.gmail.com>
References: <CAGa2bXai0cXrqeq3X2vTV8CjseAp=CUY29YaaxKniZENw0-x4g@mail.gmail.com> <op.xuxm3hojhuszwh@tsukapiou> <CAGa2bXbiQw82=+cGPurRwTnsD31MaZ9mM_e3WWLNPgcNz+H5zg@mail.gmail.com> <CANUQDCh4VGqHLuixRAHn42dGJ52yuhbkV-4_JyBntqsDgmm6Cg@mail.gmail.com> <CAGa2bXbVaFdqi-f-T8Ar4RvXrEipbCb1NvJGRKC+bieFndGueQ@mail.gmail.com>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Content-Type: text/plain;
 charset=UTF-8
Date: Thu, 05 Mar 2015 09:40:07 +0000
To: Yasuo Ohgaki <yohgaki@ohgaki.net>
CC: "internals@lists.php.net" <internals@lists.php.net>
Message-ID: <726CA870-917C-4270-A129-AFE106E0A380@gmail.com>
Subject: Re: [PHP-DEV] Re: [RFC] [DISCUSSION] Consistent Function Names
From: rowan.collins@gmail.com (Rowan Collins)

On 5 March 2015 08:50:12 GMT, Yasuo Ohgaki <yohgaki@ohgaki.net> wrote:
>Hi Niklas,
>
>On Thu, Mar 5, 2015 at 5:29 PM, Niklas Keller <me@kelunik.com> wrote:
>
>> If we introduce those new aliases, it should be clearly stated in the
>docs
>> which function should be used, maybe we can remove the old one in the
>far
>> future then. But the more important point is, that it's not that
>confusing
>> to users. Which one should I use? Why's there another one? We already
>have
>> that situation with `count` and `sizeof`.
>
>
>Good point!
>I'll update documents so that main function is prefered name/function
>to be
>used.

This would be fine if all the users read the manual, and only the manual. What about the thousands of books, tutorials, blog posts, Stack Overflow q&as, etc, all mentioning the names and behaviour that have been around for 15 to 20 years? Not to mention the thousands of lines of existing code which people will not only need to read and understand, but also contribute to without accidentally breaking compatibility with old versions of PHP.

Regards,
-- 
Rowan Collins
[IMSoP]