#
# pyAwale - A simple Awalé game
# The count-and-capture official board game of Africa.
# Author: MiKael NAVARRO <klnavarro@gmail.com>.
#

pyAwale - A simple Awalé game
=============================

**Awale** or Oware_ is a game of great antiquity, and has been played
around the world in various forms for millenia.  Currently it is the
official board game of Africa.

.. _Oware: http://en.wikipedia.org/wiki/Oware

Member of the mancala_ family of board games.  There are many variants
to the rules of this game, which is for two players.  This version is
between a player and the computer.

.. _mancala: http://en.wikipedia.org/wiki/Mancala

Licence
=======

pyAwale is a free software available under the terms of the GNU General
Public Licence.  Refer to the file COPYING (which should be included
in this distribution) for the specific terms of this licence.

Requirements
============

Realised with Pygame_ library with Python_ language 2.4 or later.

.. _Python: http://python.org
.. _Pygame: http://pygame.org

Theorically must works on all platforms.

Installation
============

To install *pyAwale*, see INSTALL file for more details.

Usage
=====

pyAwale is written to work in interactive mode but you may prefer to run
it from a user graphical interface.  Consider Pygame implementation for 
this purpose.

Simply launch::

  $ pyawale.py --help

then, see documentation for more details.

--
MiKael NAVARRO
