Doc #51418 [Opn->Bgs]: Deprecated functions should recommend replacements

Edit report at http://bugs.php.net/bug.php?id=51418&edit=1 ID: 51418 Updated by: degeberg@php.net Reported by: lion at netngine dot hu Summary: Deprecated functions should recommend replacements -Status: Open +Status: Bogus Type: Documentation Problem Package: Website problem Operating System: all PHP Version: Irrelevant New Comment: The eregi() function has a note that says: "Note: As of PHP 5.3.0, the regex extension is deprecated in favor of the PCRE extension. Calling this function will issue an E_DEPRECATED notice." We also have a list of deprecated features along with suitable replacements: http://php.net/manual/en/migration53.deprecated.php Generally, the migration guides will help you when upgrading PHP. Previous Comments: ------------------------------------------------------------------------ [2010-03-28 14:19:55] lion at netngine dot hu Description: ------------ Deprecated functions are marked with a big red warning on the website, like for example this one: http://hu.php.net/manual/en/function.eregi.php The warning text is: "This function has been DEPRECATED as of PHP 5.3.0. Relying on this feature is highly discouraged." But there is absolutely no idea given of what kind of other functions could be used to replace the deprecated function. Especially bad when trying to fix an older script to work on an updated server, with no serious knowledge of every old function used in an old script. One needs to clearly read the function, understand old behavior, then start from the Table Of Contents of PHP documentation, try to find a new function, and then convert the call. Instead, these warnings should 1. link to recommended replacements 2. note most important changes between the old and new function Note that I also checked "See also" links on many deprecated functions when I ran into this problem, and in most cases all see-also are also deprecated, so no there is no help. ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/bug.php?id=51418&edit=1