xref: /netbsd/games/gomoku/gomoku.6 (revision c4a72b64)
1.\"	$NetBSD: gomoku.6,v 1.9 2002/09/26 18:32:01 wiz Exp $
2.\"
3.\" Copyright (c) 1994
4.\"	The Regents of the University of California.  All rights reserved.
5.\"
6.\" This code is derived from software contributed to Berkeley by
7.\" Ralph Campbell.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\" 3. All advertising materials mentioning features or use of this software
18.\"    must display the following acknowledgement:
19.\"	This product includes software developed by the University of
20.\"	California, Berkeley and its contributors.
21.\" 4. Neither the name of the University nor the names of its contributors
22.\"    may be used to endorse or promote products derived from this software
23.\"    without specific prior written permission.
24.\"
25.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
26.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
29.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35.\" SUCH DAMAGE.
36.\"
37.\"     @(#)gomoku.6	8.2 (Berkeley) 8/4/94
38.\"
39.Dd August 4, 1994
40.Dt GOMOKU 6
41.Os
42.Sh NAME
43.Nm gomoku
44.Nd game of 5 in a row
45.Sh SYNOPSIS
46.Nm
47.Op Fl bcdu
48.Op Fl D Ar debugfile
49.Op Ar inputfile
50.Sh DESCRIPTION
51.Nm
52is a two player game were the object is to get 5 in a row horizontally,
53vertically or diagonally on a 19 by 19 grid.
54By convention, black always moves first.
55With no arguments,
56.Nm
57will display a playing board and prompt for moves from the user.
58Valid moves are a letter for the column and a number for the row of an empty
59board location.
60Entering ``quit" or ``resign" will end the game.
61You can save the current state of the game by entering ``save" and
62supplying a file name when prompted.
63The optional file
64.Ar inputfile
65can be used to restore a saved game.
66.Pp
67The options are:
68.Bl -tag -width Ds
69.It Fl b
70This option sets background mode.
71Input moves are read from standard input,
72the computer picks a move, and prints it to standard output.
73The first input line should be either ``black" or ``white" to specify whether
74.Nm
75has the first move or not respectively.
76This option was intended for game tournaments where a referee program handles
77the board display and pits one program against another.
78.It Fl c
79Computer versus computer.
80.Nm
81will play a game against itself.
82This is mostly used for testing.
83.It Fl d
84Print debugging information.
85Repeating this option more than once yields more detailed information.
86.It Fl D Ar debugfile
87Print the debug information to
88.Ar debugfile
89instead of to the standard output.
90.It Fl u
91User versus user.
92This is mostly used for testing.
93.El
94.Sh AUTHOR
95.An Ralph Campbell
96.Sh ACKNOWLEDGEMENTS
97The board display routines were based on the
98.Nm goref
99program written by Peter Langston.
100