################################################################################
#                                                                              #
#                             "WEBALIZER Xtended"                              #
#                                                                              #
################################################################################

README

Version: RB-14
Date   : June 12, 2006
Author : Patrick Frei
Copyright (c) 2005-2006 Patrick Frei. All rights reserved.

================================================================================

INDEX
1.   INTRODUCTION                                                                                                                                       
1.1. OVERVIEW OF FEATURES
1.2. NEW CONFIGURATION KEYWORDS
1.3. COMMAND LINE PARAMETERS
2.   SUPPORT
3.   LICENSE

================================================================================

1.   INTRODUCTION
-----------------------------------------------
The following sections attempt to provide a short introduction to using 
Webalizer Xtended.

This document is not meant to be a comprehensive manual on understanding or 
using Webalizer, but should be sufficient to get you running Webalizer with 
some more features (Webalizer Xtended).

For further information see the original README of Webalizer that can be 
obtained here: ftp://ftp.mrunix.net/pub/webalizer/README

For information on building and installing Webalizer Xtended, see the INSTALL
file.

1.1. OVERVIEW OF FEATURES
-----------------------------------------------
The current release supports the following features:

The original features of Webalizer (of course)
+ Additional monthly statistics for all "HTTP 404 Not Found"-errors found in 
  your server log-files. Information: Hits, number of requests, percentage 
  requests and URL's of the "HTTP 404 Not Found"-errors. Configurable in the 
  configuration file. 
+ Automatic sorting and incremental or full logfile processing of the "HTTP 404 
  Not Found"-errors.
+ Separate HTML page that displays all "HTTP 404 Not Found"-errors.
+ All HTTP response codes with additional percentage hits.
+ Grouping enabled for several well known browsers, user-agents and bots.
+ New configuration keywords to control the new Webalizer Xtended features with 
  the configuration file.
+ Bug-fix for truncated user agent strings in the "User Agents" statistics of 
  the original Webalizer 2.01-10 (user agent fields can now be grouped correctly).
+ Bug-fixes for serveral other truncated string problems (e.g. referrers) in the 
  original Webalizer 2.01-10.
+ Security bug-fixes for several buffer overflows in the original Webalizer 2.01-10.

1.2. NEW CONFIGURATION KEYWORDS
-----------------------------------------------
The new features in Webalizer Xtended can be controlled with new configuration 
keywords in your configuration file. These keywords are listed below:

CodeNotFound   CodeNotFound defines the number of entries in the 404 error 
               table. The default value for CodeNotFound is 20. The 404 error 
	       table may be disabled by using zero (0) for the value. Using 
	       one (1) for the value shows all 404 errors in the table.

AllErrors      The AllErrors keyword allows the display of all 404-errors on a 
               separate HTML page. A link will be added to the bottom of the 
	       "Code 404 Monthly Statistics" table if enabled. Value can be 
	       either 'yes' or 'no', with 'yes' being the default.

For furhter information about all other configuration keywords of the original 
Webalizer see the original README of Webalizer that can be obtained here: 
ftp://ftp.mrunix.net/pub/webalizer/README

1.3. COMMAND LINE PARAMETERS
-----------------------------------------------
Webalizer allows certain configuration options to be provided as parameters. 
The most common way to specify a parameter is via the command line. For 
further information see the original README of Webalizer that can be obtained 
here: ftp://ftp.mrunix.net/pub/webalizer/README 

================================================================================

2.  SUPPORT

For general information and support of Webalizer Xtended, please contact 
http://www.patrickfrei.ch/webalizer/

================================================================================

3.  LICENSE

Copyright (c) 2005-2006 Patrick Frei. All rights reserved.

This program is free software; you can redistribute it and/or modify it 
under the terms of the GNU General Public License version 2 as published by 
the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT 
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for 
more details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 
Temple Place - Suite 330, Boston, MA  02111-1307, USA.

The full GNU General Public License is included in this distribution in the
file called LICENSE.

Contact Information:
Patrick Frei frei<AT>caramail.com

================================================================================