Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:43009
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 72.14.220.157 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :cc:content-type:content-transfer-encoding;
        b=Babqle9wWpLP74yr4sj5MhsWlT4gbxRTqa+lihNO09EFpBrJhZzyhGpUJYtMAzj5YF
         ziMldX4IWnmL0m8cCsx2Xs4Eusha8A2KgU+jA6Kx4hg8g+8qZj7W2vTRNJCsB9WFUfTA
         QADss/6VoiwAGTimwbfuaB5Y8duv2+mOnyqqU=
MIME-Version: 1.0
In-Reply-To: <00ec01c98c81$2696b2d0$919f644d@foxbox>
References: <53C9D049-8C10-48F2-8312-C8A81D2B5990@pooteeweet.org>
	 <00a601c98c7b$4ed5a4a0$919f644d@foxbox>
	 <7f3ed2c30902111113q364b4094q22c71c1046a984a6@mail.gmail.com>
	 <00c301c98c7d$da9cce80$919f644d@foxbox>
	 <00d401c98c7e$a92bfcd0$919f644d@foxbox>
	 <261daaa10902111131u61ad7ec9s9257a45e1e11f086@mail.gmail.com>
	 <00ec01c98c81$2696b2d0$919f644d@foxbox>
Date: Wed, 11 Feb 2009 20:46:29 +0100
Message-ID: <fe05d1540902111146n729261a9l2386ae49aa781f1d@mail.gmail.com>
To: Steph Fox <steph@php.net>
Cc: Vesselin Kenashkov <kenashkov@gmail.com>, Hannes Magnusson <hannes.magnusson@gmail.com>, 
	Lukas Kahwe Smith <mls@pooteeweet.org>, PHP Internals List <internals@lists.php.net>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Subject: Re: [PHP-DEV] 5.3 todos
From: pierre.php@gmail.com (Pierre Joye)

On Wed, Feb 11, 2009 at 8:44 PM, Steph Fox <steph@php.net> wrote:
>> IMHO listing new functions is useful - there could be a name collision
>> with
>> a function in users code (I know it is improbable, because the functions
>> are
>> named extname_funcname, but still possible)
>
> Improbable indeed. The nearest we ever came to that was with the Date class
> (because PEAR already had a Date class - nobody else complained, mind.)
> Maybe it would be best to list any new core PHP functions and mention
> prefixes used by any new extensions.


> The 5.2 guide lists 'new optional parameters' too. I honestly don't see how
> the existence of a new optional parameter can possibly impact existing code;
> ergo, it has no place in an upgrade guide.

An upgrade is not only about problems, it is also about solutions. A
kind of tutorial on how to use all the changes in a given release in
your applications. It often helps to clean codes, remove work 'round,
etc. An upgrade guide is often the document many will read, and not
the NEWS file, which is not that useful in the current format.

So yes, we should keep as much info as we can in the guide, include
listing of new functions, constants or classes.

Cheers,
-- 
Pierre

http://blog.thepimp.net | http://www.libgd.org