.\" Automatically generated by Pod::Man version 1.15 .\" Fri Jan 13 15:56:30 2006 .\" .\" Standard preamble: .\" ====================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Ip \" List item .br .ie \\n(.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used .\" to do unbreakable dashes and therefore won't be available. \*(C` and .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<> .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and .\" index entries marked with X<> in POD. Of course, you'll have to process .\" the output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it .\" makes way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. .bd B 3 . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ====================================================================== .\" .IX Title ".::gnugo 6" .TH .::gnugo 6 "3.7.7" "2006-01-10" "User Contributed Perl Documentation" .UC .SH "NAME" gnugo \- The \s-1GNU\s0 program to play the game of Go .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBgnugo\fR [\fB\*(--boardsize ] [\fB\*(--color ] [\fB\*(--handicap ] [\fB\*(--komi ] [\fB\*(--quiet\fR] [\fB\-v, \-\-version\fR] [\fB\-h, \-\-help\fR] [\fB\*(--help debug\fR] [\fB\*(--copyright\fR] [\fB\*(--mode ] [\fB\*(--replay ] [\fB\-l, \-\-infile ] [\fB\-L, \-\-until ] [\fB\-o, \-\-outfile ] [\fB\*(--printsgf ] [\fB\-D, \-\-depth ] [\fB\-B, \-\-backfill_depth ] [\fB\*(--score [estimate|finish|aftermath]\fR ] [\fB\-a, \-\-allpats\fR] [\fB\-T, \-\-printboard\fR] [\fB\-d, \-\-debug ] [\fB\-w, \-\-worms\fR] [\fB\-m, \-\-moyo ] [\fB\-b, \-\-benchmark num\fR] [\fB\-t, \-\-trace\fR] [\fB\-r, \-\-seed num\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\s-1GNU\s0 Go plays a game of Go against the user. It has many other features: it can play against itself or another program, analyse and score a recorded game. \s-1GNU\s0 Go is compliant with Go modem protocol, load and save game in the Smart Game format. .PP \&\s-1GNU\s0 Go default is a simple alpha-numeric board display, but you can use a client such as \fBCGoban\fR. .Sh "The game of Go" .IX Subsection "The game of Go" Go is a game of strategy between two players usually played on a 19x19 grid called \fBgoban\fR. The two players put black and white \fBstones\fR on the goban to enclose \fBterritory\fR. Go was invented about 4000 years ago in ancient China. Other names for this game are (Chinese) \fBWei Chi\fR, (Korean) \&\fBBaduk\fR and (Ing) \fBGoe\fR. .Sh "Playing a game in \s-1ASCII\s0 mode" .IX Subsection "Playing a game in ASCII mode" To start a game with default options, just invoke \*(L"gnugo\*(R". The board will be drawn at your terminal using \s-1ASCII\s0 letters. In this mode, you can get help on available commands by the \fBh\fR key. To play as Black with 4 stones handicap, with a 0.5 komi, recording the game in the file record.sgf: .PP .Vb 1 \& gnugo --color black --handicap 4 --komi 0.5 -o record.sgf .Ve .Sh "Playing a game with CGoban" .IX Subsection "Playing a game with CGoban" CGoban 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 \s-1GNU\s0 Go under X Window System, obtain the most recent version of CGoban from Bill Shubert's web site .PP http://www.igoweb.org/~wms/comp/cgoban/index.html .PP 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 \s-1OK\s0, you get the Game Setup window. Choose ``Rules Set'' to be Japanese (otherwise handicaps won't work). Set the board size and handicap if you want. Click \s-1OK\s0 and you are ready to go. .PP In the Go Modem Protocol Setup window, when you specify the path to \s-1GNU\s0 Go, you can give it command line options, such as \-\-quiet to suppress most messages. Since the Go Modem Protocol preempts standard I/O, other messages are sent to stderr, even if they are not error messages. These will appear in the terminal from which you started CGoban. .Sh "Scoring system" .IX Subsection "Scoring system" The game stops when both players pass. \s-1GNU\s0 Go will attempt to compute and report the score to you. It may occasionally make mistakes due to wrong evaluation of the status of a group. You can check the score as follows. In \s-1ASCII\s0 mode, at the end of the game, stones believed dead are marked in lower case letters, and you have the option of toggling their status before counting. Using CGoban, you may use CGoban's counting facility to count the game using either Japanese or Chinese rules. .Sh "Viewing a stored game" .IX Subsection "Viewing a stored game" gnugo \fB\-l\fR filename.sgf \-\-mode ascii .PP loads filename.sgf and lets you navigate through the game by using the commands \fIforward\fR, \fIback\fR, \fIgoto\fR and \fIlast\fR. It is not possible to navigate through variations in ascii mode. You may also use CGoban to view stored games. CGoban can navigate variations. .Sh "Documentation" .IX Subsection "Documentation" The files in the \fIdoc\fR directory contain detailed documentation about debugging options and internal program structure. Other documentation may be found in comments throughout the source code. .Sh "Go Modem Protocol" .IX Subsection "Go Modem Protocol" The Go Modem Protocol is a standard interface between Go programs and graphical display. .PP 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. .Sh "Smart Game Format" .IX Subsection "Smart Game Format" Games (with comments, variations and other features) can be stored in the Smart Game Format (\s-1SGF\s0). This format originated in Anders Kierulf's program Smart Go. Martin Muller and Arno Hollosi developed the current standard, which may be found at .PP http://www.red-bean.com/sgf/ .PP \&\s-1GNU\s0 Go supports the Smart Game Format. .SH "OPTIONS" .IX Header "OPTIONS" .Sh "Main options" .IX Subsection "Main options" \&\fB\*(--mode \f(BImode\fB\fR .PP force the playing mode (\fIascii'\fR, \fIgtp\fR or \fIgmp\fR). Default is \&\s-1ASCII\s0. If no terminal is detected \s-1GMP\s0 (Go Modem Protocol) will be assumed. .PP \&\fB\*(--replay \f(BIcolor\fB\fR .PP replay the game generating moves for color, where color is \fIwhite\fR, \&\fIblack\fR, or \fIboth\fR. (requires \fB\-l\fR) .PP \&\fB\*(--quiet\fR .PP Don't print copyright and other informational messages. .PP \&\fB\-l, \-\-infile \f(BIfile\fB\fR .PP Load the \s-1SGF\s0 file (to score or analyze a recorded game). .PP \&\fB\-L, \-\-until \f(BImove\fB\fR .PP Stop loading just before \fImove\fR is played (e.g. 154 or L10). .PP \&\fB\-o, \-\-outfile \f(BIfile\fB\fR .PP Save the played game to \fIfile\fR in \s-1SGF\s0 format. .Sh "Game Options:" .IX Subsection "Game Options:" \&\fB\*(--boardsize \f(BInum\fB\fR .PP Set the board size to use (1\-19). Default is 19, other common formats are 13 and 9. .PP \&\fB\*(--color \f(BIcolor\fB\fR .PP Choose your color (\fIblack\fR or \fIwhite\fR). Black plays first, White gets the komi compensation. .PP \&\fB\*(--handicap \f(BInum\fB\fR .PP Set the number of handicap stones. .PP \&\fB\*(--komi \f(BInum\fB\fR .PP 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. .Sh "Informative Output:" .IX Subsection "Informative Output:" \&\fB\-v, \-\-version\fR .PP Display the version of \s-1GNU\s0 Go. .PP \&\fB\-h, \-\-help\fR .PP Display help message. .PP \&\fB\*(--help debug\fR .PP Display help about debugging options. .PP \&\fB\*(--copyright\fR .PP Display copyright notice. .Sh "Debugging and advanced options:" .IX Subsection "Debugging and advanced options:" \&\fB\-T, \-\-printboard\fR .PP Show board each move. .PP \&\fB\*(--level \f(BInum\fB\fR .PP Level of play. (default 10; smaller=faster, weaker). .PP \&\fB\-b, \-\-benchmark \f(BInum\fB\fR .PP Benchmarking mode \- can be used with \fB\-l\fR. .PP \&\fB\-t, \-\-trace\fR .PP Verbose tracing (use twice or more to trace reading). .PP \&\fB\-r, \-\-seed \f(BInum\fB\fR .PP Set random number seed. .PP \&\fB\*(--score [\f(BIestimate|finish|aftermath\fB]\fR .PP Count or estimate territory of the input file. Usage: .PP \&\fBgnugo \-\-score estimate \-l filename\fR .PP Loads the \s-1SGF\s0 file and estimates the score by measuring the influence. Use with \fB\-L\fR if you want the estimate somewhere else than at the end of the file. .PP \&\fBgnugo \-\-score finish \-l filename\fR .PP Loads the \s-1SGF\s0 file and gnugo continues to play by itself up to the very end. Then the winner is determined by counting the territory. .PP \&\fBgnugo \-\-score aftermath \-l filename\fR .PP Similar to \fB\*(--score finish\fR except that a more accurate but slower algorithm is used to determine the final status of the groups. .PP If the option \fB\-o outputfilename\fR is provided, the results will also be written as comment at the end of the output file. .PP \&\fB\*(--printsgf \f(BIoutfile\fB\fR .PP Load \s-1SGF\s0 file, output final position (requires \fB\-l\fR). .SH "BUGS" .IX Header "BUGS" If you find a bug, please send the \s-1SGF\s0 output file to gnugo@gnu.org together with a description of the bug.