![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to xchess.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / games / chess / Xchess|
Return to xchess.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / games / chess / Xchess |
1.1 root 1:
2: .TH XCHESS 1 "14 Nov 1986" "X Version 10"
3: .SH NAME
4: xchess \- X chess display
5: .SH SYNOPSIS
6: .B xchess
7: [ option ... ] [ white-display ] [ black-display ]
8: .SH DESCRIPTION
9: .PP
10: .B xchess
11: is a chess display program which allows players to play a game on either
12: one or two displays, or play a chess-playing program. It uses the
13: .B X
14: window system. If one or no display names are given, it will open up one
15: window and both black and white at the same board. If two displays are
16: given,
17: .B xchess
18: will accept moves from each player in his turn. Black's board will be drawn
19: with his pieces at the bottom.
20: .PP
21: .B xchess
22: will not allow a player to make an illegal move. It accepts all legal moves,
23: including castling and pawn capture \fIen passant\fR.
24: .SH OPTIONS
25: .TP 8
26: .B -d
27: Turn on debugging.
28: .TP 8
29: .B -f record-file
30: Use \fBrecord-file\fR for saving the game when the \fBSave\fR button is
31: selected, or if the \fB-s\fR flag is given. The default is "xchess.game".
32: .TP 8
33: .B -r saved-game
34: Start with the position at the end of the saved game in the named file.
35: This file may be the result of the \fBSave\fR command, and may be in
36: either English or International format. When reading moves, one move
37: it made per second.
38: .TP 8
39: .B -q
40: Don't pause for a second every time a move is made when a game is being
41: restored.
42: .TP 8
43: .B -v
44: Whenever a piece is moved, outline the path with a "lightning bolt".
45: This option and the \fB-n\fR option are useful if you don't want to miss
46: an opponent's move when he makes it.
47: .TP 8
48: .B -i
49: Use International format for recording moves (squares numbered 1-8, a-h)
50: as opposed to English (e.g, \fIp/k4xp/q5\fR).
51: .TP 8
52: .B -t moves/timeunit
53: Allows \fBtimeunit\fR seconds for every \fBmoves\fR moves. If either player
54: exceeds this allowance both recieve a message saying informing them of
55: this fact.
56: .TP 8
57: .B -c
58: Play the computer.
59: .B xchess
60: will start up a chess-playing program (currently the only one it knows
61: how to talk to is \fBGNU Chess\fR).
62: .TP 8
63: .B -p program
64: The name of the program to use if the \fB-c\fR option is given. The
65: default is "/usr/public/gnuchess". Note that \fBgnuchess\fR must be
66: compiled with the \fIcompat\fR flag (in the file "main.c") set to 1.
67: .TP 8
68: .B -b
69: If the \fB-c\fR flag was given, have the computer play white.
70: .TP 8
71: .B -bnw
72: If the display has more than one display plane (i.e, is color), pretend
73: it's black and white.
74: .TP 8
75: .B -s
76: Save the moves in the record file as they are made. This is useful if
77: you don't want your game to be lost when \fBxchess\fR core dumps.
78: .TP 8
79: .B -n
80: Be noisy \- beep after every move is made.
81: .TP 8
82: .B -h host
83: Run GNU Chess on the specified \fBhost\fR.
84: .TP 8
85: .B -R
86: Randomly chose who plays white and who plays black, if two displays are
87: given.
88: .SH CONTROLS
89: .PP
90: The window is divided up into several sub-windows. The pieces are moved by
91: pushing down any mouse button on top of the piece, moving to the destination
92: square, and releasing it. Castling is done by moving the king to the
93: right square. If you push down on a piece and then let the button
94: up without moving it, you must move that piece. ("Touch it, move it.")
95: .PP
96: The progress of the game is listed in the "Game Record" window. Error
97: messages and such things are printed in the "Message" window. Both these
98: windows have scroll bars that you can use to move around.
99: There are also windows for clocks and for a record of the pieces captured.
100: .PP
101: If you type any keys in the window, the text will go into the message
102: window of both players. This provides a simple communication facility.
103: .PP
104: There are 9 buttons in the control window. They are as follows:
105: .TP 8
106: .B Draw
107: Both players must push this button to agree on a draw (just one is ok
108: if only one display is being used).
109: .TP 8
110: .B Resign
111: The player whose turn it is to move resigns.
112: .TP 8
113: .B Reset
114: Start over from the beginning.
115: .TP 8
116: .B Back
117: Retract a move. If two displays are being used the other player will be
118: asked to confirm this.
119: .TP 8
120: .B Fwd
121: This will re-play the most recently retracted move. This button in conjunction
122: with \fBBack\fR is useful for "scrolling around" in a saved game.
123: .TP 8
124: .B Save
125: Save the game in the record file.
126: .TP 8
127: .B Flip
128: Rotate the board so that Black will have his pieces at the bottom.
129: .TP 8
130: .B Switch
131: Change the mapping of boards to players.
132: .TP 8
133: .B Pause
134: This button has two functions. When a game is being restored, pieces will
135: be moved once a second. Hitting \fBPause\fR will stop this process, and
136: hitting it again will restart it. During the time that it is stopped no
137: other action can be made except restarting it. While a game is being played,
138: \fBPause\fR will stop the clock and restart it.
139: .SH DEFAULTS
140: .PP
141: \fBxchess\fR uses the following \fI.Xdefaults\fR:
142: .TP 8
143: .B Noisy
144: The -n flag.
145: .TP 8
146: .B SaveMoves
147: The -s flag.
148: .TP 8
149: .B Algebraic
150: The -i flag.
151: .TP 8
152: .B BlackAndWhite
153: The -bnw flag.
154: .TP 8
155: .B QuickRestore
156: The -q flag.
157: .TP 8
158: .B Flash
159: The -v flag.
160: .TP 8
161: .B NumFlashes
162: How many times to flash the move. The default is 5.
163: .TP 8
164: .B FlashWidth
165: How big to make the lightning bolt. The default is 10 pixels.
166: .TP 8
167: .B ProgName
168: The -p option. This may also be changed in the Makefile (-DDEF_PROG_NAME).
169: .TP 8
170: .B ProgHost
171: The -h option.
172: .TP 8
173: .B RecordFile
174: The -f option.
175: .TP 8
176: .B BlackPiece
177: The color of the black pieces.
178: .TP 8
179: .B WhitePiece
180: The color of the white pieces.
181: .TP 8
182: .B BorderColor
183: The color of the borders.
184: .TP 8
185: .B BlackSquare
186: The color of the black squares.
187: .TP 8
188: .B WhiteSquare
189: The color of the white squares.
190: .TP 8
191: .B TextColor
192: The color of routine messages and the move record text.
193: .TP 8
194: .B ErrorText
195: The color of error messages.
196: .TP 8
197: .B PlayerText
198: The color of player-entered text.
199: .TP 8
200: .B TextBack
201: The background color for the two text windows.
202: .TP 8
203: .B CursorColor
204: The color of the mouse and the text cursors.
205: .SH "SEE ALSO"
206: X(8), gnuchess(1), chess(5)
207: .SH AUTHOR
208: Wayne A. Christopher ([email protected])
209: .SH BUGS
210: .PP
211: Checkmate and stalemate are not detected, so the appropriate player must resign
212: or agree to a draw respectively.
213: .PP
214: \fBSwitch\fR doesn't work.
215: .PP
216: If you are playing \fBgnuchess\fR, and you select Undo a few times so that it
217: is \fBgnuchess\fR's turn to move, it won't do anything.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.