X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fsource%2Flibmemcached%2Fmemcached_analyze.rst;h=74c7541ca7785647e7d7cb9be9d0522648e596c9;hb=c98c359a7ea03a0919a385bc88bf1387a47a41e8;hp=90189d96d2609a750f647cd53ea9cc4cff80e248;hpb=28c4d79e109e11d7d2a9f3189de57da28302ec68;p=awesomized%2Flibmemcached

diff --git a/docs/source/libmemcached/memcached_analyze.rst b/docs/source/libmemcached/memcached_analyze.rst
index 90189d96..74c7541c 100644
--- a/docs/source/libmemcached/memcached_analyze.rst
+++ b/docs/source/libmemcached/memcached_analyze.rst
@@ -1,51 +1,47 @@
-=================
 Analyzing servers
 =================
 
-Analyze server information
-
---------
 SYNOPSIS
 --------
 
-.. index:: object: memcached_analysis_st
-
 #include <libmemcached/memcached.h>
   Compile and link with -lmemcached
 
-.. type:: memcached_analysis_st
+.. type:: struct memcached_analysis_st memcached_analysis_st
 
-  typedef struct memcached_analysis_st memcached_analysis_st;
- 
-.. function::  memcached_analysis_st *memcached_analyze(memcached_st *ptr, memcached_stat_st *stat, memcached_return_t *error)
+.. function:: memcached_analysis_st *memcached_analyze(memcached_st *ptr, memcached_stat_st *stat, memcached_return_t *error)
+
+    :param ptr: pointer to initialized `memcached_st` struct
+    :param stat: pointer to a `memcached_stat_st` struct to fill
+    :param error: pointer to `memcached_return_t` indicating success
+    :returns: pointer to an allocated and filled out `memcached_analysis_t` struct
 
------------
 DESCRIPTION
 -----------
 
-`libmemcached` has the ability to query a memcached server (or
-collection of servers) for their current state. Queries to find state return a
-:type:`memcached_analysis_st` structure. You are responsible for freeing this structure.
+`libmemcached` 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.
 
-:func:`memcached_analyze` analyzes useful information based on the 
-provided servers and sets the result to the :type:`memcached_analysis_st` 
-structure. The return value must be freed by the calling application.
+`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.
 
-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.
+.. seealso:: :option:`memstat --analyze`
+    A command line tool to analyze a memcached server.
 
-------
-RETURN
-------
 
-A pointer to the allocated :type:`memcached_analysis_st` structure on 
-success and a NULL pointer on failure. You may inspect the error detail by 
-checking the :type:`memcached_return_t` value.
+RETURN VALUE
+------------
 
-Any method returning a :type:`memcached_analysis_st` expects you to free the
-memory allocated for it.
+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.
+
+Any method returning a `memcached_analysis_st` expects you to free the memory
+allocated for it.
 
---------
 SEE ALSO
 --------