Add some more cross-references related to the protocol

argument for Listen and AcceptFilter, as suggested by
Otmar Lendl.  PR45286

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1031215 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/bind.xml b/docs/manual/bind.xml
index f269618ae2cc3ff5c70dcc90620a870c059bcbb0..40c26fb5d2bd8f8d77f79eaa5af0c300001d3a00 100644 (file)
--- a/docs/manual/bind.xml
+++ b/docs/manual/bind.xml
@@ -148,6 +148,25 @@
     default on FreeBSD, NetBSD, and OpenBSD.</p>
   </section>
 
+  <section id="protocol">
+    <title>Specifying the protocol with Listen</title>
+    <p>The optional second <var>protocol</var> argument of
+       <directive module="mpm_common">Listen</directive>
+       is not required for most 
+       configurations. If not specified, <code>https</code> is the default for 
+       port 443 and <code>http</code> the default for all other ports.  The 
+       protocol is used to determine which module should handle a request, and
+       to apply protocol specific optimizations with the 
+       <directive module="core">AcceptFilter</directive> directive.</p>
+
+    <p>You only need to set the protocol if you are running on non-standard 
+       ports.  For example, running an <code>https</code> site on port 8443:</p>
+
+    <example>
+      Listen 192.170.2.1:8443 https
+    </example>
+  </section>
+
   <section id="virtualhost">
     <title>How This Works With Virtual Hosts</title>
 

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index c56af0e18cd3f9d59665e9771a7fe021151a0d4c..282f2e29a15ec1e666abf4762d1a79a48016ddb3 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -50,6 +50,12 @@ On Windows from Apache httpd 2.3.3 and later.</compatibility>
        send data first, such as <code>ftp:</code> or <code>nntp</code>:</p>
     <example>AcceptFilter nntp none</example>
 
+    <p>The default protocol names are <code>https</code> for port 443
+       and <code>http</code> for all other ports.  To specify another protocol
+       is being used with a listening port, add the <var>protocol</var>
+       argument to the <directive module="mpm_common">Listen</directive>
+       directive.</p>
+
     <p>The default values on FreeBSD are:</p>
     <example>
         AcceptFilter http httpready <br/>