Doc #63934 [Opn->Csd]: Please always place recommendet alternatives just next to the deprecated notice
| From: | frozenfire@php.net | Date: | Sat, 12 Jan 2013 03:56:09 +0000 |
| Subject: | Doc #63934 [Opn->Csd]: Please always place recommendet alternatives just next to the deprecated notice | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-9389@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=63934&edit=1
ID: 63934
Updated by: frozenfire@php.net
Reported by: matteosistisette at gmail dot com
Summary: Please always place recommendet alternatives just
next to the deprecated notice
-Status: Open
+Status: Closed
Type: Documentation Problem
Package: Documentation problem
PHP Version: Irrelevant
-Assigned To:
+Assigned To: frozenfire
Block user comment: N
Private report: N
New Comment:
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.
Unfortunately, due to the way we handle deprecation notices in the documentation
(using language snippets), it's not always feasible to use the same style as is
found on, say, the mysql_connect function deprecation notice.
However, we've added in a few alternative function notices, and clarified the
existing notices that can be found in the notes section of each of the
deprecated regex functions.
Thanks for the report.
Previous Comments:
------------------------------------------------------------------------
[2013-01-12 03:54:13] frozenfire@php.net
Automatic comment from SVN on behalf of frozenfire
Revision: http://svn.php.net/viewvc/?view=revision&revision=329092
Log: Added and clarified function alternatives relating to the deprecation of the regex extension.
Contribution by Ole Aass.
Relates to and closes bug #63934.
------------------------------------------------------------------------
[2013-01-07 22:26:17] matteosistisette at gmail dot com
Description:
------------
---
From manual page: http://www.php.net/function.ereg#refsect1-function.ereg-
description
---
I hate to see a huge red warning that says: "This function has been DEPRECATED as
of PHP X.X.X. Relying on this feature is highly discouraged."
without the recommended alternative IMMEDIATELY NEXT TO IT such as "Use YYYY
instead".
The recommended alternative is usually mentioned in a NOTE a few paragraphs
later, but one shouldn't have to look for it.
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=63934&edit=1