INSTALLATION
============

Welcome to GNU Othello! 

To install the program, just edit the Makefile and set the make
variables BINDIR, MANDIR and MANEXT to values fitting your
installation.  If you don't have GNU CC you will have to change the
settings of CC and CFLAGS also.  See further instructions in the
Makefile.

When this is finished you just have to type 

`make target'

where `target' is one of the following:
 sunview
 dumbterm

If you just type 

`make'

you will receive more instructions from the Makefile itself.  When you
have compiled the program successfully, you can type

`make install'

and GNU Othello and the manual will be installed in the places you
have chosen with BINDIR and MANDIR.


PORTING
=======

GNU Othello is designed to be as portable as possible to different
user interfaces.  Currently there are only the two alternatives
mentioned above to choose between.  The target `sunview' provides a
graphic interface to SUNVIEW running on a SUN workstation and the
target `dumbterm' just rewrites the board after each move.  This is
the simplest interface possible.

A volunteer is currently writing an interface for curses(3X) and this
will probably be included in GNU othello version 1.1.  Much needed is
also a port to X Windows.  See the file TODO for other user interfaces
and OS:es to port GNU Othello to.  See also the file PORTING where
most of the details in the interface between GNU Othello and the user
interface are documented.  If you want to make a contribution to GNU
Othello, this is probably the area where your effort will be most
valuable, at least now in the beginning.

Later we will try to provide more than one user interface in the same
executable and let the user specify at startup time which one he wants.


BUGS
====

If you discover a bug, please report it to ingwa@isy.liu.se and I will
try to fix it as soon as possible.  Suggestions for extensions are
also welcome.


+--------------------------+-------------------------------------------------+
|Inge Wallin               | Thus spake the master programmer:               |
|                          |      "After three days without programming,     |
|ingwa@isy.liu.se          |       life becomes meaningless."                |
|                          | Geoffrey James: The Tao of Programming.         |
+--------------------------+-------------------------------------------------+