                             PANDA-glGo Installation
                             -----------------------

Windows
-------

For Windows there is a common installer. Double-click on the downloaded
glGo-xxx.exe file and follow the instructions.

You need OpenGL libraries installed, they are included in the standard
installation of Windows 98 and newer (not recommended) or come with your
hardware driver. See section Requirements in the Readme file or the manual for
details. Summarized, install a suitable driver for your graphiccard which is
distributed by the cards vendor. Do not use the Microsoft driver.

The glGo installer includes the redistributable OpenAL library published by
Creative (http://developer.creative.com/).

The installer includes the required SDL and Python runtime libaries.

If you want to play with GNU Go, get one of the many Windows GNU Go binaries
and drop gnugo.exe into the glGo installation folder. You can download a
ready-to-run GNU Go for Windows from the glGo webpage or from many other
sites on the Internet.

If you are running Windows 98 and have trouble with text scrolling in the IGS
textareas, replace C:\Program Files\glGo\share\resource.xrs with
resource.xrs_win98 found in the same directory. Also try changing the setting
for "Force scrolling" in the preferences, see IGS tab.


Linux
-----

Install the .rpm or .deb files like you would install any of these packages:
"rpm -i glGo-xxx.rpm" or "dpkg -i glGo-xxx.deb". If you use the .tar.gz archive,
unpack it somewhere and run the glGo.install script. To uninstall, run
glGo.remove.

Basically it does not matter which of the installers you use. Take the one most
fitting for your distribution. They all install exactly the same files.

The user configuration is found in $HOME/.glGo. Please remove this directory
manually after uninstalling.

In any case you require OpenGL libraries installed, but they are installed
together with your hardware driver. In worst case, install the Mesa libraries
for software-only rendering, but this is not recommended

glGo on Linux uses the GTK-2 toolkit. This requires a couple of libraries
available. They should be installed together with GTK-2 from your
distribution. If you use the Gnome desktop, you already have all of these
libraries.

You need the following SDL libraries: libsdl, libsdl_ttf and libsdl_image. They
are available with all major Linux distributions. If you don't have them already
installed, get them from your distribution. In case try "ldd glGo" to check the
dependencies.

You need the Python 2.5 runtime library installed (shared library). Python should
be included in almost every Linux distribution.

For the sound system you need either the OpenAL or the SDL_mixer runtime
libraries installed. They should be included in every Linux distribution. Unlike
Windows, OpenAL is not included in the Linux glGo installer, as it is to be
preferred to use your Linux distribution version.
If neither libopenal nor libSDL_mixer are available, glGo should still run, but
without sound output.

Here are the most importantant dependencies. Nothing special, but you might
need to install some library from your distribution.

* libgtk 2.0
* libjpeg
* libpng 1.2
* libz
* libGL
* libGLU
* libSDL 1.2
* libSDL_image 1.2
* libSDL_ttf 2.0
* libfreetype
* libpython 2.5
* libpango 1.0
* libfontconfig

Optional for sound output:

* libopenal
* libSDL_mixer

If you want to play with GNU Go, please install it from your distribution, it is
included in almost any, or compile it yourself. Make sure the gnugo binary is
found in your PATH environment, so glGo will find it. Common locations are
/usr/local/bin, /usr/bin or /usr/games/bin.

If you installed glGo in an unusual directory, you can use the "-s" commandline
option to point to the shared data directory.
Example: glGo -s /home/foobar/myprogs/coolapps/glGo/share.
Another possibility is to set the environment variable GLGO_SHARED_PATH, for
example in bash: export GLGO_SHARED_PATH=/home/foobar/myprogs/coolapps/glGo/share
The "-s" option has higher priority than the environment variable. If neither is
given glGo will search for the shared directory in the folder the binary is
located, /usr/share/games, /usr, /usr/local, /usr/local/share/games, /opt,
$HOME, $HOME/glGo and $HOME/.local/share/glGo. If no shared directory is found,
glGo will fail to start. If you keep the default directories in the installation
and don't move files around later, you do not need to worry about this.

glGo support libraries (libalsound.so, libsdlsound.so and libsgfparser.so) are
located in /usr/lib/games/glGo. If you really need to move this directory
around, you need to tell glGo the location of these libraries. You can do this
by setting the environment LD_LIBRARY_PATH to the new directory.


Macintosh
---------

glGo requires Mac OS X 10.3 "Panther". It does not run on OS X 10.2 and earlier.

To install glGo, mount the disk image you downloaded in Finder and copy the glGo
icon to your Applications folder. If you also want the Playermanager, copy the
Playermanager icon to your Applications folder as well. The Playermanager is
optional and not required to run glGo. That's it!

To uninstall glGo move the glGo and Playermanager icons from the Applications
folder into the Trash. You can manually delete the directory
/Users/yourname/.glGo to delete the glGo configuration.

If you want to play with GNU Go, you can download a ready-to-run GNU Go for
Macintosh from the glGo webpage.
