no longer need -Wno-error=implicit-fallthrough. don't provide common symbols that...

[bsdgames-darwin.git] / gomoku / gomoku.6

diff --git a/gomoku/gomoku.6 b/gomoku/gomoku.6
index ea9a446fee24d2bed436f66d0fc95788d6f1b06f..1551493a789e666076aa291c8536db70a81a2ada 100644 (file)
--- a/gomoku/gomoku.6
+++ b/gomoku/gomoku.6
@@ -1,4 +1,4 @@
-.\"    $NetBSD: gomoku.6,v 1.12 2010/03/29 02:32:45 dholland Exp $
+.\"    $NetBSD: gomoku.6,v 1.15 2010/03/29 04:00:03 dholland Exp $

 .\"
 .\" Copyright (c) 1994
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
 .\" Copyright (c) 1994
 .\"    The Regents of the University of California.  All rights reserved.


@@ -32,7 +32,7 @@
 .\"
 .\"     @(#)gomoku.6   8.2 (Berkeley) 8/4/94
 .\"
 .\"
 .\"     @(#)gomoku.6   8.2 (Berkeley) 8/4/94
 .\"

-.Dd August 4, 1994
+.Dd March 28, 2010

 .Dt GOMOKU 6
 .Os
 .Sh NAME
 .Dt GOMOKU 6
 .Os
 .Sh NAME


@@ -42,35 +42,18 @@
 .Nm
 .Op Fl bcdu
 .Op Fl D Ar debugfile
 .Nm
 .Op Fl bcdu
 .Op Fl D Ar debugfile

-.Op Ar inputfile
+.Op Ar savefile

 .Sh DESCRIPTION
 .Nm
 is a two player game where the object is to get 5 in a row horizontally,
 vertically or diagonally on a 19 by 19 grid.
 By convention, black always moves first.
 .Sh DESCRIPTION
 .Nm
 is a two player game where the object is to get 5 in a row horizontally,
 vertically or diagonally on a 19 by 19 grid.
 By convention, black always moves first.

-With no arguments,
-.Nm
-will display a playing board and prompt for moves from the user.
-Valid moves are a letter for the column and a number for the row of an empty
-board location.
-Entering ``quit" or ``resign" will end the game.
-You can save the current state of the game by entering ``save" and
-supplying a file name when prompted.
-The optional file
-.Ar inputfile
-can be used to restore a saved game.

 .Pp
 The options are:
 .Bl -tag -width Ds
 .It Fl b
 .Pp
 The options are:
 .Bl -tag -width Ds
 .It Fl b

-This option sets background mode.
-Input moves are read from standard input,
-the computer picks a move, and prints it to standard output.
-The first input line should be either ``black" or ``white" to specify whether
-.Nm
-has the first move or not respectively.
-This option was intended for game tournaments where a referee program handles
-the board display and pits one program against another.
+Run in batch mode.
+.Pq See below.

 .It Fl c
 Computer versus computer.
 .Nm
 .It Fl c
 Computer versus computer.
 .Nm


@@ -85,11 +68,55 @@ Print the debug information to
 instead of to the standard output.
 .It Fl u
 User versus user.
 instead of to the standard output.
 .It Fl u
 User versus user.

+.Pq Play against yourself.

 This is mostly used for testing.
 This is mostly used for testing.

+.It Ar savefile
+Load a previously saved game from
+.Pa savefile .

 .El
 .El

+.Pp
+With no arguments,
+.Nm
+starts a fresh user vs. computer game.
+.Pp
+Moves may be entered by selecting the desired board location and
+pressing the space or enter key.
+The cursor may be moved using the arrow keys or
+.Xr vi 1
+motion keys
+.Em hjklyubn .
+These also may be familiar from
+.Xr rogue 6
+and
+.Xr hack 6 .
+.\" Valid moves are a letter for the column and a number for the row
+.\" of an empty board location.
+To quit, type
+.Sq Q ,
+and to save the game, type
+.Sq S
+and supply a file name when prompted.
+.Ss Batch mode
+Batch mode was intended for game tournaments where a referee program
+handles the board display and pits one program against another.
+In this mode,
+.Nm
+reads moves from standard input and writes its responses to standard
+output.
+The first line of input should be either
+.Dq black
+or
+.Dq white
+to specify whether
+.Nm
+has the first move or not respectively.

 .Sh AUTHORS
 .An Ralph Campbell
 .Sh ACKNOWLEDGEMENTS
 The board display routines were based on the
 .Nm goref
 program written by Peter Langston.
 .Sh AUTHORS
 .An Ralph Campbell
 .Sh ACKNOWLEDGEMENTS
 The board display routines were based on the
 .Nm goref
 program written by Peter Langston.

+The user interface was based on Eric S. Raymond's interface for
+.\" change this when/if we import openbsd's bs(6)
+.\" .Xr bs 6 .
+.Nm bs .