Who's The Winner
a Quake 3 Arena log analizer
written in Python.

How to install:


Part 1: Installing.

Upgrading:

To upgrade from 1.0 to 1.1 extract 1.1 upgrade archive.
Open the directory, select all files and copy them onto 1.0 main directory.
At this point you can delete 1.1 upgrade directory and rename 1.0 main directory to 1.1

Windows installing:

1) Install Python 1.5.2 with additional Tcl/Tk support (full installation). The installer will prompt after installed Python
if you want to install Tcl/Tk support. Say yes, otherwise WTW will never work.
I suggest you to install Python in C:\Python and Tcl/tk in C:\Tcl , you'll make easy a little job later.
I'll assume by now you've installed Python and Tcl/Tk in the paths above.
2) Extract the PIL archive where you want.You'll find 2 directories and 2 files. Simply copy them in Python installation path.
3) Extract WTW archive where you want.
Inside you'll find a few directories and 4 files (wtw.pyw,wtwcore.pyc,wtwsetup.bat,releaseinfo.txt).
When you open wtwsetup.bat with your preferred text editor you'll see the two first line:

set PYROOT=C:\Python
set TCLROOT=C:\Tcl


Simply replace these paths if you've chosen different installation paths and cat entire content to the end of
autoexec.bat.
Reboot Windows.

Unix installing:

On Unix platforms (Linux) don't use any precompiled packages that come with your favourite distributions because
there could be missed some modules needed by WTW that aren't been compiled.
So after downloading of Python 1.5.2 sources, compile it by yourself.
You must have Tcl&Tk (version 8 and upper versions are ok).
In this case you can use precompiled binaries and packages.

First extract wtw archive (tar gzipped) with:

tar -zxpvf wtw_<version number>.tgz

Inside you'll find a file named Setup.
Extract Python sources in the same way.
Copy Setup inside Python installation directory inside Modules:
Compile and install Python.
Extract PIL archive and follow compile and install instructions.
After that you should have all Python modules in /usr/local/lib/python1.5 and PIL modules in /usr/local/lib/python1.5/PIL
Add this line in your shell startup script:

setenv PYTHONPATH $PATH:/usr/local/lib/python1.5:/usr/local/lib/python1.5/PIL


Syntax can change depending on the shell you're using.
Add $PYTHONPATH env variable to you $PATH

Part 2: Usage.

Windows usage:

Open your WTW directory and double click wtw.pyw to execute WTW.
You can make a shortcut if you prefer.
.
Unix usage:

Go in the WTW directory.
Open a shell and type:

python wtw.pyw


--------------------------------------------------------------------------------------------------------------------------------
After WTW processed a Q3A log, simply double click index.html inside WTW directory
Enjoy.


Bugs:
Even WTW is been tested, some logs can reveal an hidden bug.
If so, WTW got stuck (i.e. the progress indicator show the same percentual number for a long time or the HD led is off etc.).
If this happen, click on the X button on the top right side of the titlebar to kill WTW.
Rename wtw.pyw to wtw.py and restart WTW. You'll see a Python console window and the gui opening togheter.
Restart WTW with the log caused the trouble. When WTW got stuck again some messages will be showned on the console
window. Cut & Paste all messages and send to me via email in a text file with the log in a zip file
so I can discover the problem.
Thanks.

Giampaolo "RainCloud" Russo.