aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/curl_easy_setopt.35
-rw-r--r--docs/curl_formparse.320
-rw-r--r--docs/libcurl.54
3 files changed, 18 insertions, 11 deletions
diff --git a/docs/curl_easy_setopt.3 b/docs/curl_easy_setopt.3
index 67d3e595b..58b542237 100644
--- a/docs/curl_easy_setopt.3
+++ b/docs/curl_easy_setopt.3
@@ -2,7 +2,7 @@
.\" nroff -man [file]
.\" Written by daniel@haxx.se
.\"
-.TH curl_easy_setopt 3 "8 May 2001" "libcurl 7.7.3" "libcurl Manual"
+.TH curl_easy_setopt 3 "21 May 2001" "libcurl 7.7.4" "libcurl Manual"
.SH NAME
curl_easy_setopt - Set curl easy-session options
.SH SYNOPSIS
@@ -276,7 +276,8 @@ of HTTP post structs as parameter. The linked list should be a fully valid
list of 'struct HttpPost' structs properly filled in. The best and most
elegant way to do this, is to use
.I curl_formparse(3)
-as documented.
+as documented. The data in this list must remained intact until you close this
+curl handle again with curl_easy_cleanup().
.TP
.B CURLOPT_SSLCERT
Pass a pointer to a zero terminated string as parameter. The string should be
diff --git a/docs/curl_formparse.3 b/docs/curl_formparse.3
index 1f524ac08..8360c4371 100644
--- a/docs/curl_formparse.3
+++ b/docs/curl_formparse.3
@@ -2,7 +2,7 @@
.\" nroff -man [file]
.\" Written by daniel@haxx.se
.\"
-.TH curl_formparse 3 "3 May 2001" "libcurl 7.7.2" "libcurl Manual"
+.TH curl_formparse 3 "21 May 2001" "libcurl 7.7.4" "libcurl Manual"
.SH NAME
curl_formparse - add a section to a multipart/formdata HTTP POST
.SH SYNOPSIS
@@ -15,16 +15,21 @@ curl_formparse - add a section to a multipart/formdata HTTP POST
curl_formparse() is used to append sections when building a multipart/formdata
HTTP POST (sometimes refered to as rfc1867-style posts). Append one section at
a time until you've added all the sections you want included and then you pass
-the \fI firstitem\fP pointer as parameter to \fBCURLOPT_HTTPPOST\fP.
+the \fIfirstitem\fP pointer as parameter to \fBCURLOPT_HTTPPOST\fP.
\fIlastitem\fP is set after each call and on repeated invokes it should be
left as set to allow repeated invokes to find the end of the list in a faster
way. \fIstring\fP must be a zero terminated string abiding to the syntax
described in a section below
-The pointers \fIfirstitem\fP and \fIlastitem\fP point to, should both be
-pointers to NULL in the first call to this function. All list-data will be
-allocated by the function itself. You must call \fIcurl_formfree\fP after the
-form post has been done to free the resources again.
+The pointers \fI*firstitem\fP and \fI*lastitem\fP should both be pointing to
+NULL in the first call to this function. All list-data will be allocated by
+the function itself. You must call \fIcurl_formfree\fP after the form post has
+been done to free the resources again.
+
+This function will copy all input data and keep its own version of it
+allocated until you call \fIcurl_formfree\fP. When you've passed the pointer
+to \fIcurl_easy_setopt\fP, you must not free the list until after you've
+called \fIcurl_easy_cleanup\fP for the curl handle.
See example below.
.SH "FORM PARSE STRINGS"
@@ -73,7 +78,8 @@ Returns non-zero if an error occurs.
curl_easy_setopt(curl, CURLOPT_HTTPPOST, post);
.SH "SEE ALSO"
-.BR curl_easy_setopt "(3) "
+.BR curl_easy_setopt "(3), "
+.BR curl_formfree "(3)
.SH BUGS
Surely there are some, you tell me!
diff --git a/docs/libcurl.5 b/docs/libcurl.5
index eb1841710..1fe0b1114 100644
--- a/docs/libcurl.5
+++ b/docs/libcurl.5
@@ -2,7 +2,7 @@
.\" nroff -man [file]
.\" Written by Daniel Stenberg
.\"
-.TH libcurl 5 "23 April 2001" "libcurl 7.7.2" "libcurl overview"
+.TH libcurl 5 "15 May 2001" "libcurl 7.7.3" "libcurl overview"
.SH NAME
libcurl \- client-side URL transfers
.SH DESCRIPTION
@@ -68,7 +68,7 @@ frees a whole curl_slist
.B curl_mprintf()
portable printf() functions
.TP
-.B curl_streual()
+.B curl_strequal()
portable case insensitive string comparisons
.RE