Merging bzr://gaz.tangent.org/libmemcached/build/ to Build branch
[m6w6/libmemcached] / docs / man / libmemcached.3
index b854a261cbc5a79d5de6164084897e9c6e5914fd..c42517b6b861302ee5ac84c64f7a54eefce9f28c 100644 (file)
@@ -1,4 +1,4 @@
-.TH "LIBMEMCACHED" "3" "September 09, 2011" "0.52" "libmemcached"
+.TH "LIBMEMCACHED" "3" "May 03, 2012" "1.0.7" "libmemcached"
 .SH NAME
 libmemcached \- Introducing the C Client Library for memcached
 .
@@ -43,37 +43,30 @@ Compile and link with \-lmemcached
 .ce 0
 .sp
 .sp
-libMemcached is an open source C/C++ client library and tools for the memcached server (\fI\%http://danga.com/memcached\fP). It has been designed to be light on memory usage, thread safe, and provide full access to server side methods.
+libMemcached is an open source C/C++ client library and tools for the memcached server (\fI\%http://memcached.org/\fP). It has been designed to be light on memory usage, thread safe, and provide full access to server side methods.
 .sp
 libMemcached was designed to provide the greatest number of options to use Memcached. Some of the features provided:
 .INDENT 0.0
 .IP 1. 3
-.
 Asynchronous and Synchronous Transport Support.
 .IP 2. 3
-.
 Consistent Hashing and Distribution.
 .IP 3. 3
-.
 Tunable Hashing algorithm to match keys.
 .IP 4. 3
-.
 Access to large object support.
 .IP 5. 3
-.
 Local replication.
 .IP 6. 3
-.
 A complete reference guide and documentation to the API.
 .IP 7. 3
-.
 Tools to Manage your Memcached networks.
 .UNINDENT
 .SH DESCRIPTION
 .sp
 "Memcached is a high\-performance, distributed memory object caching
 system, generic in nature, but intended for use in speeding up dynamic web
-applications by alleviating database load." \fI\%http://danga.com/memcached/\fP
+applications by alleviating database load." \fI\%http://memcached.org/\fP
 .sp
 \fBlibmemcached\fP is a small, thread\-safe client library for the
 memcached protocol. The code has all been written to allow
@@ -93,7 +86,7 @@ recommended that you operate directly against the structure.
 .sp
 Nearly all functions return a \fBmemcached_return_t\fP value.
 This value can be translated to a printable string with
-\fBmemcached_strerror()\fP.
+\fBmemcached_strerror\fP.
 .sp
 Objects are stored on servers by hashing keys. The hash value maps the key to a particular server. All clients understand how this hashing works, so it is possibly to reliably both push data to a server and retrieve data from a server.
 .sp
@@ -122,46 +115,44 @@ A number of constants have been provided for in the library.
 .INDENT 0.0
 .TP
 .B MEMCACHED_DEFAULT_PORT
-.
 The default port used by memcached(3).
 .UNINDENT
 .INDENT 0.0
 .TP
 .B MEMCACHED_MAX_KEY
-.
 Default maximum size of a key (which includes the null pointer). Master keys
 have no limit, this only applies to keys used for storage.
 .UNINDENT
 .INDENT 0.0
 .TP
 .B MEMCACHED_MAX_KEY
-.
 Default size of key (which includes the null pointer).
 .UNINDENT
 .INDENT 0.0
 .TP
 .B MEMCACHED_STRIDE
-.
 This is the "stride" used in the consistent hash used between replicas.
 .UNINDENT
 .INDENT 0.0
 .TP
 .B MEMCACHED_MAX_HOST_LENGTH
-.
 Maximum allowed size of the hostname.
 .UNINDENT
 .INDENT 0.0
 .TP
 .B LIBMEMCACHED_VERSION_STRING
-.
 String value of libmemcached version such as "1.23.4"
 .UNINDENT
 .INDENT 0.0
 .TP
 .B LIBMEMCACHED_VERSION_HEX
-.
 Hex value of the version number. "0x00048000" This can be used for comparing versions based on number.
 .UNINDENT
+.INDENT 0.0
+.TP
+.B MEMCACHED_PREFIX_KEY_MAX_SIZE
+Maximum length allowed for namespacing of a key.
+.UNINDENT
 .SH THREADS AND PROCESSES
 .sp
 When using threads or forked processes it is important to keep one instance