Merge from vendor branch OPENSSH:
[dragonfly.git] / games / backgammon / backgammon / backgammon.6
1 .\" Copyright (c) 1980, 1993
2 .\"     The Regents of the University of California.  All rights reserved.
3 .\"
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
6 .\" are met:
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\"    notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\"    notice, this list of conditions and the following disclaimer in the
11 .\"    documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\"    must display the following acknowledgement:
14 .\"     This product includes software developed by the University of
15 .\"     California, Berkeley and its contributors.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\"    may be used to endorse or promote products derived from this software
18 .\"    without specific prior written permission.
19 .\"
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30 .\" SUCH DAMAGE.
31 .\"
32 .\"     @(#)backgammon.6        8.1 (Berkeley) 5/31/93
33 .\" $FreeBSD: src/games/backgammon/backgammon/backgammon.6,v 1.7.2.1 2001/07/22 11:01:21 dd Exp $
34 .\" $DragonFly: src/games/backgammon/backgammon/backgammon.6,v 1.4 2007/10/20 17:56:46 swildner Exp $
35 .\"
36 .Dd May 31, 1993
37 .Dt BACKGAMMON 6
38 .Os
39 .Sh NAME
40 .Nm backgammon
41 .Nd the game of backgammon
42 .Sh SYNOPSIS
43 .Nm
44 .Op Fl hnrwb
45 .Op Fl pr
46 .Op Fl pw
47 .Op Fl pb
48 .Op Fl t Ar term
49 .Op Fl s Ar file
50 .Sh DESCRIPTION
51 This program lets you play backgammon against the computer
52 or against a "friend".
53 All commands are only one letter, so you don't need to type a carriage return,
54 except at the end of a move.
55 The program is mostly self-explanatory,
56 so that a question mark (?) will usually get some help.
57 If you answer `y' when the program asks if you want the rules,
58 you will get text explaining the rules of the game, some hints on strategy,
59 instructions on how to use the program,
60 and a tutorial consisting of a practice game against the computer.
61 A description of how to use the program can be
62 obtained by answering `y' when it asks if you want instructions.
63 .Pp
64 The possible arguments for
65 .Nm
66 (most are unnecessary but some are very convenient)
67 consist of:
68 .Bl -tag -width ".Fl pr"
69 .It Fl h
70 get a description of possible arguments and exit
71 .It Fl n
72 don't ask for rules or instructions
73 .It Fl r
74 player is red (implies
75 .Fl n )
76 .It Fl w
77 player is white (implies
78 .Fl n )
79 .It Fl b
80 two players, red and white (implies
81 .Fl n )
82 .It Fl pr
83 print the board before red's turn
84 .It Fl pw
85 print the board before white's turn
86 .It Fl pb
87 print the board before both player's turn
88 .It Fl t Ar term
89 terminal is type
90 .Ar term ,
91 uses
92 .Pa /usr/share/misc/termcap
93 .It Fl s Ar file
94 recover previously saved game from
95 .Ar file
96 .El
97 .Pp
98 If
99 .Ar term
100 has capabilities for direct cursor movement (see
101 .Xr termcap 5 )
102 .Nm
103 ``fixes'' the board after each move,
104 so the board does not need to be reprinted,
105 unless the screen suffers some horrendous malady.
106 Also, any `p' option will be ignored.
107 (The `t' option is not necessary unless the terminal type does not match
108 the entry in the
109 .Pa /usr/share/misc/termcap
110 data base.)
111 .Sh QUICK REFERENCE
112 When the program prompts by typing only your color,
113 type a space or carriage return to roll, or
114 .Bl -tag -width ".Ic s-f"
115 .It Ic d
116 to double
117 .It Ic p
118 to print the board
119 .It Ic q
120 to quit
121 .It Ic s
122 to save the game for later
123 .El
124 .Pp
125 When the program prompts with 'Move:', type
126 .Bl -tag -width ".Ic s-f"
127 .It Ic p
128 to print the board
129 .It Ic q
130 to quit
131 .It Ic s
132 to save the game
133 .El
134 .Pp
135 or a
136 .Em move ,
137 which is a sequence of
138 .Bl -tag -width ".Ic s-f"
139 .It Ic s-f
140 move from
141 .Ic s
142 to
143 .Ic f
144 .It Ic s/r
145 move one man on
146 .Ic s
147 the roll
148 .Ic r
149 separated by commas or spaces and ending with a newline.
150 Available abbreviations are
151 .Bl -tag -width ".Ic s-f1-f2"
152 .It Ic s-f1-f2
153 means
154 .Ic s-f1,f1-f2
155 .It Ic s/r1r2
156 means
157 .Ic s/r1,s/r2
158 .El
159 .El
160 .Pp
161 Use
162 .Ic b
163 for bar and
164 .Ic h
165 for home,
166 or 0 or 25 as appropriate.
167 .Sh FILES
168 .Bl -tag -width ".Pa /usr/share/misc/termcap" -compact
169 .It Pa /usr/games/teachgammon
170 rules and tutorial
171 .It Pa /usr/share/misc/termcap
172 terminal capabilities
173 .El
174 .Sh AUTHORS
175 .An Alan Char
176 .Sh BUGS
177 The program's strategy needs much work.