Bug #52778 [NEW]: array_walk() doc contradicts itself

From: Operating system: PHP version: 5.3.3 Package: Documentation problem Bug Type: Bug Bug description:array_walk() doc contradicts itself Description: ------------ Here: http://php.net/manual/en/function.array-walk.php For the funcname parameter it mentions in a note box that specifying a parameter as a reference can be useful because "any changes made to those elements will be made in the original array itself". After the box, the description of the parameter continues with a contradictory warning: "Users may not change the array itself from the callback function." Specifying a reference is useful to save memory for large arrays, but the reason given is wrong and misleading. You should also probably take the opportunity to clarify that the reference must be in the callback function formal parameter list and not the actual parameter list of the invocation, as the latter is deprecated in PHP 5.3.0. -- Edit bug report at http://bugs.php.net/bug.php?id=52778&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=52778&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=52778&r=trysnapshot53 Try a snapshot (trunk): http://bugs.php.net/fix.php?id=52778&r=trysnapshottrunk Fixed in SVN: http://bugs.php.net/fix.php?id=52778&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=52778&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=52778&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=52778&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=52778&r=needscript Try newer version: http://bugs.php.net/fix.php?id=52778&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=52778&r=support Expected behavior: http://bugs.php.net/fix.php?id=52778&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=52778&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=52778&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=52778&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=52778&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=52778&r=dst IIS Stability: http://bugs.php.net/fix.php?id=52778&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=52778&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=52778&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=52778&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=52778&r=mysqlcfg