From bdavis@house.so14k.com  Fri Jul 23 11:43:51 2004
Return-Path: <bdavis@house.so14k.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id C971316A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 23 Jul 2004 11:43:51 +0000 (GMT)
Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9BEC243D1D
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 23 Jul 2004 11:43:51 +0000 (GMT)
	(envelope-from bdavis@house.so14k.com)
Received: from localhost (localhost [127.0.0.1])
	by valentine.liquidneon.com (Postfix) with ESMTP id 0EBA5FD
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 23 Jul 2004 05:43:50 -0600 (MDT)
Received: from valentine.liquidneon.com ([216.38.206.180])
 by localhost (valentine.liquidneon.com [127.0.0.1]) (amavisd-new, port 10024)
 with ESMTP id 21540-09 for <FreeBSD-gnats-submit@freebsd.org>;
 Fri, 23 Jul 2004 05:43:49 -0600 (MDT)
Received: from mccaffrey.house.so14k.com (c-24-8-51-173.client.comcast.net [24.8.51.173])
	by valentine.liquidneon.com (Postfix) with ESMTP id 992E14F
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 23 Jul 2004 05:43:49 -0600 (MDT)
Received: by mccaffrey.house.so14k.com (Postfix, from userid 1001)
	id 49389A89; Fri, 23 Jul 2004 05:43:49 -0600 (MDT)
Message-Id: <20040723114349.49389A89@mccaffrey.house.so14k.com>
Date: Fri, 23 Jul 2004 05:43:49 -0600 (MDT)
From: Brad Davis <so14k@so14k.com>
Reply-To: Brad Davis <so14k@so14k.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Add bit about Apache VirtualHosts
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         69478
>Category:       docs
>Synopsis:       Add bit about Apache VirtualHosts
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 23 11:50:26 GMT 2004
>Closed-Date:    Mon Aug 02 05:18:16 GMT 2004
>Last-Modified:  Mon Aug  2 05:20:21 GMT 2004
>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@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>&lt;VirtualHost *&gt;
+ServerName www.domain.tld
+DocumentRoot /www/domain.tld
+&lt;VirtualHost&gt;
+
+&lt;VirtualHost *&gt;
+ServerName www.someotherdomain.tld
+DocumentRoot /www/someotherdomain.tld
+&lt;/VirtualHost&gt;</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:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Mon Aug 2 05:17:55 GMT 2004 
State-Changed-Why:  
Committed, thanks.  It may take up to 24 hours for this to appear on 
the website. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=69478 

From: Murray Stokely <murray@FreeBSD.org>
To: Brad Davis <so14k@so14k.com>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/69478: Add bit about Apache VirtualHosts
Date: Mon, 2 Aug 2004 05:17:51 +0000

 On Fri, Jul 23, 2004 at 05:43:49AM -0600, Brad Davis wrote:
 > +
 > +      <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>
 > +
 
 
 Please wrap the paragraph next time.  It makes it easier to review.
 
 
 > +      <para>To setup Apache to use Name-based Virtual Hosting add an entry like the following
 
 I added <application> tags around Apache in this section.
 
 > +      <para>If you had the domains www.domain.tld and www.someotherdomain.tld you would add
 > +        entries that look like the following:</para>
 
 This seems to be taken from the example in httpd.conf, which is fine,
 but please mention the sources when you submit things like this.  Also
 these domains should be wrapped in <hostid> tags.  I reworded this
 slightly.
 
 > +      <para>For more info consult the official Apache documentation at:
 > +        <ulink url="http://httpd.apache.org/docs/vhosts/name-based.html"></ulink></para>
 
 
 We should use 'information' here and not informal half-words like
 'info'.  Also I updated the URL to vhosts/ rather than just the
 name-based.html file.  We also want to tell the user about the other
 type of virtual hosting (ip based), that you mention in the
 introduction of this section but then only explain name based.
 
 With these chagnes, I have committed this to CVS.  Thanks!
 
      - Murray
>Unformatted:
