From 137e212f09afdeb585682e3ef2db5d135ea15260 Mon Sep 17 00:00:00 2001
From: Andrei Zmievski <andrei@php.net>
Date: Mon, 9 Feb 2009 20:15:52 +0000
Subject: [PATCH] Finish documenting constants.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@275449 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/memcached/constants.xml | 48 +++++++++++++++++--------------
 1 file changed, 26 insertions(+), 22 deletions(-)

diff --git a/reference/memcached/constants.xml b/reference/memcached/constants.xml
index 580472dedf..6877651aeb 100644
--- a/reference/memcached/constants.xml
+++ b/reference/memcached/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 
 <appendix xml:id="memcached.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.constants;
@@ -272,147 +272,151 @@
   <varlistentry xml:id="memcached.constants.res-success">
    <term><constant>Memcached::RES_SUCCESS</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>The operation was successful.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-failure">
    <term><constant>Memcached::RES_FAILURE</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>The operation failed in some fashion.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-host-lookup-failure">
    <term><constant>Memcached::RES_HOST_LOOKUP_FAILURE</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>DNS lookup failed.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-unknown-read-failure">
    <term><constant>Memcached::RES_UNKNOWN_READ_FAILURE</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Failed to read network data.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-protocol-error">
    <term><constant>Memcached::RES_PROTOCOL_ERROR</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Bad command in memcached protocol.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-client-error">
    <term><constant>Memcached::RES_CLIENT_ERROR</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Error on the client side.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-server-error">
    <term><constant>Memcached::RES_SERVER_ERROR</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Error on the server side.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-write-failure">
    <term><constant>Memcached::RES_WRITE_FAILURE</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Failed to write network data.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-data-exists">
    <term><constant>Memcached::RES_DATA_EXISTS</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Failed to do compare-and-swap: item you are trying to store has been
+     modified since you last fetched it.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-notstored">
    <term><constant>Memcached::RES_NOTSTORED</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Item was not stored: but not because of an error. This normally
+     means that either the condition for an "add" or a "replace" command
+     wasn't met, or that the item is in a delete queue.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-notfound">
    <term><constant>Memcached::RES_NOTFOUND</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Item with this key was not found (with "get" operation or "cas"
+     operations).</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-partial-read">
    <term><constant>Memcached::RES_PARTIAL_READ</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Partial network data read error.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-some-errors">
    <term><constant>Memcached::RES_SOME_ERRORS</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Some errors occurred during multi-get.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-no-servers">
    <term><constant>Memcached::RES_NO_SERVERS</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Server list is empty.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-end">
    <term><constant>Memcached::RES_END</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>End of result set.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-errno">
    <term><constant>Memcached::RES_ERRNO</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>System error.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-buffered">
    <term><constant>Memcached::RES_BUFFERED</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>The operation was buffered.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-timeout">
    <term><constant>Memcached::RES_TIMEOUT</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>The operation timed out.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-bad-key-provided">
    <term><constant>Memcached::RES_BAD_KEY_PROVIDED</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Bad key.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-connection-socket-create-failure">
    <term><constant>Memcached::RES_CONNECTION_SOCKET_CREATE_FAILURE</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Failed to create network socket.</para>
    </listitem>
   </varlistentry>
 
   <varlistentry xml:id="memcached.constants.res-payload-failure">
    <term><constant>Memcached::RES_PAYLOAD_FAILURE</constant></term>
    <listitem>
-    <para>Description here...</para>
+    <para>Payload failre: could not compress/decompress or serialize/unserialize the value.</para>
    </listitem>
   </varlistentry>