
REQUIREMENTS FOR THIS PROGRAM:
        * A Linux system with perl 5.0 or greater installed
        * Access to a web browser (preferably on the system your halflife
          server resides on)

FEATURES:
        * Creates HTML for all players that have a kill
	* Keeps stats across many different maps.  Does not operate on
	  a game to game basis.
	* Customizable HTML colors
	* Creates a very aestheticly pleasing and easy to use web interface
	* Shows a table for most uses of crowbar, bolt and gluon
	* Processes LARGE log files in short amounts of time
	  (Test machines are as follows:
	  1.	Running Redhat 6.0 on  
		Dual PPRO 180, 64MB pc66 dimms, 7200RPM IDE 10.2GB
		Processes about 10 megabytes of logs in 54 seconds
	  2.	Running Mandrake 6.0 on
		PII-350, 96mb pc100 dimms, 5400RPM IDE 9.6GB
		Processes same 10 megabytes of log files in 25 seconds
	  NOTE: Other halflife stats programs (on win32) took up to 2.5 
		minutes to process the same set of data on similar machines.)
        * Summarizes total kills, total deaths and efficiency
        * Creates a player HTML page for each player in the top 25
          (unless you reconfigure that number)
        * Summarizes hardest/easiest opponents for each player
        * Tracks your weapon usage with RAW numbers and % of your
          total kills
	* Tracks each opponent you frag.  Shows how you did against them
	  and how they fared against you.  Uses raw numbers and a 
	  kill to death ratio
	* Reports total size of log files
	* Reports time in seconds of computation
	* Is configured through and easy to edit external config file

HOW TO INSTALL:

	Run the supplied install script.

THINGS YOU MAY WISH TO ALTER:
        
        *  halfStats only shows the current month's stats.  To change this,
           search for this code:

            if($year == $curYear && $month == $curMonth)
            {
                chomp($end);
                $obitArray[$count] = "$end";
                $count++;
            }

          Replace that code with:

           chomp($end);
           $obitArray[$count] = "$end";
           $count++;

          Basically, just remove the if condition and its brackets.  This will
          add all stats to the page.  This can significently effect the
          amount of time halfStats takes to complete.


Key: 
	+ = Addtion
	* = Bug fix
	# = Modification (change)	
	
LATEST CHANGES

v0.94 - 09/20/1999
------------------
* Fixed some minor logic problems with counting suicides
  Suicides were being counted as a Kill and a Death == WRONG
# Changed the way listMax works.  If set to 0, all players are 
  displayed
+ Added 'cronEntry' script to be put in a crontab to run 
  halfStats every 15 minutes (or however much you like)
+ Added 'install' script to make installation a bit easier
+ Added 'statsTool' program to the package
  This program allows you to Remove names, Replace names, and fix
  blank name errors
+ Added weapon images from half-life in place of the names
  (Thanks to alien@alienworld.org for the idea and to 
   kit@ukrpack.net for some of the images)
+ Added colored bars to proportionately display weapon %'s
+ Added more in formation about the host running halfStats
  (Last ran date/time and the hostname)
# Changed webpage contact to reflect space on planethalflife

v0.93 - 09/16/1999
------------------
+ Added opponent tracking table 
  Shows each person you've killed in the following format:
   [Name] [Times killed] [Times they killed you] [Kills per death] 
  -- Thanks Oliver Henry!
# Modified the way configurations work.  Individuals will now edit
  the 'halfStats.cfg' file in their halfStats directory.  Configuring
  halfStats is no longer done at the top of the PERL script
+ Added the "Those" Weapons awards.  Thanks to Adam Davidison (author of HLR)
  whose program gave me the idea for this modification
+ MAJOR additions to this file (README)


v0.92 - 09/10/1999
------------------
+ Added the ability to alter background, foreground, and link colors
  (most table headers stay the same)
+ Added logfile size and computation time summary
+ Added links to halfStats homepage and my email address
# Minor aesthetic changes

v0.91 - 09/08/1999
------------------
* Updated the routines to CORRECTLY track least kills and hardest to kill.
  Players who had not been fragged or had not fragged someone at all were
  reporting them as the match.  Instead of a NULL entry for frags, it now
  does not coaunt them at all
+ Made weapon usage summary display in ranked order by highest percentage.

v0.90
-----
+ First version, not released due to problems with tracking least kills and
  hardest to kill summaries.
+ Added month to month cut off (consequently year to year cut off as well)
+ Added a customizable limiter for main page listing.

