]> granicus.if.org Git - curl/commitdiff
docs: expanded on some CURLU details
authorDaniel Stenberg <daniel@haxx.se>
Sat, 10 Nov 2018 23:10:56 +0000 (00:10 +0100)
committerDaniel Stenberg <daniel@haxx.se>
Sat, 10 Nov 2018 23:10:56 +0000 (00:10 +0100)
docs/libcurl/opts/CURLOPT_CURLU.3
docs/libcurl/opts/CURLOPT_URL.3

index 5c762c9a1b19df9f3b5270719ea4e6a422fff47e..2ac008b6090ade7a1db627c7242f79f328796bf8 100644 (file)
@@ -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
index 60308cbceea82ad640b9e9bdaa6b7daf372f749c..265c62b74c18ec2eec89de358432b3afa58b31a8 100644 (file)
@@ -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), "