File: INSTALL

package info (click to toggle)
gnugo-dv 3.1.27-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 6,724 kB
  • ctags: 3,307
  • sloc: ansic: 46,051; perl: 1,303; sh: 710; makefile: 578; tcl: 401; lisp: 193
file content (138 lines) | stat: -rw-r--r-- 4,898 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
                 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-3.0.0. Now do:

   ./configure [OPTIONS]
   make

The most important configure options, cache size, default level
and dfa will be explained in detail below. For example

   ./configure --enable-cache-size=32 --enable-level=8

creates a 48 Mb cache in RAM and sets the level to 8.  Both these
defaults can be overridden at run time.

If you do not specify any options, the default level is 10 (highest
supported) and the default cache size is 16. 

If you have a slow machine or find GNU Go too slow you may want
to decrease the default level. At level 8 the engine is

Increasing the cache size will improve performance up to a point ---
once the cache is so large that it cannot be kept in RAM, GNU Go will
start swapping (characterized by frequent hard drive accesses) and
performance will degrade.

You have now made 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 different methods of using GNU Go. You may run it from the
command line by just typing:

   gnugo

but it is nicer to run it using CGoban 1 (under X-Windows) or Jago
(on any platform with a Java runtime environment).

Obtain the most recent version of CGoban 1 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. CGoban 2 will not work.

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

                          RAM CACHE

By default, GNU Go makes a cache of 16 Megabytes in RAM for its
internal use. The cache is used to store intermediate results during
its analysis of the position.

Increasing the cache size will often give a modest speed improvement.
If your system has lots of RAM, consider increasing the cache
size. But if the cache is too large, swapping will occur,
causing hard drive accesses and degrading performance. If
your hard drive seems to be running excessively your cache
may be too large. On GNU/Linux systems, you may detect swapping
using the program 'top'. Use the 'f' command to toggle SWAP
display.

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

   ./configure --enable-cache-size=n

To set the cache size to n. For example

   ./configure --enable-cache-size=48

creates a cache of size 48. If you omit this, your default
cache size will be 16. You must recompile and reinstall GNU Go
after reconfiguring it by running make and make install.

You may override the compile-time defaults by running gnugo with
the option `--cache-size n', where n is the size (in megabytes) of 
the cache you want, and `--level n' where n is the level desired.
We will discuss setting these parameters next in detail.

                        DEFAULT LEVEL

GNU Go can play at different levels. Up to level 10 is
supported. At level 10 GNU Go is much more accurate but takes
an average of about 1.6 times longer to play than at level 8.

The level can be set at run time using the --level option.
If you don't set this, the default level will be used. You
can set the default level with the configure option
--enable-level=n. For example

./configure --enable-level=9

sets the default level to 9. If you omit this parameter,
the compiler sets the default level to 8. We recommend
using level 10 unless you find it too slow. If you decide
you want to change the default you may rerun configure
and recompile the program.

                            DFA

If you './configure --enable-dfa' you get the experimental DFA
(Discrete Finite-State Automata) pattern matcher. This will
result in a faster engine. The option is considered
experimental because it is new and harder to debug but sufficiently
tested that it is probably safe.

                            WINDOWS

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

                           MACINTOSH

If you have Mac OS X you can build GNU Go using Apple's compiler, 
which is derived from GCC. We recommend adding the flag -no-cpp-precomp
to CFLAGS.

                          THE MANUAL

You can obtain  a printed copy of the  manual by running 'make
gnugo.ps' in  the doc/ directory, then  printing the resulting
postscript file  @file{gnugo.ps}. The manual  contains a great
deal of information about the algorithms of GNU Go. The first
few sections serve as a user's manual.

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'.