More documentation fixing.
authorBrian Aker <brian@tangent.org>
Fri, 8 Apr 2011 23:07:18 +0000 (16:07 -0700)
committerBrian Aker <brian@tangent.org>
Fri, 8 Apr 2011 23:07:18 +0000 (16:07 -0700)
33 files changed:
docs/hashkit_create.rst
docs/index.rst
docs/libmemcachedutil.rst
docs/man/hashkit_clone.3
docs/man/hashkit_create.3
docs/man/hashkit_free.3
docs/man/hashkit_is_allocated.3
docs/man/libmemcachedutil.3
docs/man/memaslap.1
docs/man/memcached_result_cas.3
docs/man/memcached_result_create.3
docs/man/memcached_result_flags.3
docs/man/memcached_result_free.3
docs/man/memcached_result_key_length.3
docs/man/memcached_result_key_value.3
docs/man/memcached_result_length.3
docs/man/memcached_result_st.3
docs/man/memcached_result_value.3
docs/man/memcapable.1
docs/man/memcat.1
docs/man/memcp.1
docs/man/memdump.1
docs/man/memflush.1
docs/man/memrm.1
docs/memaslap.rst
docs/memcached_result_st.rst
docs/memcapable.rst
docs/memcat.rst
docs/memcp.rst
docs/memdump.rst
docs/memerror.rst
docs/memflush.rst
docs/memrm.rst

index 44402b37ef53d22407189a9522f3148140771105..3d801b1fe2210ed2dc0f402cb4589777f031cfd5 100644 (file)
@@ -22,7 +22,7 @@ SYNOPSIS
 
 .. code-block:: perl
 
-   #include <libhashkit/hashkit.h>
+   #include <libmemcached/hashkit.h>
  
    hashkit_st *hashkit_create(hashkit_st *hash);
  
index eaa17f68521ec92115bbd8e629a117605d7d607c..f4fda2df983d1561780e1f3b9d39afe6726129d6 100644 (file)
@@ -7,7 +7,7 @@ Libmemcached
 ------------
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    libmemcached
    libmemcached_examples
@@ -43,7 +43,7 @@ Client Applications
 -------------------
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    memcapable
    memcat
@@ -61,7 +61,7 @@ Libhashkit
 ----------
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    hashkit_create
    hashkit_functions
index 046108da0b9670d3171fcdcb58bc96c40091d8fa..4fc6c79223e055bc4c00d852c4790837bd168ad0 100644 (file)
@@ -6,17 +6,17 @@ libmemcachedutil
 Utility library for libmemcached
 
 
-=======
+-------
 LIBRARY
-=======
+-------
 
 
 C Client Library containing utility functions for libmemcached (libmemcachedutil, -lmemcachedutil)
 
 
-========
+--------
 SYNOPSIS
-========
+--------
 
 
 .. code-block:: perl
@@ -27,18 +27,18 @@ SYNOPSIS
 
 
 
-===========
+-----------
 DESCRIPTION
-===========
+-----------
 
 
 \ **libmemcachedutil**\  is a small and thread-safe client library that provides
 extra functionality built on top of \ **libmemcached**\ .
 
 
-=======
+-------
 THREADS
-=======
+-------
 
 
 Do not try to access an instance of \ ``memcached_st``\  from multiple threads
@@ -47,18 +47,18 @@ you should either clone the \ ``memcached_st``\ , or use the memcached pool
 implementation. see memcached_pool_create(3).
 
 
-====
+----
 HOME
-====
+----
 
 
 To find out more information please check:
 `https://launchpad.net/libmemcached <https://launchpad.net/libmemcached>`_
 
 
-========
+--------
 SEE ALSO
-========
+--------
 
 
 :manpage:`libmemcached(3)`
index 70ea45063e657e668ae4a763fa5e1ca33d7cf50a..87f1e86a11728313603c3d7c34d87672c2cec473 100644 (file)
@@ -39,7 +39,7 @@ C Library for hashing algorithms (libmemcached, \-lhashkit)
 .sp
 .nf
 .ft C
-#include <libhashkit/hashkit.h>
+#include <libmemcached/hashkit.h>
 
 hashkit_st *hashkit_create(hashkit_st *hash);
 
index 336ab394547ff60f37e47c652d355d02404a1090..b1864ca1a2e6a0d9fb5a73067664bc8287bb7517 100644 (file)
@@ -39,7 +39,7 @@ C Library for hashing algorithms (libmemcached, \-lhashkit)
 .sp
 .nf
 .ft C
-#include <libhashkit/hashkit.h>
+#include <libmemcached/hashkit.h>
 
 hashkit_st *hashkit_create(hashkit_st *hash);
 
index 1c7953da023d45265df27988425401c4c5b7669a..8736d6116b7dbc3cab16d505672da692b2db9d30 100644 (file)
@@ -39,7 +39,7 @@ C Library for hashing algorithms (libmemcached, \-lhashkit)
 .sp
 .nf
 .ft C
-#include <libhashkit/hashkit.h>
+#include <libmemcached/hashkit.h>
 
 hashkit_st *hashkit_create(hashkit_st *hash);
 
index a754feab419157981aa9b82f29a1a7435f6d262c..b9ec2c7418282ac649d8be86c0795ca0ee3a0290 100644 (file)
@@ -39,7 +39,7 @@ C Library for hashing algorithms (libmemcached, \-lhashkit)
 .sp
 .nf
 .ft C
-#include <libhashkit/hashkit.h>
+#include <libmemcached/hashkit.h>
 
 hashkit_st *hashkit_create(hashkit_st *hash);
 
index 25936d85f8f124e200fc7ed58a34444957950c80..f427034ccd2badd0812725ced78db41d69db28cc 100644 (file)
@@ -32,8 +32,10 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .
 .sp
 Utility library for libmemcached
+.SH LIBRARY
 .sp
 C Client Library containing utility functions for libmemcached (libmemcachedutil, \-lmemcachedutil)
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -42,17 +44,21 @@ cc [ flag ... ] file ... \-lmemcachedutil
 #include <libmemcached/memcached_util.h>
 .ft P
 .fi
+.SH DESCRIPTION
 .sp
 \fBlibmemcachedutil\fP is a small and thread\-safe client library that provides
 extra functionality built on top of \fBlibmemcached\fP.
+.SH THREADS
 .sp
 Do not try to access an instance of \fBmemcached_st\fP from multiple threads
 at the same time. If you want to access memcached from multiple threads
 you should either clone the \fBmemcached_st\fP, or use the memcached pool
 implementation. see memcached_pool_create(3).
+.SH HOME
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
+.SH SEE ALSO
 .sp
 \fIlibmemcached(3)\fP
 \fImemcached_pool_create(3)\fP \fImemcached_pool_destroy(3)\fP \fImemcached_pool_pop(3)\fP \fImemcached_pool_push(3)\fP
index cc8c0cb74eb737e173e1c6bd616ae92fad44920f..3b5a2b8af675296fcead91105da939f49600b902 100644 (file)
@@ -44,7 +44,7 @@ memaslap [options]
 \fBmemaslap\fP is a load generation and benchmark tool for memcached(1)
 servers. It generates configurable workload such as threads, concurrencies, connections,
 run time, overwrite, miss rate, key size, value size, get/set proportion,
-expected throughput, and so on. Furthermore, it also supports data
+expected throughput, and so on. Furthermore, it also testss data
 verification, expire\-time verification, UDP, binary protocol, facebook test,
 replication test, multi\-get and reconnection, etc.
 .sp
@@ -94,7 +94,7 @@ memaslap can handle network very efficiently.
 .sp
 Memslap has the similar implementation of multi\-threads to
 memcached. Memslap creates one or more self\-governed threads;
-each thread is bound with one CPU core if the system supports setting CPU
+each thread is bound with one CPU core if the system testss setting CPU
 core affinity.
 .sp
 In addition, each thread has a libevent to manage the events of the network;
@@ -165,9 +165,9 @@ layer.
 .sp
 Because each thread is self\-governed, memaslap can assign
 different threads to handle different memcached servers. This is just one of
-the ways in which memaslap supports multiple servers. The only
+the ways in which memaslap testss multiple servers. The only
 limitation is that the number of servers cannot be greater than the number
-of threads. The other way to support multiple servers is for replication
+of threads. The other way to tests multiple servers is for replication
 test. Each concurrency has one socket connection to each memcached server.
 For the implementation, memaslap can set some objects to one
 memcached server, and get these objects from the other servers.
@@ -176,10 +176,10 @@ By default, Memslap does single get. If the user specifies
 multi\-get option, memaslap will collect enough get commands and
 pack and send the commands together.
 .sp
-Memslap supports both the ASCII protocol and binary protocol,
+Memslap testss both the ASCII protocol and binary protocol,
 but it runs on the ASCII protocol by default.
 Memslap by default runs on the TCP protocol, but it also
-supports UDP. Because UDP is unreliable, dropped packages and out\-of\-order
+testss UDP. Because UDP is unreliable, dropped packages and out\-of\-order
 packages may occur. Memslap creates a memory buffer to handle
 these problems. Memslap tries to read all the response data of
 one command from the server and reorders the response data. If some packages
@@ -246,8 +246,8 @@ rounded to 3 decimal places.
 The minimum value size is 1 bytes; the maximum value size is 1M bytes. The
 precision of proportion is 0.001. The proportion of distribution will be
 rounded to 3 decimal places.
-Currently, memaslap only supports set and get commands. And it
-supports 100% set and 100% get. For 100% get, it will preset some objects to
+Currently, memaslap only testss set and get commands. And it
+testss 100% set and 100% get. For 100% get, it will preset some objects to
 the server.
 .SS Multi\-thread and concurrency
 .sp
@@ -257,7 +257,7 @@ number of them. The default number of threads is 1; the default number of
 concurrency is 16. The user can use “—threads” and “\-\-concurrency” to
 specify these variables.
 .sp
-If the system supports setting CPU affinity and the number of threads
+If the system testss setting CPU affinity and the number of threads
 specified by the user is greater than 1, memaslap will try to
 bind each thread to a different CPU core. So if you want to get the best
 performance memaslap, it is better to specify the number of
@@ -316,7 +316,7 @@ throughput using “\-\-tps” option.
 Most of the time, the user does not need to specify the window size. The
 default window size is 10k. For Schooner Memcached, the user can specify
 different window sizes to get different cache miss rates based on the test
-case. Memslap supports cache miss rate between 0% and 100%.
+case. Memslap testss cache miss rate between 0% and 100%.
 If you use this utility to test the performance of Schooner Memcached, you
 can specify a proper window size to get the expected cache miss rate. The
 formula for calculating window size is as follows:
@@ -364,11 +364,11 @@ The formula for calculating window size for cache miss rate 5%:
 cache_size / concurrency / (key_size + value_size) * 0.7
 .SS Verification
 .sp
-Memslap supports both data verification and expire\-time
+Memslap testss both data verification and expire\-time
 verification. The user can use "\-\-verify=" or "\-v" to specify the proportion
-of data verification. In theory, it supports 100% data verification. The
+of data verification. In theory, it testss 100% data verification. The
 user can use "\-\-exp_verify=" or "\-e" to specify the proportion of
-expire\-time verification. In theory, it supports 100% expire\-time
+expire\-time verification. In theory, it testss 100% expire\-time
 verification. Specify the "\-\-verbose" options to get more detailed error
 information.
 .sp
@@ -376,9 +376,9 @@ For example: \-\-exp_verify=0.01 –verify=0.1 , it means that 1% of the objects
 set with expire\-time, 10% of the objects gotten will be verified. If the
 objects are gotten, memaslap will verify the expire\-time and
 value.
-.SS multi\-servers and multi\-clients
+.SS multi\-servers and multi\-config
 .sp
-Memslap supports multi\-servers based on self\-governed thread.
+Memslap testss multi\-servers based on self\-governed thread.
 There is a limitation that the number of servers cannot be greater than the
 number of threads. Memslap assigns one thread to handle one
 server at least. The user can use the "\-\-servers=" or "\-s" option to specify
@@ -427,10 +427,10 @@ For more information on the format of dumping statistic information, refer to 
 .SS Multi\-get
 .sp
 The user can use "\-\-division=" or "\-d" to specify multi\-get keys count.
-Memslap by default does single get with TCP. Memslap also supports data
+Memslap by default does single get with TCP. Memslap also testss data
 verification and expire\-time verification for multi\-get.
 .sp
-Memslap supports multi\-get with both TCP and UDP. Because of
+Memslap testss multi\-get with both TCP and UDP. Because of
 the different implementation of the ASCII protocol and binary protocol,
 there are some differences between the two. For the ASCII protocol,
 memaslap sends one “multi\-get” to the server once. For the
@@ -438,7 +438,7 @@ binary protocol, memaslap sends several single get commands
 together as “multi\-get” to the server.
 .SS UDP and TCP
 .sp
-Memslap supports both UDP and TCP. For TCP,
+Memslap testss both UDP and TCP. For TCP,
 memaslap does not reconnect the memcached server if socket connections are
 lost. If all the socket connections are lost or memcached server crashes,
 memaslap will exit. If the user specifies the “\-\-reconnect”
@@ -449,10 +449,10 @@ limitations:
 .sp
 UDP cannot set data more than 1400 bytes.
 .sp
-UDP is not supported by the binary protocol because the binary protocol of
-memcached does not support that.
+UDP is not testsed by the binary protocol because the binary protocol of
+memcached does not tests that.
 .sp
-UDP doesn’t support reconnection.
+UDP doesn’t tests reconnection.
 .SS Facebook test
 .sp
 Set data with TCP and multi\-get with UDP. Specify the following options:
@@ -492,8 +492,8 @@ server 0 and server 1 crash, memaslap will exit.
 .SS Supports thousands of TCP connections
 .sp
 Start memaslap with "\-\-conn_sock=" or "\-n" to enable this
-feature. Make sure that your system can support opening thousands of files
-and creating thousands of sockets. However, this feature does not support
+feature. Make sure that your system can tests opening thousands of files
+and creating thousands of sockets. However, this feature does not tests
 reconnection if sockets disconnect.
 .sp
 For example:
@@ -507,7 +507,7 @@ connections, and the total number of TCP socket connections is 128 * 128 =
 .SS Supports binary protocol
 .sp
 Start memaslap with "\-\-binary" or "\-B" options to enable this
-feature. It supports all the above features except UDP, because the latest
+feature. It testss all the above features except UDP, because the latest
 memcached 1.3.3 does not implement binary UDP protocol.
 .sp
 For example:
@@ -515,7 +515,7 @@ For example:
 \-\-binary
 .sp
 Since memcached 1.3.3 doesn\(aqt implement binary UDP protocol,
-memaslap does not support UDP. In addition, memcached 1.3.3 does not support
+memaslap does not tests UDP. In addition, memcached 1.3.3 does not tests
 multi\-get. If you specify "\-\-division=50" option, it just sends 50 get
 commands together as “mulit\-get” to the server.
 .SH CONFIGURATION FILE
@@ -583,7 +583,7 @@ value
 #cmd
 #cmd_type cmd_proportion
 #
-#currently memaslap only supports get and set command.
+#currently memaslap only testss get and set command.
 #
 #cmd_type
 #set     0
@@ -1150,11 +1150,11 @@ Default never overwrite object.
 .TP
 .B \-R,  \-\-reconnect
 .
-Reconnect support, when connection is closed it will be reconnected.
+Reconnect tests, when connection is closed it will be reconnected.
 .TP
 .B \-U,  \-\-udp
 .
-UDP support, default memaslap uses TCP, TCP port and UDP port of
+UDP tests, default memaslap uses TCP, TCP port and UDP port of
 server must be same.
 .TP
 .B \-a,  \-\-facebook
index 1976022ee63bbe67701e056dac5e195617bfe869..a9bdbe6eaa1b913aa8badefa2f03451b5563226e 100644 (file)
@@ -35,7 +35,7 @@ Work with memcached_result_st
 .SH LIBRARY
 .sp
 C Client Library for memcached (libmemcached, \-lmemcached)
-.SS SYNOPSIS
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -68,7 +68,7 @@ void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags)
 void memcached_result_set_expiration (memcached_result_st *ptr, time_t)
 .ft P
 .fi
-.SS DESCRIPTION
+.SH DESCRIPTION
 .sp
 libmemcached(3) can optionally return a memcached_result_st which acts as a
 result object. The result objects have added benefits over the character
@@ -128,10 +128,7 @@ do this will result in leaked memory.
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SH AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
-.SS SEE ALSO
+.SH SEE ALSO
 .sp
 \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
 .SH AUTHOR
index 5532aa1bf5ded181e7aa4c843801178061c128b9..1298b2e372b0531796db9978d1b6740fce3bc3af 100644 (file)
@@ -35,7 +35,7 @@ Work with memcached_result_st
 .SH LIBRARY
 .sp
 C Client Library for memcached (libmemcached, \-lmemcached)
-.SS SYNOPSIS
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -68,7 +68,7 @@ void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags)
 void memcached_result_set_expiration (memcached_result_st *ptr, time_t)
 .ft P
 .fi
-.SS DESCRIPTION
+.SH DESCRIPTION
 .sp
 libmemcached(3) can optionally return a memcached_result_st which acts as a
 result object. The result objects have added benefits over the character
@@ -128,10 +128,7 @@ do this will result in leaked memory.
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SH AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
-.SS SEE ALSO
+.SH SEE ALSO
 .sp
 \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
 .SH AUTHOR
index 122dd555992efda08a1d20c7483ce3fd30253552..ab43a42d2527c84be78791d01bd955989e654f23 100644 (file)
@@ -35,7 +35,7 @@ Work with memcached_result_st
 .SH LIBRARY
 .sp
 C Client Library for memcached (libmemcached, \-lmemcached)
-.SS SYNOPSIS
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -68,7 +68,7 @@ void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags)
 void memcached_result_set_expiration (memcached_result_st *ptr, time_t)
 .ft P
 .fi
-.SS DESCRIPTION
+.SH DESCRIPTION
 .sp
 libmemcached(3) can optionally return a memcached_result_st which acts as a
 result object. The result objects have added benefits over the character
@@ -128,10 +128,7 @@ do this will result in leaked memory.
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SH AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
-.SS SEE ALSO
+.SH SEE ALSO
 .sp
 \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
 .SH AUTHOR
index 9217fdd9330852884e5d80fc8dcfb50f62a771f0..dd04da784fd0a1bcec4a7fc582c6b302a37bba02 100644 (file)
@@ -35,7 +35,7 @@ Work with memcached_result_st
 .SH LIBRARY
 .sp
 C Client Library for memcached (libmemcached, \-lmemcached)
-.SS SYNOPSIS
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -68,7 +68,7 @@ void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags)
 void memcached_result_set_expiration (memcached_result_st *ptr, time_t)
 .ft P
 .fi
-.SS DESCRIPTION
+.SH DESCRIPTION
 .sp
 libmemcached(3) can optionally return a memcached_result_st which acts as a
 result object. The result objects have added benefits over the character
@@ -128,10 +128,7 @@ do this will result in leaked memory.
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SH AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
-.SS SEE ALSO
+.SH SEE ALSO
 .sp
 \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
 .SH AUTHOR
index 50fa7be4fc9812fec82b7d63d183153ff12c7720..b00495578d8a89efa2f47b8d1dc82f1a3d7fc9a7 100644 (file)
@@ -35,7 +35,7 @@ Work with memcached_result_st
 .SH LIBRARY
 .sp
 C Client Library for memcached (libmemcached, \-lmemcached)
-.SS SYNOPSIS
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -68,7 +68,7 @@ void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags)
 void memcached_result_set_expiration (memcached_result_st *ptr, time_t)
 .ft P
 .fi
-.SS DESCRIPTION
+.SH DESCRIPTION
 .sp
 libmemcached(3) can optionally return a memcached_result_st which acts as a
 result object. The result objects have added benefits over the character
@@ -128,10 +128,7 @@ do this will result in leaked memory.
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SH AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
-.SS SEE ALSO
+.SH SEE ALSO
 .sp
 \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
 .SH AUTHOR
index 8b2d9bd0dc0c343b3011fc43b2349370b2c1d779..feaccfb2354a9b6eed6fed4aa85ad144412f5c25 100644 (file)
@@ -35,7 +35,7 @@ Work with memcached_result_st
 .SH LIBRARY
 .sp
 C Client Library for memcached (libmemcached, \-lmemcached)
-.SS SYNOPSIS
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -68,7 +68,7 @@ void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags)
 void memcached_result_set_expiration (memcached_result_st *ptr, time_t)
 .ft P
 .fi
-.SS DESCRIPTION
+.SH DESCRIPTION
 .sp
 libmemcached(3) can optionally return a memcached_result_st which acts as a
 result object. The result objects have added benefits over the character
@@ -128,10 +128,7 @@ do this will result in leaked memory.
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SH AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
-.SS SEE ALSO
+.SH SEE ALSO
 .sp
 \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
 .SH AUTHOR
index 2e6faa3ffda51309cd2147b6e527a21f1a080abe..0d6a4cede1d630116124329a023625dcff704382 100644 (file)
@@ -35,7 +35,7 @@ Work with memcached_result_st
 .SH LIBRARY
 .sp
 C Client Library for memcached (libmemcached, \-lmemcached)
-.SS SYNOPSIS
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -68,7 +68,7 @@ void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags)
 void memcached_result_set_expiration (memcached_result_st *ptr, time_t)
 .ft P
 .fi
-.SS DESCRIPTION
+.SH DESCRIPTION
 .sp
 libmemcached(3) can optionally return a memcached_result_st which acts as a
 result object. The result objects have added benefits over the character
@@ -128,10 +128,7 @@ do this will result in leaked memory.
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SH AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
-.SS SEE ALSO
+.SH SEE ALSO
 .sp
 \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
 .SH AUTHOR
index 8f17eca069031f4443c37621b92a1b6966150e46..5a00cb00cca2148463fedda6318471b07cebde1a 100644 (file)
@@ -35,7 +35,7 @@ Work with memcached_result_st
 .SH LIBRARY
 .sp
 C Client Library for memcached (libmemcached, \-lmemcached)
-.SS SYNOPSIS
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -68,7 +68,7 @@ void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags)
 void memcached_result_set_expiration (memcached_result_st *ptr, time_t)
 .ft P
 .fi
-.SS DESCRIPTION
+.SH DESCRIPTION
 .sp
 libmemcached(3) can optionally return a memcached_result_st which acts as a
 result object. The result objects have added benefits over the character
@@ -128,10 +128,7 @@ do this will result in leaked memory.
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SH AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
-.SS SEE ALSO
+.SH SEE ALSO
 .sp
 \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
 .SH AUTHOR
index b7608c885f08f2861bca78fadaf5af5c509a10b8..3194d29fab7c62f3f32124626210542ccb51c5c2 100644 (file)
@@ -35,7 +35,7 @@ Work with memcached_result_st
 .SH LIBRARY
 .sp
 C Client Library for memcached (libmemcached, \-lmemcached)
-.SS SYNOPSIS
+.SH SYNOPSIS
 .sp
 .nf
 .ft C
@@ -68,7 +68,7 @@ void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags)
 void memcached_result_set_expiration (memcached_result_st *ptr, time_t)
 .ft P
 .fi
-.SS DESCRIPTION
+.SH DESCRIPTION
 .sp
 libmemcached(3) can optionally return a memcached_result_st which acts as a
 result object. The result objects have added benefits over the character
@@ -128,10 +128,7 @@ do this will result in leaked memory.
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SH AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
-.SS SEE ALSO
+.SH SEE ALSO
 .sp
 \fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
 .SH AUTHOR
index 25910ff16e369c17b70f362697f5e8d1e6fa3e62..2ec8d99679569f6fce614d2595f228bb09f0181f 100644 (file)
@@ -31,57 +31,56 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" Man page generated from reStructeredText.
 .
 .sp
-Check memcached server capabilities
+Check the server for compatibility and capabilities
 .SH SYNOPSIS
-.sp
-.nf
-.ft C
-memcat [\-h hostname] [\-p port] [\-c] [\-v] [\-t n]
-.ft P
-.fi
-.SH DESCRIPTION
-.sp
-\fBmemcapable\fP connects to the specified memcached server and tries to
-determine its capabilities by running the various commands and verifying
-the response.
-.SS OPTIONS
-.sp
-The following options are testsed:
 .INDENT 0.0
 .TP
-.BI \-h \ hostname
-.
+.B \-h hostname
+.sp
 Specify the hostname to connect to. The default is \fIlocalhost\fP
+.UNINDENT
+.INDENT 0.0
 .TP
-.BI \-p \ port
-.
+.B \-p port
+.sp
 Specify the port number to connect to. The default is \fI11211\fP
+.UNINDENT
+.INDENT 0.0
 .TP
 .B \-c
 .
 Generate a coredump when it detects an error from the server.
+.UNINDENT
+.INDENT 0.0
 .TP
 .B \-v
 .
 Print out the comparison when it detects an error from the server.
+.UNINDENT
+.INDENT 0.0
 .TP
-.BI \-t \ n
-.
+.B \-t n
+.sp
 Set the timeout from an IO operation to/from the server to \fIn\fP seconds.
 .UNINDENT
+.SH DESCRIPTION
+.sp
+\fBmemcapable\fP connects to the specified memcached server and tries to
+determine its capabilities by running the various commands and verifying
+the response.
 .SH LIMITATIONS
 .sp
 The current version of memcapable will only verify the binary protocol.
-.SS HOME
+.SH HOME
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SS AUTHOR
+.SH AUTHOR
 .sp
 Trond Norbye, <\fI\%trond.norbye@gmail.com\fP>
 .SH SEE ALSO
 .sp
-memcached(1) libmemcached(3)
+\fImemcached(1)\fP \fIlibmemcached(3)\fP
 .SH AUTHOR
 Brian Aker
 .SH COPYRIGHT
index 95d52d3ba28620fb42ebe247787125440a01869f..3185c23271eb21df3069726ad346149f1228927e 100644 (file)
@@ -50,11 +50,11 @@ You can specify servers via the \fB\-\-servers\fP option or via the
 environment variable \fBMEMCACHED_SERVERS\fP.
 .sp
 For a full list of operations run the tool with the \fB\-\-help\fP option.
-.SS HOME
+.SH HOME
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SS AUTHOR
+.SH AUTHOR
 .sp
 Brian Aker, <\fI\%brian@tangent.org\fP>
 .sp
index be3975b8b900bbf365e8c3a887f6592d57a642f7..0deddac80b977f57dd918c69c77e739cbb18ce3f 100644 (file)
@@ -53,11 +53,11 @@ these, the final value in the command line list is the name of a
 server(s).
 .sp
 For a full list of operations run the tool with the \fB\-\-help\fP option.
-.SS HOME
+.SH HOME
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SS AUTHOR
+.SH AUTHOR
 .sp
 Brian Aker, <\fI\%brian@tangent.org\fP>
 .sp
index 683053e20a008c33de6de93a9afcc9adfc5df97e..c00846c9e86d348046773c124eceb3dffe85da1e 100644 (file)
@@ -33,12 +33,6 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .sp
 Dump a list of keys from a server.
 .SH SYNOPSIS
-.sp
-.nf
-.ft C
-memdump [options]
-.ft P
-.fi
 .SH DESCRIPTION
 .sp
 \fBmemdump\fP currently dumps a list of "keys" from all servers that
@@ -46,16 +40,13 @@ it is told to fetch from. Because memcached does not guarentee to
 provide all keys it is not possible to get a complete "dump".
 .sp
 For a full list of operations run the tool with the \fB\-\-help\fP option.
-.SS HOME
+.SH HOME
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SS AUTHOR
-.sp
-Brian Aker, <\fI\%brian@tangent.org\fP>
 .SH SEE ALSO
 .sp
-memcached(1) libmemcached(3)
+\fImemcached(1)\fP \fIlibmemcached(3)\fP
 .SH AUTHOR
 Brian Aker
 .SH COPYRIGHT
index d506a6f509d5890a24dc9d6054ac7b00b0e2bc59..80e3f1bf17abfaff873f2d86a088faf77e66d219 100644 (file)
@@ -32,14 +32,12 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .
 .sp
 Reset a server or list of servers
-.SH SYNOPSIS
 .sp
 .nf
 .ft C
 memflush [options]
 .ft P
 .fi
-.SH DESCRIPTION
 .sp
 \fBmemflush\fP resets the contents of memcached(1) servers.
 This means all data in these servers will be deleted.
@@ -48,16 +46,15 @@ You can specify servers via the \fB\-\-servers\fP option or via the
 environment variable \fBMEMCACHED_SERVERS\fP.
 .sp
 For a full list of operations run the tool with the \fB\-\-help\fP option.
-.SS HOME
+.SH HOME
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SS AUTHOR
+.SH AUTHOR
 .sp
 Brian Aker, <\fI\%brian@tangent.org\fP>
 .sp
 Mark Atwood <\fI\%mark@fallenpegasus.com\fP>
-.SH SEE ALSO
 .sp
 memcached(1) libmemcached(3)
 .SH AUTHOR
index 05292141ebe730a4135976e94a0fff36b3f33743..4d91ebb76ebd7bafd1fb731bd4a4c642d785f2f1 100644 (file)
@@ -47,11 +47,11 @@ You can specify servers via the \fB\-\-servers\fP option or via the
 environment variable \fBMEMCACHED_SERVERS\fP.
 .sp
 For a full list of operations run the tool with the \fB\-\-help\fP option.
-.SS HOME
+.SH HOME
 .sp
 To find out more information please check:
 \fI\%https://launchpad.net/libmemcached\fP
-.SS AUTHOR
+.SH AUTHOR
 .sp
 Brian Aker, <\fI\%brian@tangent.org\fP>
 .sp
index 03eb6d98ee36abb1feb5f41e399541b961aee9d1..76579d5682f5ee762fdbba6fd069012e2218ae61 100644 (file)
@@ -26,7 +26,7 @@ DESCRIPTION
 \ **memaslap**\  is a load generation and benchmark tool for memcached(1)
 servers. It generates configurable workload such as threads, concurrencies, connections,
 run time, overwrite, miss rate, key size, value size, get/set proportion,
-expected throughput, and so on. Furthermore, it also supports data
+expected throughput, and so on. Furthermore, it also testss data
 verification, expire-time verification, UDP, binary protocol, facebook test,
 replication test, multi-get and reconnection, etc.
 
@@ -118,7 +118,7 @@ _________________________________________________________
 
 Memslap has the similar implementation of multi-threads to
 memcached. Memslap creates one or more self-governed threads;
-each thread is bound with one CPU core if the system supports setting CPU
+each thread is bound with one CPU core if the system testss setting CPU
 core affinity.
 
 In addition, each thread has a libevent to manage the events of the network;
@@ -201,9 +201,9 @@ ________________________________________________________________________________
 
 Because each thread is self-governed, memaslap can assign
 different threads to handle different memcached servers. This is just one of
-the ways in which memaslap supports multiple servers. The only
+the ways in which memaslap testss multiple servers. The only
 limitation is that the number of servers cannot be greater than the number
-of threads. The other way to support multiple servers is for replication
+of threads. The other way to tests multiple servers is for replication
 test. Each concurrency has one socket connection to each memcached server.
 For the implementation, memaslap can set some objects to one
 memcached server, and get these objects from the other servers.
@@ -212,10 +212,10 @@ By default, Memslap does single get. If the user specifies
 multi-get option, memaslap will collect enough get commands and
 pack and send the commands together.
 
-Memslap supports both the ASCII protocol and binary protocol,
+Memslap testss both the ASCII protocol and binary protocol,
 but it runs on the ASCII protocol by default. 
 Memslap by default runs on the TCP protocol, but it also
-supports UDP. Because UDP is unreliable, dropped packages and out-of-order
+testss UDP. Because UDP is unreliable, dropped packages and out-of-order
 packages may occur. Memslap creates a memory buffer to handle
 these problems. Memslap tries to read all the response data of
 one command from the server and reorders the response data. If some packages
@@ -306,8 +306,8 @@ rounded to 3 decimal places.
 The minimum value size is 1 bytes; the maximum value size is 1M bytes. The
 precision of proportion is 0.001. The proportion of distribution will be
 rounded to 3 decimal places.
-Currently, memaslap only supports set and get commands. And it
-supports 100% set and 100% get. For 100% get, it will preset some objects to
+Currently, memaslap only testss set and get commands. And it
+testss 100% set and 100% get. For 100% get, it will preset some objects to
 the server.
 
 
@@ -321,7 +321,7 @@ number of them. The default number of threads is 1; the default number of
 concurrency is 16. The user can use “—threads” and “--concurrency” to
 specify these variables.
 
-If the system supports setting CPU affinity and the number of threads
+If the system testss setting CPU affinity and the number of threads
 specified by the user is greater than 1, memaslap will try to
 bind each thread to a different CPU core. So if you want to get the best
 performance memaslap, it is better to specify the number of
@@ -378,7 +378,7 @@ ___________
 Most of the time, the user does not need to specify the window size. The
 default window size is 10k. For Schooner Memcached, the user can specify
 different window sizes to get different cache miss rates based on the test
-case. Memslap supports cache miss rate between 0% and 100%.
+case. Memslap testss cache miss rate between 0% and 100%.
 If you use this utility to test the performance of Schooner Memcached, you
 can specify a proper window size to get the expected cache miss rate. The
 formula for calculating window size is as follows:
@@ -424,11 +424,11 @@ Verification
 ____________
 
 
-Memslap supports both data verification and expire-time
+Memslap testss both data verification and expire-time
 verification. The user can use "--verify=" or "-v" to specify the proportion
-of data verification. In theory, it supports 100% data verification. The
+of data verification. In theory, it testss 100% data verification. The
 user can use "--exp_verify=" or "-e" to specify the proportion of
-expire-time verification. In theory, it supports 100% expire-time
+expire-time verification. In theory, it testss 100% expire-time
 verification. Specify the "--verbose" options to get more detailed error
 information.
 
@@ -438,11 +438,11 @@ objects are gotten, memaslap will verify the expire-time and
 value.
 
 
-multi-servers and multi-clients
+multi-servers and multi-config
 _______________________________
 
 
-Memslap supports multi-servers based on self-governed thread.
+Memslap testss multi-servers based on self-governed thread.
 There is a limitation that the number of servers cannot be greater than the
 number of threads. Memslap assigns one thread to handle one
 server at least. The user can use the "--servers=" or "-s" option to specify
@@ -503,10 +503,10 @@ _________
 
 
 The user can use "--division=" or "-d" to specify multi-get keys count.
-Memslap by default does single get with TCP. Memslap also supports data 
+Memslap by default does single get with TCP. Memslap also testss data 
 verification and expire-time verification for multi-get.
 
-Memslap supports multi-get with both TCP and UDP. Because of
+Memslap testss multi-get with both TCP and UDP. Because of
 the different implementation of the ASCII protocol and binary protocol,
 there are some differences between the two. For the ASCII protocol,
 memaslap sends one “multi-get” to the server once. For the
@@ -518,7 +518,7 @@ UDP and TCP
 ___________
 
 
-Memslap supports both UDP and TCP. For TCP,
+Memslap testss both UDP and TCP. For TCP,
 memaslap does not reconnect the memcached server if socket connections are
 lost. If all the socket connections are lost or memcached server crashes,
 memaslap will exit. If the user specifies the “--reconnect”
@@ -529,10 +529,10 @@ limitations:
 
 UDP cannot set data more than 1400 bytes.
 
-UDP is not supported by the binary protocol because the binary protocol of
-memcached does not support that.
+UDP is not testsed by the binary protocol because the binary protocol of
+memcached does not tests that.
 
-UDP doesn’t support reconnection.
+UDP doesn’t tests reconnection.
 
 
 Facebook test
@@ -584,8 +584,8 @@ _____________________________________
 
 
 Start memaslap with "--conn_sock=" or "-n" to enable this
-feature. Make sure that your system can support opening thousands of files
-and creating thousands of sockets. However, this feature does not support
+feature. Make sure that your system can tests opening thousands of files
+and creating thousands of sockets. However, this feature does not tests
 reconnection if sockets disconnect.
 
 For example:
@@ -603,7 +603,7 @@ ________________________
 
 
 Start memaslap with "--binary" or "-B" options to enable this
-feature. It supports all the above features except UDP, because the latest
+feature. It testss all the above features except UDP, because the latest
 memcached 1.3.3 does not implement binary UDP protocol.
 
 For example:
@@ -611,7 +611,7 @@ For example:
 --binary
 
 Since memcached 1.3.3 doesn't implement binary UDP protocol,
-memaslap does not support UDP. In addition, memcached 1.3.3 does not support
+memaslap does not tests UDP. In addition, memcached 1.3.3 does not tests
 multi-get. If you specify "--division=50" option, it just sends 50 get
 commands together as “mulit-get” to the server.
 
@@ -686,7 +686,7 @@ Below is a sample configuration file:
   #cmd
   #cmd_type cmd_proportion
   #
-  #currently memaslap only supports get and set command.
+  #currently memaslap only testss get and set command.
   #
   #cmd_type
   #set     0
@@ -1182,10 +1182,10 @@ OPTIONS
     Default never overwrite object.
 
 -R, --reconnect 
-    Reconnect support, when connection is closed it will be reconnected.
+    Reconnect tests, when connection is closed it will be reconnected.
 
 -U, --udp 
-    UDP support, default memaslap uses TCP, TCP port and UDP port of
+    UDP tests, default memaslap uses TCP, TCP port and UDP port of
     server must be same.
 
 -a, --facebook 
index 058b743f7eb7496986854a8bb1e12df338710e70..818b4991eba531d44aef75685794da0bfcf62294 100644 (file)
@@ -6,9 +6,9 @@ Working with result sets
 Work with memcached_result_st
 
 
-*******
+-------
 LIBRARY
-*******
+-------
 
 
 C Client Library for memcached (libmemcached, -lmemcached)
@@ -108,9 +108,9 @@ stack based allocation. The most common issues related to ABI safety involve
 heap allocated structures.
 
 
-******
+------
 RETURN
-******
+------
 
 
 Varies, see particular functions. All structures must have
@@ -118,23 +118,15 @@ memcached_result_free() called on them for cleanup purposes. Failure to
 do this will result in leaked memory.
 
 
-****
+----
 HOME
-****
+----
 
 
 To find out more information please check:
 `https://launchpad.net/libmemcached <https://launchpad.net/libmemcached>`_
 
 
-******
-AUTHOR
-******
-
-
-Brian Aker, <brian@tangent.org>
-
-
 --------
 SEE ALSO
 --------
index 619adc6a05e8742afe5f5bd3fa37b98eccaa2d4e..97dbc066b656d87a47d348b95657f9c86fcd3cf9 100644 (file)
@@ -1,70 +1,50 @@
-============================================================
-Checking you Memcached server capibilities and compatibility
-============================================================
+=======================================================================
+memcapable - Checking a Memcached server capibilities and compatibility
+=======================================================================
 
 
-Check memcached server capabilities
+Check the server for compatibility and capabilities
 
 
 --------
 SYNOPSIS
 --------
 
+.. program:: memcat
 
-
-.. code-block:: perl
-
-   memcat [-h hostname] [-p port] [-c] [-v] [-t n]
-
-
-
------------
-DESCRIPTION
------------
-
-
-\ **memcapable**\  connects to the specified memcached server and tries to
-determine its capabilities by running the various commands and verifying
-the response.
-
-
-*******
-OPTIONS
-*******
-
-
-The following options are testsed:
-
-
--h hostname
+.. option:: -h hostname
  
  Specify the hostname to connect to. The default is \ *localhost*\ 
-
 
--p port
+.. option:: -p port
  
  Specify the port number to connect to. The default is \ *11211*\ 
  
 
 
--c
+.. option:: -c
  
  Generate a coredump when it detects an error from the server.
  
 
 
--v
+.. option:: -v
  
- Print out the comparison when it detects an error from the server.
 Print out the comparison when it detects an error from the server.
  
 
 
--t n
+.. option:: -t n
  
  Set the timeout from an IO operation to/from the server to \ *n*\  seconds.
  
+-----------
+DESCRIPTION
+-----------
 
+\ **memcapable**\  connects to the specified memcached server and tries to
+determine its capabilities by running the various commands and verifying
+the response.
 
 
 -----------
@@ -75,18 +55,18 @@ LIMITATIONS
 The current version of memcapable will only verify the binary protocol.
 
 
-****
+----
 HOME
-****
+----
 
 
 To find out more information please check:
 `https://launchpad.net/libmemcached <https://launchpad.net/libmemcached>`_
 
 
-******
+------
 AUTHOR
-******
+------
 
 
 Trond Norbye, <trond.norbye@gmail.com>
@@ -96,6 +76,5 @@ Trond Norbye, <trond.norbye@gmail.com>
 SEE ALSO
 --------
 
-
-memcached(1) libmemcached(3)
+:manpage:`memcached(1)` :manpage:`libmemcached(3)`
 
index 96d3422e2e3bcc5644194412cc1722f3be05985c..d25359450564a3758e74fafa8115cb272e82ae06 100644 (file)
@@ -1,6 +1,6 @@
-======
-memcat
-======
+=================================
+memcat - "cat" data from a server
+=================================
 
 
 Copy a set of keys to stdout
@@ -34,18 +34,18 @@ environment variable \ ``MEMCACHED_SERVERS``\ .
 For a full list of operations run the tool with the \ **--help**\  option.
 
 
-****
+----
 HOME
-****
+----
 
 
 To find out more information please check:
 `https://launchpad.net/libmemcached <https://launchpad.net/libmemcached>`_
 
 
-******
+------
 AUTHOR
-******
+------
 
 
 Brian Aker, <brian@tangent.org>
index 80305589f92e40b9d904fc4f95103a477e99e555..16cedf7a277d4b6c6592f59d126f7b3e54f6c8f5 100644 (file)
@@ -1,6 +1,6 @@
-=====
-memcp
-=====
+=============================
+memcp - Copy data to a server
+=============================
 
 
 Copies files to a collection of memcached servers
@@ -37,18 +37,18 @@ server(s).
 For a full list of operations run the tool with the \ **--help**\  option.
 
 
-****
+----
 HOME
-****
+----
 
 
 To find out more information please check:
 `https://launchpad.net/libmemcached <https://launchpad.net/libmemcached>`_
 
 
-******
+------
 AUTHOR
-******
+------
 
 
 Brian Aker, <brian@tangent.org>
index be34873c0643de67a912117a5fe2ebda50b3c27e..5b7fb9600b221a785a82445a32bc1d3febd716ba 100644 (file)
@@ -10,13 +10,7 @@ Dump a list of keys from a server.
 SYNOPSIS
 --------
 
-
-
-.. code-block:: perl
-
-   memdump [options]
-
-
+.. program:: memdump [options]
 
 -----------
 DESCRIPTION
@@ -30,27 +24,17 @@ provide all keys it is not possible to get a complete "dump".
 For a full list of operations run the tool with the \ **--help**\  option.
 
 
-****
+----
 HOME
-****
+----
 
 
 To find out more information please check:
 `https://launchpad.net/libmemcached <https://launchpad.net/libmemcached>`_
 
 
-******
-AUTHOR
-******
-
-
-Brian Aker, <brian@tangent.org>
-
-
 --------
 SEE ALSO
 --------
 
-
-memcached(1) libmemcached(3)
-
+:manpage:`memcached(1)` :manpage:`libmemcached(3)`
index 7e6ca011b1b69e4ea04f94e386729a1d6220451b..7e6751099e5318d58e0703eea18a613dfe967075 100644 (file)
@@ -1,6 +1,6 @@
-========
-memerror
-========
+==============================================
+memerror - translate an error code to a string
+==============================================
 
 
 Translate a memcached error code to a string
index 8f8b03121ff4552d5dc234784499d3ee5e8749b4..635c7f766d1a640a17f134e30bcd77b669c7c39c 100644 (file)
@@ -1,6 +1,6 @@
-========
-memflush
-========
+---------------------------------------
+memflush - flush all data from a server
+---------------------------------------
 
 
 Reset a server or list of servers
index ac358c29bb5eb53e09fde29f4e4061c97917fb66..df40ed3c60ea95e41ede1bbc7ad7f5ed0bc45a7f 100644 (file)
@@ -1,6 +1,6 @@
-=====
-memrm
-=====
+=================================
+memrm - Remove data from a server
+=================================
 
 
 memrm - Remove a key(s) from a collection of memcached servers
@@ -31,18 +31,18 @@ environment variable \ ``MEMCACHED_SERVERS``\ .
 For a full list of operations run the tool with the \ **--help**\  option.
 
 
-****
+----
 HOME
-****
+----
 
 
 To find out more information please check:
 `https://launchpad.net/libmemcached <https://launchpad.net/libmemcached>`_
 
 
-******
+------
 AUTHOR
-******
+------
 
 
 Brian Aker, <brian@tangent.org>