#49834 [Opn->Csd]: array_* functions badly documented

ID: 49834 Updated by: vrana@php.net Reported By: sqw at guerrillamailblock dot com -Status: Open +Status: Closed Bug Type: Documentation problem Operating System: all PHP Version: Irrelevant 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: ------------------------------------------------------------------------ [2009-11-13 21:06:59] svn@php.net Automatic comment from SVN on behalf of vrana Revision: http://svn.php.net/viewvc/?view=revision&revision=290698 Log: Terminology (bug #49834) ------------------------------------------------------------------------ [2009-10-10 20:56:49] sqw at guerrillamailblock dot com Description: ------------ if someone here is listening: i am targeting the array_* functions. i demand crystal clear distinction between the terms "key", "value", and "entry" (a.k.a. "key => value pair"). for example things like "array_intersect_key: Returns an associative array containing all the values of array1 which have matching keys that are present in all arguments. " are not acceptable. here, "value" actually denotes entry. compare array_diff_key. also "matching" is nonsensical here. next thing "array_diff_key: Returns an array containing all the entries from array1 that are not present in any of the other arrays." is directly copied from array_diff, and wrong thus. it should read "Returns an array containing all the entries from array1 whose keys are not present in any of the other arrays. " ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/?id=49834&edit=1