Doc #68159 [NEW]: Ambiguous sentence in "Reference Counting Basics"

From: lech at nextlevels dot ndo dot co dot uk Operating system: PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:Ambiguous sentence in "Reference Counting Basics" Description: ------------ --- From manual page: http://www.php.net/features.gc.refcounting-basics --- The following sentence at the top of the "Compound Types" section seems to be ambiguous or incorrect... "Instead of a scalar value, arrays and objects store their properties in a symbol table of their own." This would seem to imply that, for example, a string stores its properties in a scalar value. Should it not be... "As oppose to a scalar value, arrays and objects..."? (with "properties" meaning the zval properties: type, value, refcount, is_ref) or should it be... "Arrays and objects store their properties/elements in a symbol table of their own."? ...where I have assumed properties refers to the object's properties, so therefore we should mention "elements" for arrays, and I have missed out the first part of the sentence, because it would be too complicated to state accurately. Or am I missing the point? In any case, I think the current sentence is ambiguous and it would be great to understand this correctly. Thank you for the interesting documentation explaining garbage collection! -- Edit bug report at https://bugs.php.net/bug.php?id=68159&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=68159&r=trysnapshot54 Try a snapshot (PHP 5.5): https://bugs.php.net/fix.php?id=68159&r=trysnapshot55 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=68159&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=68159&r=fixed Fixed in release: https://bugs.php.net/fix.php?id=68159&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=68159&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=68159&r=needscript Try newer version: https://bugs.php.net/fix.php?id=68159&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=68159&r=support Expected behavior: https://bugs.php.net/fix.php?id=68159&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=68159&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=68159&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=68159&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=68159&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=68159&r=dst IIS Stability: https://bugs.php.net/fix.php?id=68159&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=68159&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=68159&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=68159&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=68159&r=mysqlcfg