Deprecation information in versions.xml
| From: | Peter Cowburn | Date: | Sun, 08 Mar 2015 15:09:33 +0000 |
| Subject: | Deprecation information in versions.xml | ||
| Groups: | php.doc php.doc.cvs | ||
| Request: | Send a blank email to phpdoc+get-969385472@lists.php.net to get a copy of this message | ||
Hi docs chaps,
Thanks to Maciej, we have the ability to mark when a function/method was
deprecated, in the versions.xml files. Simply add the "deprecated"
attribute for the function, containing the version in which deprecation
happened.
It is going to be a big task getting these versions.xml files up-to-date
but when you are amending them, please be super-careful that the
information you're adding is correct. In the commit below, I amended some
of Maciej's changes... and *still* made a mistake (set_stream_blocking()
has been deprecated since 4.0 beta 4!).
Cheers,
Peter
On 8 March 2015 at 14:21, Peter Cowburn <salathe@php.net> wrote:
> salathe Sun, 08 Mar 2015 14:21:44 +0000
>
> Revision: ‰‚-SH’ž¶ÌЪ¤G_
> ‘http://svn.php.net/viewvc?view=revision&revision=336053
>
> Log:
> update deprecations
>
> Changed paths:
> U phpdoc/en/trunk/reference/info/versions.xml
> U phpdoc/en/trunk/reference/mcrypt/versions.xml
> U phpdoc/en/trunk/reference/misc/versions.xml
> U phpdoc/en/trunk/reference/stream/versions.xml
>
> Modified: phpdoc/en/trunk/reference/info/versions.xml
> ===================================================================
> --- phpdoc/en/trunk/reference/info/versions.xml 2015-03-08 06:39:17 UTC
> (rev 336052)
> +++ phpdoc/en/trunk/reference/info/versions.xml 2015-03-08 14:21:44 UTC
> (rev 336053)
> @@ -45,7 +45,7 @@
> <function name='php_egg_logo_guid' from='PHP 4 >= 4.0.3, PHP 5
> <
> 5.5'/>
> <function name='php_ini_loaded_file' from='PHP 5 >= 5.2.4'/>
> <function name='php_ini_scanned_files' from='PHP 4 >= 4.3.0, PHP
> 5'/>
> - <function name='php_logo_guid' from='PHP 4, PHP 5 < 5.5'
> deprecated='PHP 5.5.0'/>
> + <function name='php_logo_guid' from='PHP 4, PHP 5 < 5.5'/>
> <function name='php_real_logo_guid' from='PHP 5 < 5.5'/>
> <function name='php_sapi_name' from='PHP 4 >= 4.0.1, PHP
> 5'/>
> <function name='php_uname' from='PHP 4 >= 4.0.2, PHP 5'/>
> @@ -59,7 +59,7 @@
> <function name='set_time_limit' from='PHP 4, PHP 5'/>
> <function name='sys_get_temp_dir' from='PHP 5 >= 5.2.1'/>
> <function name='version_compare' from='PHP 4 >= 4.1.0, PHP
> 5'/>
> - <function name='zend_logo_guid' from='PHP 4, PHP 5 < 5.5'
> deprecated='PHP 5.3.0'/>
> + <function name='zend_logo_guid' from='PHP 4, PHP 5 < 5.5'/>
> <function name='zend_thread_id' from='PHP 5'/>
> <function name='zend_version' from='PHP 4, PHP 5'/>
> </versions>
>
> Modified: phpdoc/en/trunk/reference/mcrypt/versions.xml
> ===================================================================
> --- phpdoc/en/trunk/reference/mcrypt/versions.xml 2015-03-08
> 06:39:17 UTC (rev 336052)
> +++ phpdoc/en/trunk/reference/mcrypt/versions.xml 2015-03-08
> 14:21:44 UTC (rev 336053)
> @@ -22,7 +22,7 @@
> <function name='mcrypt_encrypt' from='PHP 4 >= 4.0.2, PHP
> 5'/>
> <function name='mcrypt_generic' from='PHP 4 >= 4.0.2, PHP
> 5'/>
> <function name='mcrypt_generic_deinit' from='PHP 4 >= 4.0.7, PHP
> 5'/>
> - <function name='mcrypt_generic_end' from='PHP 4 >= 4.0.2, PHP 5
> <=
> 5.1.6' deprecated='PHP 5.4.0'/>
> + <function name='mcrypt_generic_end' from='PHP 4 >= 4.0.2, PHP
> 5'
> deprecated='PHP 5.2.0'/>
> <function name='mcrypt_generic_init' from='PHP 4 >= 4.0.2, PHP
> 5'/>
> <function name='mcrypt_get_block_size' from='PHP 4, PHP 5'/>
> <function name='mcrypt_get_cipher_name' from='PHP 4, PHP 5'/>
>
> Modified: phpdoc/en/trunk/reference/misc/versions.xml
> ===================================================================
> --- phpdoc/en/trunk/reference/misc/versions.xml 2015-03-08 06:39:17 UTC
> (rev 336052)
> +++ phpdoc/en/trunk/reference/misc/versions.xml 2015-03-08 14:21:44 UTC
> (rev 336053)
> @@ -19,7 +19,7 @@
> <function name='highlight_string' from='PHP 4, PHP 5'/>
> <function name='ignore_user_abort' from='PHP 4, PHP 5'/>
> <function name='pack' from='PHP 4, PHP 5'/>
> - <function name='php_check_syntax' from='PHP 5 <= 5.0.4'
> deprecated='PHP 5.0.4'/>
> + <function name='php_check_syntax' from='PHP 5 <= 5.0.4'/>
> <function name='php_strip_whitespace' from='PHP 5'/>
> <function name='show_source' from='PHP 4, PHP 5'/>
> <function name='sleep' from='PHP 4, PHP 5'/>
>
> Modified: phpdoc/en/trunk/reference/stream/versions.xml
> ===================================================================
> --- phpdoc/en/trunk/reference/stream/versions.xml 2015-03-08
> 06:39:17 UTC (rev 336052)
> +++ phpdoc/en/trunk/reference/stream/versions.xml 2015-03-08
> 14:21:44 UTC (rev 336053)
> @@ -4,7 +4,7 @@
> Do NOT translate this file
> -->
> <versions>
> - <function name='set_socket_blocking' from='PHP 4, PHP 5'
> deprecated='PHP
> 5.3.0'/>
> + <function name='set_socket_blocking' from='PHP 4, PHP 5'
> deprecated='PHP
> 5.2.0'/>
> <function name='stream_bucket_append' from='PHP 5'/>
> <function name='stream_bucket_make_writeable' from='PHP 5'/>
> <function name='stream_bucket_new' from='PHP 5'/>
>
>
> --
> PHP Documentation Commits Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
>