From f395810e47f8bee0922b380e1b06512a9137b523 Mon Sep 17 00:00:00 2001
From: Luca Toscano <elukey@apache.org>
Date: Fri, 18 Mar 2016 23:01:47 +0000
Subject: [PATCH] Added notes to the HTTP/2 howto

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1735701 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/howto/http2.xml | 26 +++++++++++++++++++-------
 1 file changed, 19 insertions(+), 7 deletions(-)

diff --git a/docs/manual/howto/http2.xml b/docs/manual/howto/http2.xml
index bd1d38d013..e6c5500129 100644
--- a/docs/manual/howto/http2.xml
+++ b/docs/manual/howto/http2.xml
@@ -168,13 +168,25 @@ ProtocolsHonorOrder Off
 
   <section id="tools">
     <title>Useful tools to debug HTTP/2</title>
-    <p><a href="https://curl.haxx.se">curl</a>.</p>
-    <p>And for really deep inspection <a href="https://www.wireshark.org">wireshark</a>.</p>
-    <p>The <a href="https://nghttp2.org">nghttp2</a> package also includes clients, such as
-    <code>nghttp</code> and <code>h2load</code>, the latter one being very useful in putting
-    some stress on your server.</p>
-    <p>Chrome offers also detailed HTTP/2 logs on its connections via the 
-    <a href="chrome://net-internals/#http2">special net-internals page</a>.</p>
+    <p>The first tool to mention is of course <a href="https://curl.haxx.se">curl</a>. Please make sure that
+    your version supports HTTP/2 checking its <code>Features</code>:</p>
+    <highlight language="config">
+    $ curl -V
+    curl 7.45.0 (x86_64-apple-darwin15.0.0) libcurl/7.45.0 OpenSSL/1.0.2d zlib/1.2.8 nghttp2/1.3.4
+    Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 [...] 
+    Features: IPv6 Largefile NTLM NTLM_WB SSL libz TLS-SRP <strong>HTTP2</strong>
+    </highlight>
+    <note><title>Mac OS homebrew notes</title>
+    brew install curl --with-openssl --with-nghttp2 
+    </note>
+    <p>And for really deep inspection <a href="https://wiki.wireshark.org/HTTP2">wireshark</a>.</p>
+    <p>The <a href="https://nghttp2.org">nghttp2</a> package also includes clients, such as:</p>
+    <ul>
+        <li><a href="https://nghttp2.org/documentation/nghttp.1.html">nghttp</a> - useful to visualize the HTTP/2 frames and get a better idea of the protocol.</li>
+        <li><a href="https://nghttp2.org/documentation/h2load-howto.html">h2load</a> - useful to stress-test your server.</li>
+    </ul>
+    <p>Chrome offers detailed HTTP/2 logs on its connections via the 
+    <a href="chrome://net-internals/#http2">special net-internals page</a>. There is also an interesting extension for <a href="https://chrome.google.com/webstore/detail/http2-and-spdy-indicator/mpbpobfflnpcgagjijhmgnchggcjblin?hl=en">Chrome</a> and <a href="https://addons.mozilla.org/en-us/firefox/addon/spdy-indicator/">Firefox</a> to visualize when your browser is using HTTP/2.</p>
   </section>
 
   <section id="push">
-- 
2.50.1