games: Massive style(9) cleanup commit. Reduces differences to NetBSD.
[dragonfly.git] / games / canfield / canfield / canfield.6
1 .\" Copyright (c) 1983, 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. Neither the name of the University nor the names of its contributors
13 .\"    may be used to endorse or promote products derived from this software
14 .\"    without specific prior written permission.
15 .\"
16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 .\" SUCH DAMAGE.
27 .\"
28 .\"     @(#)canfield.6  8.1 (Berkeley) 5/31/93
29 .\" $FreeBSD: src/games/canfield/canfield/canfield.6,v 1.4.2.2 2001/07/22 11:32:35 dd Exp $
30 .\" $DragonFly: src/games/canfield/canfield/canfield.6,v 1.4 2007/10/20 17:56:47 swildner Exp $
31 .\"
32 .Dd May 31, 1993
33 .Dt CANFIELD 6
34 .Os
35 .Sh NAME
36 .Nm canfield ,
37 .Nm cfscores
38 .Nd the solitaire card game canfield
39 .Sh SYNOPSIS
40 .Nm
41 .Nm cfscores
42 .Op Fl a
43 .Op Ar user
44 .Sh DESCRIPTION
45 If you have never played solitaire before, it is recommended
46 that you consult a solitaire instruction book. In
47 Canfield, tableau cards may be built on each other downward
48 in alternate colors. An entire pile must be moved as a unit
49 in building. Top cards of the piles are available
50 to be played on foundations, but never into empty spaces.
51 .Pp
52 Spaces must be filled from the stock. The top card of
53 the stock also is available to be played on foundations or
54 built on tableau piles. After the stock is exhausted,
55 tableau spaces may be filled from the talon and the player may
56 keep them open until he wishes to use them.
57 .Pp
58 Cards are dealt from the hand to the talon by threes
59 and this repeats until there are no more cards in the hand
60 or the player quits.
61 To have cards dealt onto the talon the player types
62 .Sq Ic ht
63 for his move.
64 Foundation base cards are also automatically moved to the foundation
65 when they become available.
66 .Pp
67 The command
68 .Sq Ic c
69 causes
70 .Nm
71 to maintain card counting statistics on the bottom of the screen.
72 When properly used this can greatly increase one's chances of winning.
73 .Pp
74 The rules for betting are somewhat less strict than
75 those used in the official version of the game.
76 The initial deal costs $13.
77 You may quit at this point or inspect the game.
78 Inspection costs $13 and allows you to make as many
79 moves as possible without moving any cards from your hand to the talon.
80 (The initial deal places three cards on the talon;
81 if all these cards are used, three more are made available.)
82 Finally, if the game seems interesting,
83 you must pay the final installment of $26.
84 At this point you are
85 credited at the rate of $5 for each card on the foundation;
86 as the game progresses you are credited with $5 for each
87 card that is moved to the foundation.
88 Each run through the hand after the first costs $5.
89 The card counting feature
90 costs $1 for each unknown card that is identified.
91 If the information is toggled on, you are only charged for cards
92 that became visible since it was last turned on.
93 Thus the maximum cost of information is $34.
94 Playing time is charged at a rate of $1 per minute.
95 .Pp
96 With no arguments, the program
97 .Nm cfscores
98 prints out the current status of your
99 .Nm
100 account.
101 If a
102 .Ar user
103 name is specified, it prints out the status of their
104 .Nm
105 account.
106 If the
107 .Fl a
108 flag is specified,
109 it prints out the
110 .Nm
111 accounts for all users that have
112 played the game since the database was set up.
113 .Sh FILES
114 .Bl -tag -width ".Pa /usr/games/canfield" -compact
115 .It Pa /usr/games/canfield
116 the game itself
117 .It Pa /usr/games/cfscores
118 the database printer
119 .It Pa /var/games/cfscores
120 the database of scores
121 .El
122 .Sh AUTHORS
123 .An -nosplit
124 Originally written:
125 .An Steve Levine
126 .Pp
127 Further random hacking by:
128 .An Steve Feldman ,
129 .An Kirk McKusick ,
130 .An Mikey Olson ,
131 and
132 .An Eric Allman .
133 .Sh BUGS
134 It is impossible to cheat.