#49834 [NEW]: array_* functions badly documented
From: sqw at guerrillamailblock dot com
Operating system: all
PHP version: Irrelevant
PHP Bug Type: Documentation problem
Bug description: array_* functions badly documented
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 bug report at http://bugs.php.net/?id=49834&edit=1
--
Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=49834&r=trysnapshot52
Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=49834&r=trysnapshot53
Try a snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=49834&r=trysnapshot60
Fixed in SVN: http://bugs.php.net/fix.php?id=49834&r=fixed
Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=49834&r=needdocs
Fixed in release: http://bugs.php.net/fix.php?id=49834&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=49834&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=49834&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=49834&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=49834&r=support
Expected behavior: http://bugs.php.net/fix.php?id=49834&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=49834&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=49834&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=49834&r=globals
PHP 4 support discontinued: http://bugs.php.net/fix.php?id=49834&r=php4
Daylight Savings: http://bugs.php.net/fix.php?id=49834&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=49834&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=49834&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=49834&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=49834&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=49834&r=mysqlcfg
Thread (2 messages)
- sqw at guerrillamailblock dot com