[master] 555c3a1 Document %r behaviour

[Federico G. Schwindt]

commit 555c3a1ecec114a3928f5fefc6a4ac57ffde711e
Author: Federico G. Schwindt <fgsch at lodoss.net>
Date:   Tue Sep 27 09:44:56 2016 +0100

    Document %r behaviour
    
    Fixes #2017.

diff --git a/doc/sphinx/reference/varnishncsa.rst b/doc/sphinx/reference/varnishncsa.rst
index 94730a8..55c38a8 100644
--- a/doc/sphinx/reference/varnishncsa.rst
+++ b/doc/sphinx/reference/varnishncsa.rst
@@ -118,7 +118,7 @@ Supported formatters are:
 
 %r
   The first line of the request. Synthesized from other fields, so it
-  may not be the request verbatim.
+  may not be the request verbatim. See the NOTES section.
 
 %s
   Status sent to the client.  In backend mode, status received from
@@ -187,6 +187,12 @@ SIGHUP
 SIGUSR1
   Flush any outstanding transactions
 
+NOTES
+=====
+
+The %r formatter is equivalent to "%m http://%{Host}i%U%q %H". This
+differs from apache's %r behavior. For the latter use "%m %U%q %H".
+
 EXAMPLE
 =======