X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fsource%2Flibmemcached%2Fmemcached_create.rst;h=a5bc63791785689bea3a8f68b7e3036c7f37cc39;hb=e20117720ca0fa133781b62c43aab59fe864b390;hp=ab6760b148597cc4950b6a5357028e6286388a11;hpb=e1833e25ab4a98f9a3f9f9268185af57b2280eaf;p=m6w6%2Flibmemcached

diff --git a/docs/source/libmemcached/memcached_create.rst b/docs/source/libmemcached/memcached_create.rst
index ab6760b1..a5bc6379 100644
--- a/docs/source/libmemcached/memcached_create.rst
+++ b/docs/source/libmemcached/memcached_create.rst
@@ -1,14 +1,13 @@
-======================================
 Creating and destroying a memcached_st
 ======================================
 
---------
 SYNOPSIS
 --------
 
 #include <libmemcached/memcached.h>
+  Compile and link with -lmemcached
 
-.. type:: memcached_st
+.. type:: struct memcached_st memcached_st
 
 .. function:: memcached_st* memcached_create(memcached_st *ptr)
 
@@ -18,54 +17,52 @@ SYNOPSIS
 
 .. function:: void memcached_servers_reset(memcached_st)
 
-Compile and link with -lmemcached
-
------------
 DESCRIPTION
 -----------
 
-:func:`memcached_create` is used to create a :type:`memcached_st`
-structure that will then be used by other libmemcached(3) functions to 
-communicate with the server. You should either pass a statically declared 
-:type:`memcached_st` to :func:`memcached_create` or
+`memcached_create` is used to create a `memcached_st` structure that will then
+be used by other `libmemcached` functions to communicate with the server. You
+should either pass a statically declared `memcached_st` to `memcached_create` or
 a NULL. If a NULL passed in then a structure is allocated for you.
 
-Please note, when you write new application use
-:func:`memcached` over :func:`memcached_create`.
+Please note, when you write new application use `memcached` over
+`memcached_create`.
 
-:func:`memcached_clone` is similar to :func:`memcached_create` but
-it copies the defaults and list of servers from the source 
-:type:`memcached_st`. If you pass a null as the argument for the source 
-to clone, it is the same as a call to :func:`memcached_create`.
-If the destination argument is NULL a :type:`memcached_st` will be allocated 
-for you.
+`memcached_clone` is similar to `memcached_create` but it copies the defaults
+and list of servers from the source `memcached_st`. If you pass a null as the
+argument for the source to clone, it is the same as a call to
+`memcached_create`. If the destination argument is NULL a `memcached_st` will be
+allocated for you.
 
-:func:`memcached_servers_reset` allows you to zero out the list of
-servers that the :type:`memcached_st` has.
+`memcached_servers_reset` allows you to zero out the list of servers that the
+`memcached_st` has.
 
-To clean up memory associated with a :type:`memcached_st` structure you
-should pass it to :func:`memcached_free` when you are finished using it. 
-:func:`memcached_free` is the only way to make sure all memory is 
-deallocated when you finish using the structure.
+To clean up memory associated with a `memcached_st` structure you should pass it
+to `memcached_free` when you are finished using it. `memcached_free` is the only
+way to make sure all memory is deallocated when you finish using the structure.
 
-You may wish to avoid using memcached_create(3) or memcached_clone(3) with a
-stack based allocation. The most common issues related to ABI safety involve
-heap allocated structures.
+You may wish to avoid using `memcached_create` or `memcached_clone` with a stack
+based allocation. The most common issues related to ABI safety involve heap
+allocated structures.
 
-------
-RETURN
-------
+RETURN VALUE
+------------
 
-:func:`memcached_create` returns a pointer to the :type:`memcached_st`
-that was created (or initialized). On an allocation failure, it returns NULL.
+`memcached_create` returns a pointer to the `memcached_st` that was created (or
+initialized). On an allocation failure, it returns NULL.
 
-:func:`memcached_clone` returns a pointer to the :type:`memcached_st`
-that was created (or initialized). On an allocation failure, it returns NULL.
+`memcached_clone` returns a pointer to the `memcached_st` that was created (or
+initialized). On an allocation failure, it returns NULL.
 
---------
 SEE ALSO
 --------
 
 .. only:: man
 
-  :manpage:`memcached(1)` :manpage:`libmemcached(3)` :manpage:`memcached_strerror(3)`
+    :manpage:`memcached(1)`
+    :manpage:`libmemcached(3)`
+
+.. only:: html
+
+    * :manpage:`memcached(1)`
+    * :doc:`../libmemcached`