From 8d67a47d6c8b32f6c3087dafad802e3fc57d55e1 Mon Sep 17 00:00:00 2001
From: Jean-Frederic Clere <jfclere@apache.org>
Date: Mon, 2 Oct 2017 09:18:50 +0000
Subject: [PATCH] Add a warning for host starting with a letter. Fix for PR
 61540.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1810316 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_proxy.html.en | 8 ++++++++
 docs/manual/mod/mod_proxy.xml     | 9 +++++++++
 2 files changed, 17 insertions(+)

diff --git a/docs/manual/mod/mod_proxy.html.en b/docs/manual/mod/mod_proxy.html.en
index f7f790ba27..2177d6a3f7 100644
--- a/docs/manual/mod/mod_proxy.html.en
+++ b/docs/manual/mod/mod_proxy.html.en
@@ -319,6 +319,14 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10</pre>
 
       </div> 
 
+      <div class="warning"><h3>Host part in the URL</h3>
+        <p>The host part needs to start with a letter [a-z]. For example:</p>
+        <pre class="prettyprint lang-config">ProxyPass "/apps"     "http://127"</pre>
+
+        <p>is not valid and will cause an error while processing a request that
+        maps the path.</p>
+      </div>
+
       <p>Explicitly configured workers come in two flavors:
       <dfn>direct workers</dfn> and <dfn>(load) balancer workers</dfn>.
       They support many important configuration attributes which are
diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index 7e440e31a5..9790165cb5 100644
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -281,6 +281,15 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
 
       </note> <!-- /worker_sharing -->
 
+      <note type="warning"><title>Host part in the URL</title>
+        <p>The host part needs to start with a letter [a-z]. For example:</p>
+        <highlight language="config">
+ProxyPass "/apps"     "http://127"
+        </highlight>
+        <p>is not valid and will cause an error while processing a request that
+        maps the path.</p>
+      </note>
+
       <p>Explicitly configured workers come in two flavors:
       <dfn>direct workers</dfn> and <dfn>(load) balancer workers</dfn>.
       They support many important configuration attributes which are
-- 
2.50.1