Frequently Asked Questions
**************************

Prog: Q3 Log Generator HTML (stat-prog for Quake 3)
home: http://www.cs.tu-berlin.de/~hanspete/Quake3
auth: Jacobs, Hans-Peter <hanspete@cs.tu-berlin.de>
date: 23th jan 2000

The newest version is always available at my homepage, so please look
there for upcoming versions.

If you find bugs or strange feature, suggestions, etc.. contact me,
and please describe short the problem, your OS, Q3 version and the
q3LogGen version..
I never thought that such a small prog can have so many "bugs" :-(

MAIL ME  ----> hanspete@cs.tu-berlin.de
HOMEPAGE ----> http://www.cs.tu-berlin.de/~hanspete/Quake3



Version 2.3 - Release 26th january 2000
  - added the "-l" option for limiting the lines in AllPlayer_tables
  - in templates: line-limits can also be set individual (LINELIMIT)
  - in the Html_log/pix/maps-directory you can store your levelshots
    (must be jpg !) - for Templates: new <Q3L_SG_MAPIMAGE>-tag
  - added small icons in SP-view
  - removed team-color bug in SP-view
  - you can use more than one games.log (command-line) - be careful,
    report bugs
  - ":" and ";" are handled as evil characters in playernames, will
    allways be replaced with "_"
  - timelines can now load a background-png (8-bit palette) from
    their Template-directory
  - new template : "bright light", like "framed", but much brighter
    colors, white, yellow, blue
    BrightLight is the new default-template (old "framed" stays in the
    releases)
  - old "noframe" template was kicked out of the releases, if you still
    want it, download it seperately, but I do not maintain it anymore

Version 2.2 - Release 23 january 2000
  - removed some score mismatches (not for sure, but better now)
    PROBLEM: What happens to the score (frags) if you change your
    players info ?? What happens to the team-score if you change teams
    ??  PLEASE HELP !!
  - in tournament: observers will not be drawn into the timeline-diag
  - the end of the game is displayed now (time-,frag-, or capturelimit)
  - minor changes for the Single-Game layout (initial table)
  - some new Q3L_tags for the SG
  - mapname-loader now also supports GameSpys "MapData.txt" - format
  - "-a" options caused some trouble, still to be used with caution
  - all text-files contain more informations (in a better layout ?)
  - custom games "fs_game" are displayed for each game
  - sorting is mcuh faster now, usefull for more than 200 players
  - new award -> Golden Bullets for the player with the highest FPH
  - new award -> Killmaster for the bloodiest player
  - thanx to Igor K. Dulevich for the hint how to handle
    crashed servers (neither Disconnect nor Exit appeared in
    "games.log"), he sent me the most f*cked up games.log I've ever
    seen, thank you ;-)
  - thanx to the animal ;-) (Jeremy) for reporting:
    * the (hopefully) last bug concerning the long-time servers
      (longer than 999:59) - didnt got mmmm:s, expected mmmm:ss
  - again Peter pointed out some bugs and probs:
    * Fragmaster was displayed right, but not FragMasterCount, etc...
    * "Warmup" is now handled via "-w" switch
    * seconds online are now converted to hh:mm:ss

Version 2.1 - Release 19 january 2000
  - added PNG-generation for the Frags
    each player is represented by a different color, palette-colors
    can individualized with the "colors.txt" in your Template-dir
  - ROBUSTNESS (TTL) and EFFECTIVENESS are new special awards
  - memory-usage reduced (more use of dynamic memory-allocs)
  - SP_KILLTABLE understands now "SHOWALL" (if "showall" is not used
    in the sp_killtable just the used weapons will be displayed)
  - VERSION - file changed, the newest stuff is now "over the top" :-)
  - thanx to Peter Bonivart for the (now implemented) suggestions:
    * for Tournament-mode observers are ignored, just the 2 fighting
      opponents are displayed
    * long mapnames can be used with "<Q3L_SG_MAPFULLNAME>" and
      "<Q3L_SG_MAPLONGNAME>" - a "maps.txt" must exist in your
      q3_loggen - directory

Version 2.0 - Release 14th january 2000
  - introduced HUMANONLY-tag for Q3L_AP_ALLSTATS
  - removed multiple (redundant) generation of the same
    all_player.html when more than one Q3L_AP_ALLSTATS - table was
    processed
  - added an effectiveness-column in the AP-ranks and the SG-ranks,
    calculation can by defined with a cmd-line-switch
    Read the HOWTO for further informations about own calculations.
  - Games are counted for each player

Version 1.9 - Release 12th january 2000
  - Table with all players can be sorted (name, frags, kills,
    time,...)
  - fragmaster, etc.. can be used for Q3L_IF - Q3L_ENDIF
  - ctf-score was corrupted in v1.8 - corrected -> thanx to Marc
    Regimbald, who was sending my the bug-report

Version 1.8 - Release 10th january 2000
  - SP_Killtable was not using funnames :-(
  - Found a name with an ESC-code inside (caused a serious prob for
    Win9x) ... people *are* crazy
  - "/" and "\" are replaced with "_" in player-names, all chars <#32
    are now handled as "_"
  - added the "-r"-option for removal of " ", "*", ">", "<" chars in
    player-names (caused some problems using Win9x)
  - new Template - tags, fragmaster etc..
  - added item_flight and item_enviro

Version 1.7 - Release 09th january 2000
  - gfx-output of counters wrote *nothing* if counter was "0"
  - some of the colors used in tables were not used correctly
  - thanx to Jeremy Kott for the first 2 real-time "games.log" files
  - big bug eliminated, causing real-time logs crashing the prog
    (ClientConnects were handled wrong)
  - time-counter twice corrected for online-games
    (time with no action was counted, all player got time counted till
    the end of the game)
  - memory leaks fixed (mcheck still finds something, but this seems
    to be libstdc)
  - Kill-table is sorted now, name in the table-head are written 2x
    smaller
  - people use really strange names ... fixed fun-code generator and
    added a "<" ">" converter (otherwise HTML thinks its a tag)
  - added a table for SinglePlayer (in a SingleGame), who was killed
    by which weapon
  - when time gets over 999 minutes a space-char (32) is missing, so
    this lines were ignored and not parsed, now it should work

Version 1.6 - Release 05th january 2000
  - found a little bug for team-frags (Tkills were not subtracted
    from kills)
  - detailed weapons-stats for SG (SingleGame) and SP (SinglePlayer)
    (kill, suicides, team-kills)
  - links to Single-Player-stats from the Ranking and the
    All-time-player-tables
  - got a y2k - problem -> yeah .. last update-time was ..strange?..
    (already fixed)
  - leading "/" in filename caused the program to interpret the file as
    an option :-(
  - HTML-templates added
  - link to the home of Q3_LogGen is automatically inserted into HTMLs
  - moved completely to GNU-C compilers (Linux and Win9x)
  - src will be included for all OS-releases
  - renewed directory-structure
  - many thanks to Moritz Bunkus for some useful hints and a piece of
    better code :)
  - Fun-Name (colors) build in

Version 1.4 - Release 29th december 1999
  - I'm programming now under Linux, using gcc and emacs (what else
    ?!), converting to windows is easy with lcc-win32
  - weapon and items-stats are now sorted
  - Team-Kills are counted and displayed
  - the index.html also displays the played game-mode
  - cleaned up the HTML-output for not used items/weapons in Single-Game-view
  - bots got extended names -> "botname [skill]"
  - ping and TTL (Time to live (averaged)) added
  - tables (weapons/items) should now have a constant column-width
  - CTF-stuff added (its a mess !), but it should work now :-)
  - all team-related tables are now sorted according to teams score
  - from index.html you can select 2 different all-time stats and a
    new help-file
  - now you can configure the used colors in the "colors.ini" file
    (if deleted the program uses some defaults)

Version 1.3 - Release 28th december 1999
  - found and removed a stupid bug (overflow) in the Frag-Count
  - added some new items and weapons, still not a complete item/death-list
  - changed the <path> to a <file> - cmd-line param, so you can use any
    (old, renamed) log-file with Q3_LogGen

Version 1.2 - Release 28th december 1999
  - first official release
