[master] 71771dc5d doc: polish varnishncsa documentation on header logging

Nils Goroll nils.goroll at uplex.de
Wed Mar 12 16:59:06 UTC 2025


commit 71771dc5d8fd7628d6f641cb83ae167f7a04fef0
Author: Nils Goroll <nils.goroll at uplex.de>
Date:   Wed Mar 12 17:08:58 2025 +0100

    doc: polish varnishncsa documentation on header logging
    
    Ref 30bfe667ad7d1ca990d55a0849d8f7c35be7c31d
    Ref #3528

diff --git a/doc/sphinx/reference/varnishncsa.rst b/doc/sphinx/reference/varnishncsa.rst
index 82bd4a4cf..435072e8f 100644
--- a/doc/sphinx/reference/varnishncsa.rst
+++ b/doc/sphinx/reference/varnishncsa.rst
@@ -239,22 +239,22 @@ SIGNALS
 NOTES
 =====
 
-The %r formatter is equivalent to ``%m http://%{Host}i%U%q %H``. This
-differs from apache's %r behavior, equivalent to "%m %U%q %H".
-
-Note that request fields are collected on a first match basis in client mode
-and last match basis in backend mode. Similarly, response fields are collected
-on a first match basis in backend mode and last match basis in client mode.
-
-In other words, this means that requests are represented as they were received
-from the client and as they were sent to the backend, while responses are
-represented as they were sent to the client and as they were received from
-the backend.
-
-Furthermore, these rules also apply for items that appear multiple times in a
-transaction. For exampe, if a header appears multiple times in a client request,
-the first occurence would be shown in client mode, while the last one would be
-used in backend mode.
+The ``%r`` formatter is equivalent to ``%m http://%{Host}i%U%q %H``. This
+differs from the Apache HTTP Server ``%r`` behavior, equivalent to ``%m %U%q
+%H``.
+
+Note that request fields are collected on a first match basis in client mode and
+last match basis in backend mode. Similarly, response fields are collected on a
+first match basis in backend mode and last match basis in client mode.
+
+In other words, request headers are logged as they were received from the client
+and as they were sent to the backend, while response headers are logged as they
+were sent to the client and as they were received from the backend.
+
+Furthermore, these rules also apply to items that appear multiple times in a
+transaction. For example, if a header appears multiple times in a client
+request, the first occurrence is logged in client mode, while in backend mode
+the last occurrence is logged.
 
 EXAMPLE
 =======


More information about the varnish-commit mailing list