Automatically generated by Pod::Man version 1.15 Fri Jan 13 15:56:30 2006 Standard preamble: ======================================================================
NAMEgnugo - The
SYNOPSISgnugo [---boardsize <num>] [---color <color>] [---handicap <num>] [---komi <num>] [---quiet] [-v, --version] [-h, --help] [---help debug] [---copyright] [---mode <mode>] [---replay <color>] [-l, --infile <filename>] [-L, --until <move>] [-o, --outfile <filename>] [---printsgf <filename>] [-D, --depth <num>] [-B, --backfill_depth <num>] [---score [estimate|finish|aftermath] ] [-a, --allpats] [-T, --printboard] [-d, --debug <level>] [-w, --worms] [-m, --moyo <level>] [-b, --benchmark num] [-t, --trace] [-r, --seed num]
The game of GoGo is a game of strategy between two players usually played on a 19x19 grid called goban. The two players put black and white stones on the goban to enclose territory. Go was invented about 4000 years ago in ancient China. Other names for this game are (Chinese) Wei Chi, (Korean) Baduk and (Ing) Goe.
Playing a game in ASCII mode
To start a game with default options, just invoke ``gnugo''. The board will be
drawn at your terminal using
gnugo --color black --handicap 4 --komi 0.5 -o record.sgf
Playing a game with CGobanCGoban is a general purpose client program by Bill Shubert for playing Go. It runs under X Window System with a beautiful resizeable graphic display. To use
Start CGoban. When the CGoban Control panel comes up, select `Go Modem.' You will get the Go Modem Protocol Setup. Choose one (or both) of the players to be ``Program,'' and fill out the box to the path to gnugo. After clicking
In the Go Modem Protocol Setup window, when you specify the path to
Scoring systemThe game stops when both players pass.
Viewing a stored gamegnugo -l filename.sgf --mode ascii
loads filename.sgf and lets you navigate through the game by using the commands forward, back, goto and last. It is not possible to navigate through variations in ascii mode. You may also use CGoban to view stored games. CGoban can navigate variations.
DocumentationThe files in the doc directory contain detailed documentation about debugging options and internal program structure. Other documentation may be found in comments throughout the source code.
Go Modem ProtocolThe Go Modem Protocol is a standard interface between Go programs and graphical display.
The Go Modem Protocol was developed by Bruce Wilcox with input from David Fotland, Anders Kierulf and others. Any Go program *should* use this protocol since it is standard. Since CGoban supports this protocol, the user interface for any Go program can be done entirely through CGoban. Using the Go Modem Protocol, you can play with another computer running a different program (even on a different operating system) using a modem, a serial cable or over the internet if the other program also supports the protocol. You can also communicate with the Go servers using CGoban.
Smart Game FormatGames (with comments, variations and other features) can be stored in the Smart Game Format (
Main options---mode mode
force the playing mode (ascii', gtp or gmp). Default is
replay the game generating moves for color, where color is white, black, or both. (requires -l)
Don't print copyright and other informational messages.
-l, --infile file
-L, --until move
Stop loading just before move is played (e.g. 154 or L10).
-o, --outfile file
Save the played game to file in
Game Options:---boardsize num
Set the board size to use (1-19). Default is 19, other common formats are 13 and 9.
Choose your color (black or white). Black plays first, White gets the komi compensation.
Set the number of handicap stones.
Set the komi (points given to white player to compensate advantage of the first move, usually 5.5 or 0.5). Default is 5.5.
Informative Output:-v, --version
Display the version of
Display help message.
Display help about debugging options.
Display copyright notice.
Debugging and advanced options:-T, --printboard
Show board each move.
Level of play. (default 10; smaller=faster, weaker).
-b, --benchmark num
Benchmarking mode - can be used with -l.
Verbose tracing (use twice or more to trace reading).
-r, --seed num
Set random number seed.
Count or estimate territory of the input file. Usage:
gnugo --score estimate -l filename
gnugo --score finish -l filename
gnugo --score aftermath -l filename
Similar to ---score finish except that a more accurate but slower algorithm is used to determine the final status of the groups.
If the option -o outputfilename is provided, the results will also be written as comment at the end of the output file.