fix install component of BC include symlinks
[awesomized/libmemcached] / docs / source / bin / memcp.rst
index d9547d918700b3c6d235b000558036beee1f7286..deea12a77d1cd3af9e866570325f6c23e8e43762 100644 (file)
@@ -1,57 +1,69 @@
-=============================
-memcp - Copy data to a server
-=============================
+memcp
+=====
 
-
-Copies files to a collection of memcached servers
-
-
---------
 SYNOPSIS
 --------
 
-memcp [options] [file] [server]
-
 .. program:: memcp
 
+memcp [options] \-\-servers <hostname[:port]...> <file...>
+
+Copy files to a collection of memcached servers.
 
------------
 DESCRIPTION
 -----------
 
+:program:`memcp` copies one or more files into :manpage:`memcached(1)` servers.
+It is similar to the standard UNIX :manpage:`cp(1)` command.
 
-:program:`memcp` copies one or more files into memcached(1) servers.
-It is similar to the standard UNIX cp(1) command.
-
-The key names will be the names of the files,
-without any directory path.
+The key names will be the names of the files, without any directory path.
 
-
--------
 OPTIONS
 -------
 
+.. include:: options/all.rst
+.. include:: options/common.rst
+.. include:: options/expire.rst
+.. include:: options/flag.rst
+.. include:: options/hash.rst
+.. include:: options/sasl.rst
+.. include:: options/udp.rst
 
-You can specify servers via the option:
+.. option:: --buffer
 
-.. option:: --servers
+    Enable internal buffering of commands.
 
-or via the environment variable:
+.. option:: --set
 
-.. envvar:: `MEMCACHED_SERVERS`
+    Issue *SET* command(s). This is the default mode.
+    See also :option:`--add` and :option:`--replace`.
 
-If you do not specify either these, the final value in the command line list is the name of a server(s).
+.. option:: --add
 
-For a full list of operations run the tool with the option:
+    Issue *ADD* command(s).
 
-.. option:: --help
+.. option:: --replace
 
+    Issue *REPLACE* command(s).
 
+ENVIRONMENT
+-----------
+
+.. envvar:: MEMCACHED_SERVERS
+
+    Specify the list of servers.
 
---------
 SEE ALSO
 --------
 
+.. only:: man
+
+    :manpage:`memcached(1)`
+    :manpage:`libmemcached(3)`
+    :manpage:`memcached_behavior(3)`
 
-:manpage:`memcached(1)` :manpage:`libmemcached(3)`
+.. only:: html
 
+    * :doc:`/libmemcached`
+    * :doc:`/libmemcached/configuration`
+    * :doc:`/libmemcached/memcached_behavior`