games-request@tekred.TEK.COM (01/19/88)
Submitted by: John Stanback <jhs%hpltbm@hplabs.hp.com>
Comp.sources.games: Volume 3, Issue 41
Archive-name: gnuchess/Part04
[Here is an official man page for gnuchess from the original
author of the program. (See also article by John in
comp.sources.d. -br]
#! /bin/sh
# This is a shell archive. Remove anything before this line, then unpack
# it by saving it into a file and typing "sh file". To overwrite existing
# files, type "sh file -c". You can also feed this as standard input via
# unshar, or by typing "sh <file", e.g.. If this archive is complete, you
# will see the following message at the end:
# "End of shell archive."
# Contents: chessgnu.6
# Wrapped by billr@tekred on Mon Jan 18 07:55:17 1988
PATH=/bin:/usr/bin:/usr/ucb ; export PATH
if test -f chessgnu.6 -a "${1}" != "-c" ; then
echo shar: Will not over-write existing file \"chessgnu.6\"
else
echo shar: Extracting \"chessgnu.6\" \(5825 characters\)
sed "s/^X//" >chessgnu.6 <<'END_OF_chessgnu.6'
X.TH Chess GNU
X.SH NAME
XChess \- GNU Chess
X.SH SYNOPSIS
X.B Chess
X[
X.B arg1 arg2
X]
X.SH DESCRIPTION
X.I Chess
Xplays a game of chess against the user or it plays against itself.
X.PP
X.I Chess
Xhas a simple alpha-numeric board display or it can be compiled for
Xuse with the CHESSTOOL program on a SUN workstation.
XThe opening library should be located in the file gnuchess.book.
XTo invoke the prgram, type 'chess' or type 'chesstool chess'
Xon a SUN workstation where 'CHESSTOOL' is installed.
XThe 'chess' command can be followed by up to 2 command line arguments.
XIf one argument is given it determines the programs search time in
Xseconds. If two arguments are given, they will be used to set tournament
Xtime controls with the first argument being the number of moves and the second
Xbeing the total clock time in minutes. Thus, entering 'chess 60 5' will set
Xthe clocks for 5 minutes (300 seconds) for the first 60 moves.
XIf no argument is given the program will prompt the user for the response
Xtime per move in seconds.
XFor use with CHESSTOOL, see the documentation on that program.
X.PP
XOnce
X.I Chess
Xis invoked, the program will display the board and prompt the user
Xfor a move. To enter a move, use the notation 'e2e4' where the first
Xletter-number pair indicates the origination square
Xand the second letter-number pair indicates the destination square.
XAn alternative is to use the notation 'nf3' where
Xthe first letter indicates the piece type (p,n,b,r,q,k).
XTo castle, type the origin and destination squares
Xof the king just as you would do for a regular move, or type
X"o-o" for kingside castling and "o-o-o" for queenside.
X.SH COMMANDS
X.PP
XIn addition to legal moves, the following commands are available as responses.
X.PP
X.I beep
X-- causes the program to beep after each move.
X.PP
X.I bd
X-- updates the current board position on the display.
X.PP
X.I book
X-- turns off use of the opening library.
X.PP
X.I both
X-- causes the computer to play both sides of a chess game.
X.PP
X.I black
X-- causes the computer to take the black pieces with the move
Xand begin searching.
X.PP
X.I clock
X-- allows the user to set tournament time controls such as
X60 moves in 5 minutes etc. The program will ask for Operator
XTime (in seconds) which will be subtracted from the computers
Xclock in addition to its search time for
Xeach move. This allows the programs clock to be more or less
Xin synch with the official clock in tournament play.
XIn tournament mode, the program will vary the time it takes for each
Xmove depending on the situation. If easy mode is disabled (using
Xthe 'easy' command), the program
Xwill often respond with its move immediately, saving time on
Xits clock for use later on.
X.PP
X.I depth
X-- allows the user to change the
Xsearch depth of the program. The maximum depth is 29 ply.
XNormally the depth is set to 29 and the computer terminates
Xits search based on elapsed time rather than depth.
XUsing the depth command allows setting depth to say
X4 ply and setting response time to a large number such as
X9999 seconds. The program will then search until all moves
Xhave been examined to a depth of 4 ply (with extensions up
Xto 11 additional ply for sequences of checks and captures).
X.PP
X.I easy
X-- toggles easy mode (thinking on opponents time)
Xon and off. The default is easy mode ON. If easy mode is disabled,
Xthe user must enter a 'break' or '^C' to get the programs
Xattention before entering each move.
X.PP
X.I force
X-- allows the user to enter moves for both
Xsides. To get the program to play after a sequence of moves
Xhas been entered use the 'white' or 'black' commands.
X.PP
X.I get
X-- retrieves a game from disk. The program will
Xprompt the user for a file name.
X.PP
X.I help
X-- displays a short description of the commands.
X.PP
X.I hint
X-- causes the program to supply the user with
Xits predicted move.
X.PP
X.I list
X-- writes the game moves and some statistics
Xon search depth, nodes, and time to the file 'chess.lst'.
X.PP
X.I new
X-- starts a new game.
X.PP
X.I post
X-- causes the program to display the principle
Xvariation and the score during the search. A score of
X100 is equivalent to a 1 pawn advantage for the computer.
X.PP
X.I random
X-- causes the program to randomize its move
Xselection slightly.
X.PP
X.I reverse
X-- causes the board display to be reversed. That
Xis, the white pieces will now appear at the top of the board.
X.PP
X.I quit
X-- exits the game.
X.PP
X.I save
X-- saves a game to disk. The program will prompt
Xthe user for a file name.
X.PP
X.I set
X-- allows the user to set up a board position.
XIn this mode, the '#' command will clear the board, the 'c'
Xcommand will toggle piece color, and the '.' command will exit
Xsetup mode. Pieces are entered by typing a letter (p,n,b,r,q,k) for
Xthe piece followed by the coordinate. For example "pb3" would
Xplace a pawn on square b3.
X.PP
X.I switch
X-- causes the program to switch places with
Xthe opponent and begin searching.
X.PP
X.I time
X-- allows the user to modify the programs response
Xtime. The programs actual response time for a given move will vary
Xsomewhat depending on the board position. A 'break' or '^C'
Xentered while the computer is thinking will cause the
Xsearch to terminate and a move to be played.
X.PP
X.I undo
X-- undoes the last move whether it was the computer's
Xor the human's. You may also type "remove". This is equivalent
Xto two "undo's" (e.g. retract one move for each side).
X.PP
X.I white
X-- causes the computer to take the white pieces
Xwith the move and begin searching.
X.PP
X.SH BUGS
X.PP
X Pawn promotion to pieces other than a queen is not allowed.
X En-Passant does not work properly with CHESSTOOOL.
X
XBug reports can be sent to the author or to:
X.nf
X.PP
XStuart Cracraft
X
X
X
X.fi
X.SH AUTHOR
X.nf
XJohn Stanback Unix mail: ...hplabs!hpltbf!jhs
X4237 Cape Cod Circle
XFort Collins, CO. 80525
X.fi
X.SH SEE ALSO
X.nf
Xchesstool(6)
X.fi
X
END_OF_chessgnu.6
if test 5825 -ne `wc -c <chessgnu.6`; then
echo shar: \"chessgnu.6\" unpacked with wrong size!
fi
# end of overwriting check
fi
echo shar: End of shell archive.
exit 0