X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_analyze.rst;h=88f3ad9d6b74076d8666606bc5db1c7cce375ce0;hb=e2688497603c56929e6dd2b4e6139dd85edcb0e0;hp=da30e1414373455bf2687f4d215a633665909545;hpb=f285e1b3821f56a8983b5ce9fb1a0070e7bb0a1c;p=m6w6%2Flibmemcached

diff --git a/docs/memcached_analyze.rst b/docs/memcached_analyze.rst
index da30e141..88f3ad9d 100644
--- a/docs/memcached_analyze.rst
+++ b/docs/memcached_analyze.rst
@@ -1,89 +1,69 @@
-.. highlight:: perl
-
-
-memcached_analyze
-*****************
+=================
+Anaylzing servers
+=================
 
 
 Analyze server information
 
 
-*******
-LIBRARY
-*******
-
-
-C Client Library for memcached (libmemcached, -lmemcached)
-
-
-********
+--------
 SYNOPSIS
-********
+--------
 
+.. index:: object: memcached_analysis_st
 
 
-.. code-block:: perl
+#include <libmemcached/memcached.h>
 
-   #include <libmemcached/memcached.h>
+.. c:type:: memcached_analysis_st
  
-   memcached_analysis_st *
-     memcached_analyze (memcached_st *ptr,
-                        memcached_stat_st *stat,
-                        memcached_return_t *error);
+.. c:function::  memcached_analysis_st * memcached_analyze (memcached_st *ptr, memcached_stat_st *stat, memcached_return_t *error)
 
+Compile and link with -lmemcached
 
-
-***********
+-----------
 DESCRIPTION
-***********
+-----------
 
 
-libmemcached(3) has the ability to query a memcached server (or collection
-of servers) for their current state. Queries to find state return a
-\ ``memcached_analysis_st``\  structure. You are responsible for freeing this structure.
+:program:`libmemcached` has the ability to query a memcached server (or 
+collection of servers) for their current state. Queries to find state return a
+:c:type:`memcached_analysis_st` structure. You are responsible for freeing this structure.
 
-memcached_analyze() analyzes useful information based on the provided servers
-and sets the result to the \ ``memcached_analysis_st``\  structure. The return value
-must be freed by the calling application.
+:c:func:`memcached_analyze` analyzes useful information based on the 
+provided servers and sets the result to the :c:type:`memcached_analysis_st` 
+structure. The return value must be freed by the calling application.
 
-A command line tool, memstat(1) with the option --analyze, is provided so that
-you do not have to write an application to use this method.
+A command line tool, :program:`memstat` with the option :option:`memstat --analyze`, 
+is provided so that you do not have to write an application to use this method.
 
 
-******
+------
 RETURN
-******
+------
 
 
-A pointer to the allocated \ ``memcached_analysis_st``\  structure on success and
-a NULL pointer on failure. You may inspect the error detail by checking the
-\ ``memcached_return_t``\  value.
+A pointer to the allocated :c:type:`memcached_analysis_st` structure on 
+success and a NULL pointer on failure. You may inspect the error detail by 
+checking the :c:type:`memcached_return_t` value.
 
-Any method returning a \ ``memcached_analysis_st``\  expects you to free the
+Any method returning a :c:type:`memcached_analysis_st` expects you to free the
 memory allocated for it.
 
 
-****
+----
 HOME
-****
+----
 
 
 To find out more information please check:
-`https://launchpad.net/libmemcached <https://launchpad.net/libmemcached>`_
-
-
-******
-AUTHOR
-******
-
-
-Toru Maesaka, <dev@torum.net>
+`http://libmemcached.org/ <http://libmemcached.org/>`_
 
 
-********
+--------
 SEE ALSO
-********
+--------
 
 
-memcached(1) libmemcached(3) memcached_strerror(3)
+:manpage:`memcached(1)` :manpage:`libmemcached(3)` :manpage:`memcached_strerror(3)`