svn commit: r1781930 - in /httpd/httpd/trunk/docs/manual/vhosts: examples.html.en examples.xml

[co...@apache.org]

Author: covener
Date: Mon Feb  6 17:41:49 2017
New Revision: 1781930

URL: http://svn.apache.org/viewvc?rev=1781930&view=rev
Log:
add a note to the vhost examples about context

seems like a steady stream of comments/questions in this area.


Modified:
    httpd/httpd/trunk/docs/manual/vhosts/examples.html.en
    httpd/httpd/trunk/docs/manual/vhosts/examples.xml

Modified: httpd/httpd/trunk/docs/manual/vhosts/examples.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/vhosts/examples.html.en?rev=1781930&r1=1781929&r2=1781930&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/vhosts/examples.html.en (original)
+++ httpd/httpd/trunk/docs/manual/vhosts/examples.html.en Mon Feb  6 17:41:49 2017
@@ -36,6 +36,17 @@
     web sites running on a single server, via <a href="name-based.html">name-based</a> or <a href="ip-based.html">IP-based</a> virtual hosts.
     </p>
 
+    <div class="note"><h3>Context note</h3><p>Virtual hosts must be specified in 
+    global scope.  Third-party distributions of the server may use an
+    alternate initial configuration file or multiple configuration files
+    that all accept directives with global scope.  These distributions may
+    also suggest a convention for specifying virtual hosts in their own individual
+    files included into the global configuration via the
+    <code class="directive"><a href="../mod/core.html#include">Include</a></code> directive. Further details
+    may be provided in a third-party README, such as 
+    /usr/share/doc/apache2/README.Debian.gz on Debian and Ubuntu based 
+    distributions.</p>
+    </div>
 </div>
 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#purename">Running several name-based web
     sites on a single IP address.</a></li>

Modified: httpd/httpd/trunk/docs/manual/vhosts/examples.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/vhosts/examples.xml?rev=1781930&r1=1781929&r2=1781930&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/vhosts/examples.xml (original)
+++ httpd/httpd/trunk/docs/manual/vhosts/examples.xml Mon Feb  6 17:41:49 2017
@@ -33,6 +33,17 @@
     href="ip-based.html">IP-based</a> virtual hosts.
     </p>
 
+    <note><title>Context note</title><p>Virtual hosts must be specified in 
+    global scope.  Third-party distributions of the server may use an
+    alternate initial configuration file or multiple configuration files
+    that all accept directives with global scope.  These distributions may
+    also suggest a convention for specifying virtual hosts in their own individual
+    files included into the global configuration via the
+    <directive module="core">Include</directive> directive. Further details
+    may be provided in a third-party README, such as 
+    /usr/share/doc/apache2/README.Debian.gz on Debian and Ubuntu based 
+    distributions.</p>
+    </note>
 </summary>
 
   <section id="purename"><title>Running several name-based web