1INSTALL of GNU Chess
2
3  Copyright (C) 2001-2012 Free Software Foundation, Inc.
4
5  Copying and distribution of this file, with or without modification,
6  are permitted in any medium without royalty provided the copyright
7  notice and this notice are preserved.
8
9The usual procedure should apply. After you have unpacked
10the sources, type (in the sources top-level directory)
11
12	./configure
13	make
14
15You may also pass several other options such as compiler options
16to configure, just type ./configure --help for advice. In particular,
17you may experiment with compiler optimization flags, which are added
18easily as (assuming you have a bourne-type shell)
19
20CFLAGS="-O3 -ffast-math" ./configure
21
22The build should work with gcc. It should also work with other
23compilers.
24
25Test gnuchess by typing
26
27	cd src
28	./gnuchess on GNU/Linux / Unix / Mac OS X
29	easy
30	new
31	post
32	depth 8
33	go
34	quit
35
36You should see an 8-ply search. Most machines these
37days should finish it within a few seconds. If not,
38Control-C out, and do
39
40	depth 6
41	go
42	quit
43
44instead.
45
46If you got this far, congratulations.
47
48If you want to install the software in some global directory,
49by default /usr/local, become root and type
50
51	make install
52
53If you want to install the sources in some other directory
54than /usr/local, replace the first line by
55
56	./configure --prefix=/my/favourite/dir
57
58You can build an opening book which may enhance the value
59of gnuchess quite a lot. In order to do so, get the file
60book_1.02.pgn (http://ftp.gnu.org/gnu/chess/book_1.02.pgn.gz)
61and type the following.
62
63	./gnuchess
64	book add book_1.02.pgn
65	quit
66
67This may take some minutes, depending on the speed of your
68machines. The book is quite large (180,000 master games).
69If you want a smaller book or you do not want to wait, do the
70following instead:
71
72	head -30000 book_1.02.pgn > smallbook.pgn
73	./gnuchess
74	book add smallbook.pgn
75	quit
76
77This will make a much smaller book.
78
79In order to use the book, edit gnuchess.ini and set the value of
80'Book' or 'OwnBook' to true.
81
82You can run the program in UCI mode, which makes it externally behave as
83a UCI engine. This is not intended for interactive usage, but for backend
84engine of a UCI-enabled chess graphical interface. Type the following:
85
86	./gnuchess -u
87