1. Introduction

Glaurung is a free UCI chess engine.  It is not a complete chess
program, but requires some UCI compatible GUI (like XBoard with
PolyGlot, eboard, Jos, Arena, Sigma Chess, Shredder, Chess Partner,
or Fritz) in order to be used comfortably.  Read the documentation for
your GUI of choice for information about how to use Glaurung with your
GUI.

Glaurung 2-epsilon ("two minus epsilon") is a development version of
Glaurung 2, a complete rewrite of Glaurung.  It is still far from
complete, and lacks many important features like parallel search,
Multi-PV mode, and configurable engine parameters.  It is also likely
to not be entirely stable, especially when running in Microsoft
Windows.  For most users, it is probably advisable to keep using the
old Glaurung 1.2.1 until the rewritten program grows more mature.


2. Files

This distribution of Glaurung consists of the following files:

  * README, the file you are currently reading.

  * COPYING, a text file containing the GNU General Public License.

  * src/, a subdirectory containing the full source code, including a
    Makefile that can be used to compile Glaurung on Unix-like
    systems.  For further information about how to compile Glaurung
    yourself, read section 4 below.

  * MacOSX/, a subdirectory containing excutables for Apple Macintosh
    computers running Mac OS X.  There are three different
    executables, for use on Intel Macs, G4 Macs and G5 Macs.  The G5
    executable is untested and may not work, please report to
    tord@glaurungchess.com if you experience problems.

  * polyglot.ini, for using Glaurung with Fabien Letouzey's PolyGlot
    adapter.

Executable files for Linux and Windows will be added later.


3. Opening books

This version of Glaurung has experimental support for PolyGlot opening
books.  For information about how to create such books, consult the
PolyGlot documentation.  Currently, Glaurung requires that the book
file is named book.bin and is placed in Glaurung's working directory.


4. Compiling it yourself

On Unix-like systems, it should usually be possible to compile
Glaurung directly from the source code with the included Makefile.
The exception is computer with big-endian CPUs, like PowerPC
Macintoshes.  Some of the bitboard routines in the current version of
Glaurung are endianness-sensitive, and won't work on a big-endian
CPU.  In 32-bit big-endian mode, it should be sufficient to comment
out the line with "#define USE_32BIT_ATTACKS" near the top of
bitboard.h.  In 64-bit big-endian mode (like on the G5), further
changes may be necessary.

If you run Glaurung on a 64-bit little-endian CPU (like the Intel Core
2 Duo or a recent AMD CPU), the source code should compile and work
correctly without any changes, but it is possible that commenting out
the line with "#define USE_32BIT_ATTACKS" will yield a slightly
faster executable.


5. Terms of use

Glaurung is free, and distributed under the GNU General Public License
(GPL).  Essentially, this means that you are free to do almost exactly
what you want with the program, including distributing it among your
friends, making it available for download from your web site, selling
it (either by itself or as part of some bigger software package), or
using it as the starting point for a software project of your own.

The only real limitation is that whenever you distribute Glaurung in
some way, you must always include the full source code, or a pointer
to where the source code can be found.  If you make any changes to the
source code, these changes must also be made available under the GPL.

For full details, read the copy of the GPL found in the file named
COPYING.


6. Feedback

The author's e-mail address is tord@glaurungchess.com
