Doc #52695 [Opn->Csd]: Contradictory sentence
| From: | cataphract@php.net | Date: | Mon, 06 Sep 2010 04:44:31 +0000 |
| Subject: | Doc #52695 [Opn->Csd]: Contradictory sentence | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-4981@lists.php.net to get a copy of this message | ||
Edit report at http://bugs.php.net/bug.php?id=52695&edit=1
ID: 52695
Updated by: cataphract@php.net
Reported by: Adrian dot L dot Parker at gmail dot com
Summary: Contradictory sentence
-Status: Open
+Status: Closed
Type: Documentation Problem
Package: Documentation problem
Operating System: Vista Ultimate
PHP Version: 5.3.3
-Assigned To:
+Assigned To: cataphract
Block user comment: N
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:
------------------------------------------------------------------------
[2010-09-06 06:44:17] cataphract@php.net
Automatic comment from SVN on behalf of cataphract
Revision: http://svn.php.net/viewvc/?view=revision&revision=303065
Log: - Clarifying apparently contradictory phrase, as per bug #52695
------------------------------------------------------------------------
[2010-08-25 13:58:22] Adrian dot L dot Parker at gmail dot com
Description:
------------
See: http://www.php.net/manual/en/features.gc.refcounting-basics.php
Example #6
The first sentence indicates there is one zval:
"From the above Xdebug output, we see that both the old and new array
element
now point to a zval container whose "refcount" is 2"
and this is what I expected, but the second sentence:
"Of course, there are now two zval containers, but they are the same
one."
This says there are two zval containers, but it also says they are the
same one.
Which is it? Either there are two zval containers (with the same
value), or
there is one.
This second sentence also seems to contradict the first which clearly
says there
is a single zval container (which makes sense given the image preceding
it).
Expected result:
----------------
If there are two zval containers, which both have the same value, I'd
expect the
documentation to say that.
However if there is just one zval container, as per the example image
and the
first sentence, then you should not say, "Of course, there are now two
zval
containers, but they are the same one."
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/bug.php?id=52695&edit=1