Some assorted minor cleanups, from larn 12.2.

[bsdgames-darwin.git] / cribbage / cribbage.6

diff --git a/cribbage/cribbage.6 b/cribbage/cribbage.6
index 59c6500d04c5782f160dadc303245e4e5ad7c6f9..3734fcb8622323522fba8731e085ce23740e4fe4 100644 (file)
--- a/cribbage/cribbage.6
+++ b/cribbage/cribbage.6
@@ -1,5 +1,7 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.
+.\"    $NetBSD: cribbage.6,v 1.11 2003/08/07 09:37:09 agc Exp $
+.\"
+.\" Copyright (c) 1980, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions


@@ -9,11 +11,7 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.

-.\" 3. All advertising materials mentioning features or use of this software
-.\"    must display the following acknowledgement:
-.\"    This product includes software developed by the University of
-.\"    California, Berkeley and its contributors.
-.\" 4. Neither the name of the University nor the names of its contributors
+.\" 3. Neither the name of the University nor the names of its contributors

 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\"
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\"


@@ -29,101 +27,159 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"

-.\"    @(#)cribbage.6  6.5 (Berkeley) 6/23/90
+.\"    @(#)cribbage.6  8.1 (Berkeley) 5/31/93

 .\"
 .\"

-.TH CRIBBAGE 6 "June 23, 1990"
-.UC 4
-.SH NAME
-cribbage \- the card game cribbage
-.SH SYNOPSIS
-.B /usr/games/cribbage
-[
-.B \-req
-]
-.I name ...
-.SH DESCRIPTION
-.I Cribbage
+.Dd May 31, 1993
+.Dt CRIBBAGE 6
+.Os
+.Sh NAME
+.Nm cribbage
+.Nd the card game cribbage
+.Sh SYNOPSIS
+.Nm
+.Op Fl eqr
+.Sh DESCRIPTION
+.Nm

 plays the card game cribbage, with the program playing one hand
 plays the card game cribbage, with the program playing one hand

-and the user the other.  The program will initially ask the user if
-the rules of the game are needed \- if so, it will print out
-the appropriate section from
-.I According to Hoyle
+and the user the other.
+The program will initially ask the user if the rules of the game are
+needed \(en if so, it will print out the appropriate section from
+.Em According to Hoyle

 with
 with

-.I more (I).
-.PP
-.I Cribbage
+.Xr more 1 .
+.Pp
+.Nm

 options include:
 options include:

-.TP
-.B \-e
+.Bl -tag -width indent
+.It Fl e

 When the player makes a mistake scoring his hand or crib, provide an
 When the player makes a mistake scoring his hand or crib, provide an

-explanation of the correct score.  (This is especially useful for
-beginning players.)
-.TP
-.B \-q
-Print a shorter form of all messages \- this is only recommended for
+explanation of the correct score.
+(This is especially useful for beginning players.)
+.It Fl q
+Print a shorter form of all messages \(en this is only recommended for

 users who have played the game without specifying this option.
 users who have played the game without specifying this option.

-.TP
-.B \-r
+.It Fl r

 Instead of asking the player to cut the deck, the program will randomly
 cut the deck.
 Instead of asking the player to cut the deck, the program will randomly
 cut the deck.

-.PP
-.I Cribbage
-first asks the player whether he wishes to play a short game
-(\*(lqonce around\*(rq, to 61) or a long game (\*(lqtwice around\*(rq, to 121).  A
-response of `s' will result in a short game, any other response will
-play a long game.
-.PP
+.El
+.Pp
+.Nm
+first asks the player whether he wishes to play a short game (
+.Dq once around ,
+to 61) or a long game (
+.Dq twice around ,
+to 121).
+A response of
+.Sq Ic s
+will result in a short game, any other response will play a long game.
+.Pp

 At the start of the first game, the program
 At the start of the first game, the program

-asks the player to cut the deck to determine who gets the
-first crib.  The user should respond with a number between 0 and
-51, indicating how many cards down the deck is to be cut.  The player
-who cuts the lower ranked card gets the first crib.
+asks the player to cut the deck to determine who gets the first crib.
+The user should respond with a number between 0 and
+51, indicating how many cards down the deck is to be cut.
+The player who cuts the lower ranked card gets the first crib.

 If more than one game is played, the
 loser of the previous game gets the first crib in the current game.
 If more than one game is played, the
 loser of the previous game gets the first crib in the current game.

-.PP
+.Pp

 For each hand, the program first prints the player's hand,
 whose crib it is, and then asks the player
 For each hand, the program first prints the player's hand,
 whose crib it is, and then asks the player

-to discard two cards into the crib.  The cards are prompted for
-one per line, and are typed as explained below.
-.PP
+to discard two cards into the crib.
+The cards are prompted for one per line, and are typed as explained below.
+.Pp

 After discarding, the program cuts the deck (if it is the player's
 crib) or asks the player to cut the deck (if it's its crib); in the latter
 case, the appropriate response is a number from 0 to 39 indicating
 how far down the remaining 40 cards are to be cut.
 After discarding, the program cuts the deck (if it is the player's
 crib) or asks the player to cut the deck (if it's its crib); in the latter
 case, the appropriate response is a number from 0 to 39 indicating
 how far down the remaining 40 cards are to be cut.

-.PP
+.Pp

 After cutting the deck, play starts with the non-dealer (the person
 who doesn't have the crib) leading the first card.
 After cutting the deck, play starts with the non-dealer (the person
 who doesn't have the crib) leading the first card.

-Play continues, as per cribbage, until all cards are exhausted.  The
-program keeps track of the scoring of all points and the total of
+Play continues, as per cribbage, until all cards are exhausted.
+The program keeps track of the scoring of all points and the total of

 the cards on the table.
 the cards on the table.

-.PP
-After play, the hands are scored.  The program requests the player to
+.Pp
+After play, the hands are scored.
+The program requests the player to

 score his hand (and the crib, if it is his) by printing out the
 appropriate cards (and the cut card enclosed in brackets).
 Play continues until one player reaches the game limit (61 or 121).
 score his hand (and the crib, if it is his) by printing out the
 appropriate cards (and the cut card enclosed in brackets).
 Play continues until one player reaches the game limit (61 or 121).

-.PP
+.Pp

 A carriage return when a numeric input is expected is equivalent
 to typing the lowest legal value; when cutting the deck this
 is equivalent to choosing the top card.
 A carriage return when a numeric input is expected is equivalent
 to typing the lowest legal value; when cutting the deck this
 is equivalent to choosing the top card.

-.PP
-Cards are specified as rank followed by suit.  The ranks may be specified
+.Pp
+Cards are specified as rank followed by suit.
+The ranks may be specified

 as one of:
 as one of:

-`a', `2', `3', `4', `5', `6', `7', `8', `9', `t', `j', `q', and `k',
-or alternatively, one of: \*(lqace\*(rq, \*(lqtwo\*(rq, \*(lqthree\*(rq, \*(lqfour\*(rq, \*(lqfive\*(rq, \*(lqsix\*(rq,
-\*(lqseven\*(rq, \*(lqeight\*(rq, \*(lqnine\*(rq, \*(lqten\*(rq, \*(lqjack\*(rq, \*(lqqueen\*(rq, and \*(lqking\*(rq.
-Suits may be specified as: `s', `h', `d', and `c', or alternatively as:
-\*(lqspades\*(rq, \*(lqhearts\*(rq, \*(lqdiamonds\*(rq, and \*(lqclubs\*(rq.
-A card may be specified as: <rank> \*(lq \*(rq <suit>, or: <rank> \*(lq of \*(rq <suit>.
+.Sq a ,
+.Sq 2 ,
+.Sq 3 ,
+.Sq 4 ,
+.Sq 5 ,
+.Sq 6 ,
+.Sq 7 ,
+.Sq 8 ,
+.Sq 9 ,
+.Sq t ,
+.Sq j ,
+.Sq q ,
+and
+.Sq k ,
+or alternatively, one of:
+.Sq ace ,
+.Sq two ,
+.Sq three ,
+.Sq four ,
+.Sq five ,
+.Sq six ,
+.Sq seven ,
+.Sq eight ,
+.Sq nine ,
+.Sq ten ,
+.Sq jack ,
+.Sq queen ,
+and
+.Sq king .
+Suits may be specified as:
+.Sq s ,
+.Sq h ,
+.Sq d ,
+and
+.Sq c ,
+or alternatively as:
+.Sq spades ,
+.Sq hearts ,
+.Sq diamonds ,
+and
+.Sq clubs .
+A card may be specified as:
+.Dq Ao rank Ac \  Aq suit ,
+or:
+.Dq Ao rank Ac of Aq suit .

 If the single letter rank and suit designations are used, the space
 If the single letter rank and suit designations are used, the space

-separating the suit and rank may be left out.  Also, if only one card
+separating the suit and rank may be left out.
+Also, if only one card

 of the desired rank is playable, typing the rank is sufficient.
 of the desired rank is playable, typing the rank is sufficient.

-For example, if your hand was \*(lq2H, 4D, 5C, 6H, JC, KD\*(rq and it was
-desired to discard the king of diamonds, any of the following could be typed:
-\*(lqk\*(rq, \*(lqking\*(rq, \*(lqkd\*(rq, \*(lqk d\*(rq, \*(lqk of d\*(rq, \*(lqking d\*(rq, \*(lqking of d\*(rq, \*(lqk diamonds\*(rq,
-\*(lqk of diamonds\*(rq, \*(lqking diamonds\*(rq, or \*(lqking of diamonds\*(rq.
-.SH FILES
-.ta 2i
-/usr/games/cribbage
-.SH AUTHORS
+For example, if your hand was
+.Dq 2H, 4D, 5C, 6H, JC, and KD
+and it was desired to discard the king of diamonds, any of
+the following could be typed:
+.Sq k ,
+.Sq king ,
+.Sq kd ,
+.Sq k d ,
+.Sq k of d ,
+.Sq king d ,
+.Sq king of d ,
+.Sq k diamonds ,
+.Sq k of diamonds ,
+.Sq king diamonds ,
+.Sq king of diamonds .
+.Sh FILES
+.Bl -tag -width /usr/share/games/cribbage.instr -compact
+.It Pa /usr/games/cribbage
+.It Pa /var/games/criblog
+.It Pa /usr/share/games/cribbage.instr
+.El
+.Sh AUTHORS

 Earl T. Cohen wrote the logic.
 Ken Arnold added the screen oriented interface.
 Earl T. Cohen wrote the logic.
 Ken Arnold added the screen oriented interface.