------+
 NAME |
------+-----------------------------------------------------------------

	wmQStat - monitor various Internet game servers

---------+
 CREDITS |
---------+--------------------------------------------------------------

Written by:

	Alexey Dokuchaev (danfe@regency.nsu.ru)

Additional credits go to (in alphabetical order by last name):

	Dave Clark (clarkd@skynet.ca)
	Antoine Nulle (warp@xs4all.nl)
	Martijn Pieterse (pieterse@xs4all.nl)
	Artem Yusipov (artem@alawar.com)

----------+
 SYNOPSIS |
----------+-------------------------------------------------------------

	wmqstat [option(s) ...]

-------------+
 DESCRIPTION |
-------------+----------------------------------------------------------

wmQStat is a dockable front-end to qstat by Steve Jankowski, a popular
command-line monitor of lots of Internet game servers, i.e. Quake/W/2/3,
Hexen2/W, HL/CS, Tribes/2, RtCW, Unreal, Heretic2, Descent3, to name a
few (this list is by far not complete).

It takes list of servers (type and address) to monitor from the
configuration file (~/.wmqstat by default) and reports current map,
number of connected clients, and players' names with their frags (or
ping) in a neat LCD fashion (much like wminet dockapp, which had been
taken as a base for creating wmqstat).  Servers are switched by left
clicking on active display area, frags or ping mode is selected by
right clicking, respectively.  The list of players is scrollable with
a mouse wheel.

It should compile and run flawlessly under FreeBSD (both -STABLE and
-CURRENT), NetBSD, Linux (probably any distro), and Solaris; may be
something else.  Feel free to port to more platforms, and report the
results! ;-)

Supported window managers include WindowMaker, AfterStep, as well as
BlackBox, FluxBox, and Waimea.  Rumors were that FVWM can eat it too.

------+
 BUGS |
------+-----------------------------------------------------------------

Currently, the following issues are considered bugs:

  - If you supply some inherently wrong arguments to qstat it will
    keep trying and trying to stat that server.  Even if qstat had
    returned an exit code of -1, it will not give up.  This is because
    there is no easy and clean way to obtain exit code that program
    returned from popen(), at least none that I'm aware of.

  - FLAG_PLAYER_TEAMS and alike are not supported.  Only FFA servers
    currently, sorry.  (Any takers?)

  - No manpage. ;-)

If you happen to find any bugs in wmqstat, please send a detailed
bug report to danfe@regency.nsu.ru.  If you can code, you could try
fix it yourself, and submit patches back!

------------+
 LEGAL CRAP |
------------+-----------------------------------------------------------

Copyright (c) 2003 Alexey Dokuchaev.  All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in
   the documentation and/or other materials provided with the
   distribution.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS''
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
