Doc #51434 [NEW]: Memcache::increment has badly written description
| From: | dominics at gmail dot com | Date: | Tue, 30 Mar 2010 02:50:27 +0000 |
| Subject: | Doc #51434 [NEW]: Memcache::increment has badly written description | ||
| Groups: | php.doc.bugs | ||
| Request: | Send a blank email to doc-bugs+get-4123@lists.php.net to get a copy of this message | ||
From:
Operating system:
PHP version: Irrelevant
Package: Documentation problem
Bug Type: Documentation Problem
Bug description:Memcache::increment has badly written description
Description:
------------
http://php.net/manual/en/function.memcache-increment.php
The description of Memcache::increment() is confusing. It is missing
determiners, uses incorrect prepositions and apostrophes, and has tense
disagreement.
Existing: Memcache::increment() increments value of the item on the
specified _value_.
Suggestion: Memcache::increment() increments the value of an item by the
specified _value_.
Existing: If the item with _key_ was not numeric and cannot be converted to
number, it will change it's value to value.
Suggestion: If the item specified by _key_ is not numeric and cannot be
converted to a number, Memcache::increment() will change its value to
_value_.
Existing: Memcache::increment() does not create an item if it didn't
exist.
Suggestion: Memcache::increment() does not create an item if one doesn't
already exist.
Existing: Note: Do not use Memcache::increment() with item, which was
stored compressed, because consequent call to Memcache::get() will fail.
Suggestion: Note: Do not use Memcache::increment() with items that have
been stored compressed because subsequent calls to Memcache::get() will
fail.
Expected result:
----------------
Memcache::increment() increments the value of an item by the specified
_value_. If the item specified by _key_ is not numeric and cannot be
converted to a number, Memcache::increment() will change its value to
_value_. Memcache::increment() does not create an item if one doesn't
already exist.
Note: Do not use Memcache::increment() with items that have been stored
compressed because subsequent calls to Memcache::get() will fail.
Actual result:
--------------
Memcache::increment() increments value of the item on the specified
_value_. If the item with _key_ was not numeric and cannot be converted to
number, it will change it's value to value. Memcache::increment() does not
create an item if it didn't exist.
Note: Do not use Memcache::increment() with item, which was stored
compressed, because consequent call to Memcache::get() will fail.
--
Edit bug report at http://bugs.php.net/bug.php?id=51434&edit=1
--
Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=51434&r=trysnapshot52
Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=51434&r=trysnapshot53
Try a snapshot (PHP 6.0): http://bugs.php.net/fix.php?id=51434&r=trysnapshot60
Fixed in SVN: http://bugs.php.net/fix.php?id=51434&r=fixed
Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=51434&r=needdocs
Fixed in release: http://bugs.php.net/fix.php?id=51434&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=51434&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=51434&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=51434&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=51434&r=support
Expected behavior: http://bugs.php.net/fix.php?id=51434&r=notwrong
Not enough info: http://bugs.php.net/fix.php?id=51434&r=notenoughinfo
Submitted twice: http://bugs.php.net/fix.php?id=51434&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=51434&r=globals
PHP 4 support discontinued: http://bugs.php.net/fix.php?id=51434&r=php4
Daylight Savings: http://bugs.php.net/fix.php?id=51434&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=51434&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=51434&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=51434&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=51434&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=51434&r=mysqlcfg