#***************************************************************************
#                        CHANGELOG  -  description
#                             -------------------
#    title                : KTrafficAnalyzer
#    version              : 0.3.9
#    release-date         : 06.03.2008
#    copyright            : (C) 2003-2008 by Wolfgang 'Vir@s' Koller
#    email                : viras@suselinuxsupport.de
#***************************************************************************

#***************************************************************************
#*                                                                         *
#*   This program is free software; you can redistribute it and/or modify  *
#*   it under the terms of the GNU General Public License as published by  *
#*   the Free Software Foundation; either version 2 of the License, or     *
#*   (at your option) any later version.                                   *
#*                                                                         *
#***************************************************************************

Requirements:
=============
- Tested under KDE 3.5.5 - it might work under other KDE versions as well (it
  most propably will), but I wont guarantee it.

Installation:
=============
A simple make should do the job:

shell> make

If no error occurs you will find the KTrafficAnalyzer binary in the current
directory. Now you can install it into your kde/bin folder by running:

shell> make install

NOTE: You have to be root in order to do that

Installation on systems with seperated libraries and include files:
===================================================================
Some systems (as e.g. Debian) store the libraries and the header files in
different directories. In order to compile on those systems you can use the
ADD_CFLAGS and ADD_LFLAGS environment variables. When you set them they are
simply prepended to the CFLAGS and LFLAGS variables.

So e.g. to add the directory /usr/lib/qt3/ to the library search path, just
run the following command:

shell> export ADD_LFLAGS=-L/usr/lib/qt3/

Similar you can do it with the header search path (adding /usr/include/qt3
in this example):

shell> export ADD_CFLAGS=-I/usr/include/qt3/

So with that it should be possible to compile on any system :).

Uninstall:
==========
Just run "make uninstall" in order to uninstall KTrafficAnalyzer:

shell> make uninstall

NOTE: You have to be root in order to do that

Troubleshooting:
================
If you get any command not found errors, make sure you have both KDE and QT
installed (including the devel packages). Also make sure both KDEDIR and
QTDIR are set (the script will tell you anyway if it isn't set). They both
should point to the KDE / QT base dirs. So e.g.:

shell> export KDEDIR=/opt/kde3
shell> export QTDIR=/usr/lib/qt3

Usage:
======
Just start it (you can do so by either typing "ktrafficanalyzer" at the command prompt
or by selecting the entry in the KDE start menu under System->Network), the rest is 
pretty self explanatory. In the settings dialog you can set the colors for up and 
download and select the interface you want to display the traffic for.
The stats dialog shows you a list of daily stats (the up-/downloads and totals for each
day). In addition you can get also view a list of monthly stats.

Known issues:
=============
- None atm :)

Special Thanks:
===============
Jan - For pointing out an issue with the Makefiles
Storm - For doing massive beta testing
Aldin - For providing constant feedback
All the other people helping me with ideas and reporting bugs

Well that's it,
Hf,
Wolfi ~ alias Vir@s

PS: Bugs, comments, tips, hints, whatever: viras@suselinuxsupport.de
