documentation/2852: Docu of Name Virtual Hosts is unclear

[Tomas Pospisek <tp...@spin.ch>]

>Number:         2852
>Category:       documentation
>Synopsis:       Docu of Name Virtual Hosts is unclear
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    apache
>State:          open
>Class:          doc-bug
>Submitter-Id:   apache
>Arrival-Date:   Fri Aug 14 08:10:01 PDT 1998
>Last-Modified:
>Originator:     tpo@spin.ch
>Organization:
apache
>Release:        1.3.0
>Environment:
Linux fetty 2.0.32 #3 Tue Dec 9 16:51:43 CET 1997 i686 unknown
Debian 2.0
>Description:
I have not been successfull in getting a Name Virtual Server configuration
using

<VirtualHost host.name>

to work. I got a huge variety of the most bizzare and incomprehensible effects
though. And I actually don't even know whether it is possible to implement it
that way sincee the docu is not explicit about it. I have finally only
succeeded after changing to

<VirtualHost IP.IP.IP.IP>

I'm sure you understand that it can be useful to >not< explicitly state the IP
number in the VirtualHost directive - it'd make at least my life easier.

Nevertheless, >if< it is >not< possible to have Name Virtual Hosts with the
VirtualHost directive using host names then please, please, please, please
say so in the docu. It would have spared me a week (!) of trying, reading
the docu, FAQs, HOWTO's, asking ppl etc.

I am willing to update the docu and submit it for control to spare you the work
and spare others the hassles when updating. I'm refering to the following pieces
of docu which are not exact enough:

http://www.apache.org/docs/misc/FAQ.html#namevhost
http://www.apache.org/docs/mod/core.html#virtualhost
http://www.apache.org/docs/vhosts/name-based.html

Please make it clearer or let me do it.
*
t
>How-To-Repeat:
Should be clear from the Description
>Fix:
Yes, provide clearer documentation.
>Audit-Trail:
>Unformatted:
[In order for any reply to be added to the PR database, ]
[you need to include <ap...@Apache.Org> in the Cc line ]
[and leave the subject line UNCHANGED.  This is not done]
[automatically because of the potential for mail loops. ]
[If you do not include this Cc, your reply may be ig-   ]
[nored unless you are responding to an explicit request ]
[from a developer.                                      ]
[Reply only with text; DO NOT SEND ATTACHMENTS!         ]