X-Git-Url: http://winboard.nl/cgi-bin?a=blobdiff_plain;f=installer%2FWinBoard-4.2.7%2Fgnuchess.txt;fp=installer%2FWinBoard-4.2.7%2Fgnuchess.txt;h=802e6a154ec43aadb6754685b01acb4dabd2bf14;hb=71a0dc43ed9498db72f4a302a4b11fabb93ab286;hp=0000000000000000000000000000000000000000;hpb=0b915ff9a9bf2c51ddd8e8c978125fffa3b2865c;p=xboard.git diff --git a/installer/WinBoard-4.2.7/gnuchess.txt b/installer/WinBoard-4.2.7/gnuchess.txt new file mode 100644 index 0000000..802e6a1 --- /dev/null +++ b/installer/WinBoard-4.2.7/gnuchess.txt @@ -0,0 +1,348 @@ +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)