Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969378663 php.internals:35955
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.146.182 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=message-id:date:from:to:subject:mime-version:content-type:content-transfer-encoding:content-disposition;
        b=frH8wWyPKL6W1d93MHRodrErJFGrei03N/vHtTv9+2eeFibw76UozIYJj5DLZ39JoPl8es3ZUdVCHnLGpTUheUkWUFw9/5jNlzu9krcBy2+qXHdZlSi0ivH3LEeYRgL6KwiXSBMKPfEfF44onP5p1g5sPXAWBUyqbkygxwT8nSI=
Message-ID: <7f3ed2c30803041138j1f726219v634712adafc1af96@mail.gmail.com>
Date: Tue, 4 Mar 2008 20:38:29 +0100
To: "PHP Development" <internals@lists.php.net>, 
	"PHP Documentation ML" <phpdoc@lists.php.net>, 
	"Stanislav Malyshev" <stas@zend.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Subject: Undocumented 5.3 features
From: hannes.magnusson@gmail.com ("Hannes Magnusson")

On Tue, Mar 4, 2008 at 8:22 PM, Stanislav Malyshev <stas@zend.com> wrote:
>  I agree with the intent - documentation is *very* important. Even
>  though, people use undocumented features too (probably cursing the lazy
>  developers on the way ;)

Indeed. And in few years noone has a clue wtf all this code is about
or how to use it even wondering if it would even work.
Testing said features is equally as important to make sure the feature
stay working and not removed since noone could figure out how to use
it *cough*zend-multibyte*cough*.


>  BTW, as far as I remember, we have at least 4 undocumented features
>  right now sitting in 5.3 CVS, so if anybody wants to do something cool,
>  that's a good place:
>  - Nowdocs aren't documented

http://docs.php.net/manual/en/language.types.string.php#language.types.string.syntax.nowdoc

>  - .htaccess-like .ini files undocumented

Heh? You mean the .htaccess FastCGI thingy?

>  - [HOST=] and [PATH=] .ini sections undocumented

Richard was looking into that one last time I knew.

>  - new version constants undocumented

Those were quick and easy job:
http://docs.php.net/manual/en/reserved.constants.php


- Functions/features throwing E_DEPRECATED
- ?:
- __callStatic I think is still undocumented
- Few stream context options
- All the new datetime and spl stuff
- GC
- New E_STRICT/E_FATAL/E_WARNINGs (like we did with the 5.2 release)

And bunch of other small things here and there.

-Hannes