#49117 [Opn->Csd]: ambiguous documentation

From: Date: Wed, 05 Aug 2009 11:10:36 +0000
Subject: #49117 [Opn->Csd]: ambiguous documentation
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-2611@lists.php.net to get a copy of this message
ID: 49117 Updated by: bjori@php.net Reported By: ben dot zayb at yahoo dot com -Status: Open +Status: Closed Bug Type: Documentation problem 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-08-05 11:10:16] svn@php.net Automatic comment from SVN on behalf of bjori Revision: http://svn.php.net/viewvc/?view=revision&revision=286830 Log: - Fixed bug#49117 (ambiguous documentation) (Patch by Niel Archer) - Added note about mysqlnd not reading my.cnf/my.ini (Patch by Niel Archer) ------------------------------------------------------------------------ [2009-08-04 07:15:06] initcontact at grahamwideman dot com 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 ------------------------------------------------------------------------ [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 (#2611) next »