#49117 [Com]: ambiguous documentation

From: Date: Tue, 04 Aug 2009 07:15:07 +0000
Subject: #49117 [Com]: ambiguous documentation
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-2601@lists.php.net to get a copy of this message
ID: 49117 Comment by: initcontact at grahamwideman dot com Reported By: ben dot zayb at yahoo dot com Status: Open Bug Type: Documentation problem PHP Version: Irrelevant New Comment: I agree. This note is very ambiguous -- needs an example. BTW, here's the page URL: http://us2.php.net/manual/en/migration53.incompatible.php Previous Comments: ------------------------------------------------------------------------ [2009-07-31 06:19:41] ben dot zayb at yahoo dot com 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 this bug report at http://bugs.php.net/?id=49117&edit=1

« previous php.doc.bugs (#2601) next »