Merge from vendor branch LESS:
[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.3 2007/03/11 19:05:31 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 backgammon
65 (most are unnecessary but some are very convenient)
66 consist of:
67 .Bl -tag -width ".Fl pr"
68 .It Fl h
69 get a description of possible arguments and exit
70 .It Fl n
71 don't ask for rules or instructions
72 .It Fl r
73 player is red (implies
74 .Fl n )
75 .It Fl w
76 player is white (implies
77 .Fl n )
78 .It Fl b
79 two players, red and white (implies
80 .Fl n )
81 .It Fl pr
82 print the board before red's turn
83 .It Fl pw
84 print the board before white's turn
85 .It Fl pb
86 print the board before both player's turn
87 .It Fl t Ar term
88 terminal is type
89 .Ar term ,
90 uses
91 .Pa /usr/share/misc/termcap
92 .It Fl s Ar file
93 recover previously saved game from
94 .Ar file
95 .El
96 .Pp
97 If
98 .Ar term
99 has capabilities for direct cursor movement (see
100 .Xr termcap 5 )
101 .Nm
102 ``fixes'' the board after each move,
103 so the board does not need to be reprinted,
104 unless the screen suffers some horrendous malady.
105 Also, any `p' option will be ignored.
106 (The `t' option is not necessary unless the terminal type does not match
107 the entry in the
108 .Pa /usr/share/misc/termcap
109 data base.)
110 .Sh QUICK REFERENCE
111 When the program prompts by typing only your color,
112 type a space or carriage return to roll, or
113 .Bl -tag -width ".Ic s-f"
114 .It Ic d
115 to double
116 .It Ic p
117 to print the board
118 .It Ic q
119 to quit
120 .It Ic s
121 to save the game for later
122 .El
123 .Pp
124 When the program prompts with 'Move:', type
125 .Bl -tag -width ".Ic s-f"
126 .It Ic p
127 to print the board
128 .It Ic q
129 to quit
130 .It Ic s
131 to save the game
132 .El
133 .Pp
134 or a
135 .Em move ,
136 which is a sequence of
137 .Bl -tag -width ".Ic s-f"
138 .It Ic s-f
139 move from
140 .Ic s
141 to
142 .Ic f
143 .It Ic s/r
144 move one man on
145 .Ic s
146 the roll
147 .Ic r
148 separated by commas or spaces and ending with a newline.
149 Available abbreviations are
150 .Bl -tag -width ".Ic s-f1-f2"
151 .It Ic s-f1-f2
152 means
153 .Ic s-f1,f1-f2
154 .It Ic s/r1r2
155 means
156 .Ic s/r1,s/r2
157 .El
158 .El
159 .Pp
160 Use
161 .Ic b
162 for bar and
163 .Ic h
164 for home,
165 or 0 or 25 as appropriate.
166 .Sh FILES
167 .Bl -tag -width ".Pa /usr/share/misc/termcap" -compact
168 .It Pa /usr/games/teachgammon
169 rules and tutorial
170 .It Pa /usr/share/misc/termcap
171 terminal capabilities
172 .El
173 .Sh AUTHORS
174 .An Alan Char
175 .Sh BUGS
176 The program's strategy needs much work.