added an EXAMPLE section

.\" 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

.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.