Table of Contents
-----------------
1. What is it?
2. Changes in this release
3. License and source code
4. Platforms
5. Special Thanks


What is it?
-----------
dgsmonX is a faceless Mac OS X application (i.e. an application that is not
visible in the Dock) that monitors the games you have joined on any number of
Dragon Go Servers (DGS) and alerts you when it is your turn to move.

For a detailed description of dgsmonX features, see the MANUAL document
(available from the Help menu).

You can check for the most recent version of dgsmonX on its homepage
http://www.herzbube.ch/dgsmonx.

If you are interested in dgsmonX as a developer, you should have a look at the
README.developer document.


Changes in this release
-----------------------
This is dgsmonX 0.2.1.

This release addresses a compatibility issue with the previous release 0.2 which
made it impossible to launch the application on Mac OS X 10.5 and earlier. The
new release should now work correctly on 10.5, but support for Mac OS X 10.4 had
to be dropped.

In addition, the status item now reflects the current status of all servers,
even after a nagging animation has been acknowledged. Previously if an animated
status item was clicked, it reverted back to it's normal state.

For more details see the ChangeLog document.


License and source code
-----------------------
dgsmonX is licensed under the GNU General Public License (GPLv3). You should
have received a copy of the license along with the dgsmonX application bundle
or the source distribution (see the file COPYING inside the application bundle
or source distribution, or start the application and choose the
"Help:GNU General Public License" menu item). If not, see
<http://www.gnu.org/licenses/>.

The source code for dgsmonX can be downloaded from its homepage
http://www.herzbube.ch/dgsmonx. You will get the source files ready for building
with Xcode. Once the project's git repository becomes available online, you may
also get the project's source code from there.


Platforms
---------
The binary release of dgsmonX runs on Intel machines only. Unfortunately PowerPC
support had to be dropped when the project was upgraded to the Xcode 4
development environment.

The minimum requirement for running this version of dgsmonX is Mac OS X 10.5.


Special Thanks
--------------
Shawn Betts, for providing code patches that 1) use quick_status.php for game
state checks and eliminate the need for storing the user's password; and 2) add
an icon to the status item.

John Cass, for suggesting alternative menu item click actions.

Dustin Bachrach, for his QuickTunes source code
(http://www.dbachrach.com/opensoft/index.php?page=QuickTunes) that gave me the
initial pointers how to create a Mac OS X faceless application with its popup
menu in the menubar.

Yves Rutschle, for letting me steal the name dgsmonX from his command line
utility dgsmon (http://www.rutschle.net/gaming/dgsmon.shtml).

Colin Jacobs, for the source code of his tool "Dragon Go Server - System Tray
Monitor" (http://coljac.net/dgs) that pointed me to DGS' quick_status.php page,
whose output is virtually fail-safe to parse. This literally saved my day, as I
was about to spend another day or two for learning how use a DOM parser in
Cocoa, in order to improve dgsmonX' parsing of the output of DGS's status.php
page.

And, of course, the people from dragongoserver.net, for making their software
free.
