Update docs directives.

[awesomized/libmemcached] / docs / memcached_version.rst

diff --git a/docs/memcached_version.rst b/docs/memcached_version.rst
index 334e09be3aa7837509bbc864c98aeddedfbaf051..20b8b25a20150943bcf2e0f7f238ab5d0476ae1c 100644 (file)
--- a/docs/memcached_version.rst
+++ b/docs/memcached_version.rst
@@ -1,89 +1,63 @@
-.. highlight:: perl
+=======================================================
+Getting version information about the client and server
+=======================================================
 
+ 
+--------
+SYNOPSIS
+--------
 
-memcached_lib_version, memcached_version
-****************************************
-
-
-Get library version
-
-
-*******
-LIBRARY
-*******
-
+#include <libmemcached/memcached.h>
 
-C Client Library for memcached (libmemcached, -lmemcached)
+.. c:function:: const char * memcached_lib_version (void) 
 
+.. c:function:: memcached_return_t memcached_version (memcached_st *ptr)
 
-********
-SYNOPSIS
-********
 
+Compile and link with -lmemcached
 
 
-.. code-block:: perl
 
-   #include <libmemcached/memcached.h>
- 
-   const char *
-     memcached_lib_version (void) 
- 
- 
-   memcached_return_t
-     memcached_version (memcached_st *ptr)
+-----------
+DESCRIPTION
+-----------
 
 
+:c:func:`memcached_lib_version` is used to return a simple version string representing the libmemcached version (client library version, not server version)
 
-***********
-DESCRIPTION
-***********
+:c:func:`memcached_version` is used to set the major, minor, and micro versions of each memcached server being used by the memcached_st connection structure. It returns the memcached server return code.
 
 
-memcached_lib_version() is used to return a simple version string representing
-the libmemcached version (version of the client library, not server)
+------
+RETURN
+------
 
-memcached_version() is used to set the major, minor, and micro versions of each
-memcached server being used by the memcached_st connection structure. It returns the 
-memcached server return code.
 
+:c:func:`memcached_lib_version` returns a string with the version of the libmemcached driver.
 
-******
-RETURN
-******
+A value of :c:type:`memcached_return_t` is returned from :c:func:'memcached_version'
 
+On success that value will be :c:type:`MEMCACHED_SUCCESS`. 
 
-A string with the version of libmemcached driver is returned from
-memcached_lib_version()
+If called with the :c:func:`MEMCACHED_BEHAVIOR_USE_UDP` behavior set, the value :c:type:`MEMCACHED_NOT_SUPPORTED` will be returned. 
 
-A value of type \ ``memcached_return_t``\  is returned from memcached_version()
-On success that value will be \ ``MEMCACHED_SUCCESS``\ . If called with the
-\ ``MEMCACHED_BEHAVIOR_USE_UDP``\  behavior set, the value \ ``MEMCACHED_NOT_SUPPORTED``\  
-will be returned. Use memcached_strerror() to translate this value to 
+Use :c:func:`memcached_strerror` to translate this value to 
 a printable string.
 
 
-****
+----
 HOME
-****
+----
 
 
 To find out more information please check:
-`https://launchpad.net/libmemcached <https://launchpad.net/libmemcached>`_
-
-
-******
-AUTHOR
-******
-
-
-Brian Aker, <brian@tangent.org>
+`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)`