ncurses 6.0 - patch 20151226
[ncurses.git] / test / bs.6
1 .\"***************************************************************************
2 .\" Copyright (c) 1998,2006 Free Software Foundation, Inc.                   *
3 .\"                                                                          *
4 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
5 .\" copy of this software and associated documentation files (the            *
6 .\" "Software"), to deal in the Software without restriction, including      *
7 .\" without limitation the rights to use, copy, modify, merge, publish,      *
8 .\" distribute, distribute with modifications, sublicense, and/or sell       *
9 .\" copies of the Software, and to permit persons to whom the Software is    *
10 .\" furnished to do so, subject to the following conditions:                 *
11 .\"                                                                          *
12 .\" The above copyright notice and this permission notice shall be included  *
13 .\" in all copies or substantial portions of the Software.                   *
14 .\"                                                                          *
15 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
16 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
17 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
18 .\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
19 .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
20 .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
21 .\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
22 .\"                                                                          *
23 .\" Except as contained in this notice, the name(s) of the above copyright   *
24 .\" holders shall not be used in advertising or otherwise to promote the     *
25 .\" sale, use or other dealings in this Software without prior written       *
26 .\" authorization.                                                           *
27 .\"***************************************************************************
28 .\"
29 .\" $Id: bs.6,v 1.2 2006/04/22 22:42:44 tom Exp $
30 .TH BATTLESHIPS 6 "Aug 23, 1989"
31 .SH NAME
32 bs \- battleships game
33 .SH SYNOPSIS
34 battle [ -b | -s ] [ -c ]
35 .SH DESCRIPTION
36 This program allows you to play the familiar Battleships game against the
37 computer on a 10x10 board. The interface is visual and largely
38 self-explanatory; you place your ships and pick your shots by moving the
39 cursor around the `sea' with the rogue/hack motion keys hjklyubn.
40 .PP
41 Note that when selecting a ship to place, you must type the capital letter
42 (these are, after all, capital ships). During ship placement, the `r' command
43 may be used to ignore the current position and randomly place your currently
44 selected ship. The `R' command will place all remaining ships randomly. The ^L
45 command (form feed, ASCII 12) will force a screen redraw).
46 .PP
47 The command-line arguments control game modes. 
48
49 .nf
50         -b selects a `blitz' variant
51         -s selects a `salvo' variant
52         -c permits ships to be placed adjacently
53 .fi
54
55 The `blitz' variant allows a side to shoot for as long as it continues to
56 score hits.
57 .PP
58 The `salvo' game allows a player one shot per turn for each of his/her ships
59 still afloat.  This puts a premium scoring hits early and knocking out some
60 ships and also makes much harder the situation where you face a superior force
61 with only your PT-boat.
62 .PP
63 Normally, ships must be separated by at least one square of open water. The
64 -c option disables this check and allows them to close-pack.
65 .PP
66 The algorithm the computer uses once it has found a ship to sink is provably
67 optimal. The dispersion criterion for the random-fire algorithm may not be.
68 .SH AUTHORS
69 Originally written by one Bruce Holloway in 1986. Salvo mode added by Chuck A.
70 DeGaul (cbosgd!cad). Visual user interface, `closepack' option, code rewrite
71 and manual page by Eric S. Raymond <esr@snark.thyrsus.com> August 1989.