php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #52695 Contradictory sentence
Submitted: 2010-08-25 13:58 UTC Modified: 2010-09-06 06:44 UTC
From: Adrian dot L dot Parker at gmail dot com Assigned: cataphract (profile)
Status: Closed Package: Documentation problem
PHP Version: 5.3.3 OS: Vista Ultimate
Private report: No CVE-ID: None
View Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
If you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
Package:
Bug Type:
Summary:
From: Adrian dot L dot Parker at gmail dot com
New email:
PHP Version: OS:

 

 [2010-08-25 13:58 UTC] 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."


Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2010-09-06 06:44 UTC] 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-09-06 06:44 UTC] cataphract@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: cataphract
 [2010-09-06 06:44 UTC] cataphract@php.net
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.


 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved.
Last updated: Wed Oct 07 22:00:01 2026 UTC