Upgrading from a previous version of Fragstats
==============================================


To upgrade from v1.03 or later:

1. Install as before.

2. Read the instructions and take note of the new options available.

3. Merge your old Fragstats.cfg into the Fragstats.cfg that came with the previous version.

4. Delete the last.dat file. You will find this by default in the QW logs
   directory, unless you changed the default location or name. Check the
   fragstats.txt file for details of what this file does if you are unsure.

5. Re-run the new Fragstats, making sure that all the logs are being scanned and
   the existing databases are not being reloaded.

Your player and victims databases should now have been recreated.

To upgrade from v1.02 or earlier:

1. Do steps 1. to 3.

2. Do step 5.

What's new in 1.08
------------------
. Expression handling via User Defined Tags. You are now no longer forced to use just
  the stats that Fragstats provides. Full sorting support so you can produce HTML
  output sorted by your own stats. For more details see the template.txt file.
. Increased the maximum length of the dbcfg filename.
. Added support in Qplayer for CGIDIR environment variable to get around some web
  servers not setting the working directory properly. See FAQ.txt for details.
. Added to the FAQ:
  - How to deal with undesirable player names.
  - How to fix Qplayer working directory problems with IIS and Website.
  - What to do to get TRIBES stats happening.
. Hopefully fixed the Linux date problem mentioned in the FAQ.
. Changed the wording of the licence.
. Other minor fixes

What's new in 1.07a
-------------------
Little fixes & additions.
. Added reverse sorting extension to the 'htmlout' command. Syntax is now:

  htmlout [<num>|all] by [reverse] <sort> using <template> [output|append] <file>

. Added notes on making search by name work when dbcfg is specified.
. FAQ has some info on merging multiple QW servers.
. Added sort by Frags back into the sample fragstats.cfg file.
. Added new tag <!--dbcfg--> which outputs the dbcfg name.
. Added the ability to sort by Ping and Last Seen.
  eg. Show the 20 players with the lowest average ping:
  htmlout 20 by reverse ping using "c:\fragstats\top20temp.html" output ping-top20.html

  eg. Show the 20 most recently connected players:
  htmlout 20 by "Last Seen" using "c:\fragstats\top20temp.html" output recent-top20.html

. Added 'FPHthresh' option to provide fairer FPH sorting.
. Made 'ping' data more accurate.
. Made 'last seen' data more accurate.
. Fixed the dodgy case comparison when looking for a log file.
. Fixed meansod/gh.html template so it refers to <!--grappling_hook-->
. Added FPHthresh info to standard templates.
. Fixed weapon sorting so that an equal number of kills will force a comparison
  by deaths.


What's new in 1.07
------------------
. Sorting by any score type now supported, eg. sort by "Flag Capture".
. New tags for time connected, maps completed, time last seen, frags per hour
  and ping:
  <!--connect_time-->        Total time that player has been connected
  <!--maps_played-->         Number of maps the player has completed
  <!--last_seen-->           Last time  that player was seen
  <!--ping-->                Average ping
  <!--fph-->                 Frags per hour

. Support for display of stats for a given weapon via user defined tags.
  eg. When defined, <!--rocket_launcher--> will display the rocket launcher
  stats for a user. Any weapon can be displayed like this in the same manner
  as special scores. You can also sort by weapon.
. Players with zero scores are automatically deleted from the database.
. Added new 'dbcfg' option which is used to specify a special database
  config file. This lets you keep seperate the stats from multiple servers
  in the same CGI directory.
. Fixed Duel sorting bug that caused a div by zero crash occasionally.
. New "Means of Destruction" templates to display top scores by weapon.
. Updated the scores.html template to include the new "Means of Destruction"
  page. Added connect time & frags per hour to the default Top 20 template.
. Fixed cgitemp.html so standard DM template doesn't have CTF tags in it.

1.06b maintenance release
-------------------------
Bug fixes:
. Problem with map names containing non-ASCII characters now fixed.

Known problems:
. Date doesn't accommodate the timezone with recent versions of Ret Hat Linux. See
  FAQ.txt for more info.

1.06a maintenance release
-------------------------
Bug fixes:
. Problem parsing certain GS logs that resulted in a core dump.
. Player names made up only of spaces are discarded.
. Fixed internal templates.

Whats new in 1.06
-----------------
. User Defined Tags (UDT's) for use in templates.
. Support for Quake 2 mods such CTF, HeadHunters, etc via UDT's
. Team statistics for GS log users.
. Map based statistics for GS log users with the option to switch them off if you want.
. Weapon based statistics for GS log users.
. Added 'Duelthresh' option to provide fairer Duel sorting.
. Specify the GS log name via the 'gslogname' option.
. Added comparative kill count to victim lists in Qplayer.
. Added optional Error template for Qplayer.
. Fixed bug with last line processing of cfg file.
. Tighter log parsing code; malformed frag log entries are now always rejected.
. Added new template tags for support of teams, weapons & map statistics:
  <!--team_name-->        team name
  <!--team_name_pad-->    team name padded to 32 chars
  <!--total_team_score--> total score for team
  <!--total_team_score_pad-->  total score for team padded to 8 chars
  <!--map_name-->         map name
  <!--map_numplayers-->   number of players recorded for that map (Fragstats only)
  <!--map_numfrags-->     number of frags recorded for that map (Fragstats only)
  <!--map_path-->         subdirectory containing the stats for
                          that map
  <!--map_name_url-->     Encoded link to Qplayer with map name and player name (Qplayer
                          only)
  <!--page_name-->        name of the HTML page being written (Fragstats only)
  <!--weap_name-->        weapon name (Qplayer only)
  <!--weap_kills-->       kills by that weapon (Qplayer only)
  <!--weap_deaths-->      deaths by that weapon (Qplayer only)

  There are also new embed tags, <!--embed_teams--> for Fragstats, <!--embed_maps-->
  for Fragstat and Qplayer, and <!--embed_weaps--> for Qplayer.
. New sample template files which show the usage of the new tags.