                 GNU GO INSTALLATION INSTRUCTIONS

Get the most recent tar file from ftp.gnu.org or a mirror (see
http://www.gnu.org/order/ftp.html for a list).

Untar the sources, change to the directory gnugo-2.5.xx. Now do:

   ./configure
   make

This makes a binary called interface/gnugo. Now (running as root) type

   make install

to install gnugo in /usr/local/bin. This will also install the man
page gnugo.6 into /usr/man/man6.

There are two methods of using GNU Go. You may run it from the
command line by just typing:

   gnugo

but it is nicer to run it under X-Windows using CGoban.

Obtain the most recent version of CGoban from Bill Shubert's web site:
http://www.inetarena.com/~wms/comp/cgoban. The CGoban version number
MUST be 1.9.1 at least or it won't work.

See the README file for instructions on how to run GNU Go from Cgoban.


                         MEMORY USAGE

By default, GNU Go makes a cache of 16 Megabytes for its internal
use. The cache is used to store intermediate results during its
analysis of the position. It is reset every move. Normally the
cache is never filled up but if it does fill, play may become
slow.

You may override the size of the default cache at compile time 
by running

   ./configure --enable-large-model
   make

or 

   ./configure --enable-small-model
   make

The large model allocates 32 megabytes, and the small model allocates 8.
Use the small model if you are running on a machine with little memory,
and use the large model if you are running on a machine with lots of
memory. You may override the compile-time default by running gnugo with
the option `--memory n', where n is the size (in megabytes) of the cache
you want.


                          PROBLEMS

On one GNU/Linux machine compilation failed because it had an
incompatible /usr/include/curses.h (from BSD) which had declarations
inconsistent with those in /usr/include/term.h. The symptom of this
problem is compilation errors in src/moyo.c and src/showbord.c.

In this case, the correct curses.h was found in /usr/include/ncurses
and a correct compilation was obtained after changing

     #include <curses.h>

to

     #include <ncurses/curses.h>

in src/moyo.c and src/showbord.c. If you have a problem with errors in
src/moyo.c and src/showbord.c caused by curses you should try such a
remedy first. If this doesn't work, you shouldn't curse. Run
'configure --disable-color' to turn off the color option and compile
again. Another alternative if you want color is 'configure
--without-curses --enable-color'.


                            WINDOWS

Windows installation is described in a separate file, called WINDOWS.

                           MACINTOSH

If you have Mac OS/X you can probably build GNU Go using
Apple's compiler, which is derived from GCC. Use the flag
-traditional-cpp to suppress Apple's preprocessor, or you
may have some problems.


                          THE MANUAL

You can obtain a printed copy of the manual by running
'make gnugo.dvi' in the doc/ directory, then printing the
resulting .dvi file. The manual contains a great deal of
information about the algorithms of GNU Go.

On platforms supporting info documentation, you can usually
install the manual by executing `make install' (running as
root) from the doc/ directory. The info documentation can
be read conveniently from within Emacs by executing the
command `Control-h i'.




