Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:38715
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: error (pb1.pair.com: domain roshambo.org from 207.210.105.50 cause and error)
Cc: "\"Hannes Magnusson\"" <hannes.magnusson@gmail.com>,
 Lukas Kahwe Smith <mls@pooteeweet.org>,
 PHP Developers Mailing List <internals@lists.php.net>
Message-ID: <6F8A39B9-080B-42D8-806A-32E324DAE157@roshambo.org>
To: =?ISO-8859-1?Q?Johannes_Schl=FCter?= <johannes@php.net>
In-Reply-To: <1215031120.18900.2.camel@goldfinger.johannes.nop>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed; delsp=yes
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Apple Message framework v924)
Date: Wed, 2 Jul 2008 18:04:13 -0600
References: <ADD0525F-F900-4F3A-9B76-1ED332CA31E0@pooteeweet.org> <7f3ed2c30807021324j201e5509j80d09b3f4efbb8d0@mail.gmail.com> <1215031120.18900.2.camel@goldfinger.johannes.nop>
Subject: Re: [PHP-DEV] towards a 5.3 release
From: philip@roshambo.org (Philip Olson)


On 2 Jul 2008, at 14:38, Johannes Schl=FCter wrote:

> On Wed, 2008-07-02 at 22:24 +0200, "Hannes Magnusson" wrote:
>> On Wed, Jul 2, 2008 at 22:00, Lukas Kahwe Smith =20
>> <mls@pooteeweet.org> wrote:
>>> @Philipp: Since you are the god of documentation .. How are things =20=

>>> looking
>>> on the scratchpad [8] you started?
>>
>> Philip, one p, recently moved to Nicaragua (last weekend actually) =20=

>> and
>> isn't really "available" these days :)
>
> Nice :-)

Indeed! :)

>> Furthermore I haven't seen Nuno for a while and "you guys" stole
>> Felipe from "us" and I recently found out that school is heckofalot
>> easier than work :]
>>
>> So... any and all help in the documentation area would be =20
>> appreciated.
>> The scratchpad wiki page is a good start, but I doubt these are the
>> "only" changes/new features in 5.3...
>> Of the top of my head; a list of error changes (especially
>> functions/features now throwing E_DEPRECATED) is missing...
>
> Also the changes to zend_parse_prameters() should be checked for tiny
> changes (like the current()/next() changes already documented on that
> wiki page)
>
> Help from any lurker here is appreciated!


Essentially the plan is to DocBookify it once 5.3 nears release but =20
today that page requires additional content. Random people add content =20=

randomly and unfortunately I'm no longer able to lead this effort so =20
please take over the task of 5.3 upgrade docs procurement. I'll move =20
it to DocBook if/when needed. In other words, to something similar to =
http://php.net/migration52

  Wiki: http://wiki.php.net/doc/scratchpad/upgrade/53

As for integrating 5.3 goodness into the PHP manual itself, most =20
features are folded within. All are welcome to edit the CVS module =20
named phpdoc and today only a recent PHP release is required (no make/=20=

xsltproc/etc.) Or write an email, post a simple text file, and/or edit =20=

the wiki page. Also, thanks to all who use the [DOC] tag!

And lastly, ideas are welcome for dealing with the current style as =20
we'll end up having the following separate migration guides:

   5.0 -> 5.1
   5.1 -> 5.2
   5.2 -> 5.3

Not a terrible problem but it's something to think about at =
phpdoc@lists.php.net=20
.

Regards,
Philip