diff options
| -rw-r--r-- | docs/libcurl/curl_slist_append.3 | 25 |
1 files changed, 17 insertions, 8 deletions
diff --git a/docs/libcurl/curl_slist_append.3 b/docs/libcurl/curl_slist_append.3 index 4737b989b..fbf993229 100644 --- a/docs/libcurl/curl_slist_append.3 +++ b/docs/libcurl/curl_slist_append.3 @@ -2,7 +2,7 @@ .\" nroff -man [file] .\" $Id$ .\" -.TH curl_slist_append 3 "5 March 2001" "libcurl 7.0" "libcurl Manual" +.TH curl_slist_append 3 "21 Feb 2003" "libcurl 7.10.4" "libcurl Manual" .SH NAME curl_slist_append - add a string to an slist .SH SYNOPSIS @@ -13,17 +13,26 @@ curl_slist_append - add a string to an slist .ad .SH DESCRIPTION curl_slist_append() appends a specified string to a linked list of -strings. The existing -.I list -should be passed as the first argument while the new list is returned from -this function. The specified -.I string -has been appended when this function returns. +strings. The existing \fIlist\fP should be passed as the first argument while +the new list is returned from this function. The specified \fIstring\fP has +been appended when this function returns. + +The list should be freed again (after usage) with \fBcurl_slist_free_all()\fP. .SH RETURN VALUE A null pointer is returned if anything went wrong, otherwise the new list pointer is returned. +.SH EXAMPLE + CURL handle; + curl_slist *slist=NULL; + + slist = curl_slist_append(slist, "pragma:"); + curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist); + + curl_easy_perform(handle); + + curl_slist_free_all(slist); /* free the list again */ .SH "SEE ALSO" .BR curl_slist_free_all "(3), " .SH BUGS -Surely there are some, you tell me! +None. |