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