1.::gnugo(6) User Contributed Perl Documentation .::gnugo(6)
2
3
4
6 gnugo - The GNU program to play the game of Go
7
9 ggnnuuggoo [----bbooaarrddssiizzee <<nnuumm>] [----ccoolloorr <<ccoolloorr>] [----hhaannddiiccaapp <<nnuumm>] [----kkoommii
10 <<nnuumm>] [----qquuiieett] [--vv,, ----vveerrssiioonn] [--hh,, ----hheellpp] [----hheellpp ddeebbuugg] [----ccooppyy‐‐
11 rriigghhtt] [----mmooddee <<mmooddee>] [----rreeppllaayy <<ccoolloorr>] [--ll,, ----iinnffiillee <<ffiilleennaammee>]
12 [--LL,, ----uunnttiill <<mmoovvee>] [--oo,, ----oouuttffiillee <<ffiilleennaammee>] [----pprriinnttssggff <<ffiilleennaammee>]
13 [--DD,, ----ddeepptthh <<nnuumm>] [--BB,, ----bbaacckkffiillll__ddeepptthh <<nnuumm>] [----ssccoorree [[eessttii‐‐
14 mmaattee⎪⎪ffiinniisshh⎪⎪aafftteerrmmaatthh]] ] [--aa,, ----aallllppaattss] [--TT,, ----pprriinnttbbooaarrdd] [--dd,,
15 ----ddeebbuugg <<lleevveell>] [--ww,, ----wwoorrmmss] [--mm,, ----mmooyyoo <<lleevveell>] [--bb,, ----bbeenncchhmmaarrkk
16 nnuumm] [--tt,, ----ttrraaccee] [--rr,, ----sseeeedd nnuumm]
17
19 GNU Go plays a game of Go against the user. It has many other features:
20 it can play against itself or another program, analyse and score a
21 recorded game. GNU Go is compliant with Go modem protocol, load and
22 save game in the Smart Game format.
23
24 GNU Go default is a simple alpha-numeric board display, but you can use
25 a client such as CCGGoobbaann.
26
27 TThhee ggaammee ooff GGoo
28
29 Go is a game of strategy between two players usually played on a 19x19
30 grid called ggoobbaann. The two players put black and white ssttoonneess on the
31 goban to enclose tteerrrriittoorryy. Go was invented about 4000 years ago in
32 ancient China. Other names for this game are (Chinese) WWeeii CChhii,
33 (Korean) BBaadduukk and (Ing) GGooee.
34
35 PPllaayyiinngg aa ggaammee iinn AASSCCIIII mmooddee
36
37 To start a game with default options, just invoke "gnugo". The board
38 will be drawn at your terminal using ASCII letters. In this mode, you
39 can get help on available commands by the hh key. To play as Black with
40 4 stones handicap, with a 0.5 komi, recording the game in the file
41 record.sgf:
42
43 gnugo --color black --handicap 4 --komi 0.5 -o record.sgf
44
45
46 PPllaayyiinngg aa ggaammee wwiitthh CCGGoobbaann
47
48 CGoban is a general purpose client program by Bill Shubert for playing
49 Go. It runs under X Window System with a beautiful resizeable graphic
50 display. To use GNU Go under X Window System, obtain the most recent
51 version of CGoban from Bill Shubert's web site
52
53 http://www.igoweb.org/~wms/comp/cgoban/index.html
54
55 Start CGoban. When the CGoban Control panel comes up, select `Go
56 Modem.' You will get the Go Modem Protocol Setup. Choose one (or both)
57 of the players to be ``Program,'' and fill out the box to the path to
58 gnugo. After clicking OK, you get the Game Setup window. Choose ``Rules
59 Set'' to be Japanese (otherwise handicaps won't work). Set the board
60 size and handicap if you want. Click OK and you are ready to go.
61
62 In the Go Modem Protocol Setup window, when you specify the path to GNU
63 Go, you can give it command line options, such as --quiet to suppress
64 most messages. Since the Go Modem Protocol preempts standard I/O, other
65 messages are sent to stderr, even if they are not error messages. These
66 will appear in the terminal from which you started CGoban.
67
68 SSccoorriinngg ssyysstteemm
69
70 The game stops when both players pass. GNU Go will attempt to compute
71 and report the score to you. It may occasionally make mistakes due to
72 wrong evaluation of the status of a group. You can check the score as
73 follows. In ASCII mode, at the end of the game, stones believed dead
74 are marked in lower case letters, and you have the option of toggling
75 their status before counting. Using CGoban, you may use CGoban's
76 counting facility to count the game using either Japanese or Chinese
77 rules.
78
79 VViieewwiinngg aa ssttoorreedd ggaammee
80
81 gnugo --ll filename.sgf --mode ascii
82
83 loads filename.sgf and lets you navigate through the game by using the
84 commands forward, back, goto and last. It is not possible to navigate
85 through variations in ascii mode. You may also use CGoban to view
86 stored games. CGoban can navigate variations.
87
88 DDooccuummeennttaattiioonn
89
90 The files in the doc directory contain detailed documentation about
91 debugging options and internal program structure. Other documentation
92 may be found in comments throughout the source code.
93
94 GGoo MMooddeemm PPrroottooccooll
95
96 The Go Modem Protocol is a standard interface between Go programs and
97 graphical display.
98
99 The Go Modem Protocol was developed by Bruce Wilcox with input from
100 David Fotland, Anders Kierulf and others. Any Go program *should* use
101 this protocol since it is standard. Since CGoban supports this proto‐
102 col, the user interface for any Go program can be done entirely through
103 CGoban. Using the Go Modem Protocol, you can play with another computer
104 running a different program (even on a different operating system)
105 using a modem, a serial cable or over the internet if the other program
106 also supports the protocol. You can also communicate with the Go
107 servers using CGoban.
108
109 SSmmaarrtt GGaammee FFoorrmmaatt
110
111 Games (with comments, variations and other features) can be stored in
112 the Smart Game Format (SGF). This format originated in Anders Kierulf's
113 program Smart Go. Martin Muller and Arno Hollosi developed the current
114 standard, which may be found at
115
116 http://www.red-bean.com/sgf/
117
118 GNU Go supports the Smart Game Format.
119
121 MMaaiinn ooppttiioonnss
122
123 ----mmooddee mode
124
125 force the playing mode (ascii', gtp or gmp). Default is ASCII. If no
126 terminal is detected GMP (Go Modem Protocol) will be assumed.
127
128 ----rreeppllaayy color
129
130 replay the game generating moves for color, where color is white,
131 black, or both. (requires --ll)
132
133 ----qquuiieett
134
135 Don't print copyright and other informational messages.
136
137 --ll,, ----iinnffiillee file
138
139 Load the SGF file (to score or analyze a recorded game).
140
141 --LL,, ----uunnttiill move
142
143 Stop loading just before move is played (e.g. 154 or L10).
144
145 --oo,, ----oouuttffiillee file
146
147 Save the played game to file in SGF format.
148
149 GGaammee OOppttiioonnss::
150
151 ----bbooaarrddssiizzee num
152
153 Set the board size to use (1-19). Default is 19, other common formats
154 are 13 and 9.
155
156 ----ccoolloorr color
157
158 Choose your color (black or white). Black plays first, White gets the
159 komi compensation.
160
161 ----hhaannddiiccaapp num
162
163 Set the number of handicap stones.
164
165 ----kkoommii num
166
167 Set the komi (points given to white player to compensate advantage of
168 the first move, usually 5.5 or 0.5). Default is 5.5.
169
170 IInnffoorrmmaattiivvee OOuuttppuutt::
171
172 --vv,, ----vveerrssiioonn
173
174 Display the version of GNU Go.
175
176 --hh,, ----hheellpp
177
178 Display help message.
179
180 ----hheellpp ddeebbuugg
181
182 Display help about debugging options.
183
184 ----ccooppyyrriigghhtt
185
186 Display copyright notice.
187
188 DDeebbuuggggiinngg aanndd aaddvvaanncceedd ooppttiioonnss::
189
190 --TT,, ----pprriinnttbbooaarrdd
191
192 Show board each move.
193
194 ----lleevveell num
195
196 Level of play. (default 10; smaller=faster, weaker).
197
198 --bb,, ----bbeenncchhmmaarrkk num
199
200 Benchmarking mode - can be used with --ll.
201
202 --tt,, ----ttrraaccee
203
204 Verbose tracing (use twice or more to trace reading).
205
206 --rr,, ----sseeeedd num
207
208 Set random number seed.
209
210 ----ssccoorree [[estimate⎪finish⎪aftermath]]
211
212 Count or estimate territory of the input file. Usage:
213
214 ggnnuuggoo ----ssccoorree eessttiimmaattee --ll ffiilleennaammee
215
216 Loads the SGF file and estimates the score by measuring the influence.
217 Use with --LL if you want the estimate somewhere else than at the end of
218 the file.
219
220 ggnnuuggoo ----ssccoorree ffiinniisshh --ll ffiilleennaammee
221
222 Loads the SGF file and gnugo continues to play by itself up to the very
223 end. Then the winner is determined by counting the territory.
224
225 ggnnuuggoo ----ssccoorree aafftteerrmmaatthh --ll ffiilleennaammee
226
227 Similar to ----ssccoorree ffiinniisshh except that a more accurate but slower algo‐
228 rithm is used to determine the final status of the groups.
229
230 If the option --oo oouuttppuuttffiilleennaammee is provided, the results will also be
231 written as comment at the end of the output file.
232
233 ----pprriinnttssggff outfile
234
235 Load SGF file, output final position (requires --ll).
236
238 If you find a bug, please send the SGF output file to gnugo@gnu.org
239 together with a description of the bug.
240
241
242
2433rd Berkeley Distribution 3.7.7 .::gnugo(6)