From: Eric Covener <covener@apache.org>
Date: Fri, 29 Aug 2025 12:17:01 +0000 (+0000)
Subject: Merge r1928078 from trunk:
X-Git-Tag: 2.4.66-rc1-candidate~46
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=56521a0ce70f235cb2c4236ffc8d86362f7d618f;p=thirdparty%2Fapache%2Fhttpd.git

Merge r1928078 from trunk:

reorder, tweak wording

help emphasize the moral of PR69698, that continued lines
win out over comments.




git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1928080 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/configuring.xml b/docs/manual/configuring.xml
index c301a6b00a..8d3acb1791 100644
--- a/docs/manual/configuring.xml
+++ b/docs/manual/configuring.xml
@@ -66,19 +66,24 @@ Server.</p>
     <p>httpd configuration files contain one directive per line.
     The backslash "\" may be used as the last character on a line
     to indicate that the directive continues onto the next line.
-    There must be no other characters or white space between the
-    backslash and the end of the line.</p>
+    To be interpreted as such a continuation, there must be no
+    other characters or white space between the backslash and the
+    end of the line. </p>
 
-    <p>Arguments to directives are separated by whitespace. If an 
+    <p>Lines that begin with the hash character "#" are considered
+    comments, and are ignored. Comments may <strong>not</strong> be
+    included on the same line as a configuration directive, including
+    at the start of a line that has been continued as described in the
+    preceding pargraph.
+    </p>
+
+    <p> White space occurring before a directive is ignored, so
+    you may indent directives for clarity. Blank lines are also ignored.
+    Arguments to directives are separated by whitespace. If an
     argument contains spaces, you must enclose that argument in quotes.</p>
 
     <p>Directives in the configuration files are case-insensitive,
-    but arguments to directives are often case sensitive. Lines
-    that begin with the hash character "#" are considered
-    comments, and are ignored. Comments may <strong>not</strong> be
-    included on the same line as a configuration directive. 
-    White space occurring before a directive is ignored, so
-    you may indent directives for clarity. Blank lines are also ignored.</p>
+    but arguments to directives are often case sensitive. </p>
 
     <p>The values of variables defined with the <directive
     module="core">Define</directive> of or shell environment variables can