Return to xchess.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / games / chess / Xchess

Annotation of 43BSDReno/games/chess/Xchess/xchess.1, revision 1.1

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.