Doc #51434 [Opn->Csd]: Memcache::increment has badly written description

From: Date: Tue, 30 Mar 2010 23:47:22 +0000
Subject: Doc #51434 [Opn->Csd]: Memcache::increment has badly written description
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-4130@lists.php.net to get a copy of this message
Edit report at http://bugs.php.net/bug.php?id=51434&edit=1 ID: 51434 Updated by: markskilbeck@php.net Reported by: dominics at gmail dot com Summary: Memcache::increment has badly written description -Status: Open +Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant -Assigned To: +Assigned To: markskilbeck Previous Comments: ------------------------------------------------------------------------ [2010-03-31 01:04:01] markskilbeck@php.net Automatic comment from SVN on behalf of markskilbeck Revision: http://svn.php.net/viewvc/?view=revision&revision=297209 Log: Closes bug #51434 ------------------------------------------------------------------------ [2010-03-30 04:50:26] dominics at gmail dot com 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 this bug report at http://bugs.php.net/bug.php?id=51434&edit=1

« previous php.doc.bugs (#4130) next »