Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:43004
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.218.180 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=vX/CRZ87Jd9Pw9ScyxIKBHzw8+tQqzdizKyKE/ansOdZ8U+GLjnrUKHWRw3GejHnQP
         WrGbzNHFVkAJrTf+BKRUQWvlhwAkzPqQKSw6kNqh7kM/11STCMDDn8F0MTmvZhjKchEw
         cP2yxMhox+KV0KafOioyC61NcrWvQn8hj1YXs=
MIME-Version: 1.0
In-Reply-To: <00a601c98c7b$4ed5a4a0$919f644d@foxbox>
References: <53C9D049-8C10-48F2-8312-C8A81D2B5990@pooteeweet.org>
	 <00a601c98c7b$4ed5a4a0$919f644d@foxbox>
Date: Wed, 11 Feb 2009 20:13:11 +0100
Message-ID: <7f3ed2c30902111113q364b4094q22c71c1046a984a6@mail.gmail.com>
To: Steph Fox <steph@php.net>
Cc: 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: hannes.magnusson@gmail.com (Hannes Magnusson)

On Wed, Feb 11, 2009 at 20:02, Steph Fox <steph@php.net> wrote:
> In the last two upgrading guides, we've repeated much of what is already in
> the NEWS file or in the release notes. This makes me wonder what the point
> is of having an upgrading guide...?

Think about the online manual. In 2 years from now people should still
be able to read the upgrading guide and it should still make sense
without needing to hunt down random release announcements or outdated
NEWS files.

The upgrade which gets committed to php-src will be taken, word by
word, and ported to Docbook and made available at
http://php.net/migration53 (just like /migration52 and
/migration51..).




> Is this entirely necessary? (I can see a case for listing new classes in the
> global namespace.)

Unless you want duplicated work, one file to php-src and one for the docs, yes.