Initial import from FreeBSD RELENG_4:
[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 .\"
35 .TH BACKGAMMON 6  "May 31, 1993"
36 .UC 5
37 .SH NAME
38 backgammon \- the game of backgammon
39 .SH SYNOPSIS
40 .B backgammon
41 [ -h n r w b pr pw pb t\c
42 .I term
43 s\c
44 .I file
45 ]
46 .SH DESCRIPTION
47 This program lets you play backgammon against the computer
48 or against a "friend".
49 All commands only are one letter,
50 so you don't need to type a carriage return,
51 except at the end of a move.
52 The program is mostly self documenting,
53 so that a question mark (?) will usually get some help.
54 If you answer `y' when the program asks if you want the rules,
55 you will get text explaining the rules of the game,
56 some hints on strategy,
57 instruction on how to use the program,
58 and a tutorial consisting of a practice game against the computer.
59 A description of how to use the program can be
60 obtained by answering `y' when it asks if you want instructions.
61 .PP
62 The possible arguments for backgammon
63 (most are unnecessary but some are very convenient)
64 consist of:
65 .ne 11
66 .PP
67 .na
68 .TP 8
69 .B -h
70 Get a description of possible arguments and exit
71 .TP 8
72 .B -n
73 don't ask for rules or instructions
74 .TP 8
75 .B -r
76 player is red (implies -n)
77 .TP 8
78 .B -w
79 player is white (implies -n)
80 .TP 8
81 .B -b
82 two players, red and white (implies -n)
83 .TP 8
84 .B -pr
85 print the board before red's turn
86 .TP 8
87 .B -pw
88 print the board before white's turn
89 .TP 8
90 .B -pb
91 print the board before both player's turn
92 .TP 8
93 .B -t\fIterm
94 terminal is type
95 .IR term ,
96 uses /etc/termcap
97 .TP 8
98 .B -s\fIfile
99 recover previously saved game from
100 .IR file .
101 .ad
102 .PP
103 .PP
104 If
105 .IR term
106 has capabilities for direct cursor movement (see
107 .IR termcap (5))
108 .IR backgammon
109 ``fixes'' the board after each move,
110 so the board does not need to be reprinted,
111 unless the screen suffers some horrendous malady.
112 Also, any `-p' option will be ignored.
113 (The `-t' option is not necessary unless the terminal type does not match
114 the entry in the /etc/termcap data base.)
115 .SH QUICK\ REFERENCE
116 When the program prompts by typing only your color,
117 type a space or carriage return to roll, or
118 .ne 5
119 .PP
120 .na
121 .TP 8
122 .B d
123 to double
124 .TP 8
125 .B p
126 to print the board
127 .TP 8
128 .B q
129 to quit
130 .TP 8
131 .B s
132 to save the game for later
133 .PP
134 .i0
135 .ad
136 When the program prompts with 'Move:', type
137 .ne 4
138 .PP
139 .na
140 .TP 8
141 .B p
142 to print the board
143 .TP 8
144 .B q
145 to quit
146 .TP 8
147 .B s
148 to save the game
149 .ad
150 .i0
151 .PP
152 or a
153 .IR move ,
154 which is a sequence of
155 .ne 4
156 .PP
157 .na
158 .TP 8
159 .B s-f
160 move from
161 .BR s
162 to
163 .BR f
164 .TP 8
165 .B s/r
166 move one man on
167 .BR s
168 the roll
169 .BR r
170 .ad
171 .PP
172 separated by commas or spaces and ending with a newline.
173 Available abbreviations are
174 .ne 4
175 .PP
176 .na
177 .TP 10
178 .B s-f1-f2
179 means
180 .BR s-f1,f1-f2
181 .TP 10
182 .B s/r1r2
183 means
184 .BR s/r1,s/r2
185 .ad
186 .PP
187 Use `b' for bar and `h' for home,
188 or 0 or 25 as appropriate.
189 .SH AUTHOR
190 Alan Char
191 .SH FILES
192 .TP 25
193 /usr/games/teachgammon
194 \- rules and tutorial
195 .br
196 .TP 25
197 /etc/termcap
198 \- terminal capabilities
199 .SH BUGS
200 The program's strategy needs much work.