Doc #66480 [Opn->Csd]: Ambiguous Language For array_diff() Documentation

Edit report at https://bugs.php.net/bug.php?id=66480&edit=1 ID: 66480 Updated by: aharvey@php.net Reported by: mpearson at mpearson dot net Summary: Ambiguous Language For array_diff() Documentation -Status: Open +Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant -Assigned To: +Assigned To: aharvey 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. Previous Comments: ------------------------------------------------------------------------ [2014-03-06 17:51:30] narf at devilix dot net This has already been fixed. ------------------------------------------------------------------------ [2014-01-15 08:58:56] aharvey@php.net Automatic comment from SVN on behalf of aharvey Revision: http://svn.php.net/viewvc/?view=revision&revision=332625 Log: Clarify the introductory array_diff() paragraph. Fixes doc bug #66480 (Ambiguous Language For array_diff() Documentation). ------------------------------------------------------------------------ [2014-01-13 20:32:19] mpearson at mpearson dot net Description: ------------ The documentation for array_diff() is a bit ambiguous in the "Description" section. Quote: "Compares array1 against array2 and returns the difference." While the statement is technically true, it is not until the "Return Values" section that the documentation clarifies that excess values in 'array2' will not be returned as well. At a quick glance, if the description matches desired action the "Return Values" section may never be viewed to clarify the ambiguity from the description. My recommendation would be to change the description to something like, " Compares array1 against array2 and returns the values from array1 which are not found in array2." This makes it immediately clear that the values returned will not include non-matching values found in array2. Granted, the confusion could be blamed on the developer for not reviewing the entire documentation, but I am certain I am not the only person that will use a function based on the description matching the desired affect not expecting the description to be ambiguous. Thanks! ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=66480&edit=1