svn commit: r1735701 - /httpd/httpd/trunk/docs/manual/howto/http2.xml

[el...@apache.org]

Author: elukey
Date: Fri Mar 18 23:01:47 2016
New Revision: 1735701

URL: http://svn.apache.org/viewvc?rev=1735701&view=rev
Log:
Added notes to the HTTP/2 howto

Modified:
    httpd/httpd/trunk/docs/manual/howto/http2.xml

Modified: httpd/httpd/trunk/docs/manual/howto/http2.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/howto/http2.xml?rev=1735701&r1=1735700&r2=1735701&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/howto/http2.xml (original)
+++ httpd/httpd/trunk/docs/manual/howto/http2.xml Fri Mar 18 23:01:47 2016
@@ -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">