Doc #54630 [Csd]: listed as a PHP 5 >= 5.1.0 when should PHP 5 >= 5.2.0

From: Date: Fri, 29 Apr 2011 11:42:19 +0000
Subject: Doc #54630 [Csd]: listed as a PHP 5 >= 5.1.0 when should PHP 5 >= 5.2.0
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-6316@lists.php.net to get a copy of this message
Edit report at http://bugs.php.net/bug.php?id=54630&edit=1 ID: 54630 Updated by: pierrick@php.net Reported by: daniel dot black at ovee dot com dot au Summary: listed as a PHP 5 >= 5.1.0 when should PHP 5 >= 5.2.0 Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: trunk-SVN-2011-04-29 (SVN) Assigned To: pierrick Block user comment: N Private report: N New Comment: As discussed with Peter, those functions will now be documented as PHP5 >= 5.2.0 since they are aliases of DateTimeZone methods documented as PHP5 >= 5.2.0. We will still keep the note in the date installation about the CFLAGS=- DEXPERIMENTAL_DATE_SUPPORT=1 to enable those in 5.1.0 Previous Comments: ------------------------------------------------------------------------ [2011-04-29 13:25:13] salathe@php.net Experimental support was added in 5.1.0 as noted on http://php.net/datetime.installation Whether we document the functions as available from then, or from when the compiler flag was not longer necessary, is a good question. Currently, the versions are not consistent with one or the other. ------------------------------------------------------------------------ [2011-04-29 13:23:15] pierrick@php.net Sorry Peter, Did not noticed your answer before submitting my patch. I compiled a 5.1 version by default and it was not available in it. pierrick@magtured:~/php-src/tags/php_5_1_0$ sapi/cli/php -r 'var_dump(timezone_identifiers_list());' Fatal error: Call to undefined function timezone_identifiers_list() in Command line code on line 1 I think it is really confusing for people furthermore since the documentation says that this is an alias of DateTimeZone::listIdentifiers() which is documented as PHP 5 >= 5.2.0. And the issue is the same with : - timezone_abbreviations_list - timezone_name_get - timezone_offset_get - timezone_open ------------------------------------------------------------------------ [2011-04-29 13:15:36] pierrick@php.net This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. ------------------------------------------------------------------------ [2011-04-29 13:14:51] pierrick@php.net Automatic comment from SVN on behalf of pierrick Revision: http://svn.php.net/viewvc/?view=revision&revision=310649 Log: Fixed bug #54630 ------------------------------------------------------------------------ [2011-04-29 13:12:58] salathe@php.net The function timezone_identifiers_list() was available (experimentally) from 5.1.0, the associated method DateTimeZone::listIdentifiers() was only added in 5.2.0. The versions should be kept as-is, even if they are confusing. ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/bug.php?id=54630 -- Edit this bug report at http://bugs.php.net/bug.php?id=54630&edit=1

« previous php.doc.bugs (#6316) next »