Amend #2619

doc/h2load.h2r

@@ -16,11 +16,13 @@ requests
   succeeded
     Requests resulting in an HTTP 2xx or 3xx status code.
   failed
-    Requests that resulted in an HTTP-level failure (non-2xx/3xx
-    status codes).
+    The total number of failed requests.  This includes both
+    ``errored`` requests and requests that completed with a
+    non-2xx/3xx status code.
   errored
-    Requests that failed due to network-level issues (e.g., TCP
-    resets, ``RST_STREAM``) rather than HTTP status codes.
+    A subset of ``failed`` where the requests failed due to
+    network-level issues (e.g., TCP resets, ``RST_STREAM``) rather
+    than HTTP status codes.
   timeout
     A subset of ``errored`` where the connection timed out before
     completion.
@@ -34,7 +36,8 @@ TRAFFIC METRICS
 
 traffic
   total
-    Total decrypted bytes received "on the wire."
+    Total application data bytes received "on the wire" (decrypted if
+    using TLS).
   headers
     Total bytes used for response headers (pre-decompression).
 
@@ -42,6 +45,9 @@ traffic
       Header compression efficiency, calculated as:
 
       (1 - headers / decompressed_headers) * 100
+
+      where ``headers`` is the compressed size and
+      ``decompressed_headers`` is the size after decompression.
   data
     Total bytes received in response bodies.
 
@@ -56,8 +62,8 @@ Metric Definitions
     The time taken to establish a connection, including TLS
     handshakes.
   time to 1st byte
-    The duration until the first byte of decrypted application data is
-    received from the server.
+    The duration until the first byte of application data is received
+    from the server (decrypted if using TLS).
   req/s
     The requests per second measured individually across all clients.
   min RTT