X-Git-Url: http://winboard.nl/cgi-bin?a=blobdiff_plain;f=manual%2Fxboard.html;h=62875d02d62ccbefd4e25c98ff29ae23460117f9;hb=ca01d025f9d6a21807145792e2a90b841600b5a3;hp=970918d822d4d545a24883542669a85ad5689874;hpb=5538e55a9678d04ac6d94baedacd150fa3910a61;p=xboard.git diff --git a/manual/xboard.html b/manual/xboard.html index 970918d..62875d0 100644 --- a/manual/xboard.html +++ b/manual/xboard.html @@ -115,11 +115,11 @@ To move a piece, you can drag it with the left mouse button, or you can click the left mouse button once on the piece, then once more on the destination square. To drop a new piece on a square (when applicable), press the middle or the right mouse button over the -square and select from the popup menu. In cases where you can drop +square and select from the pop-up menu. In cases where you can drop either a white or black piece, use the middle button (or shift+right) for white and the right button (or shift+middle) for black. When you are playing a bughouse game on an Internet Chess Server, a list of the -offboard pieces that each player has available is shown in the window +off-board pieces that each player has available is shown in the window title after the player's name; in addition, the piece menus show the number of pieces available of each type. From version 4.3.14 on, it is also possible in crazyhouse, bughouse or shogi to dag and drop pieces @@ -174,13 +174,14 @@ does cause these variants to become shuffle variants until you use the or select a new variant.
New Variant
Allows you to select a new chess variant in non-ICS mode. (In ICS play, the ICS is responsible for deciding which variant will be played, -and XBoard adapts autmatically.) If you play with an engine, the engine must +and XBoard adapts automatically.) If you play with an engine, the engine must be able to play the selected variant, or the command will be ignored. XBoard supports all major variants, such as xiangqi, shogi, chess, chess960, -Capablanca Chess, shatranj, crazyhous, bughouse. +Capablanca Chess, shatranj, crazyhouse, bughouse. +(But not every board size has built-in bitmaps for un-orthodox pieces!)
Load Game
Plays a game from a record file. The g key is a keyboard equivalent. -A popup dialog prompts you for the file name. If the file contains more -than one game, a second popup dialog +A pop-up dialog prompts you for the file name. If the file contains more +than one game, a second pop-up dialog displays a list of games (with information drawn from their PGN tags, if any), and you can select the one you want. Alternatively, you can load the Nth game in the file directly, by typing the number N after the @@ -213,7 +214,7 @@ Not available if the last game was loaded from a pipe.
Reload Same Game
Reloads the last game you loaded. Not available if the last game was loaded from a pipe.
Save Game
Appends a record of the current game to a file. -A popup dialog +A pop-up dialog prompts you for the file name. If the game did not begin with the standard starting position, the game file includes the starting position used. Games are saved in the PGN (portable @@ -232,7 +233,7 @@ applications, such as xterm and emacs, the middle mouse button can be used for pasting; in XBoard, you must use the Paste Game command.
Paste Game
Interprets the current X selection as a game record and loads it, as with Load Game. -
Load Position
Sets up a position from a position file. A popup dialog prompts +
Load Position
Sets up a position from a position file. A pop-up dialog prompts you for the file name. If the file contains more than one saved position, and you want to load the Nth one, type the number N after the file name, separated by a space. Position files must @@ -244,7 +245,7 @@ loaded. Not available if the last position was loaded from a pipe.
Reload Same Position
Reloads the last position you loaded. Not available if the last position was loaded from a pipe.
Save Position
Appends a diagram of the current position to a file. -A popup dialog +A pop-up dialog prompts you for the file name. Positions are saved in FEN (Forsythe-Edwards notation) format unless the oldSaveStyle option is true, in which case they are saved in an older, @@ -298,9 +299,9 @@ clock to tell XBoard which side moves first. with an engine loaded (zippy mode); the engine then will analyse the positions as they occur in the observed game.
Analyze File
This option lets you load a game from a file (PGN, XBoard format, etc.) -and analyze it. When you select this menu item, a popup window appears -and asks for a filename to load. -If the file contains multiple games, another popup appears that lets +and analyze it. When you select this menu item, a pop-up window appears +and asks for a file name to load. +If the file contains multiple games, another pop up appears that lets you select which game you wish to analyze. After a game is loaded, use the XBoard arrow buttons to step forwards/backwards through the game and watch the analysis. @@ -361,7 +362,7 @@ the ICS examine command, or start an ICS match against yourself.
Training
Training mode lets you interactively guess the moves of a game for one of the players. You guess the next move of the game by playing the move on the board. If the move played matches the next move of the -game, the move is accepted and the opponent's response is autoplayed. +game, the move is accepted and the opponent's response is auto-played. If the move played is incorrect, an error message is displayed. You can select this mode only while loading a game (that is, after selecting ‘Load Game’ from the File menu). While XBoard is in @@ -467,6 +468,10 @@ keyboard equivalent. observe command with no arguments. ICS mode only.
Stop Examining
Ends your participation in examining a game, by issuing the ICS unexamine command. ICS mode only. +
Adjudicate to White
Adjudicate to Black
Adjudicate Draw
Terminate an ongoing game in Two-Machines mode (including match mode), +with as result a win for white, for black, or a draw, respectively. +The PGN file of the game will accompany the result string +by the comment "user adjudication".
@@ -480,9 +485,9 @@ Up: Menus

2.4 Step Menu

-

+

-
Backward
Steps backward through a series of remembered moves. +
Backward
Steps backward through a series of remembered moves. The ‘[<]’ button and the b key are equivalents, as is turning the mouse wheel towards you. In addition, pressing the Control key steps back one move, and releasing @@ -501,7 +506,7 @@ off, ‘Backward’ issues the IC everyone's view of the game and allows you to make a different move. If Pause mode is on, ‘Backward’ only backs up your local view. -
Forward
Steps forward through a series of remembered moves (undoing the +
Forward
Steps forward through a series of remembered moves (undoing the effect of ‘Backward’) or forward through a game file. The ‘[>]’ button and the f key are equivalents, as is turning the mouse wheel away from you. @@ -513,7 +518,7 @@ everyone's view of the game forward along the current line. If Pause mode is on, ‘Forward’ only moves your local view forward, and it will not go past the position that the game was in when you paused. -
Back to Start
Jumps backward to the first remembered position in the game. +
Back to Start
Jumps backward to the first remembered position in the game. The ‘[<<]’ button and the shifted B key are equivalents.

In most modes, Back to Start only lets you look back at old @@ -530,7 +535,7 @@ is off, ‘Back to Start’ issue command, which backs up everyone's view of the game to the start and allows you to make different moves. If Pause mode is on, ‘Back to Start’ only backs up your local view. -

Forward to End
Jumps forward to the last remembered position in the game. The +
Forward to End
Jumps forward to the last remembered position in the game. The ‘[>>]’ button and the shifted F key are equivalents.

If you are examining an ICS game, the behavior of ‘Forward to @@ -540,21 +545,17 @@ command, which moves everyone's view of the game forward to the end of the current line. If Pause mode is on, ‘Forward to End’ only moves your local view forward, and it will not go past the position that the game was in when you paused. -

Revert
If you are examining an ICS game and Pause mode is off, issues +
Revert
If you are examining an ICS game and Pause mode is off, issues the ICS command ‘revert’. -
Truncate Game
Discards all remembered moves of the game beyond the current +
Truncate Game
Discards all remembered moves of the game beyond the current position. Puts XBoard into ‘Edit Game’ mode if it was not there already. -
Move Now
Forces the chess engine to move immediately. Chess engine mode only. -
Retract Move
Retracts your last move. In chess engine mode, you can do this only +
Move Now
Forces the chess engine to move immediately. Chess engine mode only. +
Retract Move
Retracts your last move. In chess engine mode, you can do this only after the chess engine has replied to your move; if the chess engine is still thinking, use ‘Move Now’ first. In ICS mode, ‘Retract Move’ issues the command ‘takeback 1’ or ‘takeback 2’ depending on whether it is your opponent's move or yours. -
Adjudicate to White
Adjudicate to Black
Adjudicate Draw
Terminate an ongoing game in Two-Machines mode (including match mode), -with as result a win for white, for black, or a draw, repsectively. -The PGN file of the game will accompany the result string -by the comment "user adjudication".
@@ -578,24 +579,24 @@ that XBoard can perform in engine-engine games. You can instruct XBoard to detect and terminate the game on checkmate or stalemate, even if the engines would not do so, to verify engine result claims (forfeiting engines that make false claims), rather than -naively following the engine, to declare draw on posititions +naively following the engine, to declare draw on positions which can never be won for lack of mating material, (e.g. KBK), -or which are impossble to win unless the opponent seeks its own demise +or which are impossible to win unless the opponent seeks its own demise (e.g. KBKN). For these adjudications to work, ‘Test Legality’ should be switched on. -It is also possible to insruct XBoard to enforce a 50-move or 3-fold-repeat -rule and automtically declare draw (after a user-adjustable number of moves +It is also possible to instruct XBoard to enforce a 50-move or 3-fold-repeat +rule and automatically declare draw (after a user-adjustable number of moves or repeats) even if the engines are prepared to go on. It is also possible to have XBoard declare draw on games that seem to drag on -forever, or adjudicate a loss if both engines agree (for 3 cosecutive moves) that one +forever, or adjudicate a loss if both engines agree (for 3 consecutive moves) that one of them is behind more than a user-adjustable score threshold. For the latter adjudication to work, XBoard should be able to properly understand -the engine's scores. To faclitate the latter, you can inform xboard here if +the engine's scores. To facilitate the latter, you can inform xboard here if the engines report scores from the viewpoint of white, or from that of their own color.
Engine Settings
Pops up a sub-menu where you can set some engine parameters common to most engines, such as hash-table size, tablebase cache size, maximum number of processors that SMP engines can use, and where to find the Polyglot adapter needed -to run UCI engines under XBoard. The feature tht allows setting of these parameters on +to run UCI engines under XBoard. The feature that allows setting of these parameters on engines is new since XBoard 4.3.15, so not many WinBoard engines respond to it yet, but UCI engines should. It is also possible to specify a GUI opening book here, i.e. an opening @@ -613,7 +614,7 @@ fixed time per move, will be divided by N.
Always Queen
If this option is off, XBoard brings up a dialog box whenever you move a pawn to the last rank, asking what piece you want to promote it to. If the option is true, your pawns are -always promoted to queens. Your opponent can still underpromote. +always promoted to queens. Your opponent can still under-promote.
Animate Dragging
If Animate Dragging is on, while you are dragging a piece with the mouse, an image of the piece follows the mouse cursor. If Animate Dragging is off, there is no visual feedback while you are @@ -736,9 +737,9 @@ message to standard error (the terminal) and exits immediately.
Popup Move Errors
If this option is off, when you make an error in moving (such as attempting an illegal move or moving the wrong color piece), the error message is displayed in the message area. If the option is -on, move errors are displayed in small popup windows like other errors. -You can dismiss an error popup either by clicking its OK button or by -clicking anywhere on the board, including downclicking to start a move. +on, move errors are displayed in small pop-up windows like other errors. +You can dismiss an error pop-up either by clicking its OK button or by +clicking anywhere on the board, including down-clicking to start a move.
Premove
If this option is on while playing a game on an ICS, you can register your next planned move before it is your turn. Move the piece with the mouse in the ordinary way, and the starting and ending squares @@ -908,7 +909,7 @@ true or false (‘XBoard*longOptionName: trueICS options: Connecting to and using ICS.
  • Load and Save options: Input/output options.
  • User interface options: Look and feel options. -
  • Adjudication Options: Control adjudcation of engine-engine games. +
  • Adjudication Options: Control adjudication of engine-engine games.
  • Other options: Miscellaneous. @@ -972,7 +973,7 @@ If mode=1, the engine that gets the most time will always get the nominal time, as specified by the time-control options, and its opponent's time is renormalized accordingly. If mode=0, both play with reduced time. Default: 0.
    -hideThinkingFromHuman true/false
    Controls the Hide Thinking option. See Options Menu. Default: true. -(Relaces the Show-Thinking option of older xboard versions.) +(Replaces the Show-Thinking option of older xboard versions.)
    -thinking/-xthinking or -showThinking true/false
    Forces the engine to send thinking output to xboard. Used to be the only way to control if thinking output was displayed in older xboard versions, @@ -982,7 +983,7 @@ by the new option Hide Thinking. See Options Menu. D (But if xboard needs the thinking output for some purpose, it makes the engine send it despite the setting of this option.)
    -ponder/-xponder or -ponderNextMove true/false
    Sets the Ponder Next Move menu option. See Options Menu. Default: true. -
    -smpCores number
    Specifies the maxmum nmber of CPUs an SMP engine is allowed to use. +
    -smpCores number
    Specifies the maximum number of CPUs an SMP engine is allowed to use. Only works for engines that support the WinBoard-protocol cores feature.
    -mg or -matchGames n
    Automatically runs an n-game match between two chess engines, with alternating colors. @@ -1074,13 +1075,23 @@ Important when XBoard uses the score for adjudications, or in PGN reporting. so that the generally insatiable hunger for CPU time of chess engines does not interfere so much with smooth operation of WinBoard (or the rest of your system). Negative values could increase the engine priority, which is not recommended. -
    -firstOptions string
    -secondOptions string
    The given string is a comma-separated list of (option name, option value) pairs, -like the following example: “style Karpov, blunder rate 0”. +
    -firstOptions string
    -secondOptions string
    The given string is a comma-separated list of (option name=option value) pairs, +like the following example: "style=Karpov,blunder rate=0". If the options announced by the engine at startup through the feature commands of WinBoard protocol -matches one of the option names (i.e. “style” or “blunder rate”), -it would be set to the given value (i.e. “Karpov” or 0) +matches one of the option names (i.e. "style" or "blunder rate"), +it would be set to the given value (i.e. "Karpov" or 0) through a corresponding option command to the engine. This provided that the type of the value (text or numeric) matches as well. +
    -firstNeedsNoncompliantFEN string
    -secondNeedsNoncompliantFEN string
    The castling rights and e.p. fields of the FEN sent to the mentioned engine +with the setboard command will be replaced by the given string. This can for +instance be used to run engines that do not understand Chess960 FENs in +variant fischerandom, to make them at least understand the opening position, +through setting the string to "KQkq -". (Note you also have to give the e.p. field!) +Other possible applications are to provide work-arounds for engines that want to see +castling and e.p. fields in variants that do not have castling or e.p. +(shatranj, courier, xiangqi, shogi) so that WinBoard would normally omit them +(string = "- -"), or to add variant-specific fields that are not yet supported by WinBoard +(e.g. to indicate the number of checks in 3check).
    @@ -1095,33 +1106,33 @@ Up: Options

    3.2 UCI + WB Engine Settings

    -

    +

    -
    -fUCI or -firstIsUCI true/false
    -sUCI or -secondIsUCI true/false
    Indicates if the mentioned engine executable file is an UCI engine, +
    -fUCI or -firstIsUCI true/false
    -sUCI or -secondIsUCI true/false
    Indicates if the mentioned engine executable file is an UCI engine, and should be run with the aid of the Polyglot adapter rather than directly. Xboard will then pass the other UCI options and engine name to Polyglot -through a .ini temporary file ceated for the purpose. -
    -PolyglotDir filename
    Gives the name of the directory in which the Polyglot adapter for UCI engines expects its files. +through a .ini temporary file created for the purpose. +
    -PolyglotDir filename
    Gives the name of the directory in which the Polyglot adapter for UCI engines expects its files. Default: "/usr/local/share/polyglot". -
    -usePolyglotBook true/false
    Specifies if the Polygot book should be used. -
    -PolyglotBook filename
    Gives the filename of the opening book that Polyglot should use. +
    -usePolyglotBook true/false
    Specifies if the Polyglot book should be used. +
    -PolyglotBook filename
    Gives the filename of the opening book that Polyglot should use. From XBoard 4.3.15 on, native WinBoard engines will also use the opening book specified here, provided the usePolyglotBook option is set to true, and the option firstHasOwnBookUCI or secondHasOwnBookUCI applying to the engine is set to false. The engine will be kept in force mode as long as the current position is in book, and XBoard will select the book moves for it. Default "". -
    -fNoOwnBookUCI or -firstXBook or -firstHasOwnBookUCI true/false
    -sNoOwnBookUCI or -secondXBook or -secondHasOwnBookUCI true/false
    Indicates if the mentioned engine has its own opening book it should play from, +
    -fNoOwnBookUCI or -firstXBook or -firstHasOwnBookUCI true/false
    -sNoOwnBookUCI or -secondXBook or -secondHasOwnBookUCI true/false
    Indicates if the mentioned engine has its own opening book it should play from, rather than using the external book through XBoard. Default: false. -
    -defaultHashSize n
    Sets the size of the hash table to n MegaBytes. Together with the EGTB cache size +
    -defaultHashSize n
    Sets the size of the hash table to n MegaBytes. Together with the EGTB cache size this number is also used to calculate the memory setting of WinBoard engines, for those that support the memory feature of WinBoard protocol. Default: 64. -
    -defaultCacheSizeEGTB n
    Sets the size of the EGTB cache to n MegaBytes. Together with the hash-table size +
    -defaultCacheSizeEGTB n
    Sets the size of the EGTB cache to n MegaBytes. Together with the hash-table size this number is also used to calculate the memory setting of WinBoard engines, for those that support the memory feature of WinBoard protocol. Default: 4. -
    -defaultPathEGTB filename
    Gives the name of the directory where the end-game tablebases are installed, for UCI engines. +
    -defaultPathEGTB filename
    Gives the name of the directory where the end-game tablebases are installed, for UCI engines. Default: "/usr/local/share/egtb". -
    -egtFormats string
    Specifies which end-game tables are installed on the computer, and where. +
    -egtFormats string
    Specifies which end-game tables are installed on the computer, and where. The argument is a comma-separated list of format specifications, each specification consisting of a format name, a colon, and a directory path name, e.g. "nalimov:/usr/local/share/egtb". @@ -1143,12 +1154,12 @@ Up: Options

    3.3 ICS options

    -

    +

    -
    -ics/-xics or -internetChessServerMode true/false
    Connect with an Internet Chess Server to play chess against its +
    -ics/-xics or -internetChessServerMode true/false
    Connect with an Internet Chess Server to play chess against its other users, observe games they are playing, or review games that have recently finished. Default: false. -
    -icshost or -internetChessServerHost host
    The Internet host name or address of the chess server to connect +
    -icshost or -internetChessServerHost host
    The Internet host name or address of the chess server to connect to when in ICS mode. Default: chessclub.com. Another popular chess server to try is freechess.org. If your site doesn't have a working Internet name server, try @@ -1156,15 +1167,15 @@ specifying the host address in numeric form. You may also need to specify the numeric address when using the icshelper option with timestamp or timeseal (see below). -
    -icsport or -internetChessServerPort port-number
    The port number to use when connecting to a chess server in ICS +
    -icsport or -internetChessServerPort port-number
    The port number to use when connecting to a chess server in ICS mode. Default: 5000. -
    -icshelper or -internetChessServerHelper prog-name
    An external helper program used to communicate with the chess server. +
    -icshelper or -internetChessServerHelper prog-name
    An external helper program used to communicate with the chess server. You would set it to "timestamp" for ICC (chessclub.com) or "timeseal" for FICS (freechess.org), after obtaining the correct version of timestamp or timeseal for your computer. See "help timestamp" on ICC and "help timeseal" on FICS. This option is shorthand for -useTelnet -telnetProgram program. -
    -telnet/-xtelnet or -useTelnet true/false
    This option is poorly named; it should be called useHelper. +
    -telnet/-xtelnet or -useTelnet true/false
    This option is poorly named; it should be called useHelper. If set to true, it instructs XBoard to run an external program to communicate with the Internet Chess Server. The program to use is given by the telnetProgram option. @@ -1172,25 +1183,25 @@ If the option is false (the default), XBoard opens a TCP socket and uses its own internal implementation of the telnet protocol to communicate with the ICS. See Firewalls. -
    -telnetProgram prog-name
    This option is poorly named; it should be called helperProgram. +
    -telnetProgram prog-name
    This option is poorly named; it should be called helperProgram. It gives the name of the telnet program to be used with the gateway and useTelnet options. The default is telnet. The telnet program is invoked with the value of internetChessServerHost as its first argument and the value of internetChessServerPort as its second argument. See Firewalls. -
    -gateway host-name
    If this option is set to a host name, XBoard communicates with the +
    -gateway host-name
    If this option is set to a host name, XBoard communicates with the Internet Chess Server by using rsh to run the telnetProgram on the given host, instead of using its own internal implementation of the telnet protocol. You can substitute a different remote shell program for rsh using the remoteShell option described below. See Firewalls. -
    -internetChessServerCommPort or -icscomm dev-name
    If this option is set, XBoard communicates with the ICS through +
    -internetChessServerCommPort or -icscomm dev-name
    If this option is set, XBoard communicates with the ICS through the given character I/O device instead of opening a TCP connection. Use this option if your system does not have any kind of Internet connection itself (not even a SLIP or PPP connection), -but you do have dialup access (or a hardwired terminal line) to +but you do have dial-up access (or a hardwired terminal line) to an Internet service provider from which you can telnet to the ICS.

    The support for this option in XBoard is minimal. You need to @@ -1229,7 +1240,7 @@ Then telnet to ICS, using a command like telnet chessclub.com 5000. Important: See the paragraph below about extra echoes, in Limitations. -

    -icslogon or -internetChessServerLogonScript file-name
    Whenever XBoard connects to the Internet Chess Server, +
    -icslogon or -internetChessServerLogonScript file-name
    Whenever XBoard connects to the Internet Chess Server, if it finds a file with the name given in this option, it feeds the file's contents to the ICS as commands. The default file name is .icsrc. @@ -1237,32 +1248,34 @@ Usually the first two lines of the file should be your ICS user name and password. The file can be either in $CHESSDIR, in XBoard's working directory if CHESSDIR is not set, or in your home directory. -
    -msLoginDelay delay
    If you experience trouble logging on to an ICS when using the +
    -msLoginDelay delay
    If you experience trouble logging on to an ICS when using the -icslogon option, inserting some delay between characters of the logon script may help. This option adds delay milliseconds of delay between characters. Good values to try are 100 and 250. -
    -icsinput/-xicsinput or -internetChessServerInputBox true/false
    Sets the ICS Input Box menu option. See Mode Menu. Default: false. -
    -autocomm/-xautocomm or -autoComment true/false
    Sets the Auto Comment menu option. See Options Menu. Default: false. -
    -autoflag/-xautoflag or -autoCallFlag true/false
    Sets the Auto Flag menu option. See Options Menu. Default: false. -
    -autobs/-xautobs or -autoObserve true/false
    Sets the Auto Observe menu option. See Options Menu. Default: false. -
    -autoKibitz
    Enables kibitzing of the engines last thinking output (depth, score, time, speed, PV) +
    -icsinput/-xicsinput or -internetChessServerInputBox true/false
    Sets the ICS Input Box menu option. See Mode Menu. Default: false. +
    -autocomm/-xautocomm or -autoComment true/false
    Sets the Auto Comment menu option. See Options Menu. Default: false. +
    -autoflag/-xautoflag or -autoCallFlag true/false
    Sets the Auto Flag menu option. See Options Menu. Default: false. +
    -autobs/-xautobs or -autoObserve true/false
    Sets the Auto Observe menu option. See Options Menu. Default: false. +
    -autoKibitz
    Enables kibitzing of the engines last thinking output (depth, score, time, speed, PV) before it moved to the ICS, in zippy mode. The option showThinking must be switched on for this option to work. Also diverts similar kibitz information of an opponent engine that is playing you through the ICS to the engine-output window, as if the engine was playing locally. -
    -moves/-xmoves or -getMoveList true/false
    Sets the Get Move List menu option. See Options Menu. Default: true. -
    -alarm/-xalarm or -icsAlarm true/false
    Sets the ICS Alarm menu option. See Options Menu. Default: true. -
    -icsAlarmTime ms
    Sets the time in milliseconds for the ICS Alarm menu option. +
    -moves/-xmoves or -getMoveList true/false
    Sets the Get Move List menu option. See Options Menu. Default: true. +
    -alarm/-xalarm or -icsAlarm true/false
    Sets the ICS Alarm menu option. See Options Menu. Default: true. +
    -icsAlarmTime ms
    Sets the time in milliseconds for the ICS Alarm menu option. See Options Menu. Default: 5000. -
    -pre/-xpre \fRor\fB -premove true/false
    Sets the Premove menu option. See Options Menu. Default: true. -
    -quiet/-xquiet or -quietPlay true/false
    Sets the Quiet Play menu option. See Options Menu. Default: false. -
    -colorizeMessages or -colorize
    Setting colorizeMessages +
    lowTimeWarning true/false
    Controls a color change of the board as a warning your time is running out. +See Options Menu. Default: false. +
    -pre/-xpre \fRor\fB -premove true/false
    Sets the Premove menu option. See Options Menu. Default: true. +
    -quiet/-xquiet or -quietPlay true/false
    Sets the Quiet Play menu option. See Options Menu. Default: false. +
    -colorizeMessages or -colorize
    Setting colorizeMessages to true tells XBoard to colorize the messages received from the ICS. Colorization works only if your xterm supports ISO 6429 escape sequences for changing text colors. -
    -colorShout foreground,background,bold
    -colorSShout foreground,background,bold
    -colorChannel1 foreground,background,bold
    -colorChannel foreground,background,bold
    -colorKibitz foreground,background,bold
    -colorTell foreground,background,bold
    -colorChallege foreground,background,bold
    -colorRequest foreground,background,bold
    -colorSeek foreground,background,bold
    -colorNormal foreground,background,bold
    These options set the colors used when colorizing ICS messages. +
    -colorShout foreground,background,bold
    -colorSShout foreground,background,bold
    -colorChannel1 foreground,background,bold
    -colorChannel foreground,background,bold
    -colorKibitz foreground,background,bold
    -colorTell foreground,background,bold
    -colorChallege foreground,background,bold
    -colorRequest foreground,background,bold
    -colorSeek foreground,background,bold
    -colorNormal foreground,background,bold
    These options set the colors used when colorizing ICS messages. All ICS messages are grouped into one of these categories: shout, sshout, channel 1, other channel, kibitz, tell, challenge, request (including abort, adjourn, draw, pause, and takeback), or @@ -1290,22 +1303,22 @@ them if you turn -colorize on without specifying your own colors. xboard*colorSeek: blue xboard*colorNormal: default -
    -soundProgram progname
    If this option is set to a sound-playing program that is installed and +
    -soundProgram progname
    If this option is set to a sound-playing program that is installed and working on your system, XBoard can play sound files when certain events occur, listed below. The default program name is "play". If any of the sound options is set to "$", the event rings the terminal bell by sending a ^G character to standard output, instead of playing a sound file. If an option is set to the empty string "", no sound is played for that event. -
    -soundShout filename
    -soundSShout filename
    -soundChannel filename
    -soundKibitz filename
    -soundTell filename
    -soundChallenge filename
    -soundRequest filename
    -soundSeek filename
    These sounds are triggered in the same way as the colorization events +
    -soundShout filename
    -soundSShout filename
    -soundChannel filename
    -soundKibitz filename
    -soundTell filename
    -soundChallenge filename
    -soundRequest filename
    -soundSeek filename
    These sounds are triggered in the same way as the colorization events described above. They all default to "", no sound. They are played only if the colorizeMessages is on. -
    -soundMove filename
    This sound is used by the Move Sound menu option. Default: "$". -
    -soundIcsAlarm filename
    This sound is used by the ICS Alarm menu option. Default: "$". -
    -soundIcsWin filename
    This sound is played when you win an ICS game. Default: "" (no sound). -
    -soundIcsLoss filename
    This sound is played when you lose an ICS game. Default: "" (no sound). -
    -soundIcsDraw filename
    This sound is played when you draw an ICS game. Default: "" (no sound). -
    -soundIcsUnfinished filename
    This sound is played when an ICS game that you are participating in is +
    -soundMove filename
    This sound is used by the Move Sound menu option. Default: "$". +
    -soundIcsAlarm filename
    This sound is used by the ICS Alarm menu option. Default: "$". +
    -soundIcsWin filename
    This sound is played when you win an ICS game. Default: "" (no sound). +
    -soundIcsLoss filename
    This sound is played when you lose an ICS game. Default: "" (no sound). +
    -soundIcsDraw filename
    This sound is played when you draw an ICS game. Default: "" (no sound). +
    -soundIcsUnfinished filename
    This sound is played when an ICS game that you are participating in is aborted, adjourned, or otherwise ends inconclusively. Default: "" (no sound). @@ -1340,9 +1353,9 @@ Up: Options

    3.4 Load and Save options

    -

    +

    -
    -lgf or -loadGameFile file
    -lgi or -loadGameIndex index
    If the loadGameFile option is set, XBoard loads the specified +
    -lgf or -loadGameFile file
    -lgi or -loadGameIndex index
    If the loadGameFile option is set, XBoard loads the specified game file at startup. The file name - specifies the standard input. If there is more than one game in the file, XBoard pops up a menu of the available games, with entries based on their PGN @@ -1365,16 +1378,16 @@ first game of the file when it has reached a specified value. positions or games in auto-increment matchMode. See loadPositionIndex and loadGameIndex. default: 0 (no rewind). -
    -td or -timeDelay seconds
    Time delay between moves during ‘Load Game’. Fractional seconds +
    -td or -timeDelay seconds
    Time delay between moves during ‘Load Game’. Fractional seconds are allowed; try ‘-td 0.4’. A time delay value of -1 tells XBoard not to step through game files automatically. Default: 1 second. -
    -sgf or -saveGameFile file
    If this option is set, XBoard appends a record of every game +
    -sgf or -saveGameFile file
    If this option is set, XBoard appends a record of every game played to the specified file. The file name - specifies the standard output. -
    -autosave/-xautosave or -autoSaveGames true/false
    Sets the Auto Save menu option. See Options Menu. Default: false. +
    -autosave/-xautosave or -autoSaveGames true/false
    Sets the Auto Save menu option. See Options Menu. Default: false. Ignored if saveGameFile is set. -
    -lpf or -loadPositionFile file
    -lpi or -loadPositionIndex index
    If the loadPositionFile option is set, XBoard loads the +
    -lpf or -loadPositionFile file
    -lpi or -loadPositionIndex index
    If the loadPositionFile option is set, XBoard loads the specified position file at startup. The file name - specifies the standard input. If the loadPositionIndex option is set to N, the Nth position found in the file is loaded; otherwise the @@ -1387,15 +1400,21 @@ causes the index to be incremented every two games, so that each position in the file is used twice (with the engines playing opposite colors). The rewindIndex option causes the index to be reset to the first position of the file when it has reached a specified value. -
    -spf or -savePositionFile file
    If this option is set, XBoard appends the final position reached +
    -spf or -savePositionFile file
    If this option is set, XBoard appends the final position reached in every game played to the specified file. The file name - specifies the standard output. -
    -pgnExtendedInfo true/false
    If this option is set, WinBoard saves depth, score and time used for each +
    -pgnExtendedInfo true/false
    If this option is set, WinBoard saves depth, score and time used for each move that the engine found as a comment in the PGN file. Default: false. -
    -pgnEventHeader string
    Sets the name used in the PGN event tag to string. +
    -pgnEventHeader string
    Sets the name used in the PGN event tag to string. Default: "Computer Chess Game". -
    -saveOutOfBookInfo true/false
    Include the information on how the engine(s) game out of its opening book in a special 'annotator' tag with the PGN file.
    -oldsave/-xoldsave or -oldSaveStyle true/false
    Sets the Old Save Style menu option. See Options Menu. Default: false. +
    -saveOutOfBookInfo true/false
    Include the information on how the engine(s) game out of its opening book in a special 'annotator' tag with the PGN file. +
    -oldsave/-xoldsave or -oldSaveStyle true/false
    Sets the Old Save Style menu option. See Options Menu. Default: false. +
    -gameListTags string
    The character string lists the PGN tags that should be printed in the +Game List, and their order. The meaning of the codes is e=event, +s=site, d=date, o=round, p=players, r=result, w=white Elo, b=black Elo, +t=time control, v=variant, a=out-of-book info. +Default: "eprd"
    @@ -1409,21 +1428,21 @@ Up: Options

    3.5 User interface options

    -

    +

    -
    -display
    -geometry
    -iconic
    These and most other standard Xt options are accepted. -
    -noGUI
    Suppresses all GUI functions of XBoard +
    -display
    -geometry
    -iconic
    These and most other standard Xt options are accepted. +
    -noGUI
    Suppresses all GUI functions of XBoard (to speed up automated ultra-fast engine-engine games, which you don’t want to watch). There will be no board or clock updates, no printing of moves, and no update of the icon on the task bar in this mode. -
    -movesound/-xmovesound or -ringBellAfterMoves true/false
    Sets the Move Sound menu option. See Options Menu. Default: false. +
    -movesound/-xmovesound or -ringBellAfterMoves true/false
    Sets the Move Sound menu option. See Options Menu. Default: false. For compatibility with old XBoard versions, -bell/-xbell are also accepted as abbreviations for this option. -
    -exit/-xexit or -popupExitMessage true/false
    Sets the Popup Exit Message menu option. See Options Menu. Default: true. -
    -popup/-xpopup or -popupMoveErrors true/false
    Sets the Popup Move Errors menu option. See Options Menu. Default: false. -
    -queen/-xqueen or -alwaysPromoteToQueen true/false
    Sets the Always Queen menu option. See Options Menu. Default: false. -
    -legal/-xlegal or -testLegality true/false
    Sets the Test Legality menu option. See Options Menu. Default: true. -
    -size or -boardSize (sizeName | n1,n2,n3,n4,n5,n6,n7)
    Determines how large the board will be, by selecting the pixel size +
    -exit/-xexit or -popupExitMessage true/false
    Sets the Popup Exit Message menu option. See Options Menu. Default: true. +
    -popup/-xpopup or -popupMoveErrors true/false
    Sets the Popup Move Errors menu option. See Options Menu. Default: false. +
    -queen/-xqueen or -alwaysPromoteToQueen true/false
    Sets the Always Queen menu option. See Options Menu. Default: false. +
    -legal/-xlegal or -testLegality true/false
    Sets the Test Legality menu option. See Options Menu. Default: true. +
    -size or -boardSize (sizeName | n1,n2,n3,n4,n5,n6,n7)
    Determines how large the board will be, by selecting the pixel size of the pieces and setting a few related parameters. The sizeName can be one of: Titanic, giving 129x129 pixel pieces, Colossal 116x116, Giant 108x108, Huge 95x95, Big 87x87, Large 80x80, Bulky 72x72, @@ -1455,11 +1474,11 @@ If smallLayout is 1 and titleInWindow is true, the window layout is rearranged to make more room for the title. If tinyLayout is 1, the labels on the menu bar are abbreviated to one character each and the buttons in the button bar are made narrower. -
    -coords/-xcoords or -showCoords true/false
    Sets the Show Coords menu option. See Options Menu. Default: false. +
    -coords/-xcoords or -showCoords true/false
    Sets the Show Coords menu option. See Options Menu. Default: false. The coordFont option specifies what font to use. -
    -autoraise/-xautoraise or -autoRaiseBoard true/false
    Sets the Auto Raise Board menu option. See Options Menu. Default: true. -
    -autoflip/-xautoflip or -autoFlipView true/false
    Sets the Auto Flip View menu option. See Options Menu. Default: true. -
    -flip/-xflip or -flipView true/false
    If Auto Flip View is not set, or if you are observing but not participating +
    -autoraise/-xautoraise or -autoRaiseBoard true/false
    Sets the Auto Raise Board menu option. See Options Menu. Default: true. +
    -autoflip/-xautoflip or -autoFlipView true/false
    Sets the Auto Flip View menu option. See Options Menu. Default: true. +
    -flip/-xflip or -flipView true/false
    If Auto Flip View is not set, or if you are observing but not participating in a game, then the positioning of the board at the start of each game depends on the flipView option. If flipView is false (the default), the board is positioned so that the white pawns move from the bottom to the @@ -1467,20 +1486,20 @@ top; if true, the black pawns move from the bottom to the top. In any case, the Flip menu option (see Options Menu) can be used to flip the board after the game starts. -
    -title/-xtitle or -titleInWindow true/false
    If this option is true, XBoard displays player names (for ICS +
    -title/-xtitle or -titleInWindow true/false
    If this option is true, XBoard displays player names (for ICS games) and game file names (for ‘Load Game’) inside its main window. If the option is false (the default), this information is displayed only in the window banner. You probably won't want to set this option unless the information is not showing up in the banner, as happens with a few X window managers. -
    -buttons/-xbuttons or -showButtonBar True/False
    If this option is False, xboard omits the [<<] [<] [P] [>] [>>] button +
    -buttons/-xbuttons or -showButtonBar True/False
    If this option is False, xboard omits the [<<] [<] [P] [>] [>>] button bar from the window, allowing the message line to be wider. You can still get the functions of these buttons using the menus or their keyboard shortcuts. Default: true. -
    -mono/-xmono or -monoMode true/false
    Determines whether XBoard displays its pieces and squares with +
    -mono/-xmono or -monoMode true/false
    Determines whether XBoard displays its pieces and squares with two colors (true) or four (false). You shouldn't have to specify monoMode; XBoard will determine if it is necessary. -
    -flashCount count
    -flashRate rate
    -flash/-xflash
    These options enable flashing of pieces when they +
    -flashCount count
    -flashRate rate
    -flash/-xflash
    These options enable flashing of pieces when they land on their destination square. flashCount tells XBoard how many times to flash a piece after it @@ -1493,23 +1512,23 @@ sets flashCount to 3. xflash sets flashCount to 0. Defaults: flashCount=0 (no flashing), flashRate=5. -
    -highlight/-xhighlight or -highlightLastMove true/false
    Sets the Highlight Last Move menu option. See Options Menu. Default: false. -
    -blind/-xblind or -blindfold true/false
    Sets the Blindfold menu option. See Options Menu. Default: false. -
    -clockFont font
    The font used for the clocks. If the option value is a pattern +
    -highlight/-xhighlight or -highlightLastMove true/false
    Sets the Highlight Last Move menu option. See Options Menu. Default: false. +
    -blind/-xblind or -blindfold true/false
    Sets the Blindfold menu option. See Options Menu. Default: false. +
    -clockFont font
    The font used for the clocks. If the option value is a pattern that does not specify the font size, XBoard tries to choose an appropriate font for the board size being used. Default: -*-helvetica-bold-r-normal–*-*-*-*-*-*-*-*. -
    -coordFont font
    The font used for rank and file coordinate labels if showCoords +
    -coordFont font
    The font used for rank and file coordinate labels if showCoords is true. If the option value is a pattern that does not specify the font size, XBoard tries to choose an appropriate font for the board size being used. Default: -*-helvetica-bold-r-normal–*-*-*-*-*-*-*-*. -
    -font font
    The font used for popup dialogs, menus, comments, etc. +
    -font font
    The font used for popup dialogs, menus, comments, etc. If the option value is a pattern that does not specify the font size, XBoard tries to choose an appropriate font for the board size being used. Default: -*-helvetica-medium-r-normal–*-*-*-*-*-*-*-*. -
    -fontSizeTolerance tol
    In the font selection algorithm, a nonscalable font will be preferred +
    -fontSizeTolerance tol
    In the font selection algorithm, a nonscalable font will be preferred over a scalable font if the nonscalable font's size differs by tol pixels or less from the desired size. A value of -1 will force @@ -1517,7 +1536,7 @@ a scalable font to always be used if available; a value of 0 will use a nonscalable font only if it is exactly the right size; a large value (say 1000) will force a nonscalable font to always be used if available. Default: 4. -
    -bm or -bitmapDirectory dir
    -pixmap or -pixmapDirectory dir
    These options control what piece images xboard uses. The XBoard +
    -bm or -bitmapDirectory dir
    -pixmap or -pixmapDirectory dir
    These options control what piece images xboard uses. The XBoard distribution includes one set of pixmap pieces in xpm format, in the directory pixmaps, and one set of bitmap pieces in xbm format, in the directory bitmaps. Pixmap @@ -1560,7 +1579,7 @@ by supplying files named icon_white.bm, <

    For more information about pixmap pieces and how to get additional sets, see zic2xpm below. -

    -whitePieceColor color
    -blackPieceColor color
    -lightSquareColor color
    -darkSquareColor color
    -highlightSquareColor color
    Colors to use for the pieces, squares, and square highlights. +
    -whitePieceColor color
    -blackPieceColor color
    -lightSquareColor color
    -darkSquareColor color
    -highlightSquareColor color
    -lowTimeWarningColor color
    Colors to use for the pieces, squares, and square highlights. Defaults: 
              -whitePieceColor       #FFFFCC
@@ -1569,6 +1588,7 @@ Defaults:
           -darkSquareColor       #77A26D
           -highlightSquareColor  #FFFF00
           -premoveHighlightColor #FF0000
+          -lowTimeWarningColor   #FF0000

    On a grayscale monitor you might prefer: @@ -1578,10 +1598,11 @@ Defaults: -darkSquareColor gray60 -highlightSquareColor gray100 -premoveHighlightColor gray70 + -lowTimeWarningColor gray70 -

    -drag/-xdrag or -animateDragging true/false
    Sets the Animate Dragging menu option. See Options Menu. Default: true. -
    -animate/-xanimate or -animateMoving true/false
    Sets the Animate Moving menu option. See Options Menu. Default: true. -
    -animateSpeed n
    Number of milliseconds delay between each animation frame when Animate +
    -drag/-xdrag or -animateDragging true/false
    Sets the Animate Dragging menu option. See Options Menu. Default: true. +
    -animate/-xanimate or -animateMoving true/false
    Sets the Animate Moving menu option. See Options Menu. Default: true. +
    -animateSpeed n
    Number of milliseconds delay between each animation frame when Animate Moves is on.
    @@ -1596,35 +1617,35 @@ Up: Options

    3.6 Adjudication Options

    -

    +

    -
    -adjudicateLossThreshold n
    If the given value is non-zero, XBoard adjudicates the game as a loss +
    -adjudicateLossThreshold n
    If the given value is non-zero, XBoard adjudicates the game as a loss if both engines agree for a duration of 6 consecutive ply that the score is below the given score threshold for that engine. Make sure the score is interpreted properly by XBoard, using -firstScoreAbs and -secondScoreAbs if needed. -Default: 0 (no adjudiction) -
    -adjudicateDrawMoves n
    If the given value is non-zero, XBoard adjudicates the game as a draw -if after the given number of moves it was not yet decided. Defaut: 0 (no adjudication) -
    -checkMates true/false
    If this option is set, XBoard detects all checkmates and stalemates, +Default: 0 (no adjudication) +
    -adjudicateDrawMoves n
    If the given value is non-zero, XBoard adjudicates the game as a draw +if after the given number of moves it was not yet decided. Default: 0 (no adjudication) +
    -checkMates true/false
    If this option is set, XBoard detects all checkmates and stalemates, and ends the game as soon as they occur. Legality-testing must be switched on for this option to work. Default: true -
    -testClaims true/false
    If this option is set, XBoard verifies all result claims made by engines, +
    -testClaims true/false
    If this option is set, XBoard verifies all result claims made by engines, and those who send false claims will forfeit the game because of it. Legality-testing must be switched on for this option to work. Default: true -
    -materialDraws true/false
    If this option is set, XBoard adjudicates games as draws when there is +
    -materialDraws true/false
    If this option is set, XBoard adjudicates games as draws when there is no sufficient material left to inflict a checkmate. This applies to KBKB with like bishops (any number, actually), and to KBK, KNK and KK. Legality-testing must be switched on for this option to work. Default: true -
    -trivialDraws true/false
    If this option is set, XBoard adjudicates games as draws that cannot be +
    -trivialDraws true/false
    If this option is set, XBoard adjudicates games as draws that cannot be usually won without opponent cooperation. This applies to KBKB with unlike bishops, and to KBKN, KNKN, KNNK, KRKR and KQKQ. The draw is called after 6 ply into these end-games, to allow quick mates that can occur in some exceptional positions to be found by the engines. KQKQ does not really belong in this category, and might be taken out in the future. (When bitbase-based adjudications are implemented.) Legality-testing must be on for this option to work. Default: false -
    -ruleMoves n
    If the given value is non-zero, XBoard adjudicates the game as a draw after the given +
    -ruleMoves n
    If the given value is non-zero, XBoard adjudicates the game as a draw after the given number of consecutive reversible moves. Engine draw claims are always accepted after 50 moves, irrespective of the given value of n.
    -repeatsToDraw n
    If the given value is non-zero, xboard adjudicates the game as a draw if a position @@ -1644,18 +1665,18 @@ Up: Options

    3.7 Other options

    -

    +

    -
    -ncp/-xncp or -noChessProgram true/false
    If this option is true, XBoard acts as a passive chessboard; it +
    -ncp/-xncp or -noChessProgram true/false
    If this option is true, XBoard acts as a passive chessboard; it does not start a chess engine at all. Turning on this option also turns off clockMode. Default: false. -
    -mode or -initialMode modename
    If this option is given, XBoard selects the given modename +
    -mode or -initialMode modename
    If this option is given, XBoard selects the given modename from the Mode menu after starting and (if applicable) processing the loadGameFile or loadPositionFile option. Default: "" (no selection). Other supported values are MachineWhite, MachineBlack, TwoMachines, Analysis, AnalyzeFile, EditGame, EditPosition, and Training. -
    -variant varname
    Activates preliminary, partial support for playing chess variants +
    -variant varname
    Activates preliminary, partial support for playing chess variants against a local engine or editing variant games. This flag is not needed in ICS mode. Recognized variant names are: @@ -1680,7 +1701,7 @@ needed in ICS mode. Recognized variant names are: gothic similar, with a better initial position caparandom An FRC-like version of Capablanca Chess (10x8) janus A game with two Archbishops (10x8 board) - courier Medieval intermedite between shatranj and + courier Medieval intermediate between shatranj and modern Chess (on 12x8 board) falcon Patented 10x8 variant with two Falcon pieces berolina Pawns capture straight ahead, and move diagonal @@ -1691,35 +1712,44 @@ needed in ICS mode. Recognized variant names are: known to XBoard can participate (8x8) unknown Catchall for other unknown variants +

    NOT ALL BOARDSIZES PROVIDE A COMPLETE SET OF BUILT-IN BITMAPS FOR ALL +UN-ORTHODOX PIECES, though. Only in boardSize middling and bulky +all 22 piece types are provided, while -boardSize petite has most +of them. Archbishop, Chancellor and Amazon are supported in every +size from petite to bulky. Kings or Amazons are substituted for +missing bitmaps. You can still play variants needing un-orthodox +pieces in other board sizes providing your own bitmaps through the +bitmapDirectory or pixmapDirectory options. +

    In the shuffle variants, XBoard now does shuffle the pieces, although you can still do it by hand using Edit Position. Some variants are supported only in ICS mode, including bughouse, and -kriegspiel. The winning/drawing conditions in crazyhouse (offboard -interposition on mate), losers, suicide, giveaway, atomic, and 3check -are not fully understood. +kriegspiel. The winning/drawing conditions in crazyhouse (off-board +interposition on mate) are not fully understood, but losers, suicide, +giveaway, atomic, and 3check should be OK. Berolina and cylinder chess can only be played with legality testing off. In crazyhouse, XBoard now does keep -track of offboard pieces. In shatranj it does implement the baring +track of off-board pieces. In shatranj it does implement the baring rule when mate detection is switched on. -

    -boardHeight N
    Allows you to set a non-standard number of board ranks in any variant. +
    -boardHeight N
    Allows you to set a non-standard number of board ranks in any variant. If the height is given as -1, the default height for the variant is used. Default: -1 -
    -boardWidth N
    Allows you to set a non-standard number of board files in any variant. +
    -boardWidth N
    Allows you to set a non-standard number of board files in any variant. If the width is given as -1, the default width for the variant is used. With a non-standard width, the initial position will always be an empty board, as the usual opening array will not fit. Default: -1 -
    -holdingsSize N
    Allows you to set a non-standard size for the holdings in any variant. +
    -holdingsSize N
    Allows you to set a non-standard size for the holdings in any variant. If the size is given as -1, the default holdings size for the variant is used. The first N piece types will go into the holdings on capture, and you will be able to drop them on the board in stead of making a normal move. If size equals 0, there will be no holdings. Default: -1 -
    -defaultFrcPosition N
    Specifies the number of the opening position in shuffle games like Chess960. +
    -defaultFrcPosition N
    Specifies the number of the opening position in shuffle games like Chess960. A value of -1 means the position is randomly generated by XBoard at the beginning of every game. Default: -1 -
    -pieceToSquareTable string
    The characters that are used to represent the piece types XBoard knows in FEN +
    -pieceToSquareTable string
    The characters that are used to represent the piece types XBoard knows in FEN diagrams and SAN moves. The string argument has to have an even length (or it will be ignored), as white and black pieces have to be given separately (in that order). The last letter for each color will be the King. @@ -1739,27 +1769,27 @@ Note that promoted pieces are represented by pieces 11 further in the list. You should not have to use this option often: each variant has its own default setting for the piece representation in FEN, which should be sufficient in normal use. Default: "" -
    -debug/-xdebug or -debugMode true/false
    Turns on debugging printout. -
    -debugFile filename or -nameOfDebugFile filename
    Sets the name of the file to which WinBoard saves debug information +
    -debug/-xdebug or -debugMode true/false
    Turns on debugging printout. +
    -debugFile filename or -nameOfDebugFile filename
    Sets the name of the file to which WinBoard saves debug information (including all communication to and from the engines). -
    -engineDebugOutput number
    Specifies how WinBoard should handle unsolicited output from the engine, +
    -engineDebugOutput number
    Specifies how WinBoard should handle unsolicited output from the engine, with respect to saving it in the debug file. The output is further (hopefully) ignored. If number=0, WinBoard refrains from writing such spurious output to the debug file. If number=1, all engine output is written faithfully to the debug file. -If number=2, any protocol-violating line is prefixed with a ‘#’ character, +If number=2, any protocol-violating line is prefixed with a '#' character, as the engine itself should have done if it wanted to submit info for inclusion in the debug file. This option is provided for the benefit of applications that use the debug file as a source of information, such as the broadcaster of live games TLCV / TLCS. Such applications can be protected from spurious engine output that might otherwise confuse them. -
    -rsh or -remoteShell shell-name
    Name of the command used to run programs remotely. The default +
    -rsh or -remoteShell shell-name
    Name of the command used to run programs remotely. The default is rsh or remsh, determined when XBoard is configured and compiled. -
    -ruser or -remoteUser user-name
    User name on the remote system when running programs with the +
    -ruser or -remoteUser user-name
    User name on the remote system when running programs with the remoteShell. The default is your local user name. -
    -userName username
    Name under which the Human player will be listed in the PGN file. +
    -userName username
    Name under which the Human player will be listed in the PGN file. Default is the login name on your local computer. -
    -delayBeforeQuit number
    -delayAfterQuit number
    These options specify how long WinBoard has to wait before sending a termination signal to rogue engine processes, that do not want to react to the ‘quit’ command. The second one determines the pause after killing the engine, to make sure it dies. +
    -delayBeforeQuit number
    -delayAfterQuit number
    These options specify how long WinBoard has to wait before sending a termination signal to rogue engine processes, that do not want to react to the 'quit' command. The second one determines the pause after killing the engine, to make sure it dies.
    @@ -1774,7 +1804,7 @@ Up: Top

    4 Chess Servers

    -

    An Internet Chess Server, or ICS, is a place on the +

    An Internet Chess Server, or ICS, is a place on the Internet where people can get together to play chess, watch other people's games, or just chat. You can use either telnet or a client program like XBoard to connect to the server. There are @@ -1807,25 +1837,25 @@ unique guest name for you.

    Some useful ICS commands include

    -
    help <topic>
    to get help on the given <topic>. To get a list of possible topics type +
    help <topic>
    to get help on the given <topic>. To get a list of possible topics type help without topic. Try the help command before you ask other people on the server for help.

    For example help register tells you how to become a registered ICS player. -

    who <flags>
    to see a list of people who are logged on. Administrators +
    who <flags>
    to see a list of people who are logged on. Administrators (people you should talk to if you have a problem) are marked with the character ‘*’, an asterisk. The <flags> allow you to display only selected players: For example, who of shows a list of players who are interested in playing but do not have an opponent. -
    games
    to see what games are being played +
    games
    to see what games are being played
    match <player> [<mins>] [<inc>]
    to challenge another player to a game. Both opponents get <mins> minutes for the game, and <inc> seconds will be added after each move. If another player challenges you, the server asks if you want to accept the challenge; use the accept or decline commands to answer. -
    accept
    decline
    to accept or decline another player's offer. +
    accept
    decline
    to accept or decline another player's offer. The offer may be to start a new game, or to agree to a draw, adjourn or abort the current game. See Action Menu. @@ -1833,7 +1863,7 @@ The offer may be to start a new game, or to agree to a is challenging you, or if your opponent offers both a draw and to adjourn the game), you have to supply additional information, by typing something like accept <player>, accept draw, or draw. -
    draw
    adjourn
    abort
    asks your opponent to terminate a game by mutual agreement. Adjourned +
    draw
    adjourn
    abort
    asks your opponent to terminate a game by mutual agreement. Adjourned games can be continued later. Your opponent can either decline your offer or accept it (by typing the same command or typing accept). In some cases these commands work @@ -1841,11 +1871,11 @@ immediately, without asking your opponent to agree. For example, you can abort the game unilaterally if your opponent is out of time, and you can claim a draw by repetition or the 50-move rule if available simply by typing draw. -
    finger <player>
    to get information about the given <player>. (Default: yourself.) -
    vars
    to get a list of personal settings -
    set <var> <value>
    to modify these settings -
    observe <player>
    to observe an ongoing game of the given <player>. -
    examine
    oldmoves
    to review a recently completed game +
    finger <player>
    to get information about the given <player>. (Default: yourself.) +
    vars
    to get a list of personal settings +
    set <var> <value>
    to modify these settings +
    observe <player>
    to observe an ongoing game of the given <player>. +
    examine
    oldmoves
    to review a recently completed game

    Some special XBoard features are activated when you are @@ -1995,7 +2025,7 @@ Up: Top

    6 Environment variables

    -

    Game and position files are found in a directory named by the +

    Game and position files are found in a directory named by the CHESSDIR environment variable. If this variable is not set, the current working directory is used. If CHESSDIR is set, XBoard actually changes its working directory to @@ -2013,7 +2043,7 @@ Up: Top

    7 Limitations and known bugs

    -

    There is no way for two people running copies of XBoard to play +

    There is no way for two people running copies of XBoard to play each other without going through an Internet Chess Server.

    Under some circumstances, your ICS password may be echoed when you log on. @@ -2078,7 +2108,7 @@ Up: Top

    8 Reporting problems

    -

    +

    Report bugs and problems with XBoard to <bug-xboard@gnu.org>.

    Please use the script program to start a typescript, run @@ -2122,7 +2152,7 @@ Up: Top

    9 Authors and contributors

    -

    +

    Tim Mann has been responsible for XBoard versions 1.3 and beyond, and for WinBoard, a port of XBoard to Microsoft Win32 (Windows NT and Windows 95). H.G.Muller is responsible for version 4.3. @@ -2149,7 +2179,7 @@ responsible for versions 1.0 through 1.2.

    Evan Welsh wrote CMail. Patrick Surry helped in designing, testing, and documenting CMail. -

    Allessandro Scotti added many elements to the user interface of WinBoard, +

    Alessandro Scotti added many elements to the user interface of WinBoard, including the board textures and font-based rendering, the evaluation-graph, move-history and engine-output window. He was also responsible for adding the UCI support. @@ -2160,7 +2190,7 @@ the crazyhouse holdings, and the fairy pieces. In addition he added most of the adjudication options, made WinBoard more robust in dealing with buggy and crashing engines, and extended time control with a time-odds and node-count-based modes. -Most of the options that initially wre WinBoard only have now been back-ported to XBoard. +Most of the options that initially were WinBoard only have now been back-ported to XBoard.

    Michel van den Bergh provided the code for reading Polyglot opening books. @@ -2179,7 +2209,7 @@ Up: Top

    10 CMail

    -

    The cmail program can help you play chess by email with opponents of +

    The cmail program can help you play chess by email with opponents of your choice using XBoard as an interface.

    You will usually run cmail without giving any options. @@ -2238,10 +2268,10 @@ directory as cmail keeps its working files (above). environment variable $CMAIL_MAILPROG or failing that /usr/ucb/Mail, /usr/ucb/mail or Mail. You will need to set this variable if none of the above paths fit your system. -

    -gamesFile <file>
    A file containing a list of games with email addresses. This defaults to +
    -gamesFile <file>
    A file containing a list of games with email addresses. This defaults to the environment variable $CMAIL_GAMES or failing that .cmailgames. -
    -aliasesFile <file>
    A file containing one or more aliases for a set of email addresses. This +
    -aliasesFile <file>
    A file containing one or more aliases for a set of email addresses. This defaults to the environment variable $CMAIL_ALIASES or failing that .cmailaliases.
    -logFile <file>
    A file in which to dump verbose debugging messages that are invoked with @@ -2395,7 +2425,7 @@ Up: Top

    11 Other programs you can use with XBoard

    -

    +

    Here are some other programs you can use with XBoard