ports/61899: Documentation error in Apache/2.0.48 port: default httpd.conf

[Marloes de Boer]

>Number:         61899
>Category:       ports
>Synopsis:       Documentation error in Apache/2.0.48 port: default httpd.conf
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-ports-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jan 25 10:10:09 PST 2004
>Closed-Date:
>Last-Modified:
>Originator:     Marloes de Boer
>Release:        FreeBSD 5.2-RELEASE
>Organization:
>Environment:
System:	FreeBSD sjalotje.home.liessa.net 5.2-RELEASE FreeBSD 5.2-RELEASE #0: Fri Jan 23 23:37:07 CET 2004     root at sjalotje.home.liessa.net:/usr/obj/usr/src/sys/SJALOTJE  i386
	
>Description:
	In the Apache/2.0.48 port, with recent CVSup, an error appears in the default httpd.conf. I noticed an inconsistency in the section that starts at line 24:

# Configuration and logfile names: If the filenames you specify for many
# of the server's control files begin with "/" (or "drive:/" for Win32), the
# server will use that explicit path.  If the filenames do *not* begin
# with "/", the value of ServerRoot is prepended -- so "/var/log/foo.log"
# with ServerRoot set to "/usr/local" will be interpreted by the
# server as "/usr/local//var/log/foo.log".

Obviously, the example states behaviour that is entirely contradictory to what is said above it. Assuming this was an error Apache itself i searched their CVS for this particular file, and found the following: 

http://cvs.apache.org/viewcvs.cgi/*checkout*/httpd-2.0/docs/conf/httpd-std.conf.in?content-type=text%2Fplain&rev=1.56

# If the filenames do *not* begin
# with "/", the value of ServerRoot is prepended -- so "@rel_logfiledir@/foo.log"
# with ServerRoot set to "@@ServerRoot@@" will be interpreted by the
# server as "@@ServerRoot@@/@rel_logfiledir@/foo.log".

Thus the replacement must have gone wrong. I'm not sure whether this is an error in the Apache-code or in the way portinstalls work.

>How-To-Repeat:
	install the apache2 port
>Fix:



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