X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fman%2Fmemcached_clone.3;h=3361f7b4cbcc91ba82edfc8278148cb2543e8392;hb=645f3f1271ac967d9f98475f685e8820f9fe1ca6;hp=65d3f6eca966691675638a0a312d9d32f67a03f1;hpb=72bc4b04c594da7f040ce699ac38d45f4a5a4704;p=m6w6%2Flibmemcached diff --git a/docs/man/memcached_clone.3 b/docs/man/memcached_clone.3 index 65d3f6ec..3361f7b4 100644 --- a/docs/man/memcached_clone.3 +++ b/docs/man/memcached_clone.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CLONE" "3" "April 14, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_CLONE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_clone \- libmemcached Documentation . @@ -30,61 +30,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .. .\" Man page generated from reStructeredText. . -.sp -Create a memcached_st structure .SH SYNOPSIS .sp #include .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcachd_st +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_st* memcached_create(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B void memcached_free (memcached_st *ptr); +.B void memcached_free(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_clone (memcached_st *destination, memcached_st *source); +.B memcached_st* memcached_clone(memcached_st\fI\ *destination\fP, memcached_st\fI\ *source\fP) .UNINDENT .INDENT 0.0 .TP -.B void memcached_servers_reset(memcached_st); +.B void memcached_servers_reset(memcached_st) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_create() is used to create a \fBmemcached_st\fP structure that will then -be used by other libmemcached(3) functions to communicate with the server. You -should either pass a statically declared \fBmemcached_st\fP to memcached_create() or +\fI\%memcached_create()\fP is used to create a \fBmemcached_st\fP +structure that will then be used by other libmemcached(3) functions to +communicate with the server. You should either pass a statically declared +\fBmemcached_st\fP to \fI\%memcached_create()\fP or a NULL. If a NULL passed in then a structure is allocated for you. .sp -Please note, when you write new application use memcached_create_with_options() over memcached_create(). +Please note, when you write new application use +\fBmemcached_create_with_options()\fP over +\fI\%memcached_create()\fP. .sp -memcached_clone() is similar to memcached_create(3) but it copies the -defaults and list of servers from the source \fBmemcached_st\fP. 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 \fBmemcached_st\fP will be allocated for you. +\fI\%memcached_clone()\fP is similar to \fI\%memcached_create()\fP but +it copies the defaults and list of servers from the source +\fBmemcached_st\fP. If you pass a null as the argument for the source +to clone, it is the same as a call to \fI\%memcached_create()\fP. +If the destination argument is NULL a \fBmemcached_st\fP will be allocated +for you. .sp -memcached_servers_reset() allows you to zero out the list of servers that -the memcached_st has. +\fI\%memcached_servers_reset()\fP allows you to zero out the list of +servers that the \fBmemcached_st\fP has. .sp -To clean up memory associated with a \fBmemcached_st\fP 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. +To clean up memory associated with a \fBmemcached_st\fP structure you +should pass it to \fI\%memcached_free()\fP when you are finished using it. +\fI\%memcached_free()\fP is the only way to make sure all memory is +deallocated when you finish using the structure. .sp 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. .SH RETURN .sp -memcached_create() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_create()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .sp -memcached_clone() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_clone()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .SH HOME .sp To find out more information please check: