added an EXAMPLE section

This commit is contained in:
Daniel Stenberg 2003-02-21 15:19:50 +00:00
parent 9faf57ee8d
commit a683416081

View File

@ -2,7 +2,7 @@
.\" nroff -man [file] .\" nroff -man [file]
.\" $Id$ .\" $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 .SH NAME
curl_slist_append - add a string to an slist curl_slist_append - add a string to an slist
.SH SYNOPSIS .SH SYNOPSIS
@ -13,17 +13,26 @@ curl_slist_append - add a string to an slist
.ad .ad
.SH DESCRIPTION .SH DESCRIPTION
curl_slist_append() appends a specified string to a linked list of curl_slist_append() appends a specified string to a linked list of
strings. The existing strings. The existing \fIlist\fP should be passed as the first argument while
.I list the new list is returned from this function. The specified \fIstring\fP has
should be passed as the first argument while the new list is returned from been appended when this function returns.
this function. The specified
.I string The list should be freed again (after usage) with \fBcurl_slist_free_all()\fP.
has been appended when this function returns.
.SH RETURN VALUE .SH RETURN VALUE
A null pointer is returned if anything went wrong, otherwise the new list A null pointer is returned if anything went wrong, otherwise the new list
pointer is returned. 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" .SH "SEE ALSO"
.BR curl_slist_free_all "(3), " .BR curl_slist_free_all "(3), "
.SH BUGS .SH BUGS
Surely there are some, you tell me! None.