On 31 March 2010 15:25, Christopher Jones <christopher.jo...@oracle.com> wrote: > > > On 03/31/2010 03:13 AM, Robert P. J. Day wrote: >> >> On Tue, 30 Mar 2010, Philip Olson wrote: >> >>> Hello everyone, >>> >>> As most of us know, PHP 6 has disappeared. It used to be 5.3+unicode >>> but now it's unknown and certainly not worth mentioning in the PHP >>> manual (at least, as a version that introduces features/changes). >>> With that said, let's talk about what to do. First: >>> >>> $ egrep --exclude=\*.svn\* -r -n "PHP 6" * |wc -l >>> > 105 >>> >>> Or, better than grep ;) >>> >>> $ ack "PHP 6" * |wc -l >>> > 105 >>> >>> Around 13 are in versions.xml, and 51 in ini.xml. We must handle this as >>> a case-by-basis because not all of these features are unicode specific, and >>> even those that are may [or may not] be in the next PHP version for all we >>> know... nobody really knows. Our options: >>> >>> (a) Remove or comment out the docs (a sad thought) >>> (b) Make guesses as to which PHP version they'll be in (5.4 is likely >>> for many, but easily wrong) >>> (c) Move them to an appendix (doesn't feel right) >>> (d) Write "Future PHP Release" or similar until we know (seems okay) >>> (e) ... >>> >>> I lean towards (d) for most cases. Thoughts? >> >> call it "PHP NG", with a huge early disclaimer that you're not sure >> what the number will be. > > It's not clear if/how these features are going to be re-included. > > I'd prefer to see them commented out. Displaying mis-information is > harmful to the overall PHP project.
I'm on this side of the fence. I think our main role is to document things as they are now. For those things that were in trunk but no longer exist I vote for removing them (commenting out) until such a point when (if) they get pushed back into the code. As for how we label additions which will be released at some point but for which the version number(s) are not certain, that's a puzzle that we must ponder for a while. > > Chris > > -- > Email: christopher.jo...@oracle.com > Tel: +1 650 506 8630 > Blog: http://blogs.oracle.com/opal/ > Free PHP Book: http://tinyurl.com/ugpomhome >
