Doc #69604 [Csd]: Doubtful examples

From: Date: Thu, 14 May 2015 12:12:03 +0000
Subject: Doc #69604 [Csd]: Doubtful examples
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-12329@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=69604&edit=1 ID: 69604 Updated by: salathe@php.net Reported by: cmb@php.net Summary: Doubtful examples Status: Closed Type: Documentation Problem Package: Arrays related Operating System: * PHP Version: Irrelevant Assigned To: salathe Block user comment: N Private report: N New Comment: Gah, wrong "quick fix" text yet again! The first part of my previous reply should have said: 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. Previous Comments: ------------------------------------------------------------------------ [2015-05-14 12:11:07] salathe@php.net The fix for this bug has been committed. Snapshots of the sources are packaged every three hours; this change will be in the next snapshot. You can grab the snapshot at http://snaps.php.net/. For Windows: http://windows.php.net/snapshots/ Thank you for the report, and for helping us make PHP better. Those parts of the example have been removed. The fourth part may be coming back as a "note" or tip on how to naturally sort by array key, at some point in the future, but won't be in the main natsort() examples section. Thanks again to Melanie, who contributed her first patch via the online documentation editor for this. ------------------------------------------------------------------------ [2015-05-14 12:01:45] salathe@php.net Automatic comment from SVN on behalf of salathe Revision: http://svn.php.net/viewvc/?view=revision&revision=336772 Log: Removes examples that a) don't demonstrate output that relates to the purpose of the example and b) relate more to another function (usort) than the function which is the topic of the manual page (natsort) (doc bug #69604) -- Provided by Melanie King (mvs.php@gmail.com) ------------------------------------------------------------------------ [2015-05-08 15:06:17] cmb@php.net Description: ------------ --- From manual page: http://www.php.net/function.natsort --- The third and fourth parts of example #2 are doubtful. Part three says "Other characters interfering", but the example doesn't show any interference (actually, it's the same behavior as shown in example #1). Part four isn't an example of natsort(), but rather of uksort() in combination with strnatcmp(), so it should better be moved to one of these man pages. ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=69604&edit=1

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