From f7fa04d7f38fe5ff90518490280a9724cb9dd704 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Sun, 11 Nov 2018 00:10:56 +0100 Subject: docs: expanded on some CURLU details --- docs/libcurl/opts/CURLOPT_CURLU.3 | 10 +++++++++- docs/libcurl/opts/CURLOPT_URL.3 | 7 +++++-- 2 files changed, 14 insertions(+), 3 deletions(-) (limited to 'docs/libcurl/opts') diff --git a/docs/libcurl/opts/CURLOPT_CURLU.3 b/docs/libcurl/opts/CURLOPT_CURLU.3 index 5c762c9a1..2ac008b60 100644 --- a/docs/libcurl/opts/CURLOPT_CURLU.3 +++ b/docs/libcurl/opts/CURLOPT_CURLU.3 @@ -29,8 +29,16 @@ CURLOPT_CURLU \- set URL with CURLU * CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CURLU, void *pointer); .SH DESCRIPTION Pass in a pointer to the \fIURL\fP to work with. The parameter should be a -CURLU *. Setting \fICURLOPT_CURLU(3)\fP will explicitly override \fICURLOPT_URL(3)\fP. +CURLU *. Setting \fICURLOPT_CURLU(3)\fP will explicitly override +\fICURLOPT_URL(3)\fP. +\fICURLOPT_URL(3)\fP or \fICURLOPT_CURLU(3)\fP \fBmust\fP be set before a +transfer is started. + +libcurl will use this handle and its contents read-only and will not change +its contents. An application can very well update the contents of the URL +handle after a transfer is done and if the same handle is then used in a +subsequest request the updated contents will then be used. .SH DEFAULT The default value of this parameter is NULL. .SH PROTOCOLS diff --git a/docs/libcurl/opts/CURLOPT_URL.3 b/docs/libcurl/opts/CURLOPT_URL.3 index 60308cbce..265c62b74 100644 --- a/docs/libcurl/opts/CURLOPT_URL.3 +++ b/docs/libcurl/opts/CURLOPT_URL.3 @@ -58,7 +58,10 @@ use for this transfer, independent of what libcurl has been compiled to support. That may be useful if you accept the URL from an external source and want to limit the accessibility. -\fICURLOPT_URL(3)\fP is the only option that \fBmust\fP be set before a +The \fICURLOPT_URL(3)\fP string will be ignored if \fICURLOPT_CURLU(3)\fP is +set. + +\fICURLOPT_URL(3)\fP or \fICURLOPT_CURLU(3)\fP \fBmust\fP be set before a transfer is started. The host part of the URL contains the address of the server that you want to @@ -350,4 +353,4 @@ similar is called. .BR CURLOPT_VERBOSE "(3), " CURLOPT_PROTOCOLS "(3), " .BR CURLOPT_FORBID_REUSE "(3), " CURLOPT_FRESH_CONNECT "(3), " .BR curl_easy_perform "(3), " -.BR CURLINFO_REDIRECT_URL "(3), " CURLOPT_PATH_AS_IS "(3), " +.BR CURLINFO_REDIRECT_URL "(3), " CURLOPT_PATH_AS_IS "(3), " CURLOPT_CURLU "(3), " -- cgit v1.2.3