#49117 [NEW]: ambiguous documentation

From: ben dot zayb at yahoo dot com Operating system: PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: ambiguous documentation Description: ------------ "The behaviour of functions with by-reference parameters called by value has changed. Where previously the function would accept the by-value argument, a warning is now emitted and all by-ref parameters are set to NULL." I find this ambiguous/difficult to understand. "The behaviour of functions with by-reference parameters..." Ok. This is a function "with by-reference parameters..." <?php function a( &$param ){ } ?> "..called by value has changed. Where previously the function would accept the by-value argument" Ok. This is "would accept the by-value argument..." <?php a(2); //2 is a literal ?> But this is illegal even in 5.2. So, I suppose this what is meant by "..called by value..." <?php a($someVariable); ?> "a warning is now emitted and all by-ref parameters are set to NULL" So, this would cause a warning, and all by-ref paramaters are set to NULL? Thanks -- Edit bug report at http://bugs.php.net/?id=49117&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=49117&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=49117&r=trysnapshot53 Try a snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=49117&r=trysnapshot60 Fixed in SVN: http://bugs.php.net/fix.php?id=49117&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=49117&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=49117&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=49117&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=49117&r=needscript Try newer version: http://bugs.php.net/fix.php?id=49117&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=49117&r=support Expected behavior: http://bugs.php.net/fix.php?id=49117&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=49117&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=49117&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=49117&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=49117&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=49117&r=dst IIS Stability: http://bugs.php.net/fix.php?id=49117&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=49117&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=49117&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=49117&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=49117&r=mysqlcfg