curl.h: added CURL_HTTP_VERSION_2_0

Initial library considerations documented in lib/README.http2

diff --git a/include/curl/curl.h b/include/curl/curl.h
index ed536d162e8ba6a5bee5747f9c1ee29f1b18eb06..b790f89cc1bb31d4b98768b21ca61c4ed482968c 100644 (file)
--- a/include/curl/curl.h
+++ b/include/curl/curl.h
@@ -1608,6 +1608,7 @@ enum {
                              for us! */
   CURL_HTTP_VERSION_1_0,  /* please use HTTP 1.0 in the request */
   CURL_HTTP_VERSION_1_1,  /* please use HTTP 1.1 in the request */
+  CURL_HTTP_VERSION_2_0,  /* please use HTTP 2.0 in the request */
 
   CURL_HTTP_VERSION_LAST /* *ILLEGAL* http version */
 };

diff --git a/lib/README.http2 b/lib/README.http2
new file mode 100644 (file)
index 0000000..4d54c0c
--- /dev/null
+++ b/lib/README.http2
@@ -0,0 +1,19 @@
+
+HTTP2 with libcurl
+
+ Spec: http://tools.ietf.org/html/draft-ietf-httpbis-http2-06
+
+ Over an http:// URL
+
+  If CURLOPT_HTTP_VERSION is set to CURL_HTTP_VERSION_2, libcurl will include
+  an upgrade header in the initial request to the host to allow upgrading to
+  http2. Possibly introduce an option that will cause libcurl to fail if not
+  possible to upgrade. Possibly introduce an option that makes libcurl use
+  http2 at once over http://
+
+ Over an https:// URL
+
+  If CURLOPT_HTTP_VERSION is set to CURL_HTTP_VERSION_2, libcurl will use ALPN
+  (or NPN) to negotiate which protocol to continue with. Possibly introduce an
+  option that will cause libcurl to fail if not possible to use http2.
+