X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;ds=sidebyside;f=docs%2Fsource%2Flibmemcached%2Fmemcached_delete.rst;h=840f62743e56bad1df07d7eceb5fd5ccd6a698dc;hb=000bce60d1b956664898d77db980952d01849b8c;hp=8c67e15d501235e6c60214c02518e2652fd4a8d5;hpb=28c4d79e109e11d7d2a9f3189de57da28302ec68;p=awesomized%2Flibmemcached

diff --git a/docs/source/libmemcached/memcached_delete.rst b/docs/source/libmemcached/memcached_delete.rst
index 8c67e15d..840f6274 100644
--- a/docs/source/libmemcached/memcached_delete.rst
+++ b/docs/source/libmemcached/memcached_delete.rst
@@ -1,59 +1,59 @@
-===========================
 Deleting data from a server
 ===========================
 
-.. index:: object: memcached_st
-
---------
 SYNOPSIS
 --------
 
-
 #include <libmemcached/memcached.h>
- 
-.. function:: memcached_return_t memcached_delete (memcached_st *ptr, const char *key, size_t key_length, time_t expiration)
+  Compile and link with -lmemcached
 
-.. function:: memcached_return_t memcached_delete_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, time_t expiration)
+.. function:: memcached_return_t memcached_delete(memcached_st *ptr, const char *key, size_t key_length, time_t expiration)
 
-Compile and link with -lmemcached
+.. function:: memcached_return_t memcached_delete_by_key(memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, time_t expiration)
+
+    :param ptr: pointer to initialized `memcached_st` struct
+    :param group_key: key namespace
+    :param group_key_length: length of the `group_key` without any terminating zero
+    :param key: the key to delete
+    :param key_length: the length og the `key` without any terminating zero
+    :param expiration: obsolete since :manpage:`memcached(1)` version 1.4
+    :returns: `memcached_return_t` indicating success
 
------------
 DESCRIPTION
 -----------
 
+`memcached_delete` is used to delete a particular key. `memcached_delete_by_key`
+works the same, but it takes a master key to find the given value.
 
-:func:`memcached_delete` is used to delete a particular key. 
-:func:`memcached_delete_by_key` works the same, but it takes a master key 
-to find the given value.
-
-Expiration works by placing the item into a delete queue, which means that
-it won't be possible to retrieve it by the "get" command. The "add" and 
-"replace" commands with this key will also fail (the "set" command will 
-succeed, however). After the time passes, the item is finally deleted from server memory.
+Expiration works by placing the item into a delete queue, which means that it
+won't be possible to retrieve it by the "get" command. The "add" and "replace"
+commands with this key will also fail (the "set" command will succeed, however).
+After the time passes, the item is finally deleted from server memory.
 
-Please note the the memcached server removed tests for expiration in
-the 1.4 version.
+Please note the the memcached server removed tests for expiration in the 1.4
+version.
 
+RETURN VALUE
+------------
 
-------
-RETURN
-------
-
-
-A value of type :type:`memcached_return_t` is returned
+A value of type `memcached_return_t` is returned
 On success that value will be `MEMCACHED_SUCCESS`.
-Use :func:`memcached_strerror` to translate this value to a printable 
-string.
-
-If you are using the non-blocking mode of the library, success only
-means that the message was queued for delivery.
-
+Use `memcached_strerror` to translate this value to a printable string.
 
+If you are using the non-blocking mode of the library, success only means that
+the message was queued for delivery.
 
---------
 SEE ALSO
 --------
 
 .. only:: man
 
-  :manpage:`memcached(1)` :manpage:`libmemcached(3)` :manpage:`memcached_strerror(3)`
+    :manpage:`memcached(1)`
+    :manpage:`libmemcached(3)`
+    :manpage:`memcached_strerror(3)`
+
+.. only:: html
+
+    * :manpage:`memcached(1)`
+    * :doc:`../libmemcached`
+    * :doc:`memcached_strerror`