From ac5b6f8082b8b94c79b750ec17bd4a318fa04683 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg <daniel@haxx.se> Date: Sat, 21 Jun 2014 19:46:45 +0200 Subject: [PATCH] curl_easy_setopt.3: CURLOPT_POSTFIELDS is the exception ... to the always-copy-char *-argument. And fix some minor mistakes. --- docs/libcurl/curl_easy_setopt.3 | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index 71b2c8fd0b..a51cc0a85a 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -45,8 +45,10 @@ options back to internal default with \fIcurl_easy_reset(3)\fP. Strings passed to libcurl as 'char *' arguments, are copied by the library; thus the string storage associated to the pointer argument may be overwritten -after curl_easy_setopt() returns. Exceptions to this rule are described in -the option details below. +after curl_easy_setopt() returns. The only exception to this rule is really +\fICURLOPT_POSTFIELDS\fP, but the alternative that copies the string +\fICURLOPT_COPYPOSTFIELDS\fP has some usage characteristics you need to read +up on. Before version 7.17.0, strings were not copied. Instead the user was forced keep them available until libcurl no longer needed them. @@ -272,7 +274,7 @@ Do a HTTP GET request. See \fICURLOPT_HTTPGET(3)\fP .IP CURLOPT_HTTP_VERSION HTTP version to use. \fICURLOPT_HTTP_VERSION(3)\fP .IP CURLOPT_IGNORE_CONTENT_LENGTH -Ignore Content-Length. See \fIURLOPT_IGNORE_CONTENT_LENGTH(3)\fP +Ignore Content-Length. See \fICURLOPT_IGNORE_CONTENT_LENGTH(3)\fP .IP CURLOPT_HTTP_CONTENT_DECODING Disable Content decoding. See \fICURLOPT_HTTP_CONTENT_DECODING(3)\fP .IP CURLOPT_HTTP_TRANSFER_DECODING @@ -333,8 +335,6 @@ RTSP session-id. See \fICURLOPT_RTSP_SESSION_ID(3)\fP RTSP stream URI. See \fICURLOPT_RTSP_STREAM_URI(3)\fP .IP CURLOPT_RTSP_TRANSPORT RTSP Transport: header. See \fICURLOPT_RTSP_TRANSPORT(3)\fP -.IP CURLOPT_RTSP_HEADER -RTSP custom headers. See \fICURLOPT_RTSP_HEADER(3)\fP .IP CURLOPT_RTSP_CLIENT_CSEQ Clent CSEQ number. See \fICURLOPT_RTSP_CLIENT_CSEQ(3)\fP .IP CURLOPT_RTSP_SERVER_CSEQ -- GitLab