check for waitid and NOWAIT

[awesomized/libmemcached] / docs / source / bin / memcat.rst

diff --git a/docs/source/bin/memcat.rst b/docs/source/bin/memcat.rst
index b8612a92e1a1bc8ffbe47da4ebc00da9e61f168d..aa6cc540053f48401eaf17925fa2a5c9a56ebe5b 100644 (file)
--- a/docs/source/bin/memcat.rst
+++ b/docs/source/bin/memcat.rst
@@ -1,73 +1,53 @@
-=================================
-memcat - "cat" data from a server
-=================================
+memcat
+======
 
-
-
---------
 SYNOPSIS
 --------
 
-memcat [options] key
-
-Copy a set of keys to stdout
-
-
 .. program:: memcat
 
+memcat [options] key [key...]
+
+Read and output the value of one key or the values of a set of keys.
 
------------
 DESCRIPTION
 -----------
 
+:program:`memcat` reads and outputs the value of a single or a set of keys
+stored in a :manpage:`memcached(1)` server.
 
-:program:`memcat` outputs to stdout the value a single or multiple set of keys
-stored in a memcached(1) server. If any key is not found an error is returned.
-
-It is similar to the standard UNIX cat(1) utility.
+If any key is not found an error is returned.
 
+It is similar to the standard UNIX :manpage:`cat(1)` utility.
 
--------
 OPTIONS
 -------
 
+.. include:: options/all.rst
+.. include:: options/common.rst
+.. include:: options/hash.rst
 
-You can specify servers via the option:
-
-.. cmdoption:: --servers
-
-or via the environment variable:
+.. option:: --flag
 
-.. envvar:: `MEMCACHED_SERVERS`
+    Display stored flags.
 
-For a full list of operations run the tool with the option:
-
-.. cmdoption:: --help
-
-
-----
-HOME
-----
-
-
-To find out more information please check:
-`http://libmemcached.org/ <http://libmemcached.org/>`_
-
-
-------
-AUTHOR
-------
-
-
-Brian Aker, <brian@tangent.org>
+ENVIRONMENT
+-----------
 
-Mark Atwood <mark@fallenpegasus.com>
+.. envvar:: MEMCACHED_SERVERS
 
+    Specify a list of servers.
 
---------
 SEE ALSO
 --------
 
+.. only:: man
+
+  :manpage:`memcached(1)`
+  :manpage:`libmemcached(3)`
+  :manpage:`libmemcached_configuration(3)`
 
-:manpage:`memcached(1)` :manpage:`libmemcached(3)`
+.. only:: html
 
+  * :doc:`/libmemcached`
+  * :doc:`/libmemcached/configuration`