Doc #65666 [Opn->Nab]: Please reference alternatives to depricated split function

Edit report at https://bugs.php.net/bug.php?id=65666&edit=1 ID: 65666 Updated by: krakjoe@php.net Reported by: joe at joeceresini dot com Summary: Please reference alternatives to depricated split function -Status: Open +Status: Not a bug Type: Documentation Problem Package: Documentation problem Operating System: N/A PHP Version: Irrelevant Block user comment: N Private report: N New Comment: All we can do is put the documentation out there ... you have to read it. Previous Comments: ------------------------------------------------------------------------ [2013-09-16 12:17:13] cmbecker69 at gmx dot de The notes[1] on the manual page are quite explicit about alternatives. IMHO that is sufficient in addition to the prominent deprecation warning. [1] <http://de3.php.net/function.split#refsect1-function.split-notes> ------------------------------------------------------------------------ [2013-09-14 01:46:41] joe at joeceresini dot com I see there is already a "see also" section, but as a developer, I'm not going to read past parameters, return values and examples to find alternatives. I could have sworn I've seen other deprecated functions with alternatives directly in the deprecation warning. If it were my decision, that's where I'd put them. ------------------------------------------------------------------------ [2013-09-13 15:20:16] gabri dot ns at gmail dot com there is already offered alternative on [Ssee Also] section. http://www.php.net/function.split#refsect1-function.split-seealso ------------------------------------------------------------------------ [2013-09-13 15:04:29] joe at joeceresini dot com Description: ------------ --- From manual page: http://www.php.net/function.split#refsect1-function.split-description --- In the notice below, please add alternatives such as explode and preg_split. I noticed a few posts on forums asking what alternatives are available for split from people that saw it was deprecated. Offering the alternatives on that page will provide a better user experience for those reading the documentation. Notice from the split doc page: "This function has been DEPRECATED as of PHP 5.3.0. Relying on this feature is highly discouraged." ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=65666&edit=1