-`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.
+
+`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.