--- /dev/null
+gnuchess(6) gnuchess(6)
+
+
+
+NAME
+ gnuchess - Chess
+
+SYNOPSIS
+ gnuchess [ [[-|+]a] [-A aging-rate] [-b bookfile] [-B binbookfile] [-C
+ cache-table-size] [-c] [[-|+]D ] [[-|+]E ] [[-|+]e ] [[-|+]F ] [-H
+ hash-depth] [[-|+]h ] [-L language] [-l listfile] [[-|+]N] [[-|+]p ]
+ [-P plys] [-r length] [-s savefile] [-S binbooksize] [-t] [-c hashfile-
+ size] [-T transition-table-size] [[-|+]V] [-v] [-x] [-z search-fuzz]
+ arg1 arg2 ]
+
+DESCRIPTION
+ Gnuchess plays a game of chess against the user or it plays against
+ itself.
+
+ Gnuchess is an updated version of the GNU chess playing program. It
+ has a simple alpha-numeric board display, an IBM PC compatible inter-
+ face, or it can be compiled for use with the chesstool program on a SUN
+ workstation or with the xboard program under X-windows. To invoke the
+ program type:
+
+ gnuchess
+ - simple curses based version
+
+ gnuchessn
+ - fancy version using curses and inverse video on UNIX, or IBM
+ PC cursor controls and characters on MSDOS
+
+ gnuchessr
+ - ASCII based version
+
+ gnuchessc
+ - chesstool compatible version
+
+ gnuchessx
+ - xboard compatible version
+
+TIME CONTROLS
+ If one argument is given, it is the search time per move in [min-
+ utes:]seconds. So gnuchess 30 will generate one move every 30 seconds,
+ while gnuchess 5:00 will generate one move every 5 minutes.
+
+ If two or more arguments are given, they will be used to set tournament
+ time controls with the first argument of each pair being the number of
+ moves and the second being the total clock time in minutes[:seconds].
+ Thus, entering gnuchess 60 5 will set the clocks for 5 minutes (300
+ seconds) for the first 60 moves, and gnuchess 30 3:30 will allow 3 min-
+ utes and 30 seconds for 30 moves.
+
+ gnuchess 30 5 1 :30 will allow 5 minutes for the first 30 moves and 30
+ seconds for each move after that. Up to 4 pairs of controls may be
+ specified.
+
+ If no argument is given the program will prompt the user for level of
+ play.
+
+ For use with chesstool or xboard, see the documentation on those pro-
+ grams.
+
+BOOK
+ At startup Gnuchess reads the binbook file if it is present. It then
+ looks for a book file. If it is present it adds its contents to the
+ binbook data. If the binbook file is writable a new combined binbook
+ file is written.
+
+ The book gnuchess.book consists of a sequence of openings. An opening
+ begins with a line starting with a ! , the rest of the line is com-
+ ments. Following this is a series of moves in algebraic notation
+ alternating white and black separated by white space. A move may have a
+ ? after it indicating this move should never be made in this position.
+ Moves are stored as position:move so transpositions between openings
+ can take place.
+
+HASHFILE
+ The hashfile if created should be on the order of 4 megabytes or
+ gnuchess -c 22. This file contains positions and moves learned from
+ previous games. If a hashfile is used the computer makes use of the
+ experience it gained in past games. Tests run so far show that it plays
+ no worse with the hashfile than without, but it is not clear yet
+ whether it provides a real advantage.
+
+LEGAL MOVES
+ Note: Piece letters and legal castling notation is determined by the
+ language file. What is specified here is the default English.
+
+ Once gnuchess is invoked, the program will display the board and prompt
+ the user for a move. To enter a move, use the notation e2e4 where the
+ first letter-number pair indicates the origination square and the sec-
+ ond letter-number pair indicates the destination square. An alterna-
+ tive is to use the notation nf3 where the first letter indicates the
+ piece type (p,n,b,r,q,k). To castle, type the origin and destination
+ squares of the king just as you would do for a regular move, or type o-
+ o or 0-0 for kingside castling and o-o-o or 0-0-0 for queenside. To
+ promote a pawn append the type of the new piece to the move, as in
+ e7e8q or c7c8r.
+
+FUNCTION LETTERS
+ -L lang
+ Use language lang from the file gnuchess.lang. If -L is not
+ specified it defaults to the language used in the first line in
+ the file. gnuchessr -L ger will use the german language.
+
+ -A aging-rate
+ Specify aging rate for hash table entries
+
+ [-]a Do [do not] search on opponents time.
+
+ -b bookfile
+ Use bookfile for opening book.
+
+ -B binbookfile
+ Use binbookfile for binary opening book.
+
+ -C cache-size
+ Specify evaluation cache table size (in entries).
+
+ -D Toggle DEEPNULL at runtime.
+
+ -E Toggle flag.threat.
+
+ -e Toggle flag.neweval to force evaluations instead of estimates
+
+ -F Toggle flag.noscore
+
+ -H hash-depth
+ pecify depth in plys for hashing.
+
+ -S size
+ Size of binbookfile for memory based and GDX books. For creating
+ a binbookfile.
+
+ -P plylevels
+ Number of plys to include in the binbookfile. For generating a
+ binbookfile.
+
+ -p Toggle flag.pvs
+
+ -c size
+ Create a new HASHFILE. File size is 2^size entries of approxi-
+ mately 65 bytes.
+
+ [-]h Do [do not] use hashfile.
+
+ -l pathname
+ Pathname of the loadfile use with the get or xget.
+
+ -r length
+ Rehash length times in searching entries for position in trans-
+ position table.
+
+ -s pathname
+ Pathname of the save file to use with the save command.
+
+ -t Show statistics for HASHFILE
+
+ -T size
+ Set the transposition table size to size entries. (minimum is
+ MINTTABLE)
+
+ -v Show version and patchlevel.
+
+ -x value
+ Use value as the evaluation window xwndw.
+
+COMMANDS
+ In addition to legal moves, the following commands are available as
+ responses. Note: command names are determined by the language file and
+ may vary with the implementation. This is default English.
+
+ alg -- allow algebraic input (not implemented)
+
+ Awindow -- change Alpha window (default score + 90)
+
+ Bwindow -- change Beta window (default score - 90)
+
+ beep -- causes the program to beep after each move.
+
+ bd -- updates the current board position on the display.
+
+ bk -- Print out all moves for this position from the book as: move
+ response value
+
+ book -- turns off use of the opening library.
+
+ both -- causes the computer to play both sides of a chess game.
+
+ black -- causes the computer to take the black pieces. If the computer
+ is to move first the go command must be given.
+
+ eco -- Print out opening information for this game - lists ECO # and
+ variations
+
+ coords -- show coordinates on the display (visual only)
+
+ contempt -- allows the value of contempt to be modified.
+
+ debug -- asks for a piece as color piece, as wb or bn, and shows its
+ calculated value on each square.
+
+ debuglevel -- sets level of debugging output if compiled with debug
+ options.
+
+ depth -- allows the user to change the search depth of the program.
+ The maximum depth is 29 ply. Normally the depth is set to 29 and the
+ computer terminates its search based on elapsed time rather than depth.
+ If depth is set to (say) 4 ply, the program will search until all moves
+ have been examined to a depth of 4 ply (with extensions up to 11 addi-
+ tional ply for sequences of checks and captures). If you set a maximum
+ time per move and also use the depth command, the search will stop at
+ the specified time or the specified depth, whichever comes first.
+
+ easy -- toggles easy mode (thinking on opponents time) on and off. The
+ default is easy mode ON. If easy mode is disabled, the keyboard is
+ polled for input every so often and when input is seen the search is
+ terminated. It may also be terminated with a sigint.
+
+ edit -- allows the user to set up a board position.
+
+ # - command will clear the board.
+
+ c - toggle piece color.
+
+ . - command will exit setup mode.
+
+ pb3 - place a pawn on b3
+
+ Pieces are entered by typing a letter (p,n,b,r,q,k) for the piece fol-
+ lowed by the coordinate.
+
+ The usual warning about the language file applies.
+
+ exit -- exits gnuchess.
+
+ first -- tells the computer to move first. Computer begins searching
+ for a move. (same as "go").
+
+ force -- allows the user to enter moves for both sides. To get the pro-
+ gram to play after a sequence of moves has been entered use the 'white'
+ or 'black' command followed by 'go'.
+
+ gamein -- toggles game mode time control. Assumes the time specified
+ for time control is the time for a complete game. Input with the level
+ command should be the game time and the expected number of moves in a
+ game.
+
+ get -- retrieves a game from disk. The program will prompt the user
+ for a file name.
+
+ go -- tells the computer to move first. Computer begins searching for a
+ move. (same as "first").
+
+ hash -- use/don't use hashfile.
+
+ hard -- think on opponents time
+
+ hashdepth -- allows the user to change the minimum depth for using the
+ hashfile and the number of moves from the begining of the game to use
+ it.
+
+ help -- displays a short description of the commands and the current
+ status of options.
+
+ hint -- causes the program to supply the user with its predicted move.
+
+ level -- allows the user to set time controls such as 60 moves in 5
+ minutes etc. In tournament mode, the program will vary the time it
+ takes for each move depending on the situation. If easy mode is dis-
+ abled (using the 'easy' command), the program will often respond with
+ its move immediately, saving time on its clock for use later on.
+
+ list -- writes the game moves and some statistics on search depth,
+ nodes, and time to the file 'chess.lst'.
+
+ material -- toggle material flag - draws on no pawns and both sides <
+ rook
+
+ Mwpawn, Mbpawn, Mwknight, Mbknight, Mwbishop, Mbbishop -- print out
+ static position evaluation table
+
+ new -- starts a new game.
+
+ p -- evaluates the board and shows the point score for each piece. The
+ total score for a position is the sum of these individual piece scores.
+
+ post -- causes the program to display the principle variation and the
+ score during the search. A score of 100 is equivalent to a 1 pawn
+ advantage for the computer.
+
+ unpost -- turn off the post display.
+
+ quit -- exits the game.
+
+ random -- causes the program to randomize its move selection slightly.
+
+ rcptr -- set recapture mode.
+
+ remove -- backout the last level for both sides. Equal to 2 undo's.
+
+ reverse -- causes the board display to be reversed. That is, the white
+ pieces will now appear at the top of the board.
+
+ rv -- reverse board display.
+
+ setup -- Compatibility with Unix chess and the nchesstool. Set up a
+ board position. Eight lines of eight characters are used to setup the
+ board. a8-h8 is the first line. Black pieces are represented by
+ uppercase characters.
+
+ stars -- (gnuchessn only) add stars (*) to black pieces.
+
+ save -- saves a game to disk. The program will prompt the user for a
+ file name.
+
+ switch -- causes the program to switch places with the opponent and
+ begin searching.
+
+ test -- performs some speed tests for MoveList and CaptureList genera-
+ tion, and ScorePosition position scoring for the current board.
+
+ time otim -- time set computers time remaining, intended for synchro-
+ nizing clocks among multiple players. -- otim set opponents time
+ remaining, intended for synchronizing clocks among multiple players.
+
+ undo -- undoes the last move whether it was the computer's or the
+ human's. You may also type "remove". This is equivalent to two "undo's"
+ (e.g. retract one move for each side).
+
+ white -- causes the computer to take the white pieces. If the computer
+ is to move first the go command must be given.
+
+ xget -- read an xboard position file.
+
+ xwndw -- change X window. The window around alpha/beta used to deter-
+ mine whether the position should be scored or just estimated.
+
+BUGS
+SEE ALSO
+ chesstool(6)
+ xboard(6)
+
+
+
+
+ gnuchess(6)