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: 25th jan 2000

Contents
********
1. Warning and error-messages
2. HTML-results
3. Features
4. Known probs and bugs


*****************************
1. Warning and error-messages
*****************************

Q: When running q3loggen with "-a" there are numbers with an "a"
   behind. What does they mean ?
A: The numbers are indicating the game q3loggen is reading actually.
   An "a" indicates an aborted game. "Aborted means", that no "Exit"
   (timelimit, fraglimit, capturelimit) was reached, somehow the
   server either performed a ShutdownGame (user-abort) or the server
   crashed... The "-a" mode does not makes a difference between
    aborted and warmup-games, they are displayed all.
   Same applies for "-w" - option, a "w" behind a number indicates
   a "warmup"-game, which are normally thrown away. But "aborted" game
   do not appear in the stats.

Q: I get the "client xy connected twice" - message - what the
   hell... ?
A: Well, this is a problem that happened just with the early versions
   of Q3 (at least I hope so). The server wrote a ClientConnect to the
   "games.log" - file, but the client was already connected without
   being disconnected .... if you still get the messages, mail me
   please.

Q: When writing HTML and png, q3loggen writes "png_bound: xyz" -
   errors to the screen - why ?
A: This is just for debugging and should not be happen for valid
   "games.log" files. However, sometimes the prog does not recognizes
   a server-crash (or other strange circumstance) and so it reads
   strange times from the log-file. If it happens often (and in your
   opinion to often), please send your "games.log" to me, so I can try to
   improve the prog.
	
Q: Sometimes q3loggen displays a whole line of "Unknown .." something,
   it looks really weird - how can I switch this off ?
A: This happens if your server crashed during a game. The "games.log"
   contains a whole line of trash.
   The line after this line contains mostly "InitGame", so a line
   later q3loggen understands what happened to your unlucky
   server. But first the parser throws out this warnings ..


***************
2. HTML-results
***************

Q: Q3 LogGen displays funny numbers in the weapon-table (0,14,15,21) !
   What does this mean ?
A: Quake 3 logs kills like "kill: 0 2 12", meaning that client 0
   killed client 2 with weapon 12 (BFG). The numbers for the weapons
   reach from 0 to 22 (at least, I did never find any other values),
   where 1 means Shotgun,..., 12 BFG,..., 16 Lava and 22 Trigger_Hurt.
   Unfortunately I do not have any clue what weapons 0, 14, 15, and 21
   are standing for. If you ever find a games-log where this weapons
   were used (counted in the weap-table with values above 0), please
   mail me immediatly.

Q: For tournament-mode the displays a higher number of players than
   the number which is displayed in the Frag-Table !
A: In tournament-mode just two players can play a game.
   All others are observers and thatswhy this players will not be
   displayed.

Q: I dont like your layouts! Cant you make them a little bit nicer ?
A: No, I like them that way :-)
   However, in the Template-directory you can create a new subdir.
   Copy all the templates from "framed" to your new subdir and modify
   all the HTML-files in you new dir. Then you start q3_loggen with
   " -t Templates/YourNewDir" as an additional command-line parameter,
   and the prog should generate new output-HTMLs with your
   modification.
   If your layout is really cute, send it to me, so we all can share
   your sweet little Template ;-)

Q: I have a lot of players (more than 500) and the All-Player table is
   now much to big, my browser loads 400KB and more - how to reduce this
   amount of date ?
A: In version 2.3 you got a new command-line-switch "-l". This sets
   for all AllPlayer-tables a linelimit.
   However, if your HTML-template contains a "LINELIMIT"-keyword
   within the <Q3L_AP_ALLSTATS>-tag, the template overwrites the
   command-line.
   e.g.: "LINELIMIT=0" allways writes the current table full
         "LINELIMIT=100" will allways limit the table to 100 lines


***********
3. Features
***********

Q: I miss the xyz - function !
A: Mail me, I try to put everything (of any use) into the prog.

Q: Why cant you display the date of the games ?
A: The boys at id (the producers of Q3A) do not write the servers date
   or time to the log-file. So there is *no* way of getting this info.
   If you would like to have this feature, write them, I did so.

Q: Why cant I use "P" (ping) for effectiveness-calculations ?
A: There is just one way to get a players ping -> the final Q3-score.
   If a player left the server before the game was finished the player
   will be handled with a ping of "0", thats not a very good value
   for computations .. :-(


***********************
4. Known probs and bugs
***********************
PLEASE ALSO READ THE "BUGS" - FILE !!

Q: Why do player always are playing a shorter time than the
   game-duration ?
A: Game-Duration means the time the server is "playing" this map.
   For the individual player just the seconds between "Begin" and
   "Exit" or "ShutdownGame" or "ClientDisconnect" are counted, and
   since Exit appears allways before ShutDown, and players rarely
   start in the same second as the server ...... okay ?

Q: In the tournament-mode sometimes just 1 or (0) players is active -
   why ? The game-overview displays the correct number of players !!
A: I used the frags and the death to identify, who is not observing
   If both of the values are "0" I assume, the person
   is not playing the game. If your server crashed before anybody
   could kill another all this values are "0", the players must be
   observers. This happend just for very short games without any frags
   or pickups....
   (without the "-a" - option you should *never* get this result)
