[GNUnet-SVN] [gnurl] 132/153: CURLOPT_ACCEPT_ENCODING.3: list them comma-separated [ci skip]

[gnunet]

This is an automated email from the git hooks/post-receive script.

ng0 pushed a commit to branch master
in repository gnurl.

commit cc67b0a2ee1607bfd2fd280ce7d78e8d68f7114e
Author: Daniel Stenberg <address@hidden>
AuthorDate: Mon Aug 27 11:15:21 2018 +0200

    CURLOPT_ACCEPT_ENCODING.3: list them comma-separated [ci skip]
---
 docs/libcurl/opts/CURLOPT_ACCEPT_ENCODING.3 | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/docs/libcurl/opts/CURLOPT_ACCEPT_ENCODING.3 
b/docs/libcurl/opts/CURLOPT_ACCEPT_ENCODING.3
index 9427a6b1d..abd4734ab 100644
--- a/docs/libcurl/opts/CURLOPT_ACCEPT_ENCODING.3
+++ b/docs/libcurl/opts/CURLOPT_ACCEPT_ENCODING.3
@@ -45,10 +45,14 @@ Alternatively, you can specify exactly the encoding or list 
of encodings you
 want in the response. Four encodings are supported: \fIidentity\fP, meaning
 non-compressed, \fIdeflate\fP which requests the server to compress its
 response using the zlib algorithm, \fIgzip\fP which requests the gzip
-algorithm and (since curl 7.57.0) \fIbr\fP which is brotli.
+algorithm and (since curl 7.57.0) \fIbr\fP which is brotli.  Provide them in
+the string as a comma-separated list of accepted encodings, like:
 
-Set this option to NULL to explicitly disable it, which makes libcurl not send
-an Accept-Encoding: header and not decompress contents automatically.
+  "br, gzip, deflate".
+
+Set \fICURLOPT_ACCEPT_ENCODING(3)\fP to NULL to explicitly disable it, which
+makes libcurl not send an Accept-Encoding: header and not decompress received
+contents automatically.
 
 You can also opt to just include the Accept-Encoding: header in your request
 with \fICURLOPT_HTTPHEADER(3)\fP but then there will be no automatic
@@ -88,6 +92,10 @@ if(curl) {
 .fi
 .SH AVAILABILITY
 This option was called CURLOPT_ENCODING before 7.21.6
+
+The specific libcurl you're using must have been built with zlib to be able to
+decompress gzip and deflate responses and with the brotli library to
+decompress brotli responses.
 .SH RETURN VALUE
 Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
 CURLE_OUT_OF_MEMORY if there was insufficient heap space.

-- 
To stop receiving notification emails like this one, please contact
address@hidden