From a83b5d1b675442d384b46a8fb8404e46c9e5f449 Mon Sep 17 00:00:00 2001 From: Dan Fandrich Date: Mon, 15 Oct 2007 21:19:40 +0000 Subject: [PATCH] Mention first version with CURLOPT_COPYPOSTFIELDS. Don't confuse NUL with NULL. --- ares/ares_expand_string.3 | 2 +- docs/libcurl/curl_easy_setopt.3 | 5 +++-- docs/libcurl/curl_formadd.3 | 6 +++--- 3 files changed, 7 insertions(+), 6 deletions(-) diff --git a/ares/ares_expand_string.3 b/ares/ares_expand_string.3 index 6f501885e..872e677f7 100644 --- a/ares/ares_expand_string.3 +++ b/ares/ares_expand_string.3 @@ -28,7 +28,7 @@ ares_expand_string \- Expand a length encoded string .SH DESCRIPTION The .B ares_expand_string -function converts a length encoded string to a NULL terminated C +function converts a length encoded string to a NUL-terminated C string. The argument .I encoded gives the beginning of the encoded string, and the arguments diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index b5a0b270e..8bdcf2172 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -727,18 +727,19 @@ data to figure out the size. This is the large file version of the \fICURLOPT_POSTFIELDSIZE\fP option. (Added in 7.11.1) .IP CURLOPT_COPYPOSTFIELDS Pass a char * as parameter, which should be the full data to post in an HTTP -POST operation. It behaves has the \fICURLOPT_POSTFIELDS\fP option, but the +POST operation. It behaves as the \fICURLOPT_POSTFIELDS\fP option, but the original data are copied by the library, allowing the application to overwrite the original data after setting this option. Because data are copied, care must be taken when using this option in conjunction with \fICURLOPT_POSTFIELDSIZE\fP or \fICURLOPT_POSTFIELDSIZE_LARGE\fP: If the size has not been set prior to -\fICURLOPT_COPYPOSTFIELDS\fP, the data are assumed to be a null-terminated +\fICURLOPT_COPYPOSTFIELDS\fP, the data are assumed to be a NUL-terminated string; else the stored size informs the library about the data byte count to copy. In any case, the size must not be changed after \fICURLOPT_COPYPOSTFIELDS\fP, unless another \fICURLOPT_POSTFIELDS\fP or \fICURLOPT_COPYPOSTFIELDS\fP option is issued. +(Added in 7.17.1) .IP CURLOPT_HTTPPOST Tells libcurl you want a multipart/formdata HTTP POST to be made and you diff --git a/docs/libcurl/curl_formadd.3 b/docs/libcurl/curl_formadd.3 index a94dd506f..8508dd411 100644 --- a/docs/libcurl/curl_formadd.3 +++ b/docs/libcurl/curl_formadd.3 @@ -44,7 +44,7 @@ parts. .IP CURLFORM_COPYNAME followed by a string which provides the \fIname\fP of this part. libcurl copies the string so your application doesn't need to keep it around after -this function call. If the name isn't null terminated, or if you'd +this function call. If the name isn't NUL-terminated, or if you'd like it to contain zero bytes, you must set its length with \fBCURLFORM_NAMELENGTH\fP. The copied data will be freed by \fIcurl_formfree(3)\fP. @@ -53,7 +53,7 @@ like it to contain zero bytes, you must set its length with followed by a string which provides the \fIname\fP of this part. libcurl will use the pointer and refer to the data in your application, so you must make sure it remains until curl no longer needs it. If the name -isn't null terminated, or if you'd like it to contain zero +isn't NUL-terminated, or if you'd like it to contain zero bytes, you must set its length with \fBCURLFORM_NAMELENGTH\fP. .IP CURLFORM_COPYCONTENTS @@ -68,7 +68,7 @@ data will be freed by \fIcurl_formfree(3)\fP. followed by a pointer to the contents of this part, the actual data to send away. libcurl will use the pointer and refer to the data in your application, so you must make sure it remains until curl no longer needs it. -If the data isn't null terminated, or if you'd like it to contain zero bytes, +If the data isn't NUL-terminated, or if you'd like it to contain zero bytes, you must set its length with \fBCURLFORM_CONTENTSLENGTH\fP. .IP CURLFORM_CONTENTSLENGTH