docs/69478: Add bit about Apache VirtualHosts

[Brad Davis]

>Number:         69478
>Category:       docs
>Synopsis:       Add bit about Apache VirtualHosts
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 23 11:50:26 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Brad Davis
>Release:        FreeBSD 4.10-STABLE i386
>Organization:
>Environment:
System: FreeBSD mccaffrey.house.so14k.com 4.10-STABLE FreeBSD 4.10-STABLE #0: Fri May 28 08:02:41 MDT 2004 root at mccaffrey.house.so14k.com:/usr/obj/usr/src/sys/MCCAFFREY i386
>Description:
	Add bit about VirtualHosts to the Apache section
>How-To-Repeat:
>Fix:

--- doc-ori/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml Fri Jul 23 01:22:03 2004
+++ doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml     Fri Jul 23 05:40:43 2004
@@ -4161,6 +4161,40 @@
     </sect2>

     <sect2>
+      <title>Virtual Hosting</title>
+
+      <para>Apache supports two different types of Virtual Hosting. The first method is
+        Name-based Virtual Hosting. Name-based virtual hosting uses the clients HTTP/1.1
+        headers to figure out the hostname. This allows many different domains to share
+        the same IP address.</para>
+
+      <para>To setup Apache to use Name-based Virtual Hosting add an entry like the following
+        to your <filename>httpd.conf</filename>.</para>
+
+      <programlisting>NameVirtualHost *</programlisting>
+
+      <para>If you had the domains www.domain.tld and www.someotherdomain.tld you would add
+        entries that look like the following:</para>
+
+      <screen><VirtualHost *>
+ServerName www.domain.tld
+DocumentRoot /www/domain.tld
+<VirtualHost>
+
+<VirtualHost *>
+ServerName www.someotherdomain.tld
+DocumentRoot /www/someotherdomain.tld
+</VirtualHost></screen>
+
+      <para>Replace the addresses with the addresses you want to use and the path to the
+        documents with what you are using.</para>
+
+      <para>For more info consult the official Apache documentation at:
+        <ulink url="http://httpd.apache.org/docs/vhosts/name-based.html"></ulink></para>
+
+    </sect2>
+
+    <sect2>
       <title>Apache Modules</title>

       <indexterm><primary>Apache</primary>

>Release-Note:
>Audit-Trail:
>Unformatted: