Documentation in httpd-vhosts.conf needs improvement

Problems with the Windows version of XAMPP, questions, comments, and anything related.

Documentation in httpd-vhosts.conf needs improvement

Postby acambre » 31. October 2008 04:40

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.
acambre
 
Posts: 5
Joined: 31. October 2008 04:31

Re: Documentation in httpd-vhosts.conf needs improvement

Postby glitzi85 » 31. October 2008 15:43

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
User avatar
glitzi85
 
Posts: 1920
Joined: 05. March 2004 23:26
Location: Dahoim

Re: Documentation in httpd-vhosts.conf needs improvement

Postby acambre » 31. October 2008 17:12

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.
acambre
 
Posts: 5
Joined: 31. October 2008 04:31

Postby Wiedmann » 31. October 2008 17:20

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.
Wiedmann
AF Moderator
 
Posts: 17102
Joined: 01. February 2004 12:38
Location: Stuttgart / Germany

Postby acambre » 31. October 2008 17:33

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.
acambre
 
Posts: 5
Joined: 31. October 2008 04:31

Postby acambre » 31. October 2008 17:36

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.
acambre
 
Posts: 5
Joined: 31. October 2008 04:31


Return to XAMPP for Windows

Who is online

Users browsing this forum: No registered users and 104 guests