Bug 108762

Summary:	webalizer ebuild documentation is misleading and incorrect
Product:	Gentoo Linux	Reporter:	Lindsay Haisley <fmouse-gentoo>
Component:	Current packages	Assignee:	Gentoo Linux bug wranglers <bug-wranglers>
Status:	RESOLVED DUPLICATE
Severity:	trivial
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description Lindsay Haisley 2005-10-10 12:19:54 UTC

This ought get some attention at some point.  The ebuild for webalizer
2.01.10-r4 says:

Package: webalizer-2.01.10-r4
 * to update your apache.conf just type
 * echo "Include  conf/addon-modules/webalizer.conf"            >>
/etc/apache/conf/apache.conf
 * 
 * Just type webalizer to generate your stats.
 * You can also use cron to generate them e.g. every day.
 * They can be accessed via http://localhost/webalizer
 * 

... and a file called 'webalizer.conf' is placed in the /etc/apache2/conf.

There are _several_ things wrong with this.

1.  The file 'webalizer.conf' is not a valid apache config file, even though it
uses a similar syntactical structure.  It's actually a copy of the
/etc/webalizer.conf file, which is read by webalizer, not apache.  Including it
in the apache configuration file set will prevent apache from starting.

2.  Even were this a proper apache config file, apache (at least version 2) in
gentoo doesn't use (or no longer uses) /etc/apache/conf/addon-modules for apache
configuration modules.  It uses /etc/apache2/modules.d, and this directory, and
everything in it, is already included in the default apache configuration file,
so there's no need to use echo to append an Include command.

3.  The apache config file is called "httpd.conf" in gentoo, in out-of-the-box
apache, and in every other distribution of Linux that I know of.  Maybe this is
a BSD-ism.

4.  The default install of webalizer won't run and generate stats if you "Just
type webalizer ..." without further attention to configuration and invocation
details.

5.  The URL "http://localhost/webalizer" won't work unless other directions are
followd so that this directory is specifically set up to contain the apropriate
stats files using the usual server administrative procedures.

The ebuild instructions (and the webzlizer.conf file in the apache config tree)
should probably be scrapped altogether in favor simply suggesting that we read
the man page.

Comment 1 Jakub Moc (RETIRED) gentoo-dev

2005-10-10 13:37:37 UTC


*** This bug has been marked as a duplicate of 106621 ***