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