Page 1 of 1

Documentation in httpd-vhosts.conf needs improvement

PostPosted: 31. October 2008 04:40
by acambre
Using http://community.apachefriends.org/f/viewtopic.php?p=128640 as guidance, you need to create a <VirtualHost> directive for localhost if you want to retain access to items under /xampp/htdocs, such as /xampp/htdocs/xampp.

The documentation inside httpd-vhosts.conf does not say this. It should, because this necessity for the special directive may not be apparent to novice or moderate users.

Re: Documentation in httpd-vhosts.conf needs improvement

PostPosted: 31. October 2008 15:43
by glitzi85
When opening the file you can read that you have to read the documentation on the Apache Website. Have a look here:

http://httpd.apache.org/docs/2.2/vhosts/name-based.html

The first grey box (Main host goes away) says exactly what you need to know.

glitzi

Re: Documentation in httpd-vhosts.conf needs improvement

PostPosted: 31. October 2008 17:12
by acambre
glitzi85 wrote:When opening the file you can read that you have to read the documentation on the Apache Website.
The problem is that the comments in the .conf file are misleading. It suggests that all you need to do is uncomment NameVirtualHost and create a VirtualHost based on the two templates provided. In fact, there is more to it.

While you are correct that I could read the manual, that does not justify misleading documentation.

PostPosted: 31. October 2008 17:20
by Wiedmann
While you are correct that I could read the manual, that does not justify misleading documentation.

Wrong place for your remarks. The Apache config files (and inline docu) are original from apache.org. And so you have to talk to the Apache developer.

PostPosted: 31. October 2008 17:33
by acambre
Wiedmann wrote:The Apache config files (and inline docu) are original from apache.org. And so you have to talk to the Apache developer.
Ah, yes, just installed apache and confirmed that. Thanks.

PostPosted: 31. October 2008 17:36
by acambre
Actually, there is a difference. The apache file is not commented out, but the file that comes with xampp is totally commented out. So it adds a layer of implication as per above.