On Friday 01 July 2016 20:39:36 Daniel Stenberg wrote: > On Fri, 1 Jul 2016, Tim Ruehsen wrote: > > Currently, curl uses HTTP2 by default. > > Yes, the command line tool does that for HTTPS URLs. > > > But the man pages says: use --http2 to switch it on. > > Well, not exactly, but I agree that this default is not exactly clear. Any > suggestion on how the best way to document this would be?
I am not sure how should work, but maybe something like this: diff --git a/docs/curl.1 b/docs/curl.1 index c573ff9..2a4bcf1 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -149,10 +149,12 @@ for each. (Added in 7.36.0) preferred: HTTP 1.1. .IP "--http1.1" (HTTP) Tells curl to use HTTP version 1.1. This is the internal default -version. (Added in 7.33.0) +version when built without HTTP2 support. +(Added in 7.33.0) .IP "--http2" (HTTP) Tells curl to issue its requests using HTTP 2. This requires that the -underlying libcurl was built to support it. (Added in 7.33.0) +underlying libcurl was built to support it - in this case this is the internal +default version. (Added in 7.33.0) .IP "--http2-prior-knowledge" (HTTP) Tells curl to issue its non-TLS HTTP requests using HTTP/2 without HTTP/1.1 Upgrade. It requires prior knowledge that the server supports HTTP/2
signature.asc
Description: This is a digitally signed message part.
------------------------------------------------------------------- List admin: https://cool.haxx.se/list/listinfo/curl-library Etiquette: https://curl.haxx.se/mail/etiquette.html