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

-------------------------------------------------------------------
List admin: https://cool.haxx.se/list/listinfo/curl-library
Etiquette: https://curl.haxx.se/mail/etiquette.html