On Sep 8, 2009, at 6:12 PM, Daniel Convissor wrote:
Hi Brandon:
Nice stuff. Two qualms with the following:
PHP 5's object model also significantly changes the way objects
are passed, passing a pointer to the object rather than copying
the object.
First, "passed" is the followed immediately by "passing." Pick a
different word for one or the other.
Second, the documentation in general talks about it being "by
reference"
rather than as "a pointer."
Thanks,
--Dan
Hi Dan,
I have no trouble changing the wording on your first point, as it does
make the wording seem a bit odd.
However, each spot where the documentation states that objects are
passed by reference is wrong. See this blog post by Sara Golemon: http://blog.libssh2.org/index.php?/archives/51-Youre-being-lied-to..html
Essentially, objects are like references, pointing to a particular
spot in memory where the object can be found. While it's easier to
describe objects as being passed by reference in PHP 5, this is in
fact not the case.
I'm not sure how to change the documentation to reflect this. How
specific should we get in the documentation?
Best,
Brandon
