xref: /csrg-svn/games/gomoku/gomoku.6 (revision 67584)
167562Smckusick.\" Copyright (c) 1994
267562Smckusick.\"	The Regents of the University of California.  All rights reserved.
367562Smckusick.\"
467562Smckusick.\" This code is derived from software contributed to Berkeley by
567562Smckusick.\" Ralph Campbell.
667562Smckusick.\"
767562Smckusick.\" %sccs.include.redist.roff%
867562Smckusick.\"
9*67584Smckusick.\"     @(#)gomoku.6	8.2 (Berkeley) 08/04/94
1067562Smckusick.\"
1167562Smckusick.Dd
1267562Smckusick.Dt GOMOKU 6
1367562Smckusick.Os BSD 4.4
1467562Smckusick.Sh NAME
1567562Smckusick.Nm gomoku
1667562Smckusick.Nd game of 5 in a row
1767562Smckusick.Sh SYNOPSIS
1867562Smckusick.Nm gomoku
1967562Smckusick.Op Fl bcdu
2067562Smckusick.Op Fl D Ar debugfile
2167562Smckusick.Op Ar inputfile
2267562Smckusick.Sh DESCRIPTION
2367562Smckusick.Nm Gomoku
2467562Smckusickis a two player game were the object is to get 5 in a row horizontally,
2567562Smckusickvertically or diagonally on a 19 by 19 grid. By convention, black always
2667562Smckusickmoves first.
2767562SmckusickWith no arguments,
2867562Smckusick.Nm gomoku
2967562Smckusickwill display a playing board and prompt for moves from the user.
3067562SmckusickValid moves are a letter for the column and a number for the row of an empty
3167562Smckusickboard location. Entering ``quit" or ``resign" will end the game.
3267562SmckusickYou can save the current state of the game by entering ``save" and
3367562Smckusicksupplying a file name when prompted.
3467562SmckusickThe optional file
3567562Smckusick.Ar inputfile
3667562Smckusickcan be used to restore a saved game.
3767562Smckusick.Pp
3867562SmckusickThe options are:
3967562Smckusick.Bl -tag -width Ds
4067562Smckusick.It Fl b
4167562SmckusickThis option sets background mode. Input moves are read from standard input,
4267562Smckusickthe computer picks a move, and prints it to standard output. The first
4367562Smckusickinput line should be either ``black" or ``white" to specify whether
4467562Smckusick.Nm gomoku
4567562Smckusickhas the first move or not respectively. This
4667562Smckusickoption was intended for game tournaments where a referee program handles
4767562Smckusickthe board display and pits one program against another.
4867562Smckusick.It Fl c
4967562SmckusickComputer verses computer.
5067562Smckusick.Nm Gomoku
5167562Smckusickwill play a game against itself. This is mostly used for testing.
5267562Smckusick.It Fl d
5367562SmckusickPrint debugging information. Repeating this option more than
5467562Smckusickonce yields more detailed information.
5567562Smckusick.It Fl D Ar debugfile
5667562SmckusickPrint the debug information to
5767562Smckusick.Ar debugfile
5867562Smckusickinstead of to the standard output.
5967562Smckusick.It Fl u
6067562SmckusickUser verses user. This is mostly used for testing.
6167562Smckusick.Sh AUTHOR
6267562SmckusickRalph Campbell
63*67584Smckusick.Sh ACKNOWLEDGEMENTS
64*67584SmckusickThe board display routines were based on the
65*67584Smckusick.Nm goref
66*67584Smckusickprogram written by Peter Langston.
67