From: Arun Persaud Date: Thu, 21 Feb 2013 06:32:14 +0000 (+0000) Subject: updated manual to 4.7.0 X-Git-Url: http://winboard.nl/cgi-bin?p=xboard.git;a=commitdiff_plain;h=9d617ed09387abb080e6728fda8a9ddfbc71ba41 updated manual to 4.7.0 --- diff --git a/manual/html_node/Action-Menu.html b/manual/html_node/Action-Menu.html index d20d880..3c36455 100644 --- a/manual/html_node/Action-Menu.html +++ b/manual/html_node/Action-Menu.html @@ -34,45 +34,45 @@ Up: Menus

3.5 Action Menu

-

+

-
Accept
Accepts a pending match offer. +
Accept
Accepts a pending match offer. The F3 key is a keyboard equivalent. If there is more than one offer pending, you will have to type in a more specific command instead of using this menu choice. -
Decline
Declines a pending offer (match, draw, adjourn, etc.). +
Decline
Declines a pending offer (match, draw, adjourn, etc.). The F4 key is a keyboard equivalent. If there is more than one offer pending, you will have to type in a more specific command instead of using this menu choice. -
Call Flag
Calls your opponent's flag, claiming a win on time, or claiming +
Call Flag
Calls your opponent's flag, claiming a win on time, or claiming a draw if you are both out of time. The F5 key is a keyboard equivalent. You can also call your opponent's flag by clicking on his clock. -
Draw
Offers a draw to your opponent, accepts a pending draw offer +
Draw
Offers a draw to your opponent, accepts a pending draw offer from your opponent, or claims a draw by repetition or the 50-move rule, as appropriate. The F6 key is a keyboard equivalent. -
Adjourn
Asks your opponent to agree to adjourning the current game, or +
Adjourn
Asks your opponent to agree to adjourning the current game, or agrees to a pending adjournment offer from your opponent. The F7 key is a keyboard equivalent. -
Abort
Asks your opponent to agree to aborting the current game, or +
Abort
Asks your opponent to agree to aborting the current game, or agrees to a pending abort offer from your opponent. The F8 key is a keyboard equivalent. An aborted game ends immediately without affecting either player's rating. -
Resign
Resigns the game to your opponent. The F9 key is a +
Resign
Resigns the game to your opponent. The F9 key is a keyboard equivalent. -
Stop Observing
Ends your participation in observing a game, by issuing the ICS +
Stop Observing
Ends your participation in observing a game, by issuing the ICS observe command with no arguments. ICS mode only. The F10 key is a keyboard equivalent. -
Stop Examining
Ends your participation in examining a game, by issuing the ICS +
Stop Examining
Ends your participation in examining a game, by issuing the ICS unexamine command. ICS mode only. The F11 key is a keyboard equivalent. -
Upload to Examine
Create an examined game of the proper variant on the ICS, +
Upload to Examine
Create an examined game of the proper variant on the ICS, and send the game there that is currenty loaded in XBoard (e.g. through pasting or loading from file). You must be connected to an ICS for this to work. -
Adjudicate to White
Adjudicate to Black
Adjudicate Draw
Terminate an ongoing game in Two-Machines mode (including match mode), +
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". diff --git a/manual/html_node/Adjudication-Options.html b/manual/html_node/Adjudication-Options.html index 282afee..63570ca 100644 --- a/manual/html_node/Adjudication-Options.html +++ b/manual/html_node/Adjudication-Options.html @@ -34,35 +34,35 @@ Up: Options

4.7 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 adjudication) -
-adjudicateDrawMoves n
If the given value is non-zero, XBoard adjudicates the game as a draw +
-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, +
-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 diff --git a/manual/html_node/CMail.html b/manual/html_node/CMail.html index 5a41c85..4362365 100644 --- a/manual/html_node/CMail.html +++ b/manual/html_node/CMail.html @@ -33,7 +33,7 @@ Up: Top

11 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. diff --git a/manual/html_node/Chess-Servers.html b/manual/html_node/Chess-Servers.html index dd4134f..718f7a6 100644 --- a/manual/html_node/Chess-Servers.html +++ b/manual/html_node/Chess-Servers.html @@ -33,7 +33,7 @@ Up: Top

5 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 @@ -66,25 +66,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. @@ -92,7 +92,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 @@ -100,11 +100,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 diff --git a/manual/html_node/Chess-engine-options.html b/manual/html_node/Chess-engine-options.html index bc468be..1f27438 100644 --- a/manual/html_node/Chess-engine-options.html +++ b/manual/html_node/Chess-engine-options.html @@ -32,36 +32,36 @@ Up: Options

4.1 Chess Engine Options

-

+

-
-tc or -timeControl minutes[:seconds]
Each player begins with his clock set to the timeControl period. +
-tc or -timeControl minutes[:seconds]
Each player begins with his clock set to the timeControl period. Default: 5 minutes. The additional options movesPerSession and timeIncrement are mutually exclusive. -
-mps or -movesPerSession moves
When both players have made movesPerSession moves, a +
-mps or -movesPerSession moves
When both players have made movesPerSession moves, a new timeControl period is added to both clocks. Default: 40 moves. -
-inc or -timeIncrement seconds
If this option is specified, movesPerSession is ignored. +
-inc or -timeIncrement seconds
If this option is specified, movesPerSession is ignored. Instead, after each player's move, timeIncrement seconds are added to his clock. Use ‘-inc 0’ if you want to require the entire game to be played in one timeControl period, with no increment. Default: -1, which specifies movesPerSession mode. -
-clock/-xclock or -clockMode true/false
Determines whether or not to display the chess clocks. If clockMode is +
-clock/-xclock or -clockMode true/false
Determines whether or not to display the chess clocks. If clockMode is false, the clocks are not shown, but the side that is to play next is still highlighted. Also, unless searchTime is set, the chess engine still keeps track of the clock time and uses it to determine how fast to make its moves. -
-st or -searchTime minutes[:seconds]
Tells the chess engine to spend at most the given amount of time +
-st or -searchTime minutes[:seconds]
Tells the chess engine to spend at most the given amount of time searching for each of its moves. Without this option, the chess engine chooses its search time based on the number of moves and amount of time remaining until the next time control. Setting this option also sets clockMode to false. -
-depth or -searchDepth number
Tells the chess engine to look ahead at most the given number of moves +
-depth or -searchDepth number
Tells the chess engine to look ahead at most the given number of moves when searching for a move to make. Without this option, the chess engine chooses its search depth based on the number of moves and amount of time remaining until the next time control. With the option, the engine will cut off its search early if it reaches the specified depth. -
-firstNPS number
-secondNPS number
Tells the chess engine to use an internal time standard based on its node count, +
-firstNPS number
-secondNPS number
Tells the chess engine to use an internal time standard based on its node count, rather then wall-clock time, to make its timing decisions. The time in virtual seconds should be obtained by dividing the node count through the given number, like the number was a rate in nodes per second. @@ -74,16 +74,16 @@ can provide fairer conditions for engine-engine matches on heavily loaded machin or with very fast games (where the wall clock is too inaccurate). showThinking must be on for this option to work. Default: -1 (off). Not many engines might support this yet! -
-firstTimeOdds factor
-secondTimeOdds factor
Reduces the time given to the mentioned engine by the given factor. +
-firstTimeOdds factor
-secondTimeOdds factor
Reduces the time given to the mentioned engine by the given factor. If pondering is off, the effect is indistinguishable from what would happen if the engine was running on an n-times slower machine. Default: 1. -
-timeOddsMode mode
This option determines how the case is handled where both engines have a time-odds handicap. +
-timeOddsMode mode
This option determines how the case is handled where both engines have a time-odds handicap. 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. (Replaces the Show-Thinking option of older xboard versions.) -
-thinking/-xthinking or -showThinking true/false
Forces the engine to send thinking output to xboard. +
-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, but as the thinking output in xboard 4.3 is also used for several other @@ -91,10 +91,10 @@ purposes (adjudication, storing in PGN file) the display of it is now controlled by the new option Hide Thinking. See Options Menu. Default: false. (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. +
-ponder/-xponder or -ponderNextMove true/false
Sets the Ponder Next Move menu option. See Options Menu. Default: true.
-smpCores number
Specifies the maximum number of CPUs an SMP engine is allowed to use. Only works for engines that support the XBoard/WinBoard-protocol cores feature. -
-mg or -matchGames n
Automatically runs an n-game match between two chess engines, +
-mg or -matchGames n
Automatically runs an n-game match between two chess engines, with alternating colors. If the loadGameFile or loadPositionFile option is set, XBoard @@ -105,35 +105,42 @@ match is appended to the specified file. If the savePositionFile option is set, the final position reached in each game of the match is appended to the specified file. When the match is over, XBoard displays the match score and exits. Default: 0 (do not run a match). -
-mm/-xmm or -matchMode true/false
Setting matchMode to true is equivalent to setting +
-mm/-xmm or -matchMode true/false
Setting matchMode to true is equivalent to setting matchGames to 1. -
-sameColorGames n
Automatically runs an n-game match between two chess engines, +
-sameColorGames n
Automatically runs an n-game match between two chess engines, without alternating colors. Otherwise the same applies as for the ‘-matchGames’ option, over which it takes precedence if both are specified. (See there.) Default: 0 (do not run a match). -
-fcp or -firstChessProgram program
Name of first chess engine. +
-fcp or -firstChessProgram program
Name of first chess engine. Default: Fairy-Max. -
-scp or -secondChessProgram program
Name of second chess engine, if needed. +
-scp or -secondChessProgram program
Name of second chess engine, if needed. A second chess engine is started only in Two Machines (match) mode. Default: Fairy-Max. -
-fb/-xfb or -firstPlaysBlack true/false
In games between two chess engines, firstChessProgram normally plays +
-fe or -firstEngine nickname
This is an alternative to the fcp option for specifying the first engine, +for engines that were already configured (using the ‘Load Engine’ dialog) +in XBoard's settings file. +It will not only retrieve the real name of the engine, +but also all options configured with it. +(E.g. if it is UCI, whether it should use book.) +
-se or -secondEngine nickname
As fe, but for the second engine. +
-fb/-xfb or -firstPlaysBlack true/false
In games between two chess engines, firstChessProgram normally plays white. If this option is true, firstChessProgram plays black. In a multi-game match, this option affects the colors only for the first game; they still alternate in subsequent games. -
-fh or -firstHost host
-sh or -secondHost host
Hosts on which the chess engines are to run. The default for +
-fh or -firstHost host
-sh or -secondHost host
Hosts on which the chess engines are to run. The default for each is localhost. If you specify another host, XBoard uses rsh to run the chess engine there. (You can substitute a different remote shell program for rsh using the remoteShell option described below.) -
-fd or -firstDirectory dir
-sd or -secondDirectory dir
Working directories in which the chess engines are to be run. +
-fd or -firstDirectory dir
-sd or -secondDirectory dir
Working directories in which the chess engines are to be run. The default is "", which means to run the chess engine in the same working directory as XBoard itself. (See the CHESSDIR environment variable.) This option is effective only when the chess engine is being run on the local host; it does not work if the engine is run remotely using the -fh or -sh option. -
-initString string or -firstInitString
-secondInitString string
The string that is sent to initialize each chess engine for a new game. +
-initString string or -firstInitString
-secondInitString string
The string that is sent to initialize each chess engine for a new game. Default: 
          new
@@ -142,10 +149,8 @@ Default:
      
Setting this option from the command line is tricky, because you must
 type in real newline characters, including one at the very end. 
 In most shells you can do this by
-entering a ‘\’ character followed by a newline. It is easier to set
-the option from your .Xresources file; in that case you can
-include the character sequence ‘\n’ in the string, and it will
-be converted to a newline.
+entering a ‘\’ character followed by a newline. 
+Using the character sequence ‘\n’ in the string should work too, though.
 
      
If you change this option, don't remove the ‘new’
 command; it is required by all chess engines to
@@ -160,11 +165,11 @@ and always (or never) randomize.
 
      
You can also try adding other commands to the initString; see the
 documentation of the chess engine you are using for details. 
-
-firstComputerString string
-secondComputerString string
The string that is sent to the chess engine if its opponent is another
+
-firstComputerString string
-secondComputerString string
The string that is sent to the chess engine if its opponent is another
 computer chess engine.  The default is ‘computer\n’.  Probably the
 only useful alternative is the empty string (‘’), which keeps the
 engine from knowing that it is playing another computer. 
-
-reuse/-xreuse or -reuseFirst true/false
-reuse2/-xreuse2 or -reuseSecond true/false
If the option is false,
+
-reuse/-xreuse or -reuseFirst true/false
-reuse2/-xreuse2 or -reuseSecond true/false
If the option is false,
 XBoard kills off the chess engine after every game and starts
 it again for the next game. 
 If the option is true (the default),
@@ -172,26 +177,26 @@ XBoard starts the chess engine only once
 and uses it repeatedly to play multiple games. 
 Some old chess engines may not work properly when
 reuse is turned on, but otherwise games will start faster if it is left on. 
-
-firstProtocolVersion version-number
-secondProtocolVersion version-number
This option specifies which version of the chess engine communication
+
-firstProtocolVersion version-number
-secondProtocolVersion version-number
This option specifies which version of the chess engine communication
 protocol to use.  By default, version-number is 2.  In version 1, the
 "protover" command is not sent to the engine; since version 1 is a
 subset of version 2, nothing else changes.  Other values for
 version-number are not supported. 
-
-firstScoreAbs true/false
-secondScoreAbs true/false
If this option is set, the score reported by the engine is taken to be
+
-firstScoreAbs true/false
-secondScoreAbs true/false
If this option is set, the score reported by the engine is taken to be
 that in favor of white, even when the engine plays black. 
 Important when XBoard uses the score for adjudications, or in PGN reporting. 
-
-niceEngines priority
This option allows you to lower the priority of the engine processes,
+
-niceEngines priority
This option allows you to lower the priority of the engine processes,
 so that the generally insatiable hunger for CPU time of chess engines does not interfere so much
 with smooth operation of XBoard (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,
+
-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 an option announced by the engine at startup through the feature commands of the XBoard/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)
 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
+
-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,
@@ -201,7 +206,7 @@ castling and e.p. fields in variants that do not have castling or e.p.
 (shatranj, courier, xiangqi, shogi) so that XBoard would normally omit them
 (string = "- -"), or to add variant-specific fields that are not yet supported by XBoard
 (e.g. to indicate the number of checks in 3check). 
-
-shuffleOpenings
Forces shuffling of the opening setup in variants that normally have a fixed initial position. 
+
-shuffleOpenings
Forces shuffling of the opening setup in variants that normally have a fixed initial position. 
 Shufflings are symmetric for black and white, and exempt King and Rooks in variants
 with normal castling. 
 Remains in force until a new variant is selected. 
diff --git a/manual/html_node/Contributors.html b/manual/html_node/Contributors.html
index e5b9f31..16fc06e 100644
--- a/manual/html_node/Contributors.html
+++ b/manual/html_node/Contributors.html
@@ -33,7 +33,7 @@ Up: Top
 
 
10 Authors and contributors

 
-

+

 Chris Sears and Dan Sears wrote the original XBoard.  They were
 responsible for versions 1.0 through 1.2.  The color scheme was taken
 from Wayne Christopher's XChess program.
diff --git a/manual/html_node/Copyright.html b/manual/html_node/Copyright.html
index 4ec3ef3..c8400b6 100644
--- a/manual/html_node/Copyright.html
+++ b/manual/html_node/Copyright.html
@@ -54,7 +54,7 @@ arising out of or in connection with the use or performance of this
 software.
 
    
Enhancements copyright © 1992-2003, 2004, 2005, 2006, 2007,
-2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc.
+2008, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc.
 
 
Published by the Free Software Foundation
 59 Temple Place - Suite 330
diff --git a/manual/html_node/Edit-Menu.html b/manual/html_node/Edit-Menu.html
index c028690..f2baa9a 100644
--- a/manual/html_node/Edit-Menu.html
+++ b/manual/html_node/Edit-Menu.html
@@ -34,32 +34,32 @@ Up: Menus
 
 
3.2 Edit Menu

 
-

+

      

-
Copy Game
Copies a record of the current game to an internal clipboard in PGN
+
Copy Game
Copies a record of the current game to an internal clipboard in PGN
 format and sets the X selection to the game text. The Ctrl-C
 key is a keyboard equivalent. The game can be
 pasted to another application (such as a text editor or another copy
 of XBoard) using that application's paste command.  In many X
 applications, such as xterm and emacs, the middle mouse button can be
 used for pasting; in XBoard, you must use the Paste Game command. 
-
Copy Position
Copies the current position to an internal clipboard in FEN format and
+
Copy Position
Copies the current position to an internal clipboard in FEN format and
 sets the X selection to the position text. The shifted Ctrl-C key
 is a keyboard equivalent.  The position can be pasted
 to another application (such as a text editor or another copy of
 XBoard) using that application's paste command.  In many X
 applications, such as xterm and emacs, the middle mouse button can be
 used for pasting; in XBoard, you must use the Paste Position command. 
-
Copy Game List
Copies the current game list to the clipboard,
+
Copy Game List
Copies the current game list to the clipboard,
 and sets the X selection to this text. 
 A format of comma-separated double-quoted strings is used,
 including all tags,
 so it can be easily imported into spread-sheet programs. 
-
Paste Game
Interprets the current X selection as a game record and loads it, as
+
Paste Game
Interprets the current X selection as a game record and loads it, as
 with Load Game. The Ctrl-V key is a keyboard equivalent. 
-
Paste Position
Interprets the current X selection as a FEN position and loads it, as
+
Paste Position
Interprets the current X selection as a FEN position and loads it, as
 with Load Position. The shifted Ctrl-V key is a keyboard equivalent. 
-
Edit Game
Allows you to make moves for both Black and White, and to change
+
Edit Game
Allows you to make moves for both Black and White, and to change
 moves after backing up with the ‘Backward’ command. The clocks do
 not run. The Ctrl-E key is a keyboard equivalent.
 
@@ -73,7 +73,7 @@ XBoard out of ICS Client mode and lets you edit games locally.
 If you want to edit games on ICS in a way that other ICS users
 can see, use the ICS examine command or start an ICS match
 against yourself. 
-
Edit Position
Lets you set up an arbitrary board position. 
+
Edit Position
Lets you set up an arbitrary board position. 
 The shifted Ctrl-E key is a keyboard equivalent. 
 Use mouse button 1 to drag pieces to new squares, or to delete a piece
 by dragging it off the board or dragging an empty square on top of it. 
@@ -102,7 +102,7 @@ not sent to the ICS: ‘Edit Position
 edit positions on ICS in a way that other ICS users can see, use
 the ICS examine command, or start an ICS match against yourself. 
 (See also the ICS Client topic above.) 
-
Edit Tags
Lets you edit the PGN (portable game notation)
+
Edit Tags
Lets you edit the PGN (portable game notation)
 tags for the current game. After editing, the tags must still conform to
 the PGN tag syntax:
 
@@ -126,10 +126,12 @@ the PGN tag syntax:
 the PGN standard requires all games to have at least the seven tags shown
 above. Any that you omit will be filled in by XBoard
 with ‘?’ (unknown value), or ‘-’ (inapplicable value). 
-
Edit Comment
Adds or modifies a comment on the current position. Comments are
+
Edit Comment
Adds or modifies a comment on the current position. Comments are
 saved by ‘Save Game’ and are displayed by ‘Load Game’,
+PGN variations will also be printed in this window,
+and can be promoted to main line by right-clicking them. 
 ‘Forward’, and ‘Backward’. 
-
Edit Book
Pops up a window listing the moves available in the GUI book
+
Edit Book
Pops up a window listing the moves available in the GUI book
 (specified in the ‘Common Engine Settings’ dialog)
 from the currently displayed position,
 together with their weights and (optionally in braces) learn info. 
@@ -137,7 +139,7 @@ You can then edit this list, and the new list will be stored
 back into the book when you press OK. 
 Note that the listed percentages are neither used, nor updated when
 you change the weights; they are just there as an optical aid. 
-
Revert
Annotate
If you are examining an ICS game and Pause mode is off,
+
Revert
Annotate
If you are examining an ICS game and Pause mode is off,
 Revert issues the ICS command ‘revert’. 
 In local mode, when you were editing or analyzing a game,
 and the -variations command-line option is switched on,
@@ -157,11 +159,11 @@ the variation you are now abandoning will be added as a comment
 (in PGN variation syntax, i.e. between parentheses)
 to the original move where you deviated, for later recalling. 
 The Home key is a keyboard equivalent to ‘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. 
 The End key is a keyboard equivalent. 
-
Backward
Steps backward through a series of remembered moves. 
+
Backward
Steps backward through a series of remembered moves. 
 The ‘[<]’ button and the Alt+LeftArrow key are equivalents,
 as is turning the mouse wheel towards you. 
 In addition, pressing the Control key steps back one move, and releasing
@@ -180,7 +182,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 Alt+RightArrow key are equivalents,
 as is turning the mouse wheel away from you.
@@ -192,7 +194,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 Alt+Home key are equivalents.
 
      
In most modes, Back to Start only lets you look back at old
@@ -209,7 +211,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 Alt+End key are equivalents.
 
      
If you are examining an ICS game, the behavior of ‘Forward to
diff --git a/manual/html_node/Engine-Menu.html b/manual/html_node/Engine-Menu.html
index e9c1e26..fbf6f78 100644
--- a/manual/html_node/Engine-Menu.html
+++ b/manual/html_node/Engine-Menu.html
@@ -34,9 +34,9 @@ Up: Menus
 
 
3.6 Engine Menu

 
-

+

      

-
Load Engine
Pops up a dialog where you can select or specify an engine to be loaded. 
+
Load Engine
Pops up a dialog where you can select or specify an engine to be loaded. 
 You will always have to indicate whether you want to load the engine
 as first or second engine, through the ‘Load menitioned engine as’
 drop-down list at the bottom of the dialog. 
@@ -65,7 +65,7 @@ will also be included in the list.
 For obsolete XBoard engines, which would normally take a long delay to load
 because XBoard is waiting for a response they will not give,
 you can tick ‘WB protocol v1’ to speed up the loading process. 
-
Engine #N Settings
Pop up a menu dialog to alter the settings specific to the applicable engine. 
+
Engine #N Settings
Pop up a menu dialog to alter the settings specific to the applicable engine. 
 (The second engine is only accessible once it has been used in Two-Machines mode.) 
 For each parameter the engine allows to be set,
 a control element will appear in this dialog that can be used to alter the value. 
@@ -80,23 +80,23 @@ and in that case the dialog will be empty (except for the OK and cancel buttons)
 UCI engines usually have many parameters. (But these are only visible with
 a sufficiently modern version of the Polyglot adapter needed to run UCI engines,
 e.g. Polyglot 1.4.55b.) For native XBoard engines this is less common. 
-
Hint
Displays a move hint from the chess engine. 
-
Book
Displays a list of possible moves from the chess engine's opening
+
Hint
Displays a move hint from the chess engine. 
+
Book
Displays a list of possible moves from the chess engine's opening
 book.  The exact format depends on what chess engine you are using. 
 With GNU Chess 4, the first column gives moves, the second column
 gives one possible response for each move, and the third column shows
 the number of lines in the book that include the move from the first
 column. If you select this option and nothing happens, the chess
 engine is out of its book or does not support this feature. 
-
Move Now
Forces the chess engine to move immediately. Chess engine mode only. 
+
Move Now
Forces the chess engine to move immediately. Chess engine mode only. 
 The Ctrl-M key is a keyboard equivalent. 
-
Retract Move
Retracts your last move. In chess engine mode, you can do this 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. 
 The Ctrl-X key is a keyboard equivalent. 
-
Recently Used Engines
At the bottom of the engine menu there can be a list of names
+
Recently Used Engines
At the bottom of the engine menu there can be a list of names
 of engines that you recently loaded through the Load Engine menu dialog
 in previous sessions. 
 Clicking on such a name will load that engine as first engine,
diff --git a/manual/html_node/Environment.html b/manual/html_node/Environment.html
index a7df8e2..73efa40 100644
--- a/manual/html_node/Environment.html
+++ b/manual/html_node/Environment.html
@@ -33,7 +33,7 @@ Up: Top
 
 
7 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
diff --git a/manual/html_node/File-Menu.html b/manual/html_node/File-Menu.html
index 9093a1f..b960ed7 100644
--- a/manual/html_node/File-Menu.html
+++ b/manual/html_node/File-Menu.html
@@ -137,8 +137,19 @@ FEN (Forsythe-Edwards notation) format unless the oldSaveStyle
 option is true, in which case they are saved in an older,
 human-readable format that is specific to XBoard. Both formats
 can be read back by the ‘Load Position’ command. 
-
Mail Move
Reload CMail Message
See CMail. 
-
Exit
Exits from XBoard. The Ctrl-Q key is a keyboard equivalent. 
+
Save Games as Book
Creates an opening book from the currently loaded game file. 
+The book will be saved on the file specified in the ‘Common Engine’
+options dialog. 
+The value of ‘Book Depth’ specified in that same dialog will
+be used to determine how many moves of each game will be added to
+the internal book buffer. 
+This command can take a long time to process,
+and the size of the buffer is currently limited. 
+At the end the buffer will be saved as a Polyglot book,
+but the buffer will ot be cleared,
+so that you can continue adding games from other game files. 
+
Mail Move
Reload CMail Message
See CMail. 
+
Exit
Exits from XBoard. The Ctrl-Q key is a keyboard equivalent. 
 

 
    
diff --git a/manual/html_node/Firewalls.html b/manual/html_node/Firewalls.html
index 0226699..6efbf63 100644
--- a/manual/html_node/Firewalls.html
+++ b/manual/html_node/Firewalls.html
@@ -48,11 +48,6 @@ command-line options as follows:
 
 
     xboard -ics -icshost firewall.example.com -icsport 23
 

-   
Or in your .Xresources file:
-
-
     XBoard*internetChessServerHost: firewall.example.com
-     XBoard*internetChessServerPort: 23
-

    
Then when you run XBoard in ICS mode, you will be prompted
 to log in to the firewall host. This works because port 23 is the
 standard telnet login service. Do so, then telnet to ICS, using a
@@ -81,12 +76,7 @@ command-line options as follows:
 
 
     xboard -ics -gateway rsh.example.com -icshost chessclub.com
 

-   
Or in your .Xresources file:
-
-
     XBoard*gateway: rsh.example.com
-     XBoard*internetChessServerHost: chessclub.com
-

-   
Then when you run XBoard in ICS mode, it will connect to
+   
Then when you run XBoard in ICS mode, it will connect to
 the ICS by using rsh to run the command
 ‘telnet chessclub.com 5000’ on host ‘rsh.example.com’.
 
@@ -99,11 +89,6 @@ In this case set command line options as follows:
 
 
     xboard -ics -telnet -telnetProgram ptelnet
 

-   
Or in your .Xresources file:
-
-
     XBoard*useTelnet: true
-     XBoard*telnetProgram: ptelnet
-

    
Then when you run XBoard in ICS mode, it will issue the
 command ‘ptelnet chessclub.com 5000’ to connect to the ICS.
 
@@ -111,8 +96,7 @@ command ‘ptelnet chessclub.com 5000
 that is, your ptelnet program doesn't let you connect to
 alternative ports. As noted above, your chess server may allow you to
 connect on port 23 instead.  In that case, just add the option
-‘-icsport ""’ to the above command, or add
-‘XBoard*internetChessServerPort:’ to your .Xresources file. 
+‘-icsport ""’ to the above command. 
 But if your chess server doesn't let you connect on port 23, you will have
 to find some other host outside the firewall and hop through it. For
 instance, suppose you have a shell account at ‘foo.edu’. Set
@@ -120,13 +104,6 @@ command line options as follows:
 
 
     xboard -ics -telnet -telnetProgram ptelnet -icshost foo.edu -icsport ""
 

-   
Or in your .Xresources file:
-
-
     XBoard*useTelnet: true
-     XBoard*telnetProgram: ptelnet
-     XBoard*internetChessServerHost: foo.edu
-     XBoard*internetChessServerPort:
-

    
Then when you run XBoard in ICS mode, it will issue the
 command ‘ptelnet foo.edu’ to connect to your account at
 ‘foo.edu’. Log in there, then type ‘telnet chessclub.com 5000’.
diff --git a/manual/html_node/Help-Menu.html b/manual/html_node/Help-Menu.html
index be89a5a..1945a0a 100644
--- a/manual/html_node/Help-Menu.html
+++ b/manual/html_node/Help-Menu.html
@@ -34,20 +34,20 @@ Up: Menus
 
 
3.8 Help Menu

 
-

+

      

-
Info XBoard
Displays the XBoard documentation in info format.  For this feature to
+
Info XBoard
Displays the XBoard documentation in info format.  For this feature to
 work, you must have the GNU info program installed on your system, and
 the file xboard.info must either be present in the current
 working directory, or have been installed by the ‘make install’
 command when you built XBoard. 
-
Man XBoard
Displays the XBoard documentation in man page format. 
+
Man XBoard
Displays the XBoard documentation in man page format. 
 The F1 key is a keyboard equivalent.  For this
 feature to work, the file xboard.6 must have been installed by
 the ‘make install’ command when you built XBoard, and the
 directory it was placed in must be on the search path for your
 system's ‘man’ command. 
-
About XBoard
Shows the current XBoard version number. 
+
About XBoard
Shows the current XBoard version number. 
 

 
    
diff --git a/manual/html_node/ICS-options.html b/manual/html_node/ICS-options.html
index fa8c5bb..c28a110 100644
--- a/manual/html_node/ICS-options.html
+++ b/manual/html_node/ICS-options.html
@@ -34,12 +34,12 @@ Up: Options
 
 
4.4 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
@@ -47,15 +47,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. 
@@ -63,21 +63,21 @@ 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),
@@ -120,7 +120,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. 
@@ -128,35 +128,35 @@ 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. 
-
-seekGraph true/false or -sg
Enables displaying of the seek graph by left-clicking the board when
+
-seekGraph true/false or -sg
Enables displaying of the seek graph by left-clicking the board when
 you are logged on to an ICS and currently idle. 
 The seek graph show all players currently seeking games on the ICS,
 plotted according to their rating and the time control of the game they seek,
 in three different colors (for rated, unrated and wild games). 
 Computer ads are displayed as squares, human ads are dots. 
 Default: false. 
-
-autoRefresh true/false
Enables automatic updating of the seek graph,
+
-autoRefresh true/false
Enables automatic updating of the seek graph,
 by having the ICS send a running update of all newly placed
 and removed seek ads. 
 This consumes a substantial amount of communication bandwidth,
 and is only supported for FICS and ICC. 
 Default: false. 
-
-backgroundObserve true/false
When true, boards sent to you by the ICS from other games while you are playing
+
-backgroundObserve true/false
When true, boards sent to you by the ICS from other games while you are playing
 (e.g. because you are observing them)
 will not be automatically displayed. 
 Only a summary of time left and material of both players will appear
@@ -170,7 +170,7 @@ This feature is provided solely for the benefit of bughouse players,
 to enable them to peek at their partner's game without the need
 to logon twice. 
 Default: false. 
-
-dualBoard true/false
In combination with -backgroundObserve true, this option will display
+
-dualBoard true/false
In combination with -backgroundObserve true, this option will display
 the board of the background game side by side with that of your own game,
 so you can have it in view permanently. 
 Any board or holdings info coming in will be displayed on the secondary
@@ -178,25 +178,25 @@ board immediately.
 This feature is still experimental and largely unfinished. 
 There is no animation or highlighting of moves on the secondary board. 
 Default: false. 
-
-disguisePromotedPieces true/false
When set promoted Pawns in crazyhouse/bughouse are displayed identical
+
-disguisePromotedPieces true/false
When set promoted Pawns in crazyhouse/bughouse are displayed identical
 to primordial pieces of the same type, rather than distinguishable. 
 Default: true. 
-
-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. 
-
lowTimeWarning true/false
Controls a color change of the board as a warning your time is running out. 
+
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. 
-
-prewhite/-xprewhite or -premoveWhite
-preblack/-xpreblack or -premoveBlack
-premoveWhiteText string
-premoveBlackText string
Set the menu options for specifying the first move for either color. 
+
-pre/-xpre \fRor\fB -premove true/false
Sets the Premove menu option. See Options Menu. Default: true. 
+
-prewhite/-xprewhite or -premoveWhite
-preblack/-xpreblack or -premoveBlack
-premoveWhiteText string
-premoveBlackText string
Set the menu options for specifying the first move for either color. 
 See Options Menu. Defaults: false and empty strings, so no pre-moves. 
-
-quiet/-xquiet or -quietPlay true/false
Sets the Quiet Play menu option.  See Options Menu.  Default: false. 
-
-colorizeMessages or -colorize/-xcolorize
Setting colorizeMessages
+
-quiet/-xquiet or -quietPlay true/false
Sets the Quiet Play menu option.  See Options Menu.  Default: false. 
+
-colorizeMessages or -colorize/-xcolorize
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. 
 Default: true. 
-
-colorShout foreground,background,bold
-colorSShout foreground,background,bold
-colorCShout 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
-colorCShout 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
@@ -208,64 +208,28 @@ Here “default” means the default foreground or background color of
 your xterm.  Bold can be 1 or 0.  If background is omitted, “default”
 is assumed; if bold is omitted, 0 is assumed.
 
-     
Here is an example of how to set the colors in your .Xresources file. 
-The colors shown here are the default values; you will get
-them if you turn -colorize on without specifying your own colors. 
-CShout is synonymous with SShout.
-
-     
          xboard*colorizeMessages: true
-          xboard*colorShout: green
-          xboard*colorSShout: green, black, 1
-          xboard*colorChannel1: cyan
-          xboard*colorChannel: cyan, black, 1
-          xboard*colorKibitz: magenta, black, 1
-          xboard*colorTell: yellow, black, 1
-          xboard*colorChallenge: red, black, 1
-          xboard*colorRequest: red
-          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. 
-
-soundDirectory directoryname
This option specifies where XBoard will look for sound files,
+
-soundDirectory directoryname
This option specifies where XBoard will look for sound files,
 when these are not given as an absolute path name. 
-
-soundShout filename
-soundSShout filename
-soundCShout filename
-soundChannel filename
-soundChannel1 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
-soundCShout filename
-soundChannel filename
-soundChannel1 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. 
 CShout is synonymous with SShout. 
-
-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).
-
-     
Here is an example of how to set the sounds in your .Xresources file:
-
-     
          xboard*soundShout: shout.wav
-          xboard*soundSShout: sshout.wav
-          xboard*soundChannel1: channel1.wav
-          xboard*soundChannel: channel.wav
-          xboard*soundKibitz: kibitz.wav
-          xboard*soundTell: tell.wav
-          xboard*soundChallenge: challenge.wav
-          xboard*soundRequest: request.wav
-          xboard*soundSeek: seek.wav
-          xboard*soundMove: move.wav
-          xboard*soundIcsWin: win.wav
-          xboard*soundIcsLoss: lose.wav
-          xboard*soundIcsDraw: draw.wav
-          xboard*soundIcsUnfinished: unfinished.wav
-          xboard*soundIcsAlarm: alarm.wav
-

-     

+sound). 
+

 
    
 
diff --git a/manual/html_node/Index.html b/manual/html_node/Index.html
index 4c173d3..d40e47c 100644
--- a/manual/html_node/Index.html
+++ b/manual/html_node/Index.html
@@ -32,580 +32,599 @@ Up: Top
 
Index

 
 
 

 
Table of Contents

diff --git a/manual/html_node/Keys.html b/manual/html_node/Keys.html
index ce12c7d..289c5e7 100644
--- a/manual/html_node/Keys.html
+++ b/manual/html_node/Keys.html
@@ -32,18 +32,18 @@ Up: Menus
 
 
3.9 Other Shortcut Keys

 
-

+

      

-
Show Last Move
By hitting Enter the last move will be re-animated. 
-
Load Next Game
Loads the next game from the last game record file you loaded. 
+
Show Last Move
By hitting Enter the last move will be re-animated. 
+
Load Next Game
Loads the next game from the last game record file you loaded. 
 The Alt+PgDn key triggers this action. 
-
Load Previous Game
Loads the previous game from the last game record file you
+
Load Previous Game
Loads the previous game from the last game record file you
 loaded.  The Alt+PgUp key triggers this action. 
 Not available if the last game was loaded from a pipe. 
-
Reload Same Game
Reloads the last game you loaded. 
+
Reload Same Game
Reloads the last game you loaded. 
 Not available if the last game was loaded from a pipe. 
 Currently no keystroke is assigned to this ReloadGameProc. 
-
Reload Same Position
Reloads the last position you loaded. 
+
Reload Same Position
Reloads the last position you loaded. 
 Not available if the last position was loaded from a pipe. 
 Currently no keystroke is assigned to this ReloadPositionProc. 
 

diff --git a/manual/html_node/Limitations.html b/manual/html_node/Limitations.html
index 373624f..40eda58 100644
--- a/manual/html_node/Limitations.html
+++ b/manual/html_node/Limitations.html
@@ -33,7 +33,7 @@ Up: Top
 
 
8 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.
diff --git a/manual/html_node/Load-and-Save-options.html b/manual/html_node/Load-and-Save-options.html
index eb36128..89e08a1 100644
--- a/manual/html_node/Load-and-Save-options.html
+++ b/manual/html_node/Load-and-Save-options.html
@@ -34,9 +34,9 @@ Up: Options
 
 
4.5 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
@@ -59,16 +59,17 @@ 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’ or ‘Analyze File’. 
+
-td or -timeDelay seconds
Time delay between moves during ‘Load Game’ or ‘Analyze File’. 
 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
+
-onlyOwnGames true/false
Suppresses auto-saving of ICS observed games. Default: false. 
+
-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
@@ -81,27 +82,27 @@ 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, XBoard saves depth, score and time used for each
+
-pgnExtendedInfo true/false
If this option is set, XBoard 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". 
-
-pgnNumberTag true/false
Include the (unique) sequence number of a tournament game into the saved
+
-pgnNumberTag true/false
Include the (unique) sequence number of a tournament game into the saved
 PGN file as a 'number' tag. 
 Default: false. 
-
-saveOutOfBookInfo true/false
Include the information on how the engine(s) game out of its opening book
+
-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. 
 Default: true. 
-
-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
+
-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, c=result comment. 
 Default: "eprd"
-
-ini or -settingsFile filename
-saveSettingsFile filename
@filename
When XBoard encounters an option -settingsFile (or -ini for short),
+
-ini or -settingsFile filename
-saveSettingsFile filename
@filename
When XBoard encounters an option -settingsFile (or -ini for short),
 or @filename, it tries to read the mentioned file,
 and substitutes the contents of it (presumaby more command-line options)
 in place of the option. 
@@ -120,7 +121,7 @@ and will be used to contain system-wide default setings, amongst which
 a -saveSettingsFile and -settingsFile options to specify a settings file
 accessible to the individual user, such as ~/.xboardrc in the user's
 home directory. 
-
-saveSettingsOnExit true/false
Controls saving of options on the settings file.  See Options Menu. 
+
-saveSettingsOnExit true/false
Controls saving of options on the settings file.  See Options Menu. 
 Default: true. 
 

 
diff --git a/manual/html_node/Mode-Menu.html b/manual/html_node/Mode-Menu.html
index 2b3ac87..00556a7 100644
--- a/manual/html_node/Mode-Menu.html
+++ b/manual/html_node/Mode-Menu.html
@@ -34,15 +34,15 @@ Up: Menus
 
 
3.4 Mode Menu

 
-

+

      

-
Machine White
Tells the chess engine to play White. 
+
Machine White
Tells the chess engine to play White. 
 The Ctrl-W key is a keyboard equivalent. 
-
Machine Black
Tells the chess engine to play Black. 
+
Machine Black
Tells the chess engine to play Black. 
 The Ctrl-B key is a keyboard equivalent. 
-
Two Machines
Plays a game between two chess engines. 
+
Two Machines
Plays a game between two chess engines. 
 The Ctrl-T key is a keyboard equivalent. 
-
Analysis Mode
XBoard tells the chess engine to start analyzing the current game/position
+
Analysis Mode
XBoard tells the chess engine to start analyzing the current game/position
 and shows you the analysis as you move pieces around. 
 The Ctrl-A key is a keyboard equivalent. 
 Note: Some chess engines do not support Analysis mode.
@@ -65,26 +65,57 @@ and then step backward through this game to take the moves back.
 Note that you can also click on the clocks to set the opposite
 side to move (adding a so-called ‘null move’ to the game).
 
-     
The analysis function can also be used when observing games on an ICS
+     
You can also tell the engine to exclude some moves from analysis. 
+(Engines that do not support the exclude-moves feature will
+ignore this, however.) 
+The general way to do this is to play the move you want to exclude
+starting with a double click on the piece. 
+When you use drag-drop moving, the piece you grab with a double click
+will also remain on its square, to show you that you are not really
+making the move, but just forbid it from the current position. 
+Playing a thus excluded move a second time will include it again. 
+Excluded moves will be listed as text in a header line in the
+Engine Output window, and you can also re-include them by
+right-clicking them there. 
+This header line will also contain the words 'best' and 'tail';
+right-clicking those will exclude the currently best move,
+or all moves not explicitly listed in the header line. 
+Once you leave the current position all memory of excluded
+moves will be lost when you return there.
+
+     
Selecting this menu item while already in ‘Analysis Mode’ will
+toggle the participation of the second engine in the analysis. 
+The output of this engine will then be shown in the lower pane
+of the Engine Output window. 
+The analysis function can also be used when observing games on an ICS
 with an engine loaded (zippy mode); the engine then will analyse
-the positions as they occur in the observed game. 
-
Analyze Game
This option subjects the currently loaded game to automatic
+the positions as they occur in the observed game.
+
+     
Analyze Game
This option subjects the currently loaded game to automatic
 analysis by the loaded engine. 
 The Ctrl-G key is a keyboard equivalent. 
 XBoard will start auto-playing the game from the currently displayed position,
 while the engine is analyzing the current position. 
 The game will be annotated with the results of these analyses. 
 In particlar, the score and depth will be added as a comment,
-and the PV will be added as a variation. 
-The time the engine spends on analyzing each move can be controlled
-through the command-line option ‘-timeDelay’. 
+and the PV will be added as a variation.
+
+     
Normally the analysis would stop after reaching the end of the game. 
+But when a game is loaded from a multi-game file
+while ‘Analyze Game’ was already switched on,
+the analysis will continue with the next game in the file
+until the end of the file is reached (or you switch to another mode).
+
+     
The time the engine spends on analyzing each move can be controlled
+through the command-line option ‘-timeDelay’,
+which can also be set from the ‘Load Game Options’ menu dialog. 
 Note: Some chess engines do not support Analysis mode. 
 
Edit Game
Duplicate of the item in the Edit menu. 
 Note that ‘Edit Game’ is the idle mode of XBoard, and can be used
 to get you out of other modes. E.g. to stop analyzing, stop a game
 between two engines or stop editing a position. 
 
Edit Position
Duplicate of the item in the Edit menu. 
-
Training
Training mode lets you interactively guess the moves of a game for one
+
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 auto-played. 
@@ -92,7 +123,7 @@ 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
 ‘Training’ mode, the navigation buttons are disabled. 
-
ICS Client
This is the normal mode when XBoard
+
ICS Client
This is the normal mode when XBoard
 is connected to a chess server.  If you have moved into
 Edit Game or Edit Position mode, you can select this option to get out.
 
@@ -114,12 +145,12 @@ drag pieces to arbitrary squares while examining on ICC, but you can
 do so in bsetup mode on FICS.  In addition, the menu commands
 ‘Forward’, ‘Backward’, ‘Pause’, and ‘Stop Examining’
 have special functions in this mode; see below. 
-
Machine Match
Starts a match between two chess programs,
+
Machine Match
Starts a match between two chess programs,
 with a number of games and other parameters set through
 the ‘Match Options’ menu dialog. 
 When a match is already running, selecting this item will make
 XBoard drop out of match mode after the current game finishes. 
-
Pause
Pauses updates to the board, and if you are playing against a chess engine,
+
Pause
Pauses updates to the board, and if you are playing against a chess engine,
 also pauses your clock. To continue, select ‘Pause’ again, and the
 display will automatically update to the latest position. 
 The ‘P’ button and keyboard Pause key are equivalents.
diff --git a/manual/html_node/Options-Menu.html b/manual/html_node/Options-Menu.html
index 1509689..3d655af 100644
--- a/manual/html_node/Options-Menu.html
+++ b/manual/html_node/Options-Menu.html
@@ -34,13 +34,13 @@ Up: Menus
 
 
3.7 Options Menu

 
-

+

      

-
General Options
The following items to set option values appear in the dialog
+
General Options
The following items to set option values appear in the dialog
 summoned by the general Options menu item. 
-
Absolute Analysis Scores
Controls if scores on the Engine Output window during analysis
+
Absolute Analysis Scores
Controls if scores on the Engine Output window during analysis
 will be printed from the white or the side-to-move point-of-view. 
-
Almost Always Queen
If this option is on, 7th-rank pawns automatically change into
+
Almost Always Queen
If this option is on, 7th-rank pawns automatically change into
 Queens when you pick them up,
 and when you drag them to the promotion square and release them there,
 they will promote to that. 
@@ -55,18 +55,18 @@ which would force promotion to Queen when true.
 Otherwise XBoard would bring up a dialog
 box whenever you move a pawn to the last rank, asking what piece
 you want to promote to. 
-
Animate Dragging
If Animate Dragging is on, while you are dragging a piece with the
+
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
 dragging a piece, but if Animate Moving is on, the move will be
 animated when it is complete. 
-
Animate Moving
If Animate Moving is on, all piece moves are animated.  An image of the
+
Animate Moving
If Animate Moving is on, all piece moves are animated.  An image of the
 piece is shown moving from the old square to the new square when the
 move is completed (unless the move was already animated by Animate Dragging). 
 If Animate Moving is off, a moved piece instantly disappears from its
 old square and reappears on its new square when the move is complete. 
 The shifted Ctrl-A key is a keyboard equivalent. 
-
Auto Flag
If this option is on and one player runs out of time
+
Auto Flag
If this option is on and one player runs out of time
 before the other,
 XBoard
 will automatically call his flag, claiming a win on time. 
@@ -76,7 +76,7 @@ and the ICS may award you a draw instead of a win if you have
 insufficient mating material.  In local chess engine mode,
 XBoard
 may call either player's flag and will not take material into account (?). 
-
Auto Flip View
If the Auto Flip View option is on when you start a game, the board
+
Auto Flip View
If the Auto Flip View option is on when you start a game, the board
 will be automatically oriented so that your pawns move from the bottom
 of the window towards the top.
 
@@ -87,16 +87,21 @@ orientation is determined by the flipView command line option;
 if it is false (the default), White's pawns move from bottom to top
 at the start of each game; if it is true, Black's pawns move from
 bottom to top. See User interface options. 
-
Blindfold
If this option is on, XBoard displays the board as usual but does
+
Blindfold
If this option is on, XBoard displays the board as usual but does
 not display pieces or move highlights.  You can still move in the
 usual way (with the mouse or by typing moves in ICS mode), even though
 the pieces are invisible. 
-
Drop Menu
Controls if right-clicking the board in crazyhouse / bughouse
+
Drop Menu
Controls if right-clicking the board in crazyhouse / bughouse
 will pop up a menu to drop a piece on the clicked square
 (old, deprecated behavior)
 or allow you to step through an engine PV
 (new, recommended behavior). 
-
Hide Thinking
If this option is off, the chess engine's notion of the score and best
+
Enable Variation Trees
If this option is on, playing a move in Edit Game or Analyze mode
+while keeping the Shift key pressed will start a new variation. 
+You can then recall the previous line through the ‘Revert’ menu item. 
+When off, playing a move will truncate the game and append the move
+irreversibly. 
+
Hide Thinking
If this option is off, the chess engine's notion of the score and best
 line of play from the current position is displayed as it is
 thinking. The score indicates how many pawns ahead (or if negative,
 behind) the chess engine thinks it is. In matches between two
@@ -104,14 +109,14 @@ machines, the score is prefixed by ‘WCtrl-H key is a keyboard equivalent. 
-
Highlight Last Move
If Highlight Last Move is on, after a move is made, the starting and
+
Highlight Last Move
If Highlight Last Move is on, after a move is made, the starting and
 ending squares remain highlighted. In addition, after you use Backward
 or Back to Start, the starting and ending squares of the last move to
 be unmade are highlighted. 
-
Highlight with Arrow
Causes the highlighting described in Highlight Last Move to be done
+
Highlight with Arrow
Causes the highlighting described in Highlight Last Move to be done
 by drawing an arrow between the highlighted squares,
 so that it is visible even when the width of the grid lines is set to zero. 
-
Move Sound
Enables the sounding of an audible signal when the computer performs a move. 
+
Move Sound
Enables the sounding of an audible signal when the computer performs a move. 
 For the selection of the sound, see ‘Sound Options’. 
 If you turn on this option when using XBoard with the Internet
 Chess Server, you will probably want to give the
@@ -119,7 +124,7 @@ Chess Server, you will probably want to give the
 command to the ICS, since otherwise the ICS will ring the terminal bell
 after every move (not just yours). (The .icsrc file
 is a good place for this; see ICS options.) 
-
One-Click Moving
If this option is on, XBoard does not wait for you to click both the
+
One-Click Moving
If this option is on, XBoard does not wait for you to click both the
 from- and the to-square, or drag the piece, but performs a move as soon
 as it is uniqely specified. 
 This applies to clicking an own piece that only has a single legal move,
@@ -130,34 +135,40 @@ will cause that capture to be made.
 Promoting a Pawn by clicking its to-square will suppress the promotion
 popup or other methods for selecting an under-promotion,
 and make it promote to Queen. 
-
Periodic Updates
If this option is off (or if
+
Periodic Updates
If this option is off (or if
 you are using a chess engine that does not support periodic updates),
 the analysis window
 will only be updated when the analysis changes. If this option is
 on, the Analysis Window will be updated every two seconds. 
-
Ponder Next Move
If this option is off, the chess engine will think only when it is on
+
Play Move(s) of Clicked PV
If this option is on, right-clicking a PV in the Engine Output window
+during Analyze mode will cause the first move of that PV to be played. 
+You could also play more than one (or no) PV move by moving the mouse
+to engage in the PV walk such a right-click will start,
+to seek out another position along the PV where you want to continue
+the analysis, before releasing the mouse button. 
+
Ponder Next Move
If this option is off, the chess engine will think only when it is on
 move.  If the option is on, the engine will also think while waiting
 for you to make your move. 
 The shifted Ctrl-P key is a keyboard equivalent. 
-
Popup Exit Message
If this option is on, when XBoard wants to display a message just
+
Popup Exit Message
If this option is on, when XBoard wants to display a message just
 before exiting, it brings up a modal dialog box and waits for you to
 click OK before exiting.  If the option is off, XBoard prints the
 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
+
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 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. 
-
Scores in Move List
If this option is on, XBoard will display the depth and score
+
Scores in Move List
If this option is on, XBoard will display the depth and score
 of engine moves in the Move List, in the format of a PGN comment. 
-
Show Coords
If this option is on, XBoard displays algebraic coordinates
+
Show Coords
If this option is on, XBoard displays algebraic coordinates
 along the board's left and bottom edges. 
-
Show Target Squares
If this option is on, all squares a piece that is 'picked up' with the mouse
+
Show Target Squares
If this option is on, all squares a piece that is 'picked up' with the mouse
 can legally move to are highighted with a fat colored dot in the
 highlightColor (non-captures) or premoveHighlightColor (captures). 
 Legality testing must be on for XBoard to know how the piece moves. 
-
Test Legality
If this option is on, XBoard tests whether the moves you try to make
+
Test Legality
If this option is on, XBoard tests whether the moves you try to make
 with the mouse are legal and refuses to let you make an illegal move. 
 The shifted Ctrl-L key is a keyboard equivalent. 
 Moves loaded from a file with ‘Load Game’ are also checked.  If
@@ -167,15 +178,15 @@ off this option is useful if you are playing a chess variant with
 rules that XBoard does not understand.  (Bughouse, suicide, and wild
 variants where the king may castle after starting on the d file are
 generally supported with Test Legality on.) 
-
Flash Moves
Flash Rate
If this option is non-zero, whenever a move is completed,
+
Flash Moves
Flash Rate
If this option is non-zero, whenever a move is completed,
 the moved piece flashes the specified number of times. 
 The flash-rate setting determines how rapidly this flashing occurs. 
-
Animation Speed
Determines the duration (in msec) of an animation step,
+
Animation Speed
Determines the duration (in msec) of an animation step,
 when ‘Animate Moving’ is swiched on. 
-
Zoom factor in Evaluation Graph
Sets the valueof the evalZoom option,
+
Zoom factor in Evaluation Graph
Sets the valueof the evalZoom option,
 indicating the factor by which the score interval (-1,1) should be
 blown up on the vertical axis of the Evaluation Graph. 
-
Time Control
Pops up a sub-menu where you can set the time-control parameters interactively. 
+
Time Control
Pops up a sub-menu where you can set the time-control parameters interactively. 
 Allows you to select classical or incremental time controls,
 set the moves per session, session duration, and time increment. 
 Also allows specification of time-odds factors for one or both engines. 
@@ -183,7 +194,7 @@ If an engine is given a time-odds factor N, all time quota it gets,
 be it at the beginning of a session or through the time increment or
 fixed time per move, will be divided by N. 
 The shifted Alt+T key is a keyboard equivalent. 
-
Common Engine
Pops up a sub-menu where you can set some engine parameters common to most engines,
+
Common Engine
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 that allows setting of these parameters on
@@ -205,7 +216,7 @@ When set to 0, only the move(s) with the highest probability will be played.
 When set to 100, all listed moves will be played with equal pobability. 
 Other settings interpolate between that. 
 The shifted Alt+U key is a keyboard equivalent. 
-
Adjudications
Pops up a sub-menu where you can enable or disable various adjudications
+
Adjudications
Pops up a sub-menu where you can enable or disable various adjudications
 that XBoard can perform in engine-engine games. 
 The shifted Alt+J key is a keyboard equivalent. 
 You can instruct XBoard to detect and terminate the game on checkmate
@@ -226,22 +237,22 @@ For the latter adjudication to work, XBoard should be able to properly understan
 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.
 
-     
ICS Options
The following options occur in a dialog summoned by the
+     
ICS Options
The following options occur in a dialog summoned by the
 ICS Options menu item. 
-
Auto Kibitz
Setting this option when playing with or aginst a chess program on an ICS
+
Auto Kibitz
Setting this option when playing with or aginst a chess program on an ICS
 will cause the last line of thinking output of the engine before its move
 to be sent to the ICS in a kibitz command. 
 In addition, any kibitz message received through the ICS from
 an opponent chess program will be diverted to the engine-output window,
 (and suppressed in the console),
 where you can play through its PV by right-clicking it. 
-
Auto Comment
If this option is on, any remarks made on ICS while you are observing or
+
Auto Comment
If this option is on, any remarks made on ICS while you are observing or
 playing a game are recorded as a comment on the current move.  This includes
 remarks made with the ICS commands say, tell, whisper,
 and kibitz. 
 Limitation: remarks that you type yourself are not recognized;
 XBoard scans only the output from ICS, not the input you type to it. 
-
Auto Observe
If this option is on and you add a player to your gnotify
+
Auto Observe
If this option is on and you add a player to your gnotify
 list on ICS, XBoard will automatically observe all of that
 player's games, unless you are doing something else (such as
 observing or playing a game of your own) when one starts. 
@@ -254,24 +265,24 @@ your ICS
 variable is set to 0, or if the ICS you are using does not
 properly support observing from Black's point of view,
 you will see the game from White's point of view. 
-
Auto Raise Board
If this option is on, whenever a new game begins, the chessboard window
+
Auto Raise Board
If this option is on, whenever a new game begins, the chessboard window
 is deiconized (if necessary) and raised to the top of the stack of windows. 
-
Auto Save
If this option is true, at the end of every game XBoard prompts
+
Auto Save
If this option is true, at the end of every game XBoard prompts
 you for a file name and appends a record of the game to the file
 you specify. 
 Disabled if the saveGameFile command-line
 option is set, as in that case all games are saved to the specified file. 
 See Load and Save options. 
-
Background Observe
Setting this option will make XBoard suppress display of any boards
+
Background Observe
Setting this option will make XBoard suppress display of any boards
 from observed games while you are playing. 
 In stead the last such board will be remembered,
 and shown to you when you right-click the board. 
 This allows you to peek at your bughouse partner's game when you want,
 without disturbing your own game too much. 
-
Dual Board
Setting this option in combination with ‘Background Observe’
+
Dual Board
Setting this option in combination with ‘Background Observe’
 will display boards of observed games while you are playing
 on a second board next to that of your own game. 
-
Get Move List
If this option is on, whenever XBoard
+
Get Move List
If this option is on, whenever XBoard
 receives the first board of a new ICS game (or a different game from
 the one it is currently displaying), it
 retrieves the list of past moves from the ICS. 
@@ -283,20 +294,20 @@ to keep from wasting time and network bandwidth fetching the move lists over
 and over. 
 When you turn this option on from the menu, XBoard
 immediately fetches the move list of the current game (if any). 
-
Quiet Play
If this option is on, XBoard will automatically issue an ICS
+
Quiet Play
If this option is on, XBoard will automatically issue an ICS
 set shout 0
 command whenever you start a game and a
 set shout 1
 command whenever you finish one.  Thus, you will not be distracted
 by shouts from other ICS users while playing. 
-
Seek Graph
Setting this option will cause XBoard to display an graph of
+
Seek Graph
Setting this option will cause XBoard to display an graph of
 currently active seek ads when you left-click the board
 while idle and logged on to an ICS. 
-
Auto-Refresh Seek Graph
In combination with the ‘Seek Graph’ option this
+
Auto-Refresh Seek Graph
In combination with the ‘Seek Graph’ option this
 will cause automatic update of the seek graph while it is up. 
 This only works on FICS and ICC,
 and requires a lot of bandwidth on a busy server. 
-
Premove
Premove White
Premove Black
First White Move
First Black Move
If this option is on while playing a game on an ICS, you can register
+
Premove
Premove White
Premove Black
First White Move
First Black Move
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
 will be highlighted with a special color (red by default).  When it is
@@ -308,7 +319,7 @@ entirely.
 
      
You can also enter premoves for the first white and black moves
 of the game. 
-
ICS Alarm
ICS Alarm Time
When this option is on, an alarm sound is played when your clock
+
ICS Alarm
ICS Alarm Time
When this option is on, an alarm sound is played when your clock
 counts down to the icsAlarmTime in an ICS game. 
 (By default, the time is 5 seconds, but you can pecify other values
 with the Alarm Time spin control.) 
@@ -317,15 +328,15 @@ alarm will sound each time the clock counts down to the icsAlarmTime.
 By default, the alarm sound is the terminal bell, but on some systems
 you can change it to a sound file using the soundIcsAlarm option; see
 below. 
-
Colorize Messages
Ticking this options causes various types of ICS messages do be
+
Colorize Messages
Ticking this options causes various types of ICS messages do be
 displayed with different foreground or background colors in the console. 
 The colors can be individually selected for each type,
 through the accompanying text edits.
 
-     
Match Options
Summons a dialog where you can set options important for playing automatic
+     
Match Options
Summons a dialog where you can set options important for playing automatic
 matches between two chess programs
 (e.g. by using the ‘Machine Match’ menu item in the ‘Mode’ menu). 
-
Tournament file
To run a tournament, XBoard needs a file to record its progress,
+
Tournament file
To run a tournament, XBoard needs a file to record its progress,
 so it can resume the tourney when it is interrupted. 
 When you want to conduct anything more complex than a simple
 two-player match with the currently loaded engines,
@@ -343,19 +354,19 @@ Provided that you specify participants;
 without participants no tournament file will be made, but other entered values
 (e.g. for the file with opening positions) will take effect. 
 Default: configured by the defaultTourneyName option. 
-
Sync after round
Sync after cycle
The sync options, when on, will cause WinBoard to refrain from starting games
+
Sync after round
Sync after cycle
The sync options, when on, will cause WinBoard to refrain from starting games
 of the next round or cycle before all games of the previous round or cycle are finished. 
 This guarantees correct ordering in the games file,
 even when multiple XBoard instances are concurrently playing games for the same tourney. 
 Default: sync after cycle, but not after round. 
-
Select Engine
Tourney participants
With the Select Engine drop-down list you can pick an engine from your list
+
Select Engine
Tourney participants
With the Select Engine drop-down list you can pick an engine from your list
 of installed engines in the settings file, to be added to the tournament. 
 The engines selected so far will be listed in the ‘Tourney participants’ memo. 
 The latter is a normal text edit, so you can use normal text-editing functions
 to delete engines you selected by accident, or change their order. 
 Do not type names yourself there, because names that do not exactly match
 one of the names from the drop-down list will lead to undefined behavior. 
-
Tourney type
Here you can specify the type of tournament you want. 
+
Tourney type
Here you can specify the type of tournament you want. 
 XBoard’s intrinsic tournament manager support round-robins (type = 0),
 where each participant plays every other participant, and (multi-)gauntlets,
 where one (or a few) so-called ‘gauntlet engines’ play an independent set of opponents. 
@@ -366,7 +377,7 @@ A value of -1 instructs XBoard to play Swiss; for this to work an external
 pairing engine must be specified through the pairingEngine option. 
 Each Swiss round will be considered a tourney cycle in that case. 
 Default:0
-
Number of tourney cycles
Default number of Games
You can specify tourneys where every two opponents play each other multiple times. 
+
Number of tourney cycles
Default number of Games
You can specify tourneys where every two opponents play each other multiple times. 
 Such multiple games can be played in a row,
 as specified by the ‘number of games per pairing’,
 or by repeating the entire tournament schedule a number of times
@@ -375,9 +386,9 @@ The total number of times two engine meet will be the product of these two.
 Default is 1 cycle;
 the number of games per pairing is the same as the default number of match games,
 stored in your settings file through the defaultMatchGames option. 
-
Save Tourney Games
File where the tournament games are saved
+
Save Tourney Games
File where the tournament games are saved
 (duplicate of the item in the ‘Save Game Options’). 
-
Game File with Opening Lines
File with Start Positions
Game Number
Position Number
Rewind Index after
These items optionally specify the file with move sequences or board positions the tourney
+
Game File with Opening Lines
File with Start Positions
Game Number
Position Number
Rewind Index after
These items optionally specify the file with move sequences or board positions the tourney
 games should start from. 
 The corresponding numbers specify the number of the game or position in the file. 
 Here a value -1 means automatic stepping through all games on the file,
@@ -390,12 +401,12 @@ In this case the first (odd) games will randomly select from the book,
 but the second (even) games will select the same moves from the book as the previous game. 
 (Note this leads to the same opening only if both engines use the GUI book!) 
 Default: No game or position file will be used. The default index if such a file is used is 1. 
-
Disable own engine bools be default
Setting this option reverses the default situation for use of the GUI opening book
+
Disable own engine bools be default
Setting this option reverses the default situation for use of the GUI opening book
 in tournaments from what it normally is, namely not using it. 
 So unless the engine is installed with an option to explicitly specify it should
 not use the GUI book (i.e. -firstHasOwnBookUCI true),
 it will be made to use the GUI book. 
-
Replace Engine
Upgrade Engine
With these two buttons you can alter the participants of an already running tournament. 
+
Replace Engine
Upgrade Engine
With these two buttons you can alter the participants of an already running tournament. 
 After opening the Match Options dialog on an XBoard that is playing for the tourney,
 you will see all the tourney parameters in the dialog fields. 
 You can then replace the name of one engine by that of another
@@ -408,24 +419,24 @@ be invalidated, and they will be replayed with the substitute engine.
 In this latter case the engine must not be playing when you do this,
 but otherwise there is no need to pause the tournament play
 for making a substitution. 
-
Clone Tourney
Pressing this button after you have specified an existing tournament file
+
Clone Tourney
Pressing this button after you have specified an existing tournament file
 will copy the contents of the latter to the dialog,
 and then puts the originally proposed name for the tourney file back. 
 You can then run a tourney with the same parameters
 (possibly after changing the proposed name of the tourney file for the new tourney)
 by pressing 'OK'.
 
-     
Load Game Options
Summons a dialog where you can set the autoDisplayComment and
+     
Load Game Options
Summons a dialog where you can set the autoDisplayComment and
 autoDisplayTags options, (which control popups when viewing loaded games),
 and specify the rate at which loaded games are auto-played,
 in seconds per move (which can be a fractional number, like 1.6). 
 You can also set search criteria for determining which games
 will be displayed in the Game List for a multi-game file,
 and thus be eligible for loading:
-
Elo of strongest player
Elo of weakest player
year
These numeric fields set thresholds (lower limits) on the Elo rating of the mentioned player,
+
Elo of strongest player
Elo of weakest player
year
These numeric fields set thresholds (lower limits) on the Elo rating of the mentioned player,
 or the date the game was played. 
 Defaults: 0
-
Search mode
This setting determines which positions in a game will be considered a match
+
Search mode
This setting determines which positions in a game will be considered a match
 to the position currently displayed in the board window
 when you press the ‘find position’ button in the Game List. 
 You can search for an exact match,
@@ -439,23 +450,29 @@ For the latter you have to place the material that must be present
 in the four lowest ranks of the board,
 and optional additional material in the four highest ranks of the board. 
 You can request the optional material to be balanced. 
-
number of consecutive positions
When you are searching by material, rather than for an exact match,
+The ‘narrow’ button is similar in fuction to the ‘find position’ button,
+but only searches in the already selected games,
+rather than the complete game file,
+and can thus be used to refine a search based on multiple criteria. 
+
number of consecutive positions
When you are searching by material, rather than for an exact match,
 this parameter indicates forhowmany consecutive game positions
 the same amount of material must be on the board before it is
 considered a match. 
-
Also match reversed colors
Also match left-right flipped position
When looking for matching positions rather than by material,
+
Also match reversed colors
Also match left-right flipped position
When looking for matching positions rather than by material,
 these settings determine whether mirror images
 (in case of a vertical flip in combination with color reversal)
 will be also considered a match. 
 The left-right flipping is only useful after all castling rights
 have expired (or in Xiangqi).
 
-     
Save Game Options
Summons a dialog where you can specify the files on which XBoard should
-automtically save any played or entered games,
+     
Save Game Options
Summons a dialog where you can specify the files on which XBoard should
+automatically save any played or entered games,
 (the saveGameFile option),
 or the final position of such games (the savePositionfile option). 
 You can also select 'auto-save' without a file name,
 in which case XBoard will prompt the user for a file name after each game. 
+In ICS mode you can limit the auto-saving to your own games
+(i.e. suppress saving of observed games). 
 You can also set the default value for the PGN Event tag that will
 be used for each new game you start. 
 Various options for the format of the game can be specified as well,
@@ -464,10 +481,10 @@ and if a tag with info about the score with which the engine came out of book
 should be included. 
 For Chess, always set the format to PGN, rather than "old save stye"!
 
-     
Game List
Pops up a dialog where you can select the PGN tags that should appear
+     
Game List
Pops up a dialog where you can select the PGN tags that should appear
 on the lines in the game list, and their order.
 
-     
Sound Options
Summons a dialog where you can specify the sounds that should accompany
+     
Sound Options
Summons a dialog where you can specify the sounds that should accompany
 various events that can occur XBoard. 
 Most events are only relevant to ICS play,
 but the move sound is an important exception. 
@@ -488,7 +505,7 @@ move if you are observing a game on the Internet Chess Server).
 The sound is not played after moves you make or moves read from a
 saved game file.
 
-     
Save Settings Now
Selecting this menu item causes the current XBoard settings to be
+     
Save Settings Now
Selecting this menu item causes the current XBoard settings to be
 written to the settings file, so they will also apply in future sessions. 
 Note that some settings are 'volatile', and are not saved,
 because XBoard considers it too unlikely that you want those to apply
@@ -499,8 +516,27 @@ if they have their own opening book, if they are UCI or native XBoard),
 or the variant you are playing. 
 Such options would still be understood when they appear in the settings
 file in case they were put there with the aid of a text editor, but they
-would disappear from the file as soon as you save the settings. 
-
Save Settings on Exit
Setting this option has no immediate effect, but causes the settings
+would disappear from the file as soon as you save the settings.
+
+     
Note that XBoard no longer pays attention to options values specified
+in the .Xresources file. 
+(Specifying key bindings there will still work, though.) 
+To alter the default of volatile options, you can use the following method:
+Rename your ~/.xboardrc settings file (to ~/.yboardrc, say), and create
+a new file ~/.xboardrc, which only contains the options
+
+     
          -settingsFile  ~/.yboardrc
+          -saveSettingsFile  ~/.yboardrc
+

+     
This will cause your settings to be saved on ~/.yboardrc in the future,
+so that ~/.xboardrc is no longer overwritten. 
+You can then safely specify volatile options in ~/.xboardrc, either
+before or after the settingsFile options. 
+Note that when you specify persistent options after the settingsFile options
+in ~/.xboardrc, you will essentially turn them into volatile options
+with the specified value as default, because that value will overrule
+the value loaded from the settings file (being read later). 
+
Save Settings on Exit
Setting this option has no immediate effect, but causes the settings
 to be saved when you quit XBoard. What happens then is otherwise
 identical to what happens when you use select "Save Settings Now",
 see there. 
diff --git a/manual/html_node/Options.html b/manual/html_node/Options.html
index 9d17c83..186b989 100644
--- a/manual/html_node/Options.html
+++ b/manual/html_node/Options.html
@@ -33,7 +33,7 @@ Up: Top
 
 
4 Options

 
-

+

 This section documents the command-line options to XBoard.  You can
 set these options in two ways: by typing them on the shell command
 line you use to start XBoard, or by editing the settings file
diff --git a/manual/html_node/Other-options.html b/manual/html_node/Other-options.html
index d384b26..48de3b5 100644
--- a/manual/html_node/Other-options.html
+++ b/manual/html_node/Other-options.html
@@ -32,18 +32,40 @@ Up: Options
 
 
4.8 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
+
-viewer
-viewerOptions string
Presence of the volatile option viewer on the command line
+will cause the value of the persistent option viewerOptions
+as stored in the settings file to be appended to the command line. 
+The view option will be used by desktop associations with
+game or position file types, so that viewerOptions can be
+used to configure the exact mode XBoard will start in when it
+should act on such a file (e.g. in -ncp mode, or analyzing
+with your favorite engine). The options are also automatically
+appended when Board is invoked with a single argument not being
+an option name, which is then assumed to be the name of a
+loadGameFile or (when the name ends in .fen) a
+loadPositionFile. 
+Default: "-ncp -engineOutputUp false -saveSettingsOnExit false". 
+
-tourneyOptions string
When XBoard is invoked with a single argument that is a file
+with .trn extension, it will assume this argument to be the value
+of a tourneyFile option,
+and apped the value of the persistent option tourneyOptions
+as stored in the settings file to the command line. 
+Thus the value of tourneyOptions can be
+used to configure XBoard to automatically start running a
+tournament when it should act on such a file. 
+Default: "-ncp -mm -saveSettingsOnExit false". 
+
-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:
 
@@ -100,25 +122,25 @@ Berolina and cylinder chess can only be played with legality testing off.
 In crazyhouse, XBoard now does keep
 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
-
-pieceToCharTable string
The characters that are used to represent the piece types XBoard knows in FEN
+
-pieceToCharTable 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. 
@@ -138,26 +160,26 @@ 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: ""
-
-pieceNickNames string
The characters in the string are interpreted the same way as in the
+
-pieceNickNames string
The characters in the string are interpreted the same way as in the
 pieceToCharTable option. But on input, piece-ID letters are
 first looked up in the nicknames, and only if not defined there,
 in the normal pieceToCharTable. This allows you to have two letters
 designate the same piece, (e.g. N as an alternative to H for Horse
 in Xiangqi), to make reading of non-compliant notations easier. 
 Default: ""
-
-colorNickNames string
The side-to-move field in a FEN will be first matched against the letters
+
-colorNickNames string
The side-to-move field in a FEN will be first matched against the letters
 in the string (first character for white, second for black),
 before it is matched to the regular 'w' and 'b'. 
 This makes it easier to read non-compliant FENs,
 which, say, use 'r' for white. 
 Default: ""
-
-debug/-xdebug or -debugMode true/false
Turns on debugging printout. 
-
-debugFile filename or -nameOfDebugFile filename
Sets the name of the file to which XBoard 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 XBoard saves debug information
 (including all communication to and from the engines). 
 A %d in the given file name (e.g. game%d.debug) will be replaced
 by the unique sequence number of a tournament game,
 so that the debug output of each game will be written on a separate file. 
-
-engineDebugOutput number
Specifies how XBoard should handle unsolicited output from the engine,
+
-engineDebugOutput number
Specifies how XBoard 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, XBoard refrains from writing such spurious output to the debug file. 
@@ -167,20 +189,20 @@ as the engine itself should have done if it wanted to submit info for inclusion
 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 XBoard 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. 
-
-searchMode n
The integer n encodes the mode for the ‘find position’ function. 
+
-delayBeforeQuit number
-delayAfterQuit number
These options specify how long XBoard 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. 
+
-searchMode n
The integer n encodes the mode for the ‘find position’ function. 
 Default: 1 (= Exact position match)
-
-eloThresholdBoth elo
-eloThresholdAny elo
Defines a lower limit for the Elo rating, which has to be surpassed
+
-eloThresholdBoth elo
-eloThresholdAny elo
Defines a lower limit for the Elo rating, which has to be surpassed
 before a game will be considered when searching for a board position. 
 Default: 0
-
-dateThreshold year
Only games not played before the given year will be considered when
+
-dateThreshold year
Only games not played before the given year will be considered when
 searching for a board position
 
    

diff --git a/manual/html_node/Other-programs.html b/manual/html_node/Other-programs.html
index dfd17d1..eb1395c 100644
--- a/manual/html_node/Other-programs.html
+++ b/manual/html_node/Other-programs.html
@@ -33,7 +33,7 @@ Up: Top
 
 
12 Other programs you can use with XBoard

 
-

+

 Here are some other programs you can use with XBoard
 
 
    
diff --git a/manual/html_node/Problems.html b/manual/html_node/Problems.html
index 7b2858a..9ac8c77 100644
--- a/manual/html_node/Problems.html
+++ b/manual/html_node/Problems.html
@@ -33,7 +33,7 @@ Up: Top
 
 
    9 Reporting problems
    
 
-
    
+
    
 You can report bugs and problems with XBoard using
 the bug tracker at https://savannah.gnu.org/projects/xboard/
 or by sending mail to <bug-xboard@gnu.org>.  It can also
diff --git a/manual/html_node/UCI-_002b-WB-Engine-Settings.html b/manual/html_node/UCI-_002b-WB-Engine-Settings.html
index 6196528..b517927 100644
--- a/manual/html_node/UCI-_002b-WB-Engine-Settings.html
+++ b/manual/html_node/UCI-_002b-WB-Engine-Settings.html
@@ -35,18 +35,18 @@ Up: Options
 
 
    4.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
 on its command line, according to the option adapterCommand. 
-
    -fUCCI
    -sUCCI
    -fUSI
    -sUSI
    Options similar to fUCI and sUCI, except that they
+
    -fUCCI
    -sUCCI
    -fUSI
    -sUSI
    Options similar to fUCI and sUCI, except that they
 use the indicated engine with the protocol adapter specified in
 the ‘uxiAdapter’ option. 
 This can then be configured for running an UCCI or USI adapter,
 as the need arises. 
-
    -adapterCommand string
    The string conatins the command that should be issued by XBoard
+
    -adapterCommand string
    The string conatins the command that should be issued by XBoard
 to start an engine that is accompanied by the fUCI option. 
 Any identifier following a percent sign in the command (e.g. %fcp)
 will be considered the name of an XBoard option, and be replaced
@@ -55,45 +55,58 @@ For starting the second engine, any leading "f" or "first" in
 the option name will first be replaced by "s" or "second",
 before finding its value. 
 Default: 'polyglot -noini -ec "%fcp" -ed "%fd"'
-
    -uxiAdapter string
    Similar to adapterCommand, but used for engines accompanied
+
    -uxiAdapter string
    Similar to adapterCommand, but used for engines accompanied
 by the fUCCI or fUSI option, so you can configure
 XBoard to be ready to handle more than one flavor of non-native protocols. 
 Default: ""
-
    -polyglotDir filename
    Gives the name of the directory in which the Polyglot adapter for UCI engines resides. 
+
    -polyglotDir filename
    Gives the name of the directory in which the Polyglot adapter for UCI engines resides. 
 Default: "". 
-
    -usePolyglotBook true/false
    Specifies if the Polyglot book should be used as GUI book. 
-
    -polyglotBook filename
    Gives the filename of the opening book. 
+
    -usePolyglotBook true/false
    Specifies if the Polyglot book should be used as GUI book. 
+
    -polyglotBook filename
    Gives the filename of the opening book. 
 The book is only used when 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: depends on setting of the option discourageOwnBooks. 
-
    -discourageOwnBooks true/false
    When set, newly loaded engines will be assumed to use the GUI book,
+
    -discourageOwnBooks true/false
    When set, newly loaded engines will be assumed to use the GUI book,
 unless they explicitly specify differently. 
 Otherwise they will be assumed to not use the GUI book,
 unless the specify differently (e.g. with firstXBook). 
 Default: false. 
-
    -bookDepth n
    Limits the use of the GUI book to the first n moves of each side. 
+
    -bookDepth n
    Limits the use of the GUI book to the first n moves of each side. 
 Default: 12. 
-
    -bookVariation n
    A value n from 0 to 100 tunes the choice of moves from the GUI books
+
    -bookVariation n
    A value n from 0 to 100 tunes the choice of moves from the GUI books
 from totally random to best-only. Default: 50
-
    -fn string or -firstPgnName string
    -sn string or -secondPgnName string
    Indicates the name that should be used for the engine in PGN tags of
+
    -mcBookMode
    When this volatile option is specified, the probing algorithm of the
+GUI book is altered to always select the move that is most under-represented
+based on its performance. 
+When all moves are played in approximately the right proportion,
+a book miss will be reported, to give the engine opportunity to
+explore a new move. 
+In addition score of the moves will be kept track of during the session
+in a book buffer. 
+By playing an match in this mode, a book will be built from scratch. 
+The only output are the saved games, which can be converted to an
+actual book later, with the ‘Save Games as Book’ command. 
+This command can also be used to pre-fill the book buffer
+before adding new games based on the probing algorithm. 
+
    -fn string or -firstPgnName string
    -sn string or -secondPgnName string
    Indicates the name that should be used for the engine in PGN tags of
 engine-engine games. 
 Intended to allow you to install verions of the same engine with different settings,
 and still distinguish them. 
 Default: "". 
-
    -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 XBoard/WinBoard engines,
 for those that support the memory feature of the XBoard/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 XBoard/WinBoard engines,
 for those that support the memory feature of the XBoard/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". 
diff --git a/manual/html_node/User-interface-options.html b/manual/html_node/User-interface-options.html
index 8aa6db6..a160e71 100644
--- a/manual/html_node/User-interface-options.html
+++ b/manual/html_node/User-interface-options.html
@@ -34,14 +34,24 @@ Up: Options
 
 
    4.6 User interface options
    
 
-
    
+
    
      
    
-
    -display
    -geometry
    -iconic
    -name
    These and most other standard Xt options are accepted. 
-
    -noGUI
    Suppresses all GUI functions of XBoard
+
    -display
    -geometry
    -iconic
    -name
    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. 
-
    -recentEngines number
    -recentEngineList list
    When the number is larger than zero, it determines how many recently
+
    -logoSize N
    This option controls the drawing of player logos next to the clocks. 
+The integer N specifies the width of the logo in pixels;
+the logo height will always be half the width. 
+When N = 0, no logos will be diplayed. 
+Default: 0. 
+
    -firstLogo imagefile
    -secondLogo imagefile
    Specify the images to be used as player logos when logoSize
+is non-zero, next to the white and black clocks, respectively. 
+
    -autoLogo true/false
    -logoDir filename
    When autoLogo is set, XBoard will search for a PNG image file
+with the name of the engine or ICS in the directory specified
+by logoDir. 
+
    -recentEngines number
    -recentEngineList list
    When the number is larger than zero, it determines how many recently
 used engines will be appended at the bottom of the ‘Engines’ menu. 
 The engines will be saved in your settings file as the option
 recentEngineList, by their nicknames,
@@ -51,37 +61,34 @@ the last one is discarded.
 Changes in the list will only become visible the next session,
 provided you saved the settings. 
 Default: 6. 
-
    -oneClickMove true/false
    When set, this option allows you to enter moves by only clicking the to-
+
    -oneClickMove true/false
    When set, this option allows you to enter moves by only clicking the to-
 or from-square, when only a single legal move to or from that square
 is possible. 
 Double-clicking a piece (or clicking an already selected piece)
 will instruct that piece to make the only capture it can legally do. 
 Default: false. 
-
    -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. 
-
    -sweepPromotions true/false
    Sets the ‘Almost Always Promote to Queen’ menu 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. 
+
    -sweepPromotions true/false
    Sets the ‘Almost Always Promote to 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
+
    -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,
 Medium 64x64, Moderate 58x58, Average 54x54, Middling 49x49, Mediocre
 45x45, Small 40x40, Slim 37x37, Petite 33x33, Dinky 29x29, Teeny 25x25,
 or Tiny 21x21. 
-Orthodox pieces of all these sizes are built into XBoard. 
-Other sizes can
-be used if you have them; see the pixmapDirectory and bitmapDirectory
-options. 
-Complete sets of un-orthodox pieces are only provided in sizes
-Bulky, Middling and (to a lesser extent) Petite;
-Archbishop, Marshall and Amazon are also available in all sizes between
-Bulky and Petite. 
-When no bitmap is available, the piece will be displayed as Amazon or King. 
+Xboard installs with a set of scalable (svg) piece images,
+which it scales to any of the requested sizes. 
+The square size can further be continuously scaled by sizing the board window,
+but this only adapts the size of the pieces,
+and has no effect on the width of the grid lines or the font choice
+(both of which would depend on he selected boardSize). 
 The default depends on the size of your screen; it is approximately the
 largest size that will fit without clipping.
 
@@ -103,16 +110,16 @@ 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. 
-
    -overrideLineGap n
    When n >= 0, this forces the width of the black border between squares
+
    -overrideLineGap n
    When n >= 0, this forces the width of the black border between squares
 to n pixels for any board size. Mostly used to suppress the grid
 entirely by setting n = 0, e.g. in xiangqi or just getting a prettier
 picture. When n < 0 this the size-dependent width of the grid lines
 is used. Default: -1. 
-
    -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
@@ -120,28 +127,28 @@ 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. 
-
    -evalZoom factor
    The score interval (-1,1) is blown up on the vertical axis of
+
    -evalZoom factor
    The score interval (-1,1) is blown up on the vertical axis of
 the Evaluation Graph by the given factor. 
 Default: 1
-
    -evalThreshold n
    Score below n (centiPawn) are plotted as 0 in the Evaluation Graph. 
+
    -evalThreshold n
    Score below n (centiPawn) are plotted as 0 in the Evaluation Graph. 
 Default: 25
-
    -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. 
-
    -showTargetSquares true/false
    Determines whether XBoard can highlight the squares a piece has
+
    -showTargetSquares true/false
    Determines whether XBoard can highlight the squares a piece has
 legal moves to, when you grab that piece with the mouse. 
 Default: false. 
-
    -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
@@ -154,33 +161,33 @@ 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. 
-
    -highlightMoveWithArrow true/false
    Sets the Highlight with Arrow menu option. See Options Menu. Default: false. 
-
    -blind/-xblind or -blindfold true/false
    Sets the Blindfold menu option.  See Options Menu.  Default: false. 
-
    -periodic/-xperiodic or -periodicUpdates true/false
    Controls updating of current move andnode counts in analysis mode. Default: true. 
-
    -fSAN
    -sSAN
    Causes the PV in thinking output of the mentioned engine to be converted
+
    -highlight/-xhighlight or -highlightLastMove true/false
    Sets the Highlight Last Move menu option. See Options Menu. Default: false. 
+
    -highlightMoveWithArrow true/false
    Sets the Highlight with Arrow menu option. See Options Menu. Default: false. 
+
    -blind/-xblind or -blindfold true/false
    Sets the Blindfold menu option.  See Options Menu.  Default: false. 
+
    -periodic/-xperiodic or -periodicUpdates true/false
    Controls updating of current move andnode counts in analysis mode. Default: true. 
+
    -fSAN
    -sSAN
    Causes the PV in thinking output of the mentioned engine to be converted
 to SAN before it is further processed. 
 Warning: this might lose engine output not understood by the parser,
 and uses a lot of CPU power. 
 Default: the PV is displayed exactly as the engine produced it. 
-
    -showEvalInMoveHistory true/false
    Controls whether the evaluation scores and search depth of engine moves
+
    -showEvalInMoveHistory true/false
    Controls whether the evaluation scores and search depth of engine moves
 are displayed with the move in the move-history window. 
 Default: true. 
-
    -clockFont font
    The font used for the clocks. If the option value is a pattern
+
    -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–*-*-*-*-*-*-*-*. 
-
    -messageFont font
    The font used for popup dialogs, menus, comments, etc. 
+
    -messageFont 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
@@ -188,50 +195,17 @@ 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
-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
-pieces give a better appearance on the screen: the white pieces have
-dark borders, and the black pieces have opaque internal details.  With
-bitmaps, neither piece color has a border, and the internal details
-are transparent; you see the square color or other background color
-through them.
+
    -pid or -pieceImageDirectory dir
    This options control what piece images xboard uses. 
+XBoard will look in the specified directory for an image in png
+or svg format for every piece type, with names like BlackQueen.svg,
+WhiteKnight.svg etc. 
+When neither of these is found (or no valid directory is specified)
+XBoard will use the svg piece that was installed with it
+(from the source-tree directory ‘svg’). 
+Both svg and png images will be scaled by XBoard to the required size,
+but the png pieces lose much in quality when scaled too much.
 
-     
    If XBoard is configured and compiled on a system that includes libXpm,
-the X pixmap library, the xpm pixmap pieces are compiled in as the
-default.  A different xpm piece set can be selected at runtime with
-the pixmapDirectory option, or a bitmap piece set can be selected
-with the bitmapDirectory option.
-
-     
    If XBoard is configured and compiled on a system that does not include
-libXpm (or the --disable-xpm option is given to the configure
-program), the bitmap pieces are compiled in as the default.  It is not
-possible to use xpm pieces in this case, but pixmap pieces in another
-format called "xim" can be used by giving the pixmapDirectory option. 
-Or again, a different bitmap piece set can be selected with the
-bitmapDirectory option.
-
-     
    Files in the bitmapDirectory must be named as follows:
-The first character of a piece bitmap name gives the piece it
-represents (‘p’, ‘n’, ‘b’, ‘r’, ‘q’, or ‘k’),
-the next characters give the size in pixels, the
-following character indicates whether the piece is
-solid or outline (‘s’ or ‘o’),
-and the extension is ‘.bm’. 
-For example, a solid 80x80 knight would be named n80s.bm. 
-The outline bitmaps are used only in monochrome mode. 
-If bitmap pieces are compiled in and the bitmapDirectory is missing
-some files, the compiled in pieces are used instead.
-
-     
    If the bitmapDirectory option is given,
-it is also possible to replace xboard's icons and menu checkmark,
-by supplying files named icon_white.bm, icon_black.bm, and
-checkmark.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
    -preoveHighlightColor color
    -lowTimeWarningColor color
    Colors to use for the pieces, squares, and square highlights. 
+     
    -whitePieceColor color
    -blackPieceColor color
    -lightSquareColor color
    -darkSquareColor color
    -highlightSquareColor color
    -preoveHighlightColor color
    -lowTimeWarningColor color
    Colors to use for the pieces, squares, and square highlights. 
 Defaults:
 
      
              -whitePieceColor       #FFFFCC
@@ -252,33 +226,44 @@ Defaults:
           -premoveHighlightColor gray70
           -lowTimeWarningColor   gray70
 
    
-     
    -useBoardTexture true/false
    -liteBackTextureFile filename
    -darkBackTextureFile filename
    Indicate the pixmap files to be used for drawing the board squares,
+     
    The PieceColor options only work properly if the image files
+defining the pieces were pure black & white
+(possibly anti-aliased to produce gray scales
+and semi-transparancy),
+like the pieces images that come with the install. 
+Their effect on colored pieces is undefined. 
+The SquareColor option only have an effect
+when no board textures are used. 
+
    -trueColors true/false
    When set, this option suppresses the effect  of the
+PieceColor options mentioned above. 
+This is recommended for images that are already colored. 
+
    -useBoardTexture true/false
    -liteBackTextureFile filename
    -darkBackTextureFile filename
    Indicate the png image files to be used for drawing the board squares,
 and if they should be used rather than using simple colors. 
 The algorithm for cutting squares out of a given bitmap is such that
 the picture is perfectly reproduced when a bitmap the size of
 the complete board is given. 
 Default: false and ""
-
    -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. 
-
    -autoDisplayComment true/false
    -autoDisplayTags true/false
    If set to true, these options cause the window with the move comments,
+
    -autoDisplayComment true/false
    -autoDisplayTags true/false
    If set to true, these options cause the window with the move comments,
 and the window with PGN tags, respectively, to pop up automatically when
 such tags or comments are encountered during the replaying a stored or
 loaded game.  Default: true. 
-
    -pasteSelection true/false
    If this option is set to true, the Paste Position and Paste Game
+
    -pasteSelection true/false
    If this option is set to true, the Paste Position and Paste Game
 options paste from the currently selected text.  If false, they paste
 from the clipboard.  Default: false. 
-
    -autoCopyPV true|false
    When this option is set, the position displayed on the board when
+
    -autoCopyPV true|false
    When this option is set, the position displayed on the board when
 you terminate a PV walk
 (initiated by a right-click on board or engine-output window)
 will be automatically put on the clipboard as FEN. 
 Default: false. 
-
    -dropMenu true|false
    This option allows you to emulate old behavior,
+
    -dropMenu true|false
    This option allows you to emulate old behavior,
 where the right mouse button brings up the (now deprecated) drop menu
 rather than displaying the position at the end of the principal variation. 
 Default: False. 
-
    -pieceMenu true|false
    This option allows you to emulate old behavior,
+
    -pieceMenu true|false
    This option allows you to emulate old behavior,
 where the right mouse button brings up the (now deprecated) piece menu
 in Edit Position mode. 
 From this menu you can select the piece to put on the square you
@@ -287,15 +272,19 @@ or select items such as clear board.
 You can also promote or demote a clicked piece to convert
 it into an unorthodox piece that is not directly in the menu,
 or give the move to black or white. 
-
    -variations true|false
    When this option is on, you can start new variations in Edit Game or
+
    -variations true|false
    When this option is on, you can start new variations in Edit Game or
 Analyze mode by holding the Shift key down while entering a move. 
 When it is off, the Shift key will be ignored. 
 Default: False. 
-
    -absoluteAnalysisScores true|false
    When true, scores on the Engine Output window during analysis
+
    -appendPV true|false
    When this option is on, right-clicking a PV in the Engine Output window
+will play the first move of that PV in Analyze mode,
+or as many moves as you walk through by moving the mouse. 
+Default: False. 
+
    -absoluteAnalysisScores true|false
    When true, scores on the Engine Output window during analysis
 will be printed from the white point-of-view, rather than the
 side-to-move point-of-view. 
 Default: False. 
-
    -scoreWhite true|false
    When true, scores will always be printed from the white point-of-view,
+
    -scoreWhite true|false
    When true, scores will always be printed from the white point-of-view,
 rather than the side-to-move point-of-view. 
 Default: False. 
 
    
diff --git a/manual/html_node/View-Menu.html b/manual/html_node/View-Menu.html
index 3613711..f9e5212 100644
--- a/manual/html_node/View-Menu.html
+++ b/manual/html_node/View-Menu.html
@@ -34,12 +34,12 @@ Up: Menus
 
 
    3.3 View Menu
    
 
-
    
+
    
      
    
-
    Flip View
    Inverts your view of the chess board for the duration of the
+
    Flip View
    Inverts your view of the chess board for the duration of the
 current game. Starting a new game returns the board to normal. 
 The F2 key is a keyboard equivalent. 
-
    Show Engine Output
    Shows or hides a window in which the thinking output of any loaded engines
+
    Show Engine Output
    Shows or hides a window in which the thinking output of any loaded engines
 is displayed. The shifted Alt+O key is a keyboard equivalent. 
 XBoard will display lines of thinking output of the same depth ordered by score,
 (highest score on top), rather than in the order the engine produced them. 
@@ -50,36 +50,56 @@ But when the engine is in multi-variation mode this needs not always be true,
 and it is more convenient for someone analyzing games to see the moves sorted by score. 
 The order in which the engine found them is only of interest to the engine author,
 and can still be deduced from the time or node count printed with the line. 
-
    Show Move History
    Shows or hides a list of moves of the current game. 
+Right-clicking a line in this window, and then moving the mouse vertically with the
+right button kept down, will make XBoard play through the PV listed there. 
+The use of the board window as 'variation board' will normally end when
+you release the right button,
+or when the opponent plays a move. 
+But beware: in Analysis mode, moves thus played out will be added to the game. 
+The Engine-Output pane for each engine will contain a header displaying the
+multi-PV status and a list of excluded moves in Analysis mode,
+which are also responsive to right-clicking. 
+
    Show Move History
    Shows or hides a list of moves of the current game. 
 The shifted Alt+H key is a keyboard equivalent. 
 This list allows you to move the display to any earlier position in the game
 by clicking on the corresponding move. 
-
    Show Evaluation Graph
    Shows or hides a window which displays a graph of how the engine score(s)
+
    Show Evaluation Graph
    Shows or hides a window which displays a graph of how the engine score(s)
 evolved as a function of the move number. 
 The shifted Alt+E key is a keyboard equivalent. 
 Clicking on the graph will bring
 the corresponding position in the board display. 
-
    Show Game List
    Shows or hides the list of games generated by the last ‘Load Game’
+
    Show Game List
    Shows or hides the list of games generated by the last ‘Load Game’
 command. The shifted Alt+G key is a keyboard equivalent. 
-
    Tags
    Pops up a window which shows the PGN (portable game notation)
+
    Tags
    Pops up a window which shows the PGN (portable game notation)
 tags for the current game. 
 For now this is a duplicate of the ‘Edit Tags’ item in the ‘Edit’ menu. 
-
    Comments
    Pops up a window which shows any comments to or variations on the current move. 
+
    Comments
    Pops up a window which shows any comments to or variations on the current move. 
 For now this is a duplicate of the ‘Edit Comment’ item in the ‘Edit’ menu. 
-
    ICS Input Box
    If this option is set in ICS mode,
+
    ICS Input Box
    If this option is set in ICS mode,
 XBoard
 creates an extra window that you can use for typing in ICS commands. 
 The input box is especially useful if you want to type in something long or do
 some editing on your input, because output from ICS doesn't get mixed
 in with your typing as it would in the main terminal window. 
-
    Board
    Summons a dialog where you can customaize the look of the chess board. 
+
    Open Chat Window
    This menu item opens a window in which you can conduct upto 5 chats
+with other ICS users (or channels). 
+To use the window, write the name of your chat partner, the channel number,
+or the words 'shouts', 'whispers', 'cshouts' in the upper field
+(closing with <Enter>). 
+Everything you type in the lowest field will then automatically be sent to
+the mentioned party, while everything that party sends to you will
+appear in the central text box, rather than appear in the ICS console. 
+The row of buttons allow you to choose between chat;
+to start a new chat, just select an empty button,
+and complete the ‘Chat partner’ field. 
+
    Board
    Summons a dialog where you can customize the look of the chess board. 
 Here you can specify the directory from which piece images should be taken,
 when you don't want to use the built-in piece images
-(see pixmapDirectory and bitmapDirectory options),
-an external pixmap to be used for the board squares
+(see pieceImageDirectory option),
+external images to be used for the board squares
 (liteBackTextureFile and darkBackTextureFile options),
-and square and piece colors for the built-ins. 
-
    Game List Tags
    a duplicate of the Game List dialog in the Options menu. 
+and square and piece colors for the default pieces. 
+
    Game List Tags
    a duplicate of the Game List dialog in the Options menu. 
 
    
 
    
diff --git a/manual/html_node/index.html b/manual/html_node/index.html
index 3395c20..19e8130 100644
--- a/manual/html_node/index.html
+++ b/manual/html_node/index.html
@@ -40,7 +40,7 @@ user interface to chess engines (such as GNU Chess), the
 Internet Chess Servers,
 electronic mail correspondence chess, or your own collection of saved games.
 
-   
    This manual documents version 4.6.0 of XBoard.
+   
    This manual documents version 4.7.0 of XBoard.
 
 
      
 
    • Major modes:      The main things XBoard can do. 
diff --git a/manual/html_node/zic2xpm.html b/manual/html_node/zic2xpm.html
index 9d7acf6..cad87e9 100644
--- a/manual/html_node/zic2xpm.html
+++ b/manual/html_node/zic2xpm.html
@@ -54,10 +54,6 @@ FRITZ4 set. These files are named “fritz4.*” in the ZIICS distributi
      
      3. Give XBoard the “-pixmap” option when starting up, e.g.:
      
      
                xboard -pixmap ~/fritz4
 
      
-     
      Alternatively, you can add this line to your .Xresources file:
-
-     
                xboard*pixmapDirectory: ~/fritz4
-
      
      
    
 
    
    (*) ZIICS is a separate copyrighted work of Andy McFarland. 
diff --git a/manual/index.html b/manual/index.html
index 52d74cf..1759e50 100644
--- a/manual/index.html
+++ b/manual/index.html
@@ -10,35 +10,35 @@
 
 
 
    Free Software Foundation
    
-
    last updated March 11, 2012
    
+
    last updated February 20, 2013
    
 
 
    This manual (xboard) is available in the following formats:
    
 
 
 
 
    You can buy printed copies of
diff --git a/manual/xboard.dvi.gz b/manual/xboard.dvi.gz
index b5f8911..3cacd97 100644
Binary files a/manual/xboard.dvi.gz and b/manual/xboard.dvi.gz differ
diff --git a/manual/xboard.html b/manual/xboard.html
index 9d72bc8..455c85b 100644
--- a/manual/xboard.html
+++ b/manual/xboard.html
@@ -38,7 +38,7 @@ user interface to chess engines (such as GNU Chess), the
 Internet Chess Servers,
 electronic mail correspondence chess, or your own collection of saved games.
 
-   
    This manual documents version 4.6.0 of XBoard.
+   
    This manual documents version 4.7.0 of XBoard.
 
 
      
 
    • Major modes:      The main things XBoard can do. 
@@ -139,6 +139,14 @@ like you entered all previous PV moves.
 As the display of the PV in that case starts after the first move
 a simple right-click will play the move the engine indicates.
 
+   
      In Analysis mode you can also make a move by grabbing the piece
+with a double-click of the left mouse button
+(or while keeping the Ctrl key pressed). 
+In this case the move you enter will not be played,
+but will be excluded from the analysis of the current position. 
+(Or included if it was already excluded; it is a toggle.) 
+This only works for engines that support this feature.
+
    
      When connected to an ICS, it is possible to call up a graphical
 representation of players seeking a game in stead of the chess board,
 when the latter is not in use
@@ -319,8 +327,19 @@ FEN (Forsythe-Edwards notation) format unless the oldSaveStyle
 option is true, in which case they are saved in an older,
 human-readable format that is specific to XBoard. Both formats
 can be read back by the ‘Load Position’ command. 
-
      Mail Move
      Reload CMail Message
      See CMail. 
-
      Exit
      Exits from XBoard. The Ctrl-Q key is a keyboard equivalent. 
+
      Save Games as Book
      Creates an opening book from the currently loaded game file. 
+The book will be saved on the file specified in the ‘Common Engine’
+options dialog. 
+The value of ‘Book Depth’ specified in that same dialog will
+be used to determine how many moves of each game will be added to
+the internal book buffer. 
+This command can take a long time to process,
+and the size of the buffer is currently limited. 
+At the end the buffer will be saved as a Polyglot book,
+but the buffer will ot be cleared,
+so that you can continue adding games from other game files. 
+
      Mail Move
      Reload CMail Message
      See CMail. 
+
      Exit
      Exits from XBoard. The Ctrl-Q key is a keyboard equivalent. 
 

 
 

@@ -334,32 +353,32 @@ Up: Menus
 
 
3.2 Edit Menu

 
-

+

      

-
Copy Game
Copies a record of the current game to an internal clipboard in PGN
+
Copy Game
Copies a record of the current game to an internal clipboard in PGN
 format and sets the X selection to the game text. The Ctrl-C
 key is a keyboard equivalent. The game can be
 pasted to another application (such as a text editor or another copy
 of XBoard) using that application's paste command.  In many X
 applications, such as xterm and emacs, the middle mouse button can be
 used for pasting; in XBoard, you must use the Paste Game command. 
-
Copy Position
Copies the current position to an internal clipboard in FEN format and
+
Copy Position
Copies the current position to an internal clipboard in FEN format and
 sets the X selection to the position text. The shifted Ctrl-C key
 is a keyboard equivalent.  The position can be pasted
 to another application (such as a text editor or another copy of
 XBoard) using that application's paste command.  In many X
 applications, such as xterm and emacs, the middle mouse button can be
 used for pasting; in XBoard, you must use the Paste Position command. 
-
Copy Game List
Copies the current game list to the clipboard,
+
Copy Game List
Copies the current game list to the clipboard,
 and sets the X selection to this text. 
 A format of comma-separated double-quoted strings is used,
 including all tags,
 so it can be easily imported into spread-sheet programs. 
-
Paste Game
Interprets the current X selection as a game record and loads it, as
+
Paste Game
Interprets the current X selection as a game record and loads it, as
 with Load Game. The Ctrl-V key is a keyboard equivalent. 
-
Paste Position
Interprets the current X selection as a FEN position and loads it, as
+
Paste Position
Interprets the current X selection as a FEN position and loads it, as
 with Load Position. The shifted Ctrl-V key is a keyboard equivalent. 
-
Edit Game
Allows you to make moves for both Black and White, and to change
+
Edit Game
Allows you to make moves for both Black and White, and to change
 moves after backing up with the ‘Backward’ command. The clocks do
 not run. The Ctrl-E key is a keyboard equivalent.
 
@@ -373,7 +392,7 @@ XBoard out of ICS Client mode and lets you edit games locally.
 If you want to edit games on ICS in a way that other ICS users
 can see, use the ICS examine command or start an ICS match
 against yourself. 
-
Edit Position
Lets you set up an arbitrary board position. 
+
Edit Position
Lets you set up an arbitrary board position. 
 The shifted Ctrl-E key is a keyboard equivalent. 
 Use mouse button 1 to drag pieces to new squares, or to delete a piece
 by dragging it off the board or dragging an empty square on top of it. 
@@ -402,7 +421,7 @@ not sent to the ICS: ‘Edit Position
 edit positions on ICS in a way that other ICS users can see, use
 the ICS examine command, or start an ICS match against yourself. 
 (See also the ICS Client topic above.) 
-
Edit Tags
Lets you edit the PGN (portable game notation)
+
Edit Tags
Lets you edit the PGN (portable game notation)
 tags for the current game. After editing, the tags must still conform to
 the PGN tag syntax:
 
@@ -426,10 +445,12 @@ the PGN tag syntax:
 the PGN standard requires all games to have at least the seven tags shown
 above. Any that you omit will be filled in by XBoard
 with ‘?’ (unknown value), or ‘-’ (inapplicable value). 
-
Edit Comment
Adds or modifies a comment on the current position. Comments are
+
Edit Comment
Adds or modifies a comment on the current position. Comments are
 saved by ‘Save Game’ and are displayed by ‘Load Game’,
+PGN variations will also be printed in this window,
+and can be promoted to main line by right-clicking them. 
 ‘Forward’, and ‘Backward’. 
-
Edit Book
Pops up a window listing the moves available in the GUI book
+
Edit Book
Pops up a window listing the moves available in the GUI book
 (specified in the ‘Common Engine Settings’ dialog)
 from the currently displayed position,
 together with their weights and (optionally in braces) learn info. 
@@ -437,7 +458,7 @@ You can then edit this list, and the new list will be stored
 back into the book when you press OK. 
 Note that the listed percentages are neither used, nor updated when
 you change the weights; they are just there as an optical aid. 
-
Revert
Annotate
If you are examining an ICS game and Pause mode is off,
+
Revert
Annotate
If you are examining an ICS game and Pause mode is off,
 Revert issues the ICS command ‘revert’. 
 In local mode, when you were editing or analyzing a game,
 and the -variations command-line option is switched on,
@@ -457,11 +478,11 @@ the variation you are now abandoning will be added as a comment
 (in PGN variation syntax, i.e. between parentheses)
 to the original move where you deviated, for later recalling. 
 The Home key is a keyboard equivalent to ‘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. 
 The End key is a keyboard equivalent. 
-
Backward
Steps backward through a series of remembered moves. 
+
Backward
Steps backward through a series of remembered moves. 
 The ‘[<]’ button and the Alt+LeftArrow key are equivalents,
 as is turning the mouse wheel towards you. 
 In addition, pressing the Control key steps back one move, and releasing
@@ -480,7 +501,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 Alt+RightArrow key are equivalents,
 as is turning the mouse wheel away from you.
@@ -492,7 +513,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 Alt+Home key are equivalents.
 
      
In most modes, Back to Start only lets you look back at old
@@ -509,7 +530,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 Alt+End key are equivalents.
 
      
If you are examining an ICS game, the behavior of ‘Forward to
@@ -532,12 +553,12 @@ Up: Menus
 
 
3.3 View Menu

 
-

+

      

-
Flip View
Inverts your view of the chess board for the duration of the
+
Flip View
Inverts your view of the chess board for the duration of the
 current game. Starting a new game returns the board to normal. 
 The F2 key is a keyboard equivalent. 
-
Show Engine Output
Shows or hides a window in which the thinking output of any loaded engines
+
Show Engine Output
Shows or hides a window in which the thinking output of any loaded engines
 is displayed. The shifted Alt+O key is a keyboard equivalent. 
 XBoard will display lines of thinking output of the same depth ordered by score,
 (highest score on top), rather than in the order the engine produced them. 
@@ -548,36 +569,56 @@ But when the engine is in multi-variation mode this needs not always be true,
 and it is more convenient for someone analyzing games to see the moves sorted by score. 
 The order in which the engine found them is only of interest to the engine author,
 and can still be deduced from the time or node count printed with the line. 
-
Show Move History
Shows or hides a list of moves of the current game. 
+Right-clicking a line in this window, and then moving the mouse vertically with the
+right button kept down, will make XBoard play through the PV listed there. 
+The use of the board window as 'variation board' will normally end when
+you release the right button,
+or when the opponent plays a move. 
+But beware: in Analysis mode, moves thus played out will be added to the game. 
+The Engine-Output pane for each engine will contain a header displaying the
+multi-PV status and a list of excluded moves in Analysis mode,
+which are also responsive to right-clicking. 
+
Show Move History
Shows or hides a list of moves of the current game. 
 The shifted Alt+H key is a keyboard equivalent. 
 This list allows you to move the display to any earlier position in the game
 by clicking on the corresponding move. 
-
Show Evaluation Graph
Shows or hides a window which displays a graph of how the engine score(s)
+
Show Evaluation Graph
Shows or hides a window which displays a graph of how the engine score(s)
 evolved as a function of the move number. 
 The shifted Alt+E key is a keyboard equivalent. 
 Clicking on the graph will bring
 the corresponding position in the board display. 
-
Show Game List
Shows or hides the list of games generated by the last ‘Load Game’
+
Show Game List
Shows or hides the list of games generated by the last ‘Load Game’
 command. The shifted Alt+G key is a keyboard equivalent. 
-
Tags
Pops up a window which shows the PGN (portable game notation)
+
Tags
Pops up a window which shows the PGN (portable game notation)
 tags for the current game. 
 For now this is a duplicate of the ‘Edit Tags’ item in the ‘Edit’ menu. 
-
Comments
Pops up a window which shows any comments to or variations on the current move. 
+
Comments
Pops up a window which shows any comments to or variations on the current move. 
 For now this is a duplicate of the ‘Edit Comment’ item in the ‘Edit’ menu. 
-
ICS Input Box
If this option is set in ICS mode,
+
ICS Input Box
If this option is set in ICS mode,
 XBoard
 creates an extra window that you can use for typing in ICS commands. 
 The input box is especially useful if you want to type in something long or do
 some editing on your input, because output from ICS doesn't get mixed
 in with your typing as it would in the main terminal window. 
-
Board
Summons a dialog where you can customaize the look of the chess board. 
+
Open Chat Window
This menu item opens a window in which you can conduct upto 5 chats
+with other ICS users (or channels). 
+To use the window, write the name of your chat partner, the channel number,
+or the words 'shouts', 'whispers', 'cshouts' in the upper field
+(closing with <Enter>). 
+Everything you type in the lowest field will then automatically be sent to
+the mentioned party, while everything that party sends to you will
+appear in the central text box, rather than appear in the ICS console. 
+The row of buttons allow you to choose between chat;
+to start a new chat, just select an empty button,
+and complete the ‘Chat partner’ field. 
+
Board
Summons a dialog where you can customize the look of the chess board. 
 Here you can specify the directory from which piece images should be taken,
 when you don't want to use the built-in piece images
-(see pixmapDirectory and bitmapDirectory options),
-an external pixmap to be used for the board squares
+(see pieceImageDirectory option),
+external images to be used for the board squares
 (liteBackTextureFile and darkBackTextureFile options),
-and square and piece colors for the built-ins. 
-
Game List Tags
a duplicate of the Game List dialog in the Options menu. 
+and square and piece colors for the default pieces. 
+
Game List Tags
a duplicate of the Game List dialog in the Options menu. 
 

 
 

@@ -591,15 +632,15 @@ Up: Menus
 
 
3.4 Mode Menu

 
-

+

      

-
Machine White
Tells the chess engine to play White. 
+
Machine White
Tells the chess engine to play White. 
 The Ctrl-W key is a keyboard equivalent. 
-
Machine Black
Tells the chess engine to play Black. 
+
Machine Black
Tells the chess engine to play Black. 
 The Ctrl-B key is a keyboard equivalent. 
-
Two Machines
Plays a game between two chess engines. 
+
Two Machines
Plays a game between two chess engines. 
 The Ctrl-T key is a keyboard equivalent. 
-
Analysis Mode
XBoard tells the chess engine to start analyzing the current game/position
+
Analysis Mode
XBoard tells the chess engine to start analyzing the current game/position
 and shows you the analysis as you move pieces around. 
 The Ctrl-A key is a keyboard equivalent. 
 Note: Some chess engines do not support Analysis mode.
@@ -622,26 +663,57 @@ and then step backward through this game to take the moves back.
 Note that you can also click on the clocks to set the opposite
 side to move (adding a so-called ‘null move’ to the game).
 
-     
The analysis function can also be used when observing games on an ICS
+     
You can also tell the engine to exclude some moves from analysis. 
+(Engines that do not support the exclude-moves feature will
+ignore this, however.) 
+The general way to do this is to play the move you want to exclude
+starting with a double click on the piece. 
+When you use drag-drop moving, the piece you grab with a double click
+will also remain on its square, to show you that you are not really
+making the move, but just forbid it from the current position. 
+Playing a thus excluded move a second time will include it again. 
+Excluded moves will be listed as text in a header line in the
+Engine Output window, and you can also re-include them by
+right-clicking them there. 
+This header line will also contain the words 'best' and 'tail';
+right-clicking those will exclude the currently best move,
+or all moves not explicitly listed in the header line. 
+Once you leave the current position all memory of excluded
+moves will be lost when you return there.
+
+     
Selecting this menu item while already in ‘Analysis Mode’ will
+toggle the participation of the second engine in the analysis. 
+The output of this engine will then be shown in the lower pane
+of the Engine Output window. 
+The analysis function can also be used when observing games on an ICS
 with an engine loaded (zippy mode); the engine then will analyse
-the positions as they occur in the observed game. 
-
Analyze Game
This option subjects the currently loaded game to automatic
+the positions as they occur in the observed game.
+
+     
Analyze Game
This option subjects the currently loaded game to automatic
 analysis by the loaded engine. 
 The Ctrl-G key is a keyboard equivalent. 
 XBoard will start auto-playing the game from the currently displayed position,
 while the engine is analyzing the current position. 
 The game will be annotated with the results of these analyses. 
 In particlar, the score and depth will be added as a comment,
-and the PV will be added as a variation. 
-The time the engine spends on analyzing each move can be controlled
-through the command-line option ‘-timeDelay’. 
+and the PV will be added as a variation.
+
+     
Normally the analysis would stop after reaching the end of the game. 
+But when a game is loaded from a multi-game file
+while ‘Analyze Game’ was already switched on,
+the analysis will continue with the next game in the file
+until the end of the file is reached (or you switch to another mode).
+
+     
The time the engine spends on analyzing each move can be controlled
+through the command-line option ‘-timeDelay’,
+which can also be set from the ‘Load Game Options’ menu dialog. 
 Note: Some chess engines do not support Analysis mode. 
 
Edit Game
Duplicate of the item in the Edit menu. 
 Note that ‘Edit Game’ is the idle mode of XBoard, and can be used
 to get you out of other modes. E.g. to stop analyzing, stop a game
 between two engines or stop editing a position. 
 
Edit Position
Duplicate of the item in the Edit menu. 
-
Training
Training mode lets you interactively guess the moves of a game for one
+
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 auto-played. 
@@ -649,7 +721,7 @@ 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
 ‘Training’ mode, the navigation buttons are disabled. 
-
ICS Client
This is the normal mode when XBoard
+
ICS Client
This is the normal mode when XBoard
 is connected to a chess server.  If you have moved into
 Edit Game or Edit Position mode, you can select this option to get out.
 
@@ -671,12 +743,12 @@ drag pieces to arbitrary squares while examining on ICC, but you can
 do so in bsetup mode on FICS.  In addition, the menu commands
 ‘Forward’, ‘Backward’, ‘Pause’, and ‘Stop Examining’
 have special functions in this mode; see below. 
-
Machine Match
Starts a match between two chess programs,
+
Machine Match
Starts a match between two chess programs,
 with a number of games and other parameters set through
 the ‘Match Options’ menu dialog. 
 When a match is already running, selecting this item will make
 XBoard drop out of match mode after the current game finishes. 
-
Pause
Pauses updates to the board, and if you are playing against a chess engine,
+
Pause
Pauses updates to the board, and if you are playing against a chess engine,
 also pauses your clock. To continue, select ‘Pause’ again, and the
 display will automatically update to the latest position. 
 The ‘P’ button and keyboard Pause key are equivalents.
@@ -711,45 +783,45 @@ Up: Menus
 
 
3.5 Action Menu

 
-

+

      

-
Accept
Accepts a pending match offer. 
+
Accept
Accepts a pending match offer. 
 The F3 key is a keyboard equivalent. 
 If there is more than one offer
 pending, you will have to type in a more specific command
 instead of using this menu choice. 
-
Decline
Declines a pending offer (match, draw, adjourn, etc.). 
+
Decline
Declines a pending offer (match, draw, adjourn, etc.). 
 The F4 key is a keyboard equivalent. If there
 is more than one offer pending, you will have to type in a more
 specific command instead of using this menu choice. 
-
Call Flag
Calls your opponent's flag, claiming a win on time, or claiming
+
Call Flag
Calls your opponent's flag, claiming a win on time, or claiming
 a draw if you are both out of time. 
 The F5 key is a keyboard equivalent. 
 You can also call your
 opponent's flag by clicking on his clock. 
-
Draw
Offers a draw to your opponent, accepts a pending draw offer
+
Draw
Offers a draw to your opponent, accepts a pending draw offer
 from your opponent, or claims a draw by repetition or the 50-move
 rule, as appropriate. The F6 key is a keyboard equivalent. 
-
Adjourn
Asks your opponent to agree to adjourning the current game, or
+
Adjourn
Asks your opponent to agree to adjourning the current game, or
 agrees to a pending adjournment offer from your opponent. 
 The F7 key is a keyboard equivalent. 
-
Abort
Asks your opponent to agree to aborting the current game, or
+
Abort
Asks your opponent to agree to aborting the current game, or
 agrees to a pending abort offer from your opponent. 
 The F8 key is a keyboard equivalent. An aborted
 game ends immediately without affecting either player's rating. 
-
Resign
Resigns the game to your opponent. The F9 key is a
+
Resign
Resigns the game to your opponent. The F9 key is a
 keyboard equivalent. 
-
Stop Observing
Ends your participation in observing a game, by issuing the ICS
+
Stop Observing
Ends your participation in observing a game, by issuing the ICS
 observe command with no arguments. ICS mode only. 
 The F10 key is a keyboard equivalent. 
-
Stop Examining
Ends your participation in examining a game, by issuing the ICS
+
Stop Examining
Ends your participation in examining a game, by issuing the ICS
 unexamine command. ICS mode only. 
 The F11 key is a keyboard equivalent. 
-
Upload to Examine
Create an examined game of the proper variant on the ICS,
+
Upload to Examine
Create an examined game of the proper variant on the ICS,
 and send the game there that is currenty loaded in XBoard
 (e.g. through pasting or loading from file). 
 You must be connected to an ICS for this to work. 
-
Adjudicate to White
Adjudicate to Black
Adjudicate Draw
Terminate an ongoing game in Two-Machines mode (including match mode),
+
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". 
@@ -766,9 +838,9 @@ Up: Menus
 
 
3.6 Engine Menu

 
-

+

      

-
Load Engine
Pops up a dialog where you can select or specify an engine to be loaded. 
+
Load Engine
Pops up a dialog where you can select or specify an engine to be loaded. 
 You will always have to indicate whether you want to load the engine
 as first or second engine, through the ‘Load menitioned engine as’
 drop-down list at the bottom of the dialog. 
@@ -797,7 +869,7 @@ will also be included in the list.
 For obsolete XBoard engines, which would normally take a long delay to load
 because XBoard is waiting for a response they will not give,
 you can tick ‘WB protocol v1’ to speed up the loading process. 
-
Engine #N Settings
Pop up a menu dialog to alter the settings specific to the applicable engine. 
+
Engine #N Settings
Pop up a menu dialog to alter the settings specific to the applicable engine. 
 (The second engine is only accessible once it has been used in Two-Machines mode.) 
 For each parameter the engine allows to be set,
 a control element will appear in this dialog that can be used to alter the value. 
@@ -812,23 +884,23 @@ and in that case the dialog will be empty (except for the OK and cancel buttons)
 UCI engines usually have many parameters. (But these are only visible with
 a sufficiently modern version of the Polyglot adapter needed to run UCI engines,
 e.g. Polyglot 1.4.55b.) For native XBoard engines this is less common. 
-
Hint
Displays a move hint from the chess engine. 
-
Book
Displays a list of possible moves from the chess engine's opening
+
Hint
Displays a move hint from the chess engine. 
+
Book
Displays a list of possible moves from the chess engine's opening
 book.  The exact format depends on what chess engine you are using. 
 With GNU Chess 4, the first column gives moves, the second column
 gives one possible response for each move, and the third column shows
 the number of lines in the book that include the move from the first
 column. If you select this option and nothing happens, the chess
 engine is out of its book or does not support this feature. 
-
Move Now
Forces the chess engine to move immediately. Chess engine mode only. 
+
Move Now
Forces the chess engine to move immediately. Chess engine mode only. 
 The Ctrl-M key is a keyboard equivalent. 
-
Retract Move
Retracts your last move. In chess engine mode, you can do this 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. 
 The Ctrl-X key is a keyboard equivalent. 
-
Recently Used Engines
At the bottom of the engine menu there can be a list of names
+
Recently Used Engines
At the bottom of the engine menu there can be a list of names
 of engines that you recently loaded through the Load Engine menu dialog
 in previous sessions. 
 Clicking on such a name will load that engine as first engine,
@@ -849,13 +921,13 @@ Up: Menus
 
 
3.7 Options Menu

 
-

+

      

-
General Options
The following items to set option values appear in the dialog
+
General Options
The following items to set option values appear in the dialog
 summoned by the general Options menu item. 
-
Absolute Analysis Scores
Controls if scores on the Engine Output window during analysis
+
Absolute Analysis Scores
Controls if scores on the Engine Output window during analysis
 will be printed from the white or the side-to-move point-of-view. 
-
Almost Always Queen
If this option is on, 7th-rank pawns automatically change into
+
Almost Always Queen
If this option is on, 7th-rank pawns automatically change into
 Queens when you pick them up,
 and when you drag them to the promotion square and release them there,
 they will promote to that. 
@@ -870,18 +942,18 @@ which would force promotion to Queen when true.
 Otherwise XBoard would bring up a dialog
 box whenever you move a pawn to the last rank, asking what piece
 you want to promote to. 
-
Animate Dragging
If Animate Dragging is on, while you are dragging a piece with the
+
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
 dragging a piece, but if Animate Moving is on, the move will be
 animated when it is complete. 
-
Animate Moving
If Animate Moving is on, all piece moves are animated.  An image of the
+
Animate Moving
If Animate Moving is on, all piece moves are animated.  An image of the
 piece is shown moving from the old square to the new square when the
 move is completed (unless the move was already animated by Animate Dragging). 
 If Animate Moving is off, a moved piece instantly disappears from its
 old square and reappears on its new square when the move is complete. 
 The shifted Ctrl-A key is a keyboard equivalent. 
-
Auto Flag
If this option is on and one player runs out of time
+
Auto Flag
If this option is on and one player runs out of time
 before the other,
 XBoard
 will automatically call his flag, claiming a win on time. 
@@ -891,7 +963,7 @@ and the ICS may award you a draw instead of a win if you have
 insufficient mating material.  In local chess engine mode,
 XBoard
 may call either player's flag and will not take material into account (?). 
-
Auto Flip View
If the Auto Flip View option is on when you start a game, the board
+
Auto Flip View
If the Auto Flip View option is on when you start a game, the board
 will be automatically oriented so that your pawns move from the bottom
 of the window towards the top.
 
@@ -902,16 +974,21 @@ orientation is determined by the flipView command line option;
 if it is false (the default), White's pawns move from bottom to top
 at the start of each game; if it is true, Black's pawns move from
 bottom to top. See User interface options. 
-
Blindfold
If this option is on, XBoard displays the board as usual but does
+
Blindfold
If this option is on, XBoard displays the board as usual but does
 not display pieces or move highlights.  You can still move in the
 usual way (with the mouse or by typing moves in ICS mode), even though
 the pieces are invisible. 
-
Drop Menu
Controls if right-clicking the board in crazyhouse / bughouse
+
Drop Menu
Controls if right-clicking the board in crazyhouse / bughouse
 will pop up a menu to drop a piece on the clicked square
 (old, deprecated behavior)
 or allow you to step through an engine PV
 (new, recommended behavior). 
-
Hide Thinking
If this option is off, the chess engine's notion of the score and best
+
Enable Variation Trees
If this option is on, playing a move in Edit Game or Analyze mode
+while keeping the Shift key pressed will start a new variation. 
+You can then recall the previous line through the ‘Revert’ menu item. 
+When off, playing a move will truncate the game and append the move
+irreversibly. 
+
Hide Thinking
If this option is off, the chess engine's notion of the score and best
 line of play from the current position is displayed as it is
 thinking. The score indicates how many pawns ahead (or if negative,
 behind) the chess engine thinks it is. In matches between two
@@ -919,14 +996,14 @@ machines, the score is prefixed by ‘WCtrl-H key is a keyboard equivalent. 
-
Highlight Last Move
If Highlight Last Move is on, after a move is made, the starting and
+
Highlight Last Move
If Highlight Last Move is on, after a move is made, the starting and
 ending squares remain highlighted. In addition, after you use Backward
 or Back to Start, the starting and ending squares of the last move to
 be unmade are highlighted. 
-
Highlight with Arrow
Causes the highlighting described in Highlight Last Move to be done
+
Highlight with Arrow
Causes the highlighting described in Highlight Last Move to be done
 by drawing an arrow between the highlighted squares,
 so that it is visible even when the width of the grid lines is set to zero. 
-
Move Sound
Enables the sounding of an audible signal when the computer performs a move. 
+
Move Sound
Enables the sounding of an audible signal when the computer performs a move. 
 For the selection of the sound, see ‘Sound Options’. 
 If you turn on this option when using XBoard with the Internet
 Chess Server, you will probably want to give the
@@ -934,7 +1011,7 @@ Chess Server, you will probably want to give the
 command to the ICS, since otherwise the ICS will ring the terminal bell
 after every move (not just yours). (The .icsrc file
 is a good place for this; see ICS options.) 
-
One-Click Moving
If this option is on, XBoard does not wait for you to click both the
+
One-Click Moving
If this option is on, XBoard does not wait for you to click both the
 from- and the to-square, or drag the piece, but performs a move as soon
 as it is uniqely specified. 
 This applies to clicking an own piece that only has a single legal move,
@@ -945,34 +1022,40 @@ will cause that capture to be made.
 Promoting a Pawn by clicking its to-square will suppress the promotion
 popup or other methods for selecting an under-promotion,
 and make it promote to Queen. 
-
Periodic Updates
If this option is off (or if
+
Periodic Updates
If this option is off (or if
 you are using a chess engine that does not support periodic updates),
 the analysis window
 will only be updated when the analysis changes. If this option is
 on, the Analysis Window will be updated every two seconds. 
-
Ponder Next Move
If this option is off, the chess engine will think only when it is on
+
Play Move(s) of Clicked PV
If this option is on, right-clicking a PV in the Engine Output window
+during Analyze mode will cause the first move of that PV to be played. 
+You could also play more than one (or no) PV move by moving the mouse
+to engage in the PV walk such a right-click will start,
+to seek out another position along the PV where you want to continue
+the analysis, before releasing the mouse button. 
+
Ponder Next Move
If this option is off, the chess engine will think only when it is on
 move.  If the option is on, the engine will also think while waiting
 for you to make your move. 
 The shifted Ctrl-P key is a keyboard equivalent. 
-
Popup Exit Message
If this option is on, when XBoard wants to display a message just
+
Popup Exit Message
If this option is on, when XBoard wants to display a message just
 before exiting, it brings up a modal dialog box and waits for you to
 click OK before exiting.  If the option is off, XBoard prints the
 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
+
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 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. 
-
Scores in Move List
If this option is on, XBoard will display the depth and score
+
Scores in Move List
If this option is on, XBoard will display the depth and score
 of engine moves in the Move List, in the format of a PGN comment. 
-
Show Coords
If this option is on, XBoard displays algebraic coordinates
+
Show Coords
If this option is on, XBoard displays algebraic coordinates
 along the board's left and bottom edges. 
-
Show Target Squares
If this option is on, all squares a piece that is 'picked up' with the mouse
+
Show Target Squares
If this option is on, all squares a piece that is 'picked up' with the mouse
 can legally move to are highighted with a fat colored dot in the
 highlightColor (non-captures) or premoveHighlightColor (captures). 
 Legality testing must be on for XBoard to know how the piece moves. 
-
Test Legality
If this option is on, XBoard tests whether the moves you try to make
+
Test Legality
If this option is on, XBoard tests whether the moves you try to make
 with the mouse are legal and refuses to let you make an illegal move. 
 The shifted Ctrl-L key is a keyboard equivalent. 
 Moves loaded from a file with ‘Load Game’ are also checked.  If
@@ -982,15 +1065,15 @@ off this option is useful if you are playing a chess variant with
 rules that XBoard does not understand.  (Bughouse, suicide, and wild
 variants where the king may castle after starting on the d file are
 generally supported with Test Legality on.) 
-
Flash Moves
Flash Rate
If this option is non-zero, whenever a move is completed,
+
Flash Moves
Flash Rate
If this option is non-zero, whenever a move is completed,
 the moved piece flashes the specified number of times. 
 The flash-rate setting determines how rapidly this flashing occurs. 
-
Animation Speed
Determines the duration (in msec) of an animation step,
+
Animation Speed
Determines the duration (in msec) of an animation step,
 when ‘Animate Moving’ is swiched on. 
-
Zoom factor in Evaluation Graph
Sets the valueof the evalZoom option,
+
Zoom factor in Evaluation Graph
Sets the valueof the evalZoom option,
 indicating the factor by which the score interval (-1,1) should be
 blown up on the vertical axis of the Evaluation Graph. 
-
Time Control
Pops up a sub-menu where you can set the time-control parameters interactively. 
+
Time Control
Pops up a sub-menu where you can set the time-control parameters interactively. 
 Allows you to select classical or incremental time controls,
 set the moves per session, session duration, and time increment. 
 Also allows specification of time-odds factors for one or both engines. 
@@ -998,7 +1081,7 @@ If an engine is given a time-odds factor N, all time quota it gets,
 be it at the beginning of a session or through the time increment or
 fixed time per move, will be divided by N. 
 The shifted Alt+T key is a keyboard equivalent. 
-
Common Engine
Pops up a sub-menu where you can set some engine parameters common to most engines,
+
Common Engine
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 that allows setting of these parameters on
@@ -1020,7 +1103,7 @@ When set to 0, only the move(s) with the highest probability will be played.
 When set to 100, all listed moves will be played with equal pobability. 
 Other settings interpolate between that. 
 The shifted Alt+U key is a keyboard equivalent. 
-
Adjudications
Pops up a sub-menu where you can enable or disable various adjudications
+
Adjudications
Pops up a sub-menu where you can enable or disable various adjudications
 that XBoard can perform in engine-engine games. 
 The shifted Alt+J key is a keyboard equivalent. 
 You can instruct XBoard to detect and terminate the game on checkmate
@@ -1041,22 +1124,22 @@ For the latter adjudication to work, XBoard should be able to properly understan
 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.
 
-     
ICS Options
The following options occur in a dialog summoned by the
+     
ICS Options
The following options occur in a dialog summoned by the
 ICS Options menu item. 
-
Auto Kibitz
Setting this option when playing with or aginst a chess program on an ICS
+
Auto Kibitz
Setting this option when playing with or aginst a chess program on an ICS
 will cause the last line of thinking output of the engine before its move
 to be sent to the ICS in a kibitz command. 
 In addition, any kibitz message received through the ICS from
 an opponent chess program will be diverted to the engine-output window,
 (and suppressed in the console),
 where you can play through its PV by right-clicking it. 
-
Auto Comment
If this option is on, any remarks made on ICS while you are observing or
+
Auto Comment
If this option is on, any remarks made on ICS while you are observing or
 playing a game are recorded as a comment on the current move.  This includes
 remarks made with the ICS commands say, tell, whisper,
 and kibitz. 
 Limitation: remarks that you type yourself are not recognized;
 XBoard scans only the output from ICS, not the input you type to it. 
-
Auto Observe
If this option is on and you add a player to your gnotify
+
Auto Observe
If this option is on and you add a player to your gnotify
 list on ICS, XBoard will automatically observe all of that
 player's games, unless you are doing something else (such as
 observing or playing a game of your own) when one starts. 
@@ -1069,24 +1152,24 @@ your ICS
 variable is set to 0, or if the ICS you are using does not
 properly support observing from Black's point of view,
 you will see the game from White's point of view. 
-
Auto Raise Board
If this option is on, whenever a new game begins, the chessboard window
+
Auto Raise Board
If this option is on, whenever a new game begins, the chessboard window
 is deiconized (if necessary) and raised to the top of the stack of windows. 
-
Auto Save
If this option is true, at the end of every game XBoard prompts
+
Auto Save
If this option is true, at the end of every game XBoard prompts
 you for a file name and appends a record of the game to the file
 you specify. 
 Disabled if the saveGameFile command-line
 option is set, as in that case all games are saved to the specified file. 
 See Load and Save options. 
-
Background Observe
Setting this option will make XBoard suppress display of any boards
+
Background Observe
Setting this option will make XBoard suppress display of any boards
 from observed games while you are playing. 
 In stead the last such board will be remembered,
 and shown to you when you right-click the board. 
 This allows you to peek at your bughouse partner's game when you want,
 without disturbing your own game too much. 
-
Dual Board
Setting this option in combination with ‘Background Observe’
+
Dual Board
Setting this option in combination with ‘Background Observe’
 will display boards of observed games while you are playing
 on a second board next to that of your own game. 
-
Get Move List
If this option is on, whenever XBoard
+
Get Move List
If this option is on, whenever XBoard
 receives the first board of a new ICS game (or a different game from
 the one it is currently displaying), it
 retrieves the list of past moves from the ICS. 
@@ -1098,20 +1181,20 @@ to keep from wasting time and network bandwidth fetching the move lists over
 and over. 
 When you turn this option on from the menu, XBoard
 immediately fetches the move list of the current game (if any). 
-
Quiet Play
If this option is on, XBoard will automatically issue an ICS
+
Quiet Play
If this option is on, XBoard will automatically issue an ICS
 set shout 0
 command whenever you start a game and a
 set shout 1
 command whenever you finish one.  Thus, you will not be distracted
 by shouts from other ICS users while playing. 
-
Seek Graph
Setting this option will cause XBoard to display an graph of
+
Seek Graph
Setting this option will cause XBoard to display an graph of
 currently active seek ads when you left-click the board
 while idle and logged on to an ICS. 
-
Auto-Refresh Seek Graph
In combination with the ‘Seek Graph’ option this
+
Auto-Refresh Seek Graph
In combination with the ‘Seek Graph’ option this
 will cause automatic update of the seek graph while it is up. 
 This only works on FICS and ICC,
 and requires a lot of bandwidth on a busy server. 
-
Premove
Premove White
Premove Black
First White Move
First Black Move
If this option is on while playing a game on an ICS, you can register
+
Premove
Premove White
Premove Black
First White Move
First Black Move
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
 will be highlighted with a special color (red by default).  When it is
@@ -1123,7 +1206,7 @@ entirely.
 
      
You can also enter premoves for the first white and black moves
 of the game. 
-
ICS Alarm
ICS Alarm Time
When this option is on, an alarm sound is played when your clock
+
ICS Alarm
ICS Alarm Time
When this option is on, an alarm sound is played when your clock
 counts down to the icsAlarmTime in an ICS game. 
 (By default, the time is 5 seconds, but you can pecify other values
 with the Alarm Time spin control.) 
@@ -1132,15 +1215,15 @@ alarm will sound each time the clock counts down to the icsAlarmTime.
 By default, the alarm sound is the terminal bell, but on some systems
 you can change it to a sound file using the soundIcsAlarm option; see
 below. 
-
Colorize Messages
Ticking this options causes various types of ICS messages do be
+
Colorize Messages
Ticking this options causes various types of ICS messages do be
 displayed with different foreground or background colors in the console. 
 The colors can be individually selected for each type,
 through the accompanying text edits.
 
-     
Match Options
Summons a dialog where you can set options important for playing automatic
+     
Match Options
Summons a dialog where you can set options important for playing automatic
 matches between two chess programs
 (e.g. by using the ‘Machine Match’ menu item in the ‘Mode’ menu). 
-
Tournament file
To run a tournament, XBoard needs a file to record its progress,
+
Tournament file
To run a tournament, XBoard needs a file to record its progress,
 so it can resume the tourney when it is interrupted. 
 When you want to conduct anything more complex than a simple
 two-player match with the currently loaded engines,
@@ -1158,19 +1241,19 @@ Provided that you specify participants;
 without participants no tournament file will be made, but other entered values
 (e.g. for the file with opening positions) will take effect. 
 Default: configured by the defaultTourneyName option. 
-
Sync after round
Sync after cycle
The sync options, when on, will cause WinBoard to refrain from starting games
+
Sync after round
Sync after cycle
The sync options, when on, will cause WinBoard to refrain from starting games
 of the next round or cycle before all games of the previous round or cycle are finished. 
 This guarantees correct ordering in the games file,
 even when multiple XBoard instances are concurrently playing games for the same tourney. 
 Default: sync after cycle, but not after round. 
-
Select Engine
Tourney participants
With the Select Engine drop-down list you can pick an engine from your list
+
Select Engine
Tourney participants
With the Select Engine drop-down list you can pick an engine from your list
 of installed engines in the settings file, to be added to the tournament. 
 The engines selected so far will be listed in the ‘Tourney participants’ memo. 
 The latter is a normal text edit, so you can use normal text-editing functions
 to delete engines you selected by accident, or change their order. 
 Do not type names yourself there, because names that do not exactly match
 one of the names from the drop-down list will lead to undefined behavior. 
-
Tourney type
Here you can specify the type of tournament you want. 
+
Tourney type
Here you can specify the type of tournament you want. 
 XBoard’s intrinsic tournament manager support round-robins (type = 0),
 where each participant plays every other participant, and (multi-)gauntlets,
 where one (or a few) so-called ‘gauntlet engines’ play an independent set of opponents. 
@@ -1181,7 +1264,7 @@ A value of -1 instructs XBoard to play Swiss; for this to work an external
 pairing engine must be specified through the pairingEngine option. 
 Each Swiss round will be considered a tourney cycle in that case. 
 Default:0
-
Number of tourney cycles
Default number of Games
You can specify tourneys where every two opponents play each other multiple times. 
+
Number of tourney cycles
Default number of Games
You can specify tourneys where every two opponents play each other multiple times. 
 Such multiple games can be played in a row,
 as specified by the ‘number of games per pairing’,
 or by repeating the entire tournament schedule a number of times
@@ -1190,9 +1273,9 @@ The total number of times two engine meet will be the product of these two.
 Default is 1 cycle;
 the number of games per pairing is the same as the default number of match games,
 stored in your settings file through the defaultMatchGames option. 
-
Save Tourney Games
File where the tournament games are saved
+
Save Tourney Games
File where the tournament games are saved
 (duplicate of the item in the ‘Save Game Options’). 
-
Game File with Opening Lines
File with Start Positions
Game Number
Position Number
Rewind Index after
These items optionally specify the file with move sequences or board positions the tourney
+
Game File with Opening Lines
File with Start Positions
Game Number
Position Number
Rewind Index after
These items optionally specify the file with move sequences or board positions the tourney
 games should start from. 
 The corresponding numbers specify the number of the game or position in the file. 
 Here a value -1 means automatic stepping through all games on the file,
@@ -1205,12 +1288,12 @@ In this case the first (odd) games will randomly select from the book,
 but the second (even) games will select the same moves from the book as the previous game. 
 (Note this leads to the same opening only if both engines use the GUI book!) 
 Default: No game or position file will be used. The default index if such a file is used is 1. 
-
Disable own engine bools be default
Setting this option reverses the default situation for use of the GUI opening book
+
Disable own engine bools be default
Setting this option reverses the default situation for use of the GUI opening book
 in tournaments from what it normally is, namely not using it. 
 So unless the engine is installed with an option to explicitly specify it should
 not use the GUI book (i.e. -firstHasOwnBookUCI true),
 it will be made to use the GUI book. 
-
Replace Engine
Upgrade Engine
With these two buttons you can alter the participants of an already running tournament. 
+
Replace Engine
Upgrade Engine
With these two buttons you can alter the participants of an already running tournament. 
 After opening the Match Options dialog on an XBoard that is playing for the tourney,
 you will see all the tourney parameters in the dialog fields. 
 You can then replace the name of one engine by that of another
@@ -1223,24 +1306,24 @@ be invalidated, and they will be replayed with the substitute engine.
 In this latter case the engine must not be playing when you do this,
 but otherwise there is no need to pause the tournament play
 for making a substitution. 
-
Clone Tourney
Pressing this button after you have specified an existing tournament file
+
Clone Tourney
Pressing this button after you have specified an existing tournament file
 will copy the contents of the latter to the dialog,
 and then puts the originally proposed name for the tourney file back. 
 You can then run a tourney with the same parameters
 (possibly after changing the proposed name of the tourney file for the new tourney)
 by pressing 'OK'.
 
-     
Load Game Options
Summons a dialog where you can set the autoDisplayComment and
+     
Load Game Options
Summons a dialog where you can set the autoDisplayComment and
 autoDisplayTags options, (which control popups when viewing loaded games),
 and specify the rate at which loaded games are auto-played,
 in seconds per move (which can be a fractional number, like 1.6). 
 You can also set search criteria for determining which games
 will be displayed in the Game List for a multi-game file,
 and thus be eligible for loading:
-
Elo of strongest player
Elo of weakest player
year
These numeric fields set thresholds (lower limits) on the Elo rating of the mentioned player,
+
Elo of strongest player
Elo of weakest player
year
These numeric fields set thresholds (lower limits) on the Elo rating of the mentioned player,
 or the date the game was played. 
 Defaults: 0
-
Search mode
This setting determines which positions in a game will be considered a match
+
Search mode
This setting determines which positions in a game will be considered a match
 to the position currently displayed in the board window
 when you press the ‘find position’ button in the Game List. 
 You can search for an exact match,
@@ -1254,23 +1337,29 @@ For the latter you have to place the material that must be present
 in the four lowest ranks of the board,
 and optional additional material in the four highest ranks of the board. 
 You can request the optional material to be balanced. 
-
number of consecutive positions
When you are searching by material, rather than for an exact match,
+The ‘narrow’ button is similar in fuction to the ‘find position’ button,
+but only searches in the already selected games,
+rather than the complete game file,
+and can thus be used to refine a search based on multiple criteria. 
+
number of consecutive positions
When you are searching by material, rather than for an exact match,
 this parameter indicates forhowmany consecutive game positions
 the same amount of material must be on the board before it is
 considered a match. 
-
Also match reversed colors
Also match left-right flipped position
When looking for matching positions rather than by material,
+
Also match reversed colors
Also match left-right flipped position
When looking for matching positions rather than by material,
 these settings determine whether mirror images
 (in case of a vertical flip in combination with color reversal)
 will be also considered a match. 
 The left-right flipping is only useful after all castling rights
 have expired (or in Xiangqi).
 
-     
Save Game Options
Summons a dialog where you can specify the files on which XBoard should
-automtically save any played or entered games,
+     
Save Game Options
Summons a dialog where you can specify the files on which XBoard should
+automatically save any played or entered games,
 (the saveGameFile option),
 or the final position of such games (the savePositionfile option). 
 You can also select 'auto-save' without a file name,
 in which case XBoard will prompt the user for a file name after each game. 
+In ICS mode you can limit the auto-saving to your own games
+(i.e. suppress saving of observed games). 
 You can also set the default value for the PGN Event tag that will
 be used for each new game you start. 
 Various options for the format of the game can be specified as well,
@@ -1279,10 +1368,10 @@ and if a tag with info about the score with which the engine came out of book
 should be included. 
 For Chess, always set the format to PGN, rather than "old save stye"!
 
-     
Game List
Pops up a dialog where you can select the PGN tags that should appear
+     
Game List
Pops up a dialog where you can select the PGN tags that should appear
 on the lines in the game list, and their order.
 
-     
Sound Options
Summons a dialog where you can specify the sounds that should accompany
+     
Sound Options
Summons a dialog where you can specify the sounds that should accompany
 various events that can occur XBoard. 
 Most events are only relevant to ICS play,
 but the move sound is an important exception. 
@@ -1303,7 +1392,7 @@ move if you are observing a game on the Internet Chess Server).
 The sound is not played after moves you make or moves read from a
 saved game file.
 
-     
Save Settings Now
Selecting this menu item causes the current XBoard settings to be
+     
Save Settings Now
Selecting this menu item causes the current XBoard settings to be
 written to the settings file, so they will also apply in future sessions. 
 Note that some settings are 'volatile', and are not saved,
 because XBoard considers it too unlikely that you want those to apply
@@ -1314,8 +1403,27 @@ if they have their own opening book, if they are UCI or native XBoard),
 or the variant you are playing. 
 Such options would still be understood when they appear in the settings
 file in case they were put there with the aid of a text editor, but they
-would disappear from the file as soon as you save the settings. 
-
Save Settings on Exit
Setting this option has no immediate effect, but causes the settings
+would disappear from the file as soon as you save the settings.
+
+     
Note that XBoard no longer pays attention to options values specified
+in the .Xresources file. 
+(Specifying key bindings there will still work, though.) 
+To alter the default of volatile options, you can use the following method:
+Rename your ~/.xboardrc settings file (to ~/.yboardrc, say), and create
+a new file ~/.xboardrc, which only contains the options
+
+     
          -settingsFile  ~/.yboardrc
+          -saveSettingsFile  ~/.yboardrc
+

+     
This will cause your settings to be saved on ~/.yboardrc in the future,
+so that ~/.xboardrc is no longer overwritten. 
+You can then safely specify volatile options in ~/.xboardrc, either
+before or after the settingsFile options. 
+Note that when you specify persistent options after the settingsFile options
+in ~/.xboardrc, you will essentially turn them into volatile options
+with the specified value as default, because that value will overrule
+the value loaded from the settings file (being read later). 
+
Save Settings on Exit
Setting this option has no immediate effect, but causes the settings
 to be saved when you quit XBoard. What happens then is otherwise
 identical to what happens when you use select "Save Settings Now",
 see there. 
@@ -1332,20 +1440,20 @@ Up: Menus
 
 
3.8 Help Menu

 
-

+

      

-
Info XBoard
Displays the XBoard documentation in info format.  For this feature to
+
Info XBoard
Displays the XBoard documentation in info format.  For this feature to
 work, you must have the GNU info program installed on your system, and
 the file xboard.info must either be present in the current
 working directory, or have been installed by the ‘make install’
 command when you built XBoard. 
-
Man XBoard
Displays the XBoard documentation in man page format. 
+
Man XBoard
Displays the XBoard documentation in man page format. 
 The F1 key is a keyboard equivalent.  For this
 feature to work, the file xboard.6 must have been installed by
 the ‘make install’ command when you built XBoard, and the
 directory it was placed in must be on the search path for your
 system's ‘man’ command. 
-
About XBoard
Shows the current XBoard version number. 
+
About XBoard
Shows the current XBoard version number. 
 

 
 

@@ -1358,18 +1466,18 @@ Up: Menus
 
 
3.9 Other Shortcut Keys

 
-

+

      

-
Show Last Move
By hitting Enter the last move will be re-animated. 
-
Load Next Game
Loads the next game from the last game record file you loaded. 
+
Show Last Move
By hitting Enter the last move will be re-animated. 
+
Load Next Game
Loads the next game from the last game record file you loaded. 
 The Alt+PgDn key triggers this action. 
-
Load Previous Game
Loads the previous game from the last game record file you
+
Load Previous Game
Loads the previous game from the last game record file you
 loaded.  The Alt+PgUp key triggers this action. 
 Not available if the last game was loaded from a pipe. 
-
Reload Same Game
Reloads the last game you loaded. 
+
Reload Same Game
Reloads the last game you loaded. 
 Not available if the last game was loaded from a pipe. 
 Currently no keystroke is assigned to this ReloadGameProc. 
-
Reload Same Position
Reloads the last position you loaded. 
+
Reload Same Position
Reloads the last position you loaded. 
 Not available if the last position was loaded from a pipe. 
 Currently no keystroke is assigned to this ReloadPositionProc. 
 

@@ -1421,7 +1529,7 @@ Up: Top
 
 
4 Options

 
-

+

 This section documents the command-line options to XBoard.  You can
 set these options in two ways: by typing them on the shell command
 line you use to start XBoard, or by editing the settings file
@@ -1460,36 +1568,36 @@ Up: Options
 
 
4.1 Chess Engine Options

 
-

+

      

-
-tc or -timeControl minutes[:seconds]
Each player begins with his clock set to the timeControl period. 
+
-tc or -timeControl minutes[:seconds]
Each player begins with his clock set to the timeControl period. 
 Default: 5 minutes. 
 The additional options movesPerSession and timeIncrement
 are mutually exclusive. 
-
-mps or -movesPerSession moves
When both players have made movesPerSession moves, a
+
-mps or -movesPerSession moves
When both players have made movesPerSession moves, a
 new timeControl period is added to both clocks.  Default: 40 moves. 
-
-inc or -timeIncrement seconds
If this option is specified, movesPerSession is ignored. 
+
-inc or -timeIncrement seconds
If this option is specified, movesPerSession is ignored. 
 Instead, after each player's move, timeIncrement seconds are
 added to his clock. 
 Use ‘-inc 0’ if you want to require the entire
 game to be played in one timeControl period, with no increment. 
 Default: -1, which specifies movesPerSession mode. 
-
-clock/-xclock or -clockMode true/false
Determines whether or not to display the chess clocks. If clockMode is
+
-clock/-xclock or -clockMode true/false
Determines whether or not to display the chess clocks. If clockMode is
 false, the clocks are not shown, but the side that is to play next
 is still highlighted. Also, unless searchTime
 is set, the chess engine still keeps track of the clock time and uses it to
 determine how fast to make its moves. 
-
-st or -searchTime minutes[:seconds]
Tells the chess engine to spend at most the given amount of time
+
-st or -searchTime minutes[:seconds]
Tells the chess engine to spend at most the given amount of time
 searching for each of its moves. Without this option, the chess engine
 chooses its search time based on the number of moves and amount
 of time remaining until the next time control. 
 Setting this option also sets clockMode to false. 
-
-depth or -searchDepth number
Tells the chess engine to look ahead at most the given number of moves
+
-depth or -searchDepth number
Tells the chess engine to look ahead at most the given number of moves
 when searching for a move to make. Without this option, the chess
 engine chooses its search depth based on the number of moves and
 amount of time remaining until the next time control.  With the option,
 the engine will cut off its search early if it reaches the specified depth. 
-
-firstNPS number
-secondNPS number
Tells the chess engine to use an internal time standard based on its node count,
+
-firstNPS number
-secondNPS number
Tells the chess engine to use an internal time standard based on its node count,
 rather then wall-clock time, to make its timing decisions. 
 The time in virtual seconds should be obtained by dividing the node count
 through the given number, like the number was a rate in nodes per second. 
@@ -1502,16 +1610,16 @@ can provide fairer conditions for engine-engine matches on heavily loaded machin
 or with very fast games (where the wall clock is too inaccurate). 
 showThinking must be on for this option to work. Default: -1 (off). 
 Not many engines might support this yet! 
-
-firstTimeOdds factor
-secondTimeOdds factor
Reduces the time given to the mentioned engine by the given factor. 
+
-firstTimeOdds factor
-secondTimeOdds factor
Reduces the time given to the mentioned engine by the given factor. 
 If pondering is off, the effect is indistinguishable from what would happen
 if the engine was running on an n-times slower machine. Default: 1. 
-
-timeOddsMode mode
This option determines how the case is handled where both engines have a time-odds handicap. 
+
-timeOddsMode mode
This option determines how the case is handled where both engines have a time-odds handicap. 
 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. 
 (Replaces the Show-Thinking option of older xboard versions.) 
-
-thinking/-xthinking or -showThinking true/false
Forces the engine to send thinking output to xboard. 
+
-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,
 but as the thinking output in xboard 4.3 is also used for several other
@@ -1519,10 +1627,10 @@ purposes (adjudication, storing in PGN file) the display of it is now controlled
 by the new option Hide Thinking. See Options Menu. Default: false. 
 (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. 
+
-ponder/-xponder or -ponderNextMove true/false
Sets the Ponder Next Move menu option. See Options Menu. Default: true. 
 
-smpCores number
Specifies the maximum number of CPUs an SMP engine is allowed to use. 
 Only works for engines that support the XBoard/WinBoard-protocol cores feature. 
-
-mg or -matchGames n
Automatically runs an n-game match between two chess engines,
+
-mg or -matchGames n
Automatically runs an n-game match between two chess engines,
 with alternating colors. 
 If the loadGameFile or loadPositionFile option is set,
 XBoard
@@ -1533,35 +1641,42 @@ match is appended to the specified file. If the savePositionFile
 option is set, the final position reached in each game of the match is appended
 to the specified file. When the match is over, XBoard
 displays the match score and exits. Default: 0 (do not run a match). 
-
-mm/-xmm or -matchMode true/false
Setting matchMode to true is equivalent to setting
+
-mm/-xmm or -matchMode true/false
Setting matchMode to true is equivalent to setting
 matchGames to 1. 
-
-sameColorGames n
Automatically runs an n-game match between two chess engines,
+
-sameColorGames n
Automatically runs an n-game match between two chess engines,
 without alternating colors. 
 Otherwise the same applies as for the ‘-matchGames’ option,
 over which it takes precedence if both are specified. (See there.) 
 Default: 0 (do not run a match). 
-
-fcp or -firstChessProgram program
Name of first chess engine. 
+
-fcp or -firstChessProgram program
Name of first chess engine. 
 Default: Fairy-Max. 
-
-scp or -secondChessProgram program
Name of second chess engine, if needed. 
+
-scp or -secondChessProgram program
Name of second chess engine, if needed. 
 A second chess engine is started only in Two Machines (match) mode. 
 Default: Fairy-Max. 
-
-fb/-xfb or -firstPlaysBlack true/false
In games between two chess engines, firstChessProgram normally plays
+
-fe or -firstEngine nickname
This is an alternative to the fcp option for specifying the first engine,
+for engines that were already configured (using the ‘Load Engine’ dialog)
+in XBoard's settings file. 
+It will not only retrieve the real name of the engine,
+but also all options configured with it. 
+(E.g. if it is UCI, whether it should use book.) 
+
-se or -secondEngine nickname
As fe, but for the second engine. 
+
-fb/-xfb or -firstPlaysBlack true/false
In games between two chess engines, firstChessProgram normally plays
 white.  If this option is true, firstChessProgram plays black.  In a
 multi-game match, this option affects the colors only for the first
 game; they still alternate in subsequent games. 
-
-fh or -firstHost host
-sh or -secondHost host
Hosts on which the chess engines are to run. The default for
+
-fh or -firstHost host
-sh or -secondHost host
Hosts on which the chess engines are to run. The default for
 each is localhost. If you specify another host, XBoard
 uses rsh to run the chess engine there. (You can substitute a
 different remote shell program for rsh using the remoteShell
 option described below.) 
-
-fd or -firstDirectory dir
-sd or -secondDirectory dir
Working directories in which the chess engines are to be run. 
+
-fd or -firstDirectory dir
-sd or -secondDirectory dir
Working directories in which the chess engines are to be run. 
 The default is "", which means to run the chess engine
 in the same working directory as XBoard
 itself.  (See the CHESSDIR environment variable.) 
 This option is effective only when the chess engine is being run
 on the local host; it does not work if the engine is run remotely
 using the -fh or -sh option. 
-
-initString string or -firstInitString
-secondInitString string
The string that is sent to initialize each chess engine for a new game. 
+
-initString string or -firstInitString
-secondInitString string
The string that is sent to initialize each chess engine for a new game. 
 Default:
 
      
          new
@@ -1570,10 +1685,8 @@ Default:
      
Setting this option from the command line is tricky, because you must
 type in real newline characters, including one at the very end. 
 In most shells you can do this by
-entering a ‘\’ character followed by a newline. It is easier to set
-the option from your .Xresources file; in that case you can
-include the character sequence ‘\n’ in the string, and it will
-be converted to a newline.
+entering a ‘\’ character followed by a newline. 
+Using the character sequence ‘\n’ in the string should work too, though.
 
      
If you change this option, don't remove the ‘new’
 command; it is required by all chess engines to
@@ -1588,11 +1701,11 @@ and always (or never) randomize.
 
      
You can also try adding other commands to the initString; see the
 documentation of the chess engine you are using for details. 
-
-firstComputerString string
-secondComputerString string
The string that is sent to the chess engine if its opponent is another
+
-firstComputerString string
-secondComputerString string
The string that is sent to the chess engine if its opponent is another
 computer chess engine.  The default is ‘computer\n’.  Probably the
 only useful alternative is the empty string (‘’), which keeps the
 engine from knowing that it is playing another computer. 
-
-reuse/-xreuse or -reuseFirst true/false
-reuse2/-xreuse2 or -reuseSecond true/false
If the option is false,
+
-reuse/-xreuse or -reuseFirst true/false
-reuse2/-xreuse2 or -reuseSecond true/false
If the option is false,
 XBoard kills off the chess engine after every game and starts
 it again for the next game. 
 If the option is true (the default),
@@ -1600,26 +1713,26 @@ XBoard starts the chess engine only once
 and uses it repeatedly to play multiple games. 
 Some old chess engines may not work properly when
 reuse is turned on, but otherwise games will start faster if it is left on. 
-
-firstProtocolVersion version-number
-secondProtocolVersion version-number
This option specifies which version of the chess engine communication
+
-firstProtocolVersion version-number
-secondProtocolVersion version-number
This option specifies which version of the chess engine communication
 protocol to use.  By default, version-number is 2.  In version 1, the
 "protover" command is not sent to the engine; since version 1 is a
 subset of version 2, nothing else changes.  Other values for
 version-number are not supported. 
-
-firstScoreAbs true/false
-secondScoreAbs true/false
If this option is set, the score reported by the engine is taken to be
+
-firstScoreAbs true/false
-secondScoreAbs true/false
If this option is set, the score reported by the engine is taken to be
 that in favor of white, even when the engine plays black. 
 Important when XBoard uses the score for adjudications, or in PGN reporting. 
-
-niceEngines priority
This option allows you to lower the priority of the engine processes,
+
-niceEngines priority
This option allows you to lower the priority of the engine processes,
 so that the generally insatiable hunger for CPU time of chess engines does not interfere so much
 with smooth operation of XBoard (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,
+
-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 an option announced by the engine at startup through the feature commands of the XBoard/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)
 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
+
-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,
@@ -1629,7 +1742,7 @@ castling and e.p. fields in variants that do not have castling or e.p.
 (shatranj, courier, xiangqi, shogi) so that XBoard would normally omit them
 (string = "- -"), or to add variant-specific fields that are not yet supported by XBoard
 (e.g. to indicate the number of checks in 3check). 
-
-shuffleOpenings
Forces shuffling of the opening setup in variants that normally have a fixed initial position. 
+
-shuffleOpenings
Forces shuffling of the opening setup in variants that normally have a fixed initial position. 
 Shufflings are symmetric for black and white, and exempt King and Rooks in variants
 with normal castling. 
 Remains in force until a new variant is selected. 
@@ -1647,18 +1760,18 @@ Up: Options
 
 
4.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
 on its command line, according to the option adapterCommand. 
-
-fUCCI
-sUCCI
-fUSI
-sUSI
Options similar to fUCI and sUCI, except that they
+
-fUCCI
-sUCCI
-fUSI
-sUSI
Options similar to fUCI and sUCI, except that they
 use the indicated engine with the protocol adapter specified in
 the ‘uxiAdapter’ option. 
 This can then be configured for running an UCCI or USI adapter,
 as the need arises. 
-
-adapterCommand string
The string conatins the command that should be issued by XBoard
+
-adapterCommand string
The string conatins the command that should be issued by XBoard
 to start an engine that is accompanied by the fUCI option. 
 Any identifier following a percent sign in the command (e.g. %fcp)
 will be considered the name of an XBoard option, and be replaced
@@ -1667,45 +1780,58 @@ For starting the second engine, any leading "f" or "first" in
 the option name will first be replaced by "s" or "second",
 before finding its value. 
 Default: 'polyglot -noini -ec "%fcp" -ed "%fd"'
-
-uxiAdapter string
Similar to adapterCommand, but used for engines accompanied
+
-uxiAdapter string
Similar to adapterCommand, but used for engines accompanied
 by the fUCCI or fUSI option, so you can configure
 XBoard to be ready to handle more than one flavor of non-native protocols. 
 Default: ""
-
-polyglotDir filename
Gives the name of the directory in which the Polyglot adapter for UCI engines resides. 
+
-polyglotDir filename
Gives the name of the directory in which the Polyglot adapter for UCI engines resides. 
 Default: "". 
-
-usePolyglotBook true/false
Specifies if the Polyglot book should be used as GUI book. 
-
-polyglotBook filename
Gives the filename of the opening book. 
+
-usePolyglotBook true/false
Specifies if the Polyglot book should be used as GUI book. 
+
-polyglotBook filename
Gives the filename of the opening book. 
 The book is only used when 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: depends on setting of the option discourageOwnBooks. 
-
-discourageOwnBooks true/false
When set, newly loaded engines will be assumed to use the GUI book,
+
-discourageOwnBooks true/false
When set, newly loaded engines will be assumed to use the GUI book,
 unless they explicitly specify differently. 
 Otherwise they will be assumed to not use the GUI book,
 unless the specify differently (e.g. with firstXBook). 
 Default: false. 
-
-bookDepth n
Limits the use of the GUI book to the first n moves of each side. 
+
-bookDepth n
Limits the use of the GUI book to the first n moves of each side. 
 Default: 12. 
-
-bookVariation n
A value n from 0 to 100 tunes the choice of moves from the GUI books
+
-bookVariation n
A value n from 0 to 100 tunes the choice of moves from the GUI books
 from totally random to best-only. Default: 50
-
-fn string or -firstPgnName string
-sn string or -secondPgnName string
Indicates the name that should be used for the engine in PGN tags of
+
-mcBookMode
When this volatile option is specified, the probing algorithm of the
+GUI book is altered to always select the move that is most under-represented
+based on its performance. 
+When all moves are played in approximately the right proportion,
+a book miss will be reported, to give the engine opportunity to
+explore a new move. 
+In addition score of the moves will be kept track of during the session
+in a book buffer. 
+By playing an match in this mode, a book will be built from scratch. 
+The only output are the saved games, which can be converted to an
+actual book later, with the ‘Save Games as Book’ command. 
+This command can also be used to pre-fill the book buffer
+before adding new games based on the probing algorithm. 
+
-fn string or -firstPgnName string
-sn string or -secondPgnName string
Indicates the name that should be used for the engine in PGN tags of
 engine-engine games. 
 Intended to allow you to install verions of the same engine with different settings,
 and still distinguish them. 
 Default: "". 
-
-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 XBoard/WinBoard engines,
 for those that support the memory feature of the XBoard/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 XBoard/WinBoard engines,
 for those that support the memory feature of the XBoard/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". 
@@ -1739,46 +1865,46 @@ Up: Options
 
 
4.3 Tournament options

 
-

+

      

-
-defaultMatchGames n
Sets the number of games that will be used for a match between two engines
+
-defaultMatchGames n
Sets the number of games that will be used for a match between two engines
 started from the menu to n. Also used as games per pairing in other tournament
 formats.  Default: 10. 
-
-matchPause n
Specifies the duration of the pause between two games of a match or tournament
+
-matchPause n
Specifies the duration of the pause between two games of a match or tournament
 between engines as n milliseconds. 
 Especially engines that do not support ping need this option,
 to prevent that the move they are thinking on when an opponent unexpectedly
 resigns will be counted for the next game, (leading to illegal moves there). 
 Default: 10000. 
-
-tf filename or -tourneyFile filename
Specifies the name of the tournament file used in match mode
+
-tf filename or -tourneyFile filename
Specifies the name of the tournament file used in match mode
 to conduct a multi-player tournament. 
 This file is a special settings file,
 which stores the description of the tournament (including progress info),
 through normal options (e.g. for time control, load and save files),
 and through some special-purpose options listed below. 
-
-tt number or -tourneyType number
Specifies the type of tourney: 0 = round-robin,
+
-tt number or -tourneyType number
Specifies the type of tourney: 0 = round-robin,
 N>0 = (multi-)gauntlet with N gauntlet engines,
 -1 = Swiss through external pairing engine. 
 Volatile option, but stored in tourney file. 
-
-cy number or -tourneyCycles number
Specifies the number of cycles in a tourney. 
+
-cy number or -tourneyCycles number
Specifies the number of cycles in a tourney. 
 Volatile option, but stored in tourney file. 
-
-participants list
The list is a multi-line text string that specifies engines
+
-participants list
The list is a multi-line text string that specifies engines
 occurring in the firstChesProgramNames list
 in the settings file by their (implied or explicitly given) nicknames,
 one engine per line. 
 The mentioned engines will play in the tourney. 
 Volatile option, but stored in tourney file. 
-
-results string
The string of +=- characters lists the result of all played games in a toruney. 
+
-results string
The string of +=- characters lists the result of all played games in a toruney. 
 Games currently playing are listed as *,
 while a space indicates a game that is not yet played or playing . 
 Volatile option, but stored in tourney file. 
-
-defaultTourneyName string
Specifies the name of the tournament file XBoard should propose
+
-defaultTourneyName string
Specifies the name of the tournament file XBoard should propose
 when the ‘Match Options’ dialog is opened. 
 Any %y, %M, %d, %h, %m, %s in the string are replaced by the current
 year, month, day of the month, hours, minutes, seconds of the current time,
 respectively, as two-digit number. 
 A %Y would be replaced by the year as 4-digit number. Default: empty string. 
-
-pairingEngine filename
Specifies the external program to be used to pair the participants in Swiss tourneys. 
+
-pairingEngine filename
Specifies the external program to be used to pair the participants in Swiss tourneys. 
 XBoard communicates with this engine in the same way as it communicates with Chess engines. 
 The only commands sent to the pairing engine are “results N string”,
 (where N is the number of participants,
@@ -1787,15 +1913,15 @@ and “pairing N”, (where N is the number of the tourney game).
 To the latter the pairing engine should answer with “A-B”,
 where A and B are participant numbers (in the range 1-N). 
 (There should be no reply to the results command.) Default: empty string. 
-
-afterGame string
-afterTourney string
When non-empty, the given string will be executed as a system command
+
-afterGame string
-afterTourney string
When non-empty, the given string will be executed as a system command
 after each tournament game, orafterthe tourney completes, respectively. 
 This can be used, for example, to autmatically run a cross-table generator
 on the PGN file where games are saved, to update the tourney standings. 
 Default: ""
-
-syncAfterRound true/false
-syncAfterCycle true/false
Controls whether different instances of XBoard concurrently running the
+
-syncAfterRound true/false
-syncAfterCycle true/false
Controls whether different instances of XBoard concurrently running the
 same tournament will wait for each other. 
 Defaults: sync after cycle, but not after round. 
-
-seedBase number
Used to store the seed of the pseudo-random-number generator in the
+
-seedBase number
Used to store the seed of the pseudo-random-number generator in the
 tourneyFile, so that separate instances of XBoard working on the same
 tourney can take coherent 'random' decisions, such as picking an
 opening for a given game number. 
@@ -1812,12 +1938,12 @@ Up: Options
 
 
4.4 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
@@ -1825,15 +1951,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. 
@@ -1841,21 +1967,21 @@ 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),
@@ -1898,7 +2024,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. 
@@ -1906,35 +2032,35 @@ 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. 
-
-seekGraph true/false or -sg
Enables displaying of the seek graph by left-clicking the board when
+
-seekGraph true/false or -sg
Enables displaying of the seek graph by left-clicking the board when
 you are logged on to an ICS and currently idle. 
 The seek graph show all players currently seeking games on the ICS,
 plotted according to their rating and the time control of the game they seek,
 in three different colors (for rated, unrated and wild games). 
 Computer ads are displayed as squares, human ads are dots. 
 Default: false. 
-
-autoRefresh true/false
Enables automatic updating of the seek graph,
+
-autoRefresh true/false
Enables automatic updating of the seek graph,
 by having the ICS send a running update of all newly placed
 and removed seek ads. 
 This consumes a substantial amount of communication bandwidth,
 and is only supported for FICS and ICC. 
 Default: false. 
-
-backgroundObserve true/false
When true, boards sent to you by the ICS from other games while you are playing
+
-backgroundObserve true/false
When true, boards sent to you by the ICS from other games while you are playing
 (e.g. because you are observing them)
 will not be automatically displayed. 
 Only a summary of time left and material of both players will appear
@@ -1948,7 +2074,7 @@ This feature is provided solely for the benefit of bughouse players,
 to enable them to peek at their partner's game without the need
 to logon twice. 
 Default: false. 
-
-dualBoard true/false
In combination with -backgroundObserve true, this option will display
+
-dualBoard true/false
In combination with -backgroundObserve true, this option will display
 the board of the background game side by side with that of your own game,
 so you can have it in view permanently. 
 Any board or holdings info coming in will be displayed on the secondary
@@ -1956,25 +2082,25 @@ board immediately.
 This feature is still experimental and largely unfinished. 
 There is no animation or highlighting of moves on the secondary board. 
 Default: false. 
-
-disguisePromotedPieces true/false
When set promoted Pawns in crazyhouse/bughouse are displayed identical
+
-disguisePromotedPieces true/false
When set promoted Pawns in crazyhouse/bughouse are displayed identical
 to primordial pieces of the same type, rather than distinguishable. 
 Default: true. 
-
-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. 
-
lowTimeWarning true/false
Controls a color change of the board as a warning your time is running out. 
+
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. 
-
-prewhite/-xprewhite or -premoveWhite
-preblack/-xpreblack or -premoveBlack
-premoveWhiteText string
-premoveBlackText string
Set the menu options for specifying the first move for either color. 
+
-pre/-xpre \fRor\fB -premove true/false
Sets the Premove menu option. See Options Menu. Default: true. 
+
-prewhite/-xprewhite or -premoveWhite
-preblack/-xpreblack or -premoveBlack
-premoveWhiteText string
-premoveBlackText string
Set the menu options for specifying the first move for either color. 
 See Options Menu. Defaults: false and empty strings, so no pre-moves. 
-
-quiet/-xquiet or -quietPlay true/false
Sets the Quiet Play menu option.  See Options Menu.  Default: false. 
-
-colorizeMessages or -colorize/-xcolorize
Setting colorizeMessages
+
-quiet/-xquiet or -quietPlay true/false
Sets the Quiet Play menu option.  See Options Menu.  Default: false. 
+
-colorizeMessages or -colorize/-xcolorize
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. 
 Default: true. 
-
-colorShout foreground,background,bold
-colorSShout foreground,background,bold
-colorCShout 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
-colorCShout 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
@@ -1986,64 +2112,28 @@ Here “default” means the default foreground or background color of
 your xterm.  Bold can be 1 or 0.  If background is omitted, “default”
 is assumed; if bold is omitted, 0 is assumed.
 
-     
Here is an example of how to set the colors in your .Xresources file. 
-The colors shown here are the default values; you will get
-them if you turn -colorize on without specifying your own colors. 
-CShout is synonymous with SShout.
-
-     
          xboard*colorizeMessages: true
-          xboard*colorShout: green
-          xboard*colorSShout: green, black, 1
-          xboard*colorChannel1: cyan
-          xboard*colorChannel: cyan, black, 1
-          xboard*colorKibitz: magenta, black, 1
-          xboard*colorTell: yellow, black, 1
-          xboard*colorChallenge: red, black, 1
-          xboard*colorRequest: red
-          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. 
-
-soundDirectory directoryname
This option specifies where XBoard will look for sound files,
+
-soundDirectory directoryname
This option specifies where XBoard will look for sound files,
 when these are not given as an absolute path name. 
-
-soundShout filename
-soundSShout filename
-soundCShout filename
-soundChannel filename
-soundChannel1 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
-soundCShout filename
-soundChannel filename
-soundChannel1 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. 
 CShout is synonymous with SShout. 
-
-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).
-
-     
Here is an example of how to set the sounds in your .Xresources file:
-
-     
          xboard*soundShout: shout.wav
-          xboard*soundSShout: sshout.wav
-          xboard*soundChannel1: channel1.wav
-          xboard*soundChannel: channel.wav
-          xboard*soundKibitz: kibitz.wav
-          xboard*soundTell: tell.wav
-          xboard*soundChallenge: challenge.wav
-          xboard*soundRequest: request.wav
-          xboard*soundSeek: seek.wav
-          xboard*soundMove: move.wav
-          xboard*soundIcsWin: win.wav
-          xboard*soundIcsLoss: lose.wav
-          xboard*soundIcsDraw: draw.wav
-          xboard*soundIcsUnfinished: unfinished.wav
-          xboard*soundIcsAlarm: alarm.wav
-

-     

+sound). 
+

 
 

 
@@ -2056,9 +2146,9 @@ Up: Options
 
 
4.5 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
@@ -2081,16 +2171,17 @@ 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’ or ‘Analyze File’. 
+
-td or -timeDelay seconds
Time delay between moves during ‘Load Game’ or ‘Analyze File’. 
 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
+
-onlyOwnGames true/false
Suppresses auto-saving of ICS observed games. Default: false. 
+
-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
@@ -2103,27 +2194,27 @@ 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, XBoard saves depth, score and time used for each
+
-pgnExtendedInfo true/false
If this option is set, XBoard 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". 
-
-pgnNumberTag true/false
Include the (unique) sequence number of a tournament game into the saved
+
-pgnNumberTag true/false
Include the (unique) sequence number of a tournament game into the saved
 PGN file as a 'number' tag. 
 Default: false. 
-
-saveOutOfBookInfo true/false
Include the information on how the engine(s) game out of its opening book
+
-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. 
 Default: true. 
-
-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
+
-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, c=result comment. 
 Default: "eprd"
-
-ini or -settingsFile filename
-saveSettingsFile filename
@filename
When XBoard encounters an option -settingsFile (or -ini for short),
+
-ini or -settingsFile filename
-saveSettingsFile filename
@filename
When XBoard encounters an option -settingsFile (or -ini for short),
 or @filename, it tries to read the mentioned file,
 and substitutes the contents of it (presumaby more command-line options)
 in place of the option. 
@@ -2142,7 +2233,7 @@ and will be used to contain system-wide default setings, amongst which
 a -saveSettingsFile and -settingsFile options to specify a settings file
 accessible to the individual user, such as ~/.xboardrc in the user's
 home directory. 
-
-saveSettingsOnExit true/false
Controls saving of options on the settings file.  See Options Menu. 
+
-saveSettingsOnExit true/false
Controls saving of options on the settings file.  See Options Menu. 
 Default: true. 
 

 
@@ -2157,14 +2248,24 @@ Up: Options
 
 
4.6 User interface options

 
-

+

      

-
-display
-geometry
-iconic
-name
These and most other standard Xt options are accepted. 
-
-noGUI
Suppresses all GUI functions of XBoard
+
-display
-geometry
-iconic
-name
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. 
-
-recentEngines number
-recentEngineList list
When the number is larger than zero, it determines how many recently
+
-logoSize N
This option controls the drawing of player logos next to the clocks. 
+The integer N specifies the width of the logo in pixels;
+the logo height will always be half the width. 
+When N = 0, no logos will be diplayed. 
+Default: 0. 
+
-firstLogo imagefile
-secondLogo imagefile
Specify the images to be used as player logos when logoSize
+is non-zero, next to the white and black clocks, respectively. 
+
-autoLogo true/false
-logoDir filename
When autoLogo is set, XBoard will search for a PNG image file
+with the name of the engine or ICS in the directory specified
+by logoDir. 
+
-recentEngines number
-recentEngineList list
When the number is larger than zero, it determines how many recently
 used engines will be appended at the bottom of the ‘Engines’ menu. 
 The engines will be saved in your settings file as the option
 recentEngineList, by their nicknames,
@@ -2174,37 +2275,34 @@ the last one is discarded.
 Changes in the list will only become visible the next session,
 provided you saved the settings. 
 Default: 6. 
-
-oneClickMove true/false
When set, this option allows you to enter moves by only clicking the to-
+
-oneClickMove true/false
When set, this option allows you to enter moves by only clicking the to-
 or from-square, when only a single legal move to or from that square
 is possible. 
 Double-clicking a piece (or clicking an already selected piece)
 will instruct that piece to make the only capture it can legally do. 
 Default: false. 
-
-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. 
-
-sweepPromotions true/false
Sets the ‘Almost Always Promote to Queen’ menu 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. 
+
-sweepPromotions true/false
Sets the ‘Almost Always Promote to 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
+
-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,
 Medium 64x64, Moderate 58x58, Average 54x54, Middling 49x49, Mediocre
 45x45, Small 40x40, Slim 37x37, Petite 33x33, Dinky 29x29, Teeny 25x25,
 or Tiny 21x21. 
-Orthodox pieces of all these sizes are built into XBoard. 
-Other sizes can
-be used if you have them; see the pixmapDirectory and bitmapDirectory
-options. 
-Complete sets of un-orthodox pieces are only provided in sizes
-Bulky, Middling and (to a lesser extent) Petite;
-Archbishop, Marshall and Amazon are also available in all sizes between
-Bulky and Petite. 
-When no bitmap is available, the piece will be displayed as Amazon or King. 
+Xboard installs with a set of scalable (svg) piece images,
+which it scales to any of the requested sizes. 
+The square size can further be continuously scaled by sizing the board window,
+but this only adapts the size of the pieces,
+and has no effect on the width of the grid lines or the font choice
+(both of which would depend on he selected boardSize). 
 The default depends on the size of your screen; it is approximately the
 largest size that will fit without clipping.
 
@@ -2226,16 +2324,16 @@ 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. 
-
-overrideLineGap n
When n >= 0, this forces the width of the black border between squares
+
-overrideLineGap n
When n >= 0, this forces the width of the black border between squares
 to n pixels for any board size. Mostly used to suppress the grid
 entirely by setting n = 0, e.g. in xiangqi or just getting a prettier
 picture. When n < 0 this the size-dependent width of the grid lines
 is used. Default: -1. 
-
-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
@@ -2243,28 +2341,28 @@ 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. 
-
-evalZoom factor
The score interval (-1,1) is blown up on the vertical axis of
+
-evalZoom factor
The score interval (-1,1) is blown up on the vertical axis of
 the Evaluation Graph by the given factor. 
 Default: 1
-
-evalThreshold n
Score below n (centiPawn) are plotted as 0 in the Evaluation Graph. 
+
-evalThreshold n
Score below n (centiPawn) are plotted as 0 in the Evaluation Graph. 
 Default: 25
-
-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. 
-
-showTargetSquares true/false
Determines whether XBoard can highlight the squares a piece has
+
-showTargetSquares true/false
Determines whether XBoard can highlight the squares a piece has
 legal moves to, when you grab that piece with the mouse. 
 Default: false. 
-
-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
@@ -2277,33 +2375,33 @@ 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. 
-
-highlightMoveWithArrow true/false
Sets the Highlight with Arrow menu option. See Options Menu. Default: false. 
-
-blind/-xblind or -blindfold true/false
Sets the Blindfold menu option.  See Options Menu.  Default: false. 
-
-periodic/-xperiodic or -periodicUpdates true/false
Controls updating of current move andnode counts in analysis mode. Default: true. 
-
-fSAN
-sSAN
Causes the PV in thinking output of the mentioned engine to be converted
+
-highlight/-xhighlight or -highlightLastMove true/false
Sets the Highlight Last Move menu option. See Options Menu. Default: false. 
+
-highlightMoveWithArrow true/false
Sets the Highlight with Arrow menu option. See Options Menu. Default: false. 
+
-blind/-xblind or -blindfold true/false
Sets the Blindfold menu option.  See Options Menu.  Default: false. 
+
-periodic/-xperiodic or -periodicUpdates true/false
Controls updating of current move andnode counts in analysis mode. Default: true. 
+
-fSAN
-sSAN
Causes the PV in thinking output of the mentioned engine to be converted
 to SAN before it is further processed. 
 Warning: this might lose engine output not understood by the parser,
 and uses a lot of CPU power. 
 Default: the PV is displayed exactly as the engine produced it. 
-
-showEvalInMoveHistory true/false
Controls whether the evaluation scores and search depth of engine moves
+
-showEvalInMoveHistory true/false
Controls whether the evaluation scores and search depth of engine moves
 are displayed with the move in the move-history window. 
 Default: true. 
-
-clockFont font
The font used for the clocks. If the option value is a pattern
+
-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–*-*-*-*-*-*-*-*. 
-
-messageFont font
The font used for popup dialogs, menus, comments, etc. 
+
-messageFont 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
@@ -2311,50 +2409,17 @@ 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
-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
-pieces give a better appearance on the screen: the white pieces have
-dark borders, and the black pieces have opaque internal details.  With
-bitmaps, neither piece color has a border, and the internal details
-are transparent; you see the square color or other background color
-through them.
-
-     
If XBoard is configured and compiled on a system that includes libXpm,
-the X pixmap library, the xpm pixmap pieces are compiled in as the
-default.  A different xpm piece set can be selected at runtime with
-the pixmapDirectory option, or a bitmap piece set can be selected
-with the bitmapDirectory option.
-
-     
If XBoard is configured and compiled on a system that does not include
-libXpm (or the --disable-xpm option is given to the configure
-program), the bitmap pieces are compiled in as the default.  It is not
-possible to use xpm pieces in this case, but pixmap pieces in another
-format called "xim" can be used by giving the pixmapDirectory option. 
-Or again, a different bitmap piece set can be selected with the
-bitmapDirectory option.
-
-     
Files in the bitmapDirectory must be named as follows:
-The first character of a piece bitmap name gives the piece it
-represents (‘p’, ‘n’, ‘b’, ‘r’, ‘q’, or ‘k’),
-the next characters give the size in pixels, the
-following character indicates whether the piece is
-solid or outline (‘s’ or ‘o’),
-and the extension is ‘.bm’. 
-For example, a solid 80x80 knight would be named n80s.bm. 
-The outline bitmaps are used only in monochrome mode. 
-If bitmap pieces are compiled in and the bitmapDirectory is missing
-some files, the compiled in pieces are used instead.
-
-     
If the bitmapDirectory option is given,
-it is also possible to replace xboard's icons and menu checkmark,
-by supplying files named icon_white.bm, icon_black.bm, and
-checkmark.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
-preoveHighlightColor color
-lowTimeWarningColor color
Colors to use for the pieces, squares, and square highlights. 
+
-pid or -pieceImageDirectory dir
This options control what piece images xboard uses. 
+XBoard will look in the specified directory for an image in png
+or svg format for every piece type, with names like BlackQueen.svg,
+WhiteKnight.svg etc. 
+When neither of these is found (or no valid directory is specified)
+XBoard will use the svg piece that was installed with it
+(from the source-tree directory ‘svg’). 
+Both svg and png images will be scaled by XBoard to the required size,
+but the png pieces lose much in quality when scaled too much.
+
+     
-whitePieceColor color
-blackPieceColor color
-lightSquareColor color
-darkSquareColor color
-highlightSquareColor color
-preoveHighlightColor color
-lowTimeWarningColor color
Colors to use for the pieces, squares, and square highlights. 
 Defaults:
 
      
          -whitePieceColor       #FFFFCC
@@ -2375,33 +2440,44 @@ Defaults:
           -premoveHighlightColor gray70
           -lowTimeWarningColor   gray70
 

-     
-useBoardTexture true/false
-liteBackTextureFile filename
-darkBackTextureFile filename
Indicate the pixmap files to be used for drawing the board squares,
+     
The PieceColor options only work properly if the image files
+defining the pieces were pure black & white
+(possibly anti-aliased to produce gray scales
+and semi-transparancy),
+like the pieces images that come with the install. 
+Their effect on colored pieces is undefined. 
+The SquareColor option only have an effect
+when no board textures are used. 
+
-trueColors true/false
When set, this option suppresses the effect  of the
+PieceColor options mentioned above. 
+This is recommended for images that are already colored. 
+
-useBoardTexture true/false
-liteBackTextureFile filename
-darkBackTextureFile filename
Indicate the png image files to be used for drawing the board squares,
 and if they should be used rather than using simple colors. 
 The algorithm for cutting squares out of a given bitmap is such that
 the picture is perfectly reproduced when a bitmap the size of
 the complete board is given. 
 Default: false and ""
-
-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. 
-
-autoDisplayComment true/false
-autoDisplayTags true/false
If set to true, these options cause the window with the move comments,
+
-autoDisplayComment true/false
-autoDisplayTags true/false
If set to true, these options cause the window with the move comments,
 and the window with PGN tags, respectively, to pop up automatically when
 such tags or comments are encountered during the replaying a stored or
 loaded game.  Default: true. 
-
-pasteSelection true/false
If this option is set to true, the Paste Position and Paste Game
+
-pasteSelection true/false
If this option is set to true, the Paste Position and Paste Game
 options paste from the currently selected text.  If false, they paste
 from the clipboard.  Default: false. 
-
-autoCopyPV true|false
When this option is set, the position displayed on the board when
+
-autoCopyPV true|false
When this option is set, the position displayed on the board when
 you terminate a PV walk
 (initiated by a right-click on board or engine-output window)
 will be automatically put on the clipboard as FEN. 
 Default: false. 
-
-dropMenu true|false
This option allows you to emulate old behavior,
+
-dropMenu true|false
This option allows you to emulate old behavior,
 where the right mouse button brings up the (now deprecated) drop menu
 rather than displaying the position at the end of the principal variation. 
 Default: False. 
-
-pieceMenu true|false
This option allows you to emulate old behavior,
+
-pieceMenu true|false
This option allows you to emulate old behavior,
 where the right mouse button brings up the (now deprecated) piece menu
 in Edit Position mode. 
 From this menu you can select the piece to put on the square you
@@ -2410,15 +2486,19 @@ or select items such as clear board.
 You can also promote or demote a clicked piece to convert
 it into an unorthodox piece that is not directly in the menu,
 or give the move to black or white. 
-
-variations true|false
When this option is on, you can start new variations in Edit Game or
+
-variations true|false
When this option is on, you can start new variations in Edit Game or
 Analyze mode by holding the Shift key down while entering a move. 
 When it is off, the Shift key will be ignored. 
 Default: False. 
-
-absoluteAnalysisScores true|false
When true, scores on the Engine Output window during analysis
+
-appendPV true|false
When this option is on, right-clicking a PV in the Engine Output window
+will play the first move of that PV in Analyze mode,
+or as many moves as you walk through by moving the mouse. 
+Default: False. 
+
-absoluteAnalysisScores true|false
When true, scores on the Engine Output window during analysis
 will be printed from the white point-of-view, rather than the
 side-to-move point-of-view. 
 Default: False. 
-
-scoreWhite true|false
When true, scores will always be printed from the white point-of-view,
+
-scoreWhite true|false
When true, scores will always be printed from the white point-of-view,
 rather than the side-to-move point-of-view. 
 Default: False. 
 

@@ -2434,35 +2514,35 @@ Up: Options
 
 
4.7 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 adjudication)
-
-adjudicateDrawMoves n
If the given value is non-zero, XBoard adjudicates the game as a draw
+
-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,
+
-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
@@ -2482,18 +2562,40 @@ Up: Options
 
 
4.8 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
+
-viewer
-viewerOptions string
Presence of the volatile option viewer on the command line
+will cause the value of the persistent option viewerOptions
+as stored in the settings file to be appended to the command line. 
+The view option will be used by desktop associations with
+game or position file types, so that viewerOptions can be
+used to configure the exact mode XBoard will start in when it
+should act on such a file (e.g. in -ncp mode, or analyzing
+with your favorite engine). The options are also automatically
+appended when Board is invoked with a single argument not being
+an option name, which is then assumed to be the name of a
+loadGameFile or (when the name ends in .fen) a
+loadPositionFile. 
+Default: "-ncp -engineOutputUp false -saveSettingsOnExit false". 
+
-tourneyOptions string
When XBoard is invoked with a single argument that is a file
+with .trn extension, it will assume this argument to be the value
+of a tourneyFile option,
+and apped the value of the persistent option tourneyOptions
+as stored in the settings file to the command line. 
+Thus the value of tourneyOptions can be
+used to configure XBoard to automatically start running a
+tournament when it should act on such a file. 
+Default: "-ncp -mm -saveSettingsOnExit false". 
+
-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:
 
@@ -2550,25 +2652,25 @@ Berolina and cylinder chess can only be played with legality testing off.
 In crazyhouse, XBoard now does keep
 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
-
-pieceToCharTable string
The characters that are used to represent the piece types XBoard knows in FEN
+
-pieceToCharTable 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. 
@@ -2588,26 +2690,26 @@ 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: ""
-
-pieceNickNames string
The characters in the string are interpreted the same way as in the
+
-pieceNickNames string
The characters in the string are interpreted the same way as in the
 pieceToCharTable option. But on input, piece-ID letters are
 first looked up in the nicknames, and only if not defined there,
 in the normal pieceToCharTable. This allows you to have two letters
 designate the same piece, (e.g. N as an alternative to H for Horse
 in Xiangqi), to make reading of non-compliant notations easier. 
 Default: ""
-
-colorNickNames string
The side-to-move field in a FEN will be first matched against the letters
+
-colorNickNames string
The side-to-move field in a FEN will be first matched against the letters
 in the string (first character for white, second for black),
 before it is matched to the regular 'w' and 'b'. 
 This makes it easier to read non-compliant FENs,
 which, say, use 'r' for white. 
 Default: ""
-
-debug/-xdebug or -debugMode true/false
Turns on debugging printout. 
-
-debugFile filename or -nameOfDebugFile filename
Sets the name of the file to which XBoard 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 XBoard saves debug information
 (including all communication to and from the engines). 
 A %d in the given file name (e.g. game%d.debug) will be replaced
 by the unique sequence number of a tournament game,
 so that the debug output of each game will be written on a separate file. 
-
-engineDebugOutput number
Specifies how XBoard should handle unsolicited output from the engine,
+
-engineDebugOutput number
Specifies how XBoard 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, XBoard refrains from writing such spurious output to the debug file. 
@@ -2617,20 +2719,20 @@ as the engine itself should have done if it wanted to submit info for inclusion
 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 XBoard 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. 
-
-searchMode n
The integer n encodes the mode for the ‘find position’ function. 
+
-delayBeforeQuit number
-delayAfterQuit number
These options specify how long XBoard 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. 
+
-searchMode n
The integer n encodes the mode for the ‘find position’ function. 
 Default: 1 (= Exact position match)
-
-eloThresholdBoth elo
-eloThresholdAny elo
Defines a lower limit for the Elo rating, which has to be surpassed
+
-eloThresholdBoth elo
-eloThresholdAny elo
Defines a lower limit for the Elo rating, which has to be surpassed
 before a game will be considered when searching for a board position. 
 Default: 0
-
-dateThreshold year
Only games not played before the given year will be considered when
+
-dateThreshold year
Only games not played before the given year will be considered when
 searching for a board position
 
    

@@ -2646,7 +2748,7 @@ Up: Top
 
 
5 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
@@ -2679,25 +2781,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.
 
@@ -2705,7 +2807,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
@@ -2713,11 +2815,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
@@ -2752,11 +2854,6 @@ command-line options as follows:
 
 
     xboard -ics -icshost firewall.example.com -icsport 23
 

-   
Or in your .Xresources file:
-
-
     XBoard*internetChessServerHost: firewall.example.com
-     XBoard*internetChessServerPort: 23
-

    
Then when you run XBoard in ICS mode, you will be prompted
 to log in to the firewall host. This works because port 23 is the
 standard telnet login service. Do so, then telnet to ICS, using a
@@ -2785,12 +2882,7 @@ command-line options as follows:
 
 
     xboard -ics -gateway rsh.example.com -icshost chessclub.com
 

-   
Or in your .Xresources file:
-
-
     XBoard*gateway: rsh.example.com
-     XBoard*internetChessServerHost: chessclub.com
-

-   
Then when you run XBoard in ICS mode, it will connect to
+   
Then when you run XBoard in ICS mode, it will connect to
 the ICS by using rsh to run the command
 ‘telnet chessclub.com 5000’ on host ‘rsh.example.com’.
 
@@ -2803,11 +2895,6 @@ In this case set command line options as follows:
 
 
     xboard -ics -telnet -telnetProgram ptelnet
 

-   
Or in your .Xresources file:
-
-
     XBoard*useTelnet: true
-     XBoard*telnetProgram: ptelnet
-

    
Then when you run XBoard in ICS mode, it will issue the
 command ‘ptelnet chessclub.com 5000’ to connect to the ICS.
 
@@ -2815,8 +2902,7 @@ command ‘ptelnet chessclub.com 5000
 that is, your ptelnet program doesn't let you connect to
 alternative ports. As noted above, your chess server may allow you to
 connect on port 23 instead.  In that case, just add the option
-‘-icsport ""’ to the above command, or add
-‘XBoard*internetChessServerPort:’ to your .Xresources file. 
+‘-icsport ""’ to the above command. 
 But if your chess server doesn't let you connect on port 23, you will have
 to find some other host outside the firewall and hop through it. For
 instance, suppose you have a shell account at ‘foo.edu’. Set
@@ -2824,13 +2910,6 @@ command line options as follows:
 
 
     xboard -ics -telnet -telnetProgram ptelnet -icshost foo.edu -icsport ""
 

-   
Or in your .Xresources file:
-
-
     XBoard*useTelnet: true
-     XBoard*telnetProgram: ptelnet
-     XBoard*internetChessServerHost: foo.edu
-     XBoard*internetChessServerPort:
-

    
Then when you run XBoard in ICS mode, it will issue the
 command ‘ptelnet foo.edu’ to connect to your account at
 ‘foo.edu’. Log in there, then type ‘telnet chessclub.com 5000’.
@@ -2867,7 +2946,7 @@ Up: Top
 
 
7 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
@@ -2885,7 +2964,7 @@ Up: Top
 
 
8 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.
@@ -2946,7 +3025,7 @@ Up: Top
 
 
9 Reporting problems

 
-

+

 You can report bugs and problems with XBoard using
 the bug tracker at https://savannah.gnu.org/projects/xboard/
 or by sending mail to <bug-xboard@gnu.org>.  It can also
@@ -2975,7 +3054,7 @@ Up: Top
 
 
10 Authors and contributors

 
-

+

 Chris Sears and Dan Sears wrote the original XBoard.  They were
 responsible for versions 1.0 through 1.2.  The color scheme was taken
 from Wayne Christopher's XChess program.
@@ -3036,7 +3115,7 @@ Up: Top
 
 
11 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.
@@ -3246,7 +3325,7 @@ Up: Top
 
 
12 Other programs you can use with XBoard

 
-

+

 Here are some other programs you can use with XBoard
 
 
    
@@ -3375,10 +3454,6 @@ FRITZ4 set. These files are named “fritz4.*” in the ZIICS distributi
      
    3. Give XBoard the “-pixmap” option when starting up, e.g.:
    
      
              xboard -pixmap ~/fritz4
 
    
-     
    Alternatively, you can add this line to your .Xresources file:
-
-     
              xboard*pixmapDirectory: ~/fritz4
-
    
      

 
    
(*) ZIICS is a separate copyrighted work of Andy McFarland. 
@@ -3419,7 +3494,7 @@ arising out of or in connection with the use or performance of this
 software.
 
    
Enhancements copyright © 1992-2003, 2004, 2005, 2006, 2007,
-2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc.
+2008, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc.
 
 
Published by the Free Software Foundation
 59 Temple Place - Suite 330
@@ -4161,580 +4236,599 @@ Up: Top
 
Index

 
 
 

 
Table of Contents

diff --git a/manual/xboard.html.gz b/manual/xboard.html.gz
index e1b2b6c..da9421c 100644
Binary files a/manual/xboard.html.gz and b/manual/xboard.html.gz differ
diff --git a/manual/xboard.html_node.tar.gz b/manual/xboard.html_node.tar.gz
index 3166065..2b8ef92 100644
Binary files a/manual/xboard.html_node.tar.gz and b/manual/xboard.html_node.tar.gz differ
diff --git a/manual/xboard.info.tar.gz b/manual/xboard.info.tar.gz
index fe87001..9c29a04 100644
Binary files a/manual/xboard.info.tar.gz and b/manual/xboard.info.tar.gz differ
diff --git a/manual/xboard.pdf b/manual/xboard.pdf
index adedc8e..02746ac 100644
Binary files a/manual/xboard.pdf and b/manual/xboard.pdf differ
diff --git a/manual/xboard.ps.gz b/manual/xboard.ps.gz
index 41109b3..f38d6a3 100644
Binary files a/manual/xboard.ps.gz and b/manual/xboard.ps.gz differ
diff --git a/manual/xboard.texi.tar.gz b/manual/xboard.texi.tar.gz
index 8ab7ce5..df98b4c 100644
Binary files a/manual/xboard.texi.tar.gz and b/manual/xboard.texi.tar.gz differ
diff --git a/manual/xboard.txt b/manual/xboard.txt
index d20169f..fb74550 100644
--- a/manual/xboard.txt
+++ b/manual/xboard.txt
@@ -11,7 +11,7 @@ chess engines (such as GNU Chess), the Internet Chess Servers,
 electronic mail correspondence chess, or your own collection of saved
 games.
 
-   This manual documents version 4.6.0 of XBoard.
+   This manual documents version 4.7.0 of XBoard.
 
 1 Major modes
 *************
@@ -79,6 +79,13 @@ point, like you entered all previous PV moves.  As the display of the
 PV in that case starts after the first move a simple right-click will
 play the move the engine indicates.
 
+   In Analysis mode you can also make a move by grabbing the piece with
+a double-click of the left mouse button (or while keeping the Ctrl key
+pressed).  In this case the move you enter will not be played, but will
+be excluded from the analysis of the current position.  (Or included if
+it was already excluded; it is a toggle.)  This only works for engines
+that support this feature.
+
    When connected to an ICS, it is possible to call up a graphical
 representation of players seeking a game in stead of the chess board,
 when the latter is not in use (i.e. when you are not playing or
@@ -234,6 +241,17 @@ Save Position
      human-readable format that is specific to XBoard. Both formats can
      be read back by the `Load Position' command.
 
+Save Games as Book
+     Creates an opening book from the currently loaded game file.  The
+     book will be saved on the file specified in the `Common Engine'
+     options dialog.  The value of `Book Depth' specified in that same
+     dialog will be used to determine how many moves of each game will
+     be added to the internal book buffer.  This command can take a
+     long time to process, and the size of the buffer is currently
+     limited.  At the end the buffer will be saved as a Polyglot book,
+     but the buffer will ot be cleared, so that you can continue adding
+     games from other game files.
+
 Mail Move
 Reload CMail Message
      See *note CMail::.
@@ -347,8 +365,10 @@ Edit Tags
 
 Edit Comment
      Adds or modifies a comment on the current position. Comments are
-     saved by `Save Game' and are displayed by `Load Game', `Forward',
-     and `Backward'.
+     saved by `Save Game' and are displayed by `Load Game', PGN
+     variations will also be printed in this window, and can be
+     promoted to main line by right-clicking them.  `Forward', and
+     `Backward'.
 
 Edit Book
      Pops up a window listing the moves available in the GUI book
@@ -470,7 +490,16 @@ Show Engine Output
      convenient for someone analyzing games to see the moves sorted by
      score.  The order in which the engine found them is only of
      interest to the engine author, and can still be deduced from the
-     time or node count printed with the line.
+     time or node count printed with the line.  Right-clicking a line
+     in this window, and then moving the mouse vertically with the
+     right button kept down, will make XBoard play through the PV
+     listed there.  The use of the board window as 'variation board'
+     will normally end when you release the right button, or when the
+     opponent plays a move.  But beware: in Analysis mode, moves thus
+     played out will be added to the game.  The Engine-Output pane for
+     each engine will contain a header displaying the multi-PV status
+     and a list of excluded moves in Analysis mode, which are also
+     responsive to right-clicking.
 
 Show Move History
      Shows or hides a list of moves of the current game.  The shifted
@@ -505,14 +534,26 @@ ICS Input Box
      editing on your input, because output from ICS doesn't get mixed
      in with your typing as it would in the main terminal window.
 
+Open Chat Window
+     This menu item opens a window in which you can conduct upto 5 chats
+     with other ICS users (or channels).  To use the window, write the
+     name of your chat partner, the channel number, or the words
+     'shouts', 'whispers', 'cshouts' in the upper field (closing with
+     ).  Everything you type in the lowest field will then
+     automatically be sent to the mentioned party, while everything
+     that party sends to you will appear in the central text box,
+     rather than appear in the ICS console.  The row of buttons allow
+     you to choose between chat; to start a new chat, just select an
+     empty button, and complete the `Chat partner' field.
+
 Board
-     Summons a dialog where you can customaize the look of the chess
+     Summons a dialog where you can customize the look of the chess
      board.  Here you can specify the directory from which piece images
      should be taken, when you don't want to use the built-in piece
-     images (see `pixmapDirectory' and `bitmapDirectory' options), an
-     external pixmap to be used for the board squares
-     (`liteBackTextureFile' and `darkBackTextureFile' options), and
-     square and piece colors for the built-ins.
+     images (see `pieceImageDirectory' option), external images to be
+     used for the board squares (`liteBackTextureFile' and
+     `darkBackTextureFile' options), and square and piece colors for
+     the default pieces.
 
 Game List Tags
      a duplicate of the Game List dialog in the Options menu.
@@ -556,9 +597,29 @@ Analysis Mode
      back.  Note that you can also click on the clocks to set the
      opposite side to move (adding a so-called `null move' to the game).
 
-     The analysis function can also be used when observing games on an
-     ICS with an engine loaded (zippy mode); the engine then will
-     analyse the positions as they occur in the observed game.
+     You can also tell the engine to exclude some moves from analysis.
+     (Engines that do not support the exclude-moves feature will ignore
+     this, however.)  The general way to do this is to play the move
+     you want to exclude starting with a double click on the piece.
+     When you use drag-drop moving, the piece you grab with a double
+     click will also remain on its square, to show you that you are not
+     really making the move, but just forbid it from the current
+     position.  Playing a thus excluded move a second time will include
+     it again.  Excluded moves will be listed as text in a header line
+     in the Engine Output window, and you can also re-include them by
+     right-clicking them there.  This header line will also contain the
+     words 'best' and 'tail'; right-clicking those will exclude the
+     currently best move, or all moves not explicitly listed in the
+     header line.  Once you leave the current position all memory of
+     excluded moves will be lost when you return there.
+
+     Selecting this menu item while already in `Analysis Mode' will
+     toggle the participation of the second engine in the analysis.
+     The output of this engine will then be shown in the lower pane of
+     the Engine Output window.  The analysis function can also be used
+     when observing games on an ICS with an engine loaded (zippy mode);
+     the engine then will analyse the positions as they occur in the
+     observed game.
 
 Analyze Game
      This option subjects the currently loaded game to automatic
@@ -567,10 +628,18 @@ Analyze Game
      currently displayed position, while the engine is analyzing the
      current position.  The game will be annotated with the results of
      these analyses.  In particlar, the score and depth will be added
-     as a comment, and the PV will be added as a variation.  The time
-     the engine spends on analyzing each move can be controlled through
-     the command-line option `-timeDelay'.  Note: Some chess engines do
-     not support Analysis mode.
+     as a comment, and the PV will be added as a variation.
+
+     Normally the analysis would stop after reaching the end of the
+     game.  But when a game is loaded from a multi-game file while
+     `Analyze Game' was already switched on, the analysis will continue
+     with the next game in the file until the end of the file is
+     reached (or you switch to another mode).
+
+     The time the engine spends on analyzing each move can be controlled
+     through the command-line option `-timeDelay', which can also be
+     set from the `Load Game Options' menu dialog.  Note: Some chess
+     engines do not support Analysis mode.
 
 Edit Game
      Duplicate of the item in the Edit menu.  Note that `Edit Game' is
@@ -873,6 +942,13 @@ Drop Menu
      deprecated behavior) or allow you to step through an engine PV
      (new, recommended behavior).
 
+Enable Variation Trees
+     If this option is on, playing a move in Edit Game or Analyze mode
+     while keeping the Shift key pressed will start a new variation.
+     You can then recall the previous line through the `Revert' menu
+     item.  When off, playing a move will truncate the game and append
+     the move irreversibly.
+
 Hide Thinking
      If this option is off, the chess engine's notion of the score and
      best line of play from the current position is displayed as it is
@@ -921,6 +997,14 @@ Periodic Updates
      be updated when the analysis changes. If this option is on, the
      Analysis Window will be updated every two seconds.
 
+Play Move(s) of Clicked PV
+     If this option is on, right-clicking a PV in the Engine Output
+     window during Analyze mode will cause the first move of that PV to
+     be played.  You could also play more than one (or no) PV move by
+     moving the mouse to engage in the PV walk such a right-click will
+     start, to seek out another position along the PV where you want to
+     continue the analysis, before releasing the mouse button.
+
 Ponder Next Move
      If this option is off, the chess engine will think only when it is
      on move.  If the option is on, the engine will also think while
@@ -1318,7 +1402,10 @@ Search mode
      material that must be present in the four lowest ranks of the
      board, and optional additional material in the four highest ranks
      of the board.  You can request the optional material to be
-     balanced.
+     balanced.  The `narrow' button is similar in fuction to the `find
+     position' button, but only searches in the already selected games,
+     rather than the complete game file, and can thus be used to refine
+     a search based on multiple criteria.
 
 number of consecutive positions
      When you are searching by material, rather than for an exact match,
@@ -1336,18 +1423,19 @@ Also match left-right flipped position
 
 Save Game Options
      Summons a dialog where you can specify the files on which XBoard
-     should automtically save any played or entered games, (the
+     should automatically save any played or entered games, (the
      `saveGameFile' option), or the final position of such games (the
      `savePositionfile' option).  You can also select 'auto-save'
      without a file name, in which case XBoard will prompt the user for
-     a file name after each game.  You can also set the default value
-     for the PGN Event tag that will be used for each new game you
-     start.  Various options for the format of the game can be
-     specified as well, such as whether scores and depths of engine
-     games should be saved as comments, and if a tag with info about
-     the score with which the engine came out of book should be
-     included.  For Chess, always set the format to PGN, rather than
-     "old save stye"!
+     a file name after each game.  In ICS mode you can limit the
+     auto-saving to your own games (i.e. suppress saving of observed
+     games).  You can also set the default value for the PGN Event tag
+     that will be used for each new game you start.  Various options
+     for the format of the game can be specified as well, such as
+     whether scores and depths of engine games should be saved as
+     comments, and if a tag with info about the score with which the
+     engine came out of book should be included.  For Chess, always set
+     the format to PGN, rather than "old save stye"!
 
 Game List
      Pops up a dialog where you can select the PGN tags that should
@@ -1385,6 +1473,25 @@ Save Settings Now
      text editor, but they would disappear from the file as soon as you
      save the settings.
 
+     Note that XBoard no longer pays attention to options values
+     specified in the .Xresources file.  (Specifying key bindings there
+     will still work, though.)  To alter the default of volatile
+     options, you can use the following method: Rename your ~/.xboardrc
+     settings file (to ~/.yboardrc, say), and create a new file
+     ~/.xboardrc, which only contains the options
+
+          -settingsFile  ~/.yboardrc
+          -saveSettingsFile  ~/.yboardrc
+
+     This will cause your settings to be saved on ~/.yboardrc in the
+     future, so that ~/.xboardrc is no longer overwritten.  You can
+     then safely specify volatile options in ~/.xboardrc, either before
+     or after the settingsFile options.  Note that when you specify
+     persistent options after the settingsFile options in ~/.xboardrc,
+     you will essentially turn them into volatile options with the
+     specified value as default, because that value will overrule the
+     value loaded from the settings file (being read later).
+
 Save Settings on Exit
      Setting this option has no immediate effect, but causes the
      settings to be saved when you quit XBoard. What happens then is
@@ -1615,6 +1722,17 @@ names interchangeably.
      Name of second chess engine, if needed.  A second chess engine is
      started only in Two Machines (match) mode.  Default: `Fairy-Max'.
 
+-fe or -firstEngine nickname
+     This is an alternative to the `fcp' option for specifying the
+     first engine, for engines that were already configured (using the
+     `Load Engine' dialog) in XBoard's settings file.  It will not only
+     retrieve the real name of the engine, but also all options
+     configured with it.  (E.g. if it is UCI, whether it should use
+     book.)
+
+-se or -secondEngine nickname
+     As `fe', but for the second engine.
+
 -fb/-xfb or -firstPlaysBlack true/false
      In games between two chess engines, firstChessProgram normally
      plays white.  If this option is true, firstChessProgram plays
@@ -1648,9 +1766,8 @@ names interchangeably.
      Setting this option from the command line is tricky, because you
      must type in real newline characters, including one at the very
      end.  In most shells you can do this by entering a `\' character
-     followed by a newline. It is easier to set the option from your
-     `.Xresources' file; in that case you can include the character
-     sequence `\n' in the string, and it will be converted to a newline.
+     followed by a newline.  Using the character sequence `\n' in the
+     string should work too, though.
 
      If you change this option, don't remove the `new' command; it is
      required by all chess engines to start a new game.
@@ -1808,6 +1925,20 @@ names interchangeably.
      A value n from 0 to 100 tunes the choice of moves from the GUI
      books from totally random to best-only. Default: 50
 
+-mcBookMode
+     When this volatile option is specified, the probing algorithm of
+     the GUI book is altered to always select the move that is most
+     under-represented based on its performance.  When all moves are
+     played in approximately the right proportion, a book miss will be
+     reported, to give the engine opportunity to explore a new move.
+     In addition score of the moves will be kept track of during the
+     session in a book buffer.  By playing an match in this mode, a
+     book will be built from scratch.  The only output are the saved
+     games, which can be converted to an actual book later, with the
+     `Save Games as Book' command.  This command can also be used to
+     pre-fill the book buffer before adding new games based on the
+     probing algorithm.
+
 -fn string or -firstPgnName string
 -sn string or -secondPgnName string
      Indicates the name that should be used for the engine in PGN tags
@@ -2183,23 +2314,6 @@ lowTimeWarning true/false
      your xterm.  Bold can be 1 or 0.  If background is omitted,
      "default" is assumed; if bold is omitted, 0 is assumed.
 
-     Here is an example of how to set the colors in your `.Xresources'
-     file.  The colors shown here are the default values; you will get
-     them if you turn `-colorize' on without specifying your own colors.
-     CShout is synonymous with SShout.
-
-          xboard*colorizeMessages: true
-          xboard*colorShout: green
-          xboard*colorSShout: green, black, 1
-          xboard*colorChannel1: cyan
-          xboard*colorChannel: cyan, black, 1
-          xboard*colorKibitz: magenta, black, 1
-          xboard*colorTell: yellow, black, 1
-          xboard*colorChallenge: red, black, 1
-          xboard*colorRequest: red
-          xboard*colorSeek: blue
-          xboard*colorNormal: default
-
 -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
@@ -2251,25 +2365,6 @@ lowTimeWarning true/false
      in is aborted, adjourned, or otherwise ends inconclusively.
      Default: "" (no sound).
 
-     Here is an example of how to set the sounds in your `.Xresources'
-     file:
-
-          xboard*soundShout: shout.wav
-          xboard*soundSShout: sshout.wav
-          xboard*soundChannel1: channel1.wav
-          xboard*soundChannel: channel.wav
-          xboard*soundKibitz: kibitz.wav
-          xboard*soundTell: tell.wav
-          xboard*soundChallenge: challenge.wav
-          xboard*soundRequest: request.wav
-          xboard*soundSeek: seek.wav
-          xboard*soundMove: move.wav
-          xboard*soundIcsWin: win.wav
-          xboard*soundIcsLoss: lose.wav
-          xboard*soundIcsDraw: draw.wav
-          xboard*soundIcsUnfinished: unfinished.wav
-          xboard*soundIcsAlarm: alarm.wav
-
 4.5 Load and Save options
 =========================
 
@@ -2315,6 +2410,9 @@ lowTimeWarning true/false
      Sets the Auto Save menu option.  *Note Options Menu::.  Default:
      false.  Ignored if `saveGameFile' is set.
 
+-onlyOwnGames true/false
+     Suppresses auto-saving of ICS observed games. Default: false.
+
 -lpf or -loadPositionFile file
 -lpi or -loadPositionIndex index
      If the `loadPositionFile' option is set, XBoard loads the
@@ -2406,6 +2504,24 @@ lowTimeWarning true/false
      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.
 
+-logoSize N
+     This option controls the drawing of player logos next to the
+     clocks.  The integer N specifies the width of the logo in pixels;
+     the logo height will always be half the width.  When N = 0, no
+     logos will be diplayed.  Default: 0.
+
+-firstLogo imagefile
+-secondLogo imagefile
+     Specify the images to be used as player logos when `logoSize' is
+     non-zero, next to the white and black clocks, respectively.
+
+-autoLogo true/false
+
+-logoDir filename
+     When `autoLogo' is set, XBoard will search for a PNG image file
+     with the name of the engine or ICS in the directory specified by
+     `logoDir'.
+
 -recentEngines number
 -recentEngineList list
      When the number is larger than zero, it determines how many
@@ -2456,16 +2572,14 @@ lowTimeWarning true/false
      116x116, Giant 108x108, Huge 95x95, Big 87x87, Large 80x80, Bulky
      72x72, Medium 64x64, Moderate 58x58, Average 54x54, Middling
      49x49, Mediocre 45x45, Small 40x40, Slim 37x37, Petite 33x33,
-     Dinky 29x29, Teeny 25x25, or Tiny 21x21.  Orthodox pieces of all
-     these sizes are built into XBoard.  Other sizes can be used if you
-     have them; see the pixmapDirectory and bitmapDirectory options.
-     Complete sets of un-orthodox pieces are only provided in sizes
-     Bulky, Middling and (to a lesser extent) Petite; Archbishop,
-     Marshall and Amazon are also available in all sizes between Bulky
-     and Petite.  When no bitmap is available, the piece will be
-     displayed as Amazon or King.  The default depends on the size of
-     your screen; it is approximately the largest size that will fit
-     without clipping.
+     Dinky 29x29, Teeny 25x25, or Tiny 21x21.  Xboard installs with a
+     set of scalable (svg) piece images, which it scales to any of the
+     requested sizes.  The square size can further be continuously
+     scaled by sizing the board window, but this only adapts the size
+     of the pieces, and has no effect on the width of the grid lines or
+     the font choice (both of which would depend on he selected
+     boardSize).  The default depends on the size of your screen; it is
+     approximately the largest size that will fit without clipping.
 
      You can select other sizes or vary other layout parameters by
      providing a list of comma-separated values (with no spaces) as the
@@ -2613,48 +2727,15 @@ lowTimeWarning true/false
      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
-     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 pieces give a better
-     appearance on the screen: the white pieces have dark borders, and
-     the black pieces have opaque internal details.  With bitmaps,
-     neither piece color has a border, and the internal details are
-     transparent; you see the square color or other background color
-     through them.
-
-     If XBoard is configured and compiled on a system that includes
-     libXpm, the X pixmap library, the xpm pixmap pieces are compiled
-     in as the default.  A different xpm piece set can be selected at
-     runtime with the `pixmapDirectory' option, or a bitmap piece set
-     can be selected with the `bitmapDirectory' option.
-
-     If XBoard is configured and compiled on a system that does not
-     include libXpm (or the `--disable-xpm' option is given to the
-     configure program), the bitmap pieces are compiled in as the
-     default.  It is not possible to use xpm pieces in this case, but
-     pixmap pieces in another format called "xim" can be used by giving
-     the `pixmapDirectory' option.  Or again, a different bitmap piece
-     set can be selected with the `bitmapDirectory' option.
-
-     Files in the `bitmapDirectory' must be named as follows: The first
-     character of a piece bitmap name gives the piece it represents
-     (`p', `n', `b', `r', `q', or `k'), the next characters give the
-     size in pixels, the following character indicates whether the
-     piece is solid or outline (`s' or `o'), and the extension is `.bm'.
-     For example, a solid 80x80 knight would be named `n80s.bm'.  The
-     outline bitmaps are used only in monochrome mode.  If bitmap
-     pieces are compiled in and the bitmapDirectory is missing some
-     files, the compiled in pieces are used instead.
-
-     If the bitmapDirectory option is given, it is also possible to
-     replace xboard's icons and menu checkmark, by supplying files
-     named `icon_white.bm', `icon_black.bm', and `checkmark.bm'.
-
-     For more information about pixmap pieces and how to get additional
-     sets, see *note zic2xpm:: below.
+-pid or -pieceImageDirectory dir
+     This options control what piece images xboard uses.  XBoard will
+     look in the specified directory for an image in png or svg format
+     for every piece type, with names like BlackQueen.svg,
+     WhiteKnight.svg etc.  When neither of these is found (or no valid
+     directory is specified) XBoard will use the svg piece that was
+     installed with it (from the source-tree directory `svg').  Both
+     svg and png images will be scaled by XBoard to the required size,
+     but the png pieces lose much in quality when scaled too much.
 
 -whitePieceColor color
 -blackPieceColor color
@@ -2684,14 +2765,26 @@ lowTimeWarning true/false
           -premoveHighlightColor gray70
           -lowTimeWarningColor   gray70
 
+     The PieceColor options only work properly if the image files
+     defining the pieces were pure black & white (possibly anti-aliased
+     to produce gray scales and semi-transparancy), like the pieces
+     images that come with the install.  Their effect on colored pieces
+     is undefined.  The SquareColor option only have an effect when no
+     board textures are used.
+
+-trueColors true/false
+     When set, this option suppresses the effect  of the PieceColor
+     options mentioned above.  This is recommended for images that are
+     already colored.
+
 -useBoardTexture true/false
 -liteBackTextureFile filename
 -darkBackTextureFile filename
-     Indicate the pixmap files to be used for drawing the board squares,
-     and if they should be used rather than using simple colors.  The
-     algorithm for cutting squares out of a given bitmap is such that
-     the picture is perfectly reproduced when a bitmap the size of the
-     complete board is given.  Default: false and ""
+     Indicate the png image files to be used for drawing the board
+     squares, and if they should be used rather than using simple
+     colors.  The algorithm for cutting squares out of a given bitmap
+     is such that the picture is perfectly reproduced when a bitmap the
+     size of the complete board is given.  Default: false and ""
 
 -drag/-xdrag or -animateDragging true/false
      Sets the Animate Dragging menu option. *Note Options Menu::.
@@ -2744,6 +2837,12 @@ lowTimeWarning true/false
      move.  When it is off, the Shift key will be ignored.  Default:
      False.
 
+-appendPV true|false
+     When this option is on, right-clicking a PV in the Engine Output
+     window will play the first move of that PV in Analyze mode, or as
+     many moves as you walk through by moving the mouse.  Default:
+     False.
+
 -absoluteAnalysisScores true|false
      When true, scores on the Engine Output window during analysis will
      be printed from the white point-of-view, rather than the
@@ -2822,6 +2921,30 @@ lowTimeWarning true/false
      does not start a chess engine at all. Turning on this option also
      turns off clockMode. Default: false.
 
+-viewer
+-viewerOptions string
+     Presence of the volatile option `viewer' on the command line will
+     cause the value of the persistent option `viewerOptions' as stored
+     in the settings file to be appended to the command line.  The
+     `view' option will be used by desktop associations with game or
+     position file types, so that `viewerOptions' can be used to
+     configure the exact mode XBoard will start in when it should act
+     on such a file (e.g. in -ncp mode, or analyzing with your favorite
+     engine). The options are also automatically appended when Board is
+     invoked with a single argument not being an option name, which is
+     then assumed to be the name of a `loadGameFile' or (when the name
+     ends in .fen) a `loadPositionFile'.  Default: "-ncp
+     -engineOutputUp false -saveSettingsOnExit false".
+
+-tourneyOptions string
+     When XBoard is invoked with a single argument that is a file with
+     .trn extension, it will assume this argument to be the value of a
+     `tourneyFile' option, and apped the value of the persistent option
+     `tourneyOptions' as stored in the settings file to the command
+     line.  Thus the value of `tourneyOptions' can be used to configure
+     XBoard to automatically start running a tournament when it should
+     act on such a file.  Default: "-ncp -mm -saveSettingsOnExit false".
+
 -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
@@ -3132,10 +3255,6 @@ the firewall is called `firewall.example.com'. Set command-line options
 as follows:
 
      xboard -ics -icshost firewall.example.com -icsport 23
-   Or in your `.Xresources' file:
-
-     XBoard*internetChessServerHost: firewall.example.com
-     XBoard*internetChessServerPort: 23
    Then when you run XBoard in ICS mode, you will be prompted to log in
 to the firewall host. This works because port 23 is the standard telnet
 login service. Do so, then telnet to ICS, using a command like `telnet
@@ -3163,12 +3282,7 @@ options as follows:
 
      xboard -ics -gateway rsh.example.com -icshost chessclub.com
 
-Or in your `.Xresources' file:
-
-     XBoard*gateway: rsh.example.com
-     XBoard*internetChessServerHost: chessclub.com
-
-   Then when you run XBoard in ICS mode, it will connect to the ICS by
+Then when you run XBoard in ICS mode, it will connect to the ICS by
 using `rsh' to run the command `telnet chessclub.com 5000' on host
 `rsh.example.com'.
 
@@ -3181,11 +3295,6 @@ options as follows:
 
      xboard -ics -telnet -telnetProgram ptelnet
 
-Or in your `.Xresources' file:
-
-     XBoard*useTelnet: true
-     XBoard*telnetProgram: ptelnet
-
 Then when you run XBoard in ICS mode, it will issue the command
 `ptelnet chessclub.com 5000' to connect to the ICS.
 
@@ -3193,21 +3302,13 @@ Then when you run XBoard in ICS mode, it will issue the command
 is, your `ptelnet' program doesn't let you connect to alternative
 ports. As noted above, your chess server may allow you to connect on
 port 23 instead.  In that case, just add the option `-icsport ""' to
-the above command, or add `XBoard*internetChessServerPort:' to your
-`.Xresources' file.  But if your chess server doesn't let you connect
-on port 23, you will have to find some other host outside the firewall
-and hop through it. For instance, suppose you have a shell account at
+the above command.  But if your chess server doesn't let you connect on
+port 23, you will have to find some other host outside the firewall and
+hop through it. For instance, suppose you have a shell account at
 `foo.edu'. Set command line options as follows:
 
      xboard -ics -telnet -telnetProgram ptelnet -icshost foo.edu -icsport ""
 
-Or in your `.Xresources' file:
-
-     XBoard*useTelnet: true
-     XBoard*telnetProgram: ptelnet
-     XBoard*internetChessServerHost: foo.edu
-     XBoard*internetChessServerPort:
-
 Then when you run XBoard in ICS mode, it will issue the command
 `ptelnet foo.edu' to connect to your account at `foo.edu'. Log in
 there, then type `telnet chessclub.com 5000'.
@@ -3646,10 +3747,6 @@ ZIICS is available from:
 3. Give XBoard the "-pixmap" option when starting up, e.g.:
           xboard -pixmap ~/fritz4
 
-     Alternatively, you can add this line to your `.Xresources' file:
-
-          xboard*pixmapDirectory: ~/fritz4
-
    (*) ZIICS is a separate copyrighted work of Andy McFarland.  The
 "ZIICS pieces" are copyrighted works of their respective creators.
 Files produced by "zic2xpm" are for PERSONAL USE ONLY and may NOT be
@@ -3681,7 +3778,7 @@ other tortious action, arising out of or in connection with the use or
 performance of this software.
 
    Enhancements copyright (C) 1992-2003, 2004, 2005, 2006, 2007, 2008,
-2009, 2010, 2011, 2012 Free Software Foundation, Inc.
+2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc.
 
 Published by the Free Software Foundation
 59 Temple Place - Suite 330
@@ -4427,581 +4524,600 @@ please read `http://www.gnu.org/philosophy/why-not-lgpl.html'.
 Index
 *****
 
--animateSpeed, option:                         See 4.6.      (line 2705)
--autoDisplayComment, option:                   See 4.6.      (line 2710)
--autoDisplayTags, option:                      See 4.6.      (line 2710)
--pasteSelection, option:                       See 4.6.      (line 2716)
-.icsrc:                                        See 4.4.      (line 2045)
-<, Button:                                     See 3.2.      (line  389)
-<<, Button:                                    See 3.2.      (line  422)
->, Button:                                     See 3.2.      (line  409)
->>, Button:                                    See 3.2.      (line  441)
-abort, ICS command:                            See 5.        (line 3089)
-Abort, Menu Item:                              See 3.5.      (line  680)
-About XBoard, Menu Item:                       See 3.8.      (line 1412)
-Absolute Analysis Scores, Menu Item:           See 3.7.      (line  808)
-absoluteAnalysisScores, option:                See 4.6.      (line 2748)
-accept, ICS command:                           See 5.        (line 3076)
-Accept, Menu Item:                             See 3.5.      (line  652)
-Action, Menu:                                  See 3.5.      (line  651)
-adapterCommand, option:                        See 4.2.      (line 1760)
-adjourn, ICS command:                          See 5.        (line 3089)
-Adjourn, Menu Item:                            See 3.5.      (line  675)
-Adjudicate Draw, Menu Item:                    See 3.5.      (line  708)
-Adjudicate to Black, Menu Item:                See 3.5.      (line  708)
-Adjudicate to White, Menu Item:                See 3.5.      (line  708)
-adjudicateDrawMoves, option:                   See 4.7.      (line 2769)
-adjudicateLossThreshold, option:               See 4.7.      (line 2761)
-Adjudications, Menu Item:                      See 3.7.      (line 1023)
-afterGame, option:                             See 4.3.      (line 1929)
-afterTourney, option:                          See 4.3.      (line 1929)
-alarm, option:                                 See 4.4.      (line 2131)
-Almost Always Queen, Menu Item:                See 3.7.      (line  812)
-Also match left-right flipped position, Menu Item:See 3.7.   (line 1331)
-Also match reversed colors, Menu Item:         See 3.7.      (line 1331)
-alwaysPromoteToQueen, option:                  See 4.6.      (line 2441)
-Analysis Mode, Menu Item:                      See 3.4.      (line  536)
-Analyze Game, Menu Item:                       See 3.4.      (line  564)
-Animate Dragging, Menu Item:                   See 3.7.      (line  826)
-Animate Moving, Menu Item:                     See 3.7.      (line  833)
-animate, option:                               See 4.6.      (line 2701)
-animateDragging, option:                       See 4.6.      (line 2697)
-animateMoving, option:                         See 4.6.      (line 2701)
-Animation Speed, Menu Item:                    See 3.7.      (line  980)
-Annotate, Menu Item:                           See 3.2.      (line  365)
-at sign, option:                               See 4.5.      (line 2371)
-Authors:                                       See 10.       (line 3321)
-Auto Comment, Menu Item:                       See 3.7.      (line 1059)
-Auto Flag, Menu Item:                          See 3.7.      (line  842)
-Auto Flip View, Menu Item:                     See 3.7.      (line  852)
-Auto Kibitz, Menu Item:                        See 3.7.      (line 1050)
-Auto Observe, Menu Item:                       See 3.7.      (line 1067)
-Auto Raise Board, Menu Item:                   See 3.7.      (line 1080)
-Auto Save, Menu Item:                          See 3.7.      (line 1085)
-Auto-Refresh Seek Graph, Menu Item:            See 3.7.      (line 1127)
-autobs, option:                                See 4.4.      (line 2072)
-autoCallFlag, option:                          See 4.4.      (line 2068)
-autocomm, option:                              See 4.4.      (line 2064)
-autoComment, option:                           See 4.4.      (line 2064)
-autoCopyPV, option:                            See 4.6.      (line 2721)
-autoflag, option:                              See 4.4.      (line 2068)
-autoflip, option:                              See 4.6.      (line 2503)
-autoFlipView, option:                          See 4.6.      (line 2503)
-autoKibitz, option:                            See 4.4.      (line 2076)
-autoObserve, option:                           See 4.4.      (line 2072)
-autoraise, option:                             See 4.6.      (line 2499)
-autoRaiseBoard, option:                        See 4.6.      (line 2499)
-autoRefresh, option:                           See 4.4.      (line 2093)
-autosave, option:                              See 4.5.      (line 2315)
-autoSaveGames, option:                         See 4.5.      (line 2315)
-Back to Start, Menu Item:                      See 3.2.      (line  422)
-Background Observe, Menu Item:                 See 3.7.      (line 1092)
-backgroundObserve, option:                     See 4.4.      (line 2099)
-Backward, Menu Item:                           See 3.2.      (line  389)
+-animateSpeed, option:                         See 4.6.      (line 2798)
+-autoDisplayComment, option:                   See 4.6.      (line 2803)
+-autoDisplayTags, option:                      See 4.6.      (line 2803)
+-pasteSelection, option:                       See 4.6.      (line 2809)
+.icsrc:                                        See 4.4.      (line 2176)
+<, Button:                                     See 3.2.      (line  409)
+<<, Button:                                    See 3.2.      (line  442)
+>, Button:                                     See 3.2.      (line  429)
+>>, Button:                                    See 3.2.      (line  461)
+abort, ICS command:                            See 5.        (line 3212)
+Abort, Menu Item:                              See 3.5.      (line  749)
+About XBoard, Menu Item:                       See 3.8.      (line 1519)
+Absolute Analysis Scores, Menu Item:           See 3.7.      (line  877)
+absoluteAnalysisScores, option:                See 4.6.      (line 2847)
+accept, ICS command:                           See 5.        (line 3199)
+Accept, Menu Item:                             See 3.5.      (line  721)
+Action, Menu:                                  See 3.5.      (line  720)
+adapterCommand, option:                        See 4.2.      (line 1877)
+adjourn, ICS command:                          See 5.        (line 3212)
+Adjourn, Menu Item:                            See 3.5.      (line  744)
+Adjudicate Draw, Menu Item:                    See 3.5.      (line  777)
+Adjudicate to Black, Menu Item:                See 3.5.      (line  777)
+Adjudicate to White, Menu Item:                See 3.5.      (line  777)
+adjudicateDrawMoves, option:                   See 4.7.      (line 2868)
+adjudicateLossThreshold, option:               See 4.7.      (line 2860)
+Adjudications, Menu Item:                      See 3.7.      (line 1107)
+afterGame, option:                             See 4.3.      (line 2060)
+afterTourney, option:                          See 4.3.      (line 2060)
+alarm, option:                                 See 4.4.      (line 2262)
+Almost Always Queen, Menu Item:                See 3.7.      (line  881)
+Also match left-right flipped position, Menu Item:See 3.7.   (line 1418)
+Also match reversed colors, Menu Item:         See 3.7.      (line 1418)
+alwaysPromoteToQueen, option:                  See 4.6.      (line 2557)
+Analysis Mode, Menu Item:                      See 3.4.      (line  577)
+Analyze Game, Menu Item:                       See 3.4.      (line  625)
+Animate Dragging, Menu Item:                   See 3.7.      (line  895)
+Animate Moving, Menu Item:                     See 3.7.      (line  902)
+animate, option:                               See 4.6.      (line 2794)
+animateDragging, option:                       See 4.6.      (line 2790)
+animateMoving, option:                         See 4.6.      (line 2794)
+Animation Speed, Menu Item:                    See 3.7.      (line 1064)
+Annotate, Menu Item:                           See 3.2.      (line  385)
+appendPV, option:                              See 4.6.      (line 2841)
+at sign, option:                               See 4.5.      (line 2469)
+Authors:                                       See 10.       (line 3422)
+Auto Comment, Menu Item:                       See 3.7.      (line 1143)
+Auto Flag, Menu Item:                          See 3.7.      (line  911)
+Auto Flip View, Menu Item:                     See 3.7.      (line  921)
+Auto Kibitz, Menu Item:                        See 3.7.      (line 1134)
+Auto Observe, Menu Item:                       See 3.7.      (line 1151)
+Auto Raise Board, Menu Item:                   See 3.7.      (line 1164)
+Auto Save, Menu Item:                          See 3.7.      (line 1169)
+Auto-Refresh Seek Graph, Menu Item:            See 3.7.      (line 1211)
+autobs, option:                                See 4.4.      (line 2203)
+autoCallFlag, option:                          See 4.4.      (line 2199)
+autocomm, option:                              See 4.4.      (line 2195)
+autoComment, option:                           See 4.4.      (line 2195)
+autoCopyPV, option:                            See 4.6.      (line 2814)
+autoflag, option:                              See 4.4.      (line 2199)
+autoflip, option:                              See 4.6.      (line 2617)
+autoFlipView, option:                          See 4.6.      (line 2617)
+autoKibitz, option:                            See 4.4.      (line 2207)
+autoLogo, option:                              See 4.6.      (line 2521)
+autoObserve, option:                           See 4.4.      (line 2203)
+autoraise, option:                             See 4.6.      (line 2613)
+autoRaiseBoard, option:                        See 4.6.      (line 2613)
+autoRefresh, option:                           See 4.4.      (line 2224)
+autosave, option:                              See 4.5.      (line 2410)
+autoSaveGames, option:                         See 4.5.      (line 2410)
+Back to Start, Menu Item:                      See 3.2.      (line  442)
+Background Observe, Menu Item:                 See 3.7.      (line 1176)
+backgroundObserve, option:                     See 4.4.      (line 2230)
+Backward, Menu Item:                           See 3.2.      (line  409)
 Basic operation:                               See 2.        (line   57)
-bell, option:                                  See 4.6.      (line 2428)
-bitmapDirectory, option:                       See 4.6.      (line 2618)
-blackPieceColor, option:                       See 4.6.      (line 2666)
-blind, option:                                 See 4.6.      (line 2568)
-Blindfold, Menu Item:                          See 3.7.      (line  865)
-blindfold, option:                             See 4.6.      (line 2568)
-bm, option:                                    See 4.6.      (line 2618)
-board size:                                    See 4.6.      (line 2453)
-Board, Menu Item:                              See 3.3.      (line  509)
-boardHeight, option:                           See 4.8.      (line 2893)
-boardSize, option:                             See 4.6.      (line 2453)
-boardWidth, option:                            See 4.8.      (line 2898)
-Book, Menu Item:                               See 3.6.      (line  770)
-bookDepth, option:                             See 4.2.      (line 1804)
-bookVariation, option:                         See 4.2.      (line 1808)
-Bug reports:                                   See 9.        (line 3303)
-Bugs <1>:                                      See 9.        (line 3303)
-Bugs:                                          See 8.        (line 3248)
-buttons, option:                               See 4.6.      (line 2525)
-Call Flag, Menu Item:                          See 3.5.      (line  664)
-checkMates, option:                            See 4.7.      (line 2774)
-Chess engine options:                          See 4.1.      (line 1495)
-CHESSDIR:                                      See 7.        (line 3239)
-clock, option:                                 See 4.1.      (line 1512)
-clockFont, option:                             See 4.6.      (line 2589)
-clockMode, option:                             See 4.1.      (line 1512)
-CloneTourney, Menu Item:                       See 3.7.      (line 1285)
-cmail:                                         See 11.       (line 3373)
-colorChallenge, option:                        See 4.4.      (line 2174)
-colorChannel, option:                          See 4.4.      (line 2174)
-colorChannel1, option:                         See 4.4.      (line 2174)
-colorCShout, option:                           See 4.4.      (line 2174)
-Colorize Messages, Menu Item:                  See 3.7.      (line 1162)
-colorize, option:                              See 4.4.      (line 2158)
-colorizeMessages, option:                      See 4.4.      (line 2158)
-colorKibitz, option:                           See 4.4.      (line 2174)
-colorNickNames, option:                        See 4.8.      (line 2953)
-colorNormal, option:                           See 4.4.      (line 2174)
-colorRequest, option:                          See 4.4.      (line 2174)
-Colors <1>:                                    See 4.6.      (line 2666)
-Colors:                                        See 4.4.      (line 2158)
-colorSeek, option:                             See 4.4.      (line 2174)
-colorShout, option:                            See 4.4.      (line 2174)
-colorSShout, option:                           See 4.4.      (line 2174)
-colorTell, option:                             See 4.4.      (line 2174)
-Comments, Menu Item:                           See 3.3.      (line  497)
-Common Engine, Menu Item:                      See 3.7.      (line  999)
-Contributors:                                  See 10.       (line 3321)
-coordFont, option:                             See 4.6.      (line 2595)
-coords, option:                                See 4.6.      (line 2495)
-Copy Game List, Menu Item:                     See 3.2.      (line  267)
-Copy Game, Menu Item:                          See 3.2.      (line  248)
-Copy Position, Menu Item:                      See 3.2.      (line  257)
-cy, option:                                    See 4.3.      (line 1891)
-darkBackTextureFile, option:                   See 4.6.      (line 2690)
-darkSquareColor, option:                       See 4.6.      (line 2666)
-dateThreshold, option:                         See 4.8.      (line 3014)
-debug, option:                                 See 4.8.      (line 2960)
-debugFile, option:                             See 4.8.      (line 2963)
-debugMode, option:                             See 4.8.      (line 2960)
-decline, ICS command:                          See 5.        (line 3076)
-Decline, Menu Item:                            See 3.5.      (line  658)
-Default number of Games, Menu Item:            See 3.7.      (line 1227)
-defaultCacheSizeEGTB, option:                  See 4.2.      (line 1825)
-defaultFrcPosition, option:                    See 4.8.      (line 2913)
-defaultHashSize, option:                       See 4.2.      (line 1819)
-defaultMatchGames, option:                     See 4.3.      (line 1864)
-defaultPathEGTB, option:                       See 4.2.      (line 1831)
-defaultTourneyName, option:                    See 4.3.      (line 1908)
-delayAfterQuit, option:                        See 4.8.      (line 2998)
-delayBeforeQuit, option:                       See 4.8.      (line 2998)
-Disable own engine bools be default, Menu Item:See 3.7.      (line 1262)
-discourageOwnBooks, option:                    See 4.2.      (line 1798)
-disguisePromotedPieces, option:                See 4.4.      (line 2122)
-display, option:                               See 4.6.      (line 2401)
-drag, option:                                  See 4.6.      (line 2697)
-draw, ICS command:                             See 5.        (line 3089)
-Draw, Menu Item:                               See 3.5.      (line  670)
-Drop Menu, Menu Item:                          See 3.7.      (line  871)
-dropMenu, option:                              See 4.6.      (line 2727)
-Dual Board, Menu Item:                         See 3.7.      (line 1099)
-dualBoard, option:                             See 4.4.      (line 2113)
-Edit Book, Menu Item:                          See 3.2.      (line  354)
-Edit Comment, Menu Item:                       See 3.2.      (line  349)
-Edit Game, Menu Item:                          See 3.2.      (line  282)
-Edit Menu:                                     See 3.2.      (line  247)
-Edit Position, Menu Item:                      See 3.2.      (line  298)
-Edit Tags, Menu Item:                          See 3.2.      (line  325)
-egtFormats, option:                            See 4.2.      (line 1835)
-Elo of strongest player, Menu Item:            See 3.7.      (line 1304)
-Elo of weakest player, Menu Item:              See 3.7.      (line 1304)
-eloThresholdAny, option:                       See 4.8.      (line 3009)
-eloThresholdBoth, option:                      See 4.8.      (line 3009)
-Engine #1 Settings, Menu Item:                 See 3.6.      (line  748)
-Engine #2 Settings, Menu Item:                 See 3.6.      (line  748)
-Engine Menu:                                   See 3.6.      (line  716)
-Engine Settings:                               See 4.2.      (line 1742)
-Engine Settings, Menu Item:                    See 3.6.      (line  748)
-engineDebugOutput, option:                     See 4.8.      (line 2970)
-Environment variables:                         See 7.        (line 3239)
-evalThreshold, option:                         See 4.6.      (line 2535)
-evalZoom, option:                              See 4.6.      (line 2531)
-examine, ICS command:                          See 5.        (line 3112)
-Exit, Menu Item:                               See 3.1.      (line  242)
-exit, option:                                  See 4.6.      (line 2433)
-fb, option:                                    See 4.1.      (line 1619)
-fcp, option:                                   See 4.1.      (line 1612)
-fd, option:                                    See 4.1.      (line 1634)
-fh, option:                                    See 4.1.      (line 1626)
-File Menu:                                     See 3.1.      (line  122)
-File with Start Positions, Menu Item:          See 3.7.      (line 1246)
-find position, Menu Item:                      See 3.7.      (line 1309)
-finger, ICS command:                           See 5.        (line 3099)
-First Black Move, Menu Item:                   See 3.7.      (line 1137)
-First White Move, Menu Item:                   See 3.7.      (line 1137)
-firstChessProgram, option:                     See 4.1.      (line 1612)
-firstComputerString, option:                   See 4.1.      (line 1670)
-firstDirectory, option:                        See 4.1.      (line 1634)
-firstHasOwnBookUCI, option:                    See 4.2.      (line 1792)
-firstHost, option:                             See 4.1.      (line 1626)
-firstInitString, option:                       See 4.1.      (line 1643)
-firstIsUCI, option:                            See 4.2.      (line 1744)
-firstNeedsNoncompliantFEN, option:             See 4.1.      (line 1720)
-firstNPS, option:                              See 4.1.      (line 1535)
-firstOptions, option:                          See 4.1.      (line 1709)
-firstPgnName, option:                          See 4.2.      (line 1813)
-firstPlaysBlack, option:                       See 4.1.      (line 1619)
-firstProtocolVersion, option:                  See 4.1.      (line 1687)
-firstScoreAbs, option:                         See 4.1.      (line 1695)
-firstTimeOdds, option:                         See 4.1.      (line 1553)
-firstXBook, option:                            See 4.2.      (line 1792)
-Flash Moves, Menu Item:                        See 3.7.      (line  975)
-Flash Rate, Menu Item:                         See 3.7.      (line  975)
-flash, option:                                 See 4.6.      (line 2551)
-flashCount, option:                            See 4.6.      (line 2551)
-flashRate, option:                             See 4.6.      (line 2551)
-Flip View, Menu Item:                          See 3.3.      (line  456)
-flip, option:                                  See 4.6.      (line 2507)
-flipView, option:                              See 4.6.      (line 2507)
-fn, option:                                    See 4.2.      (line 1813)
-fNoOwnBookUCI, option:                         See 4.2.      (line 1792)
-Font, clock:                                   See 4.6.      (line 2589)
-Font, coordinates:                             See 4.6.      (line 2595)
-Font, message:                                 See 4.6.      (line 2602)
-fontSizeTolerance, option:                     See 4.6.      (line 2608)
-Forward to End, Menu Item:                     See 3.2.      (line  441)
-Forward, Menu Item:                            See 3.2.      (line  409)
-fSAN, option:                                  See 4.6.      (line 2577)
-fUCCI, option:                                 See 4.2.      (line 1754)
-fUCI, option:                                  See 4.2.      (line 1744)
-fUSI, option:                                  See 4.2.      (line 1754)
-Game File with Opening Lines, Menu Item:       See 3.7.      (line 1246)
-Game List Tags, Menu Item <1>:                 See 3.7.      (line 1353)
-Game List Tags, Menu Item:                     See 3.3.      (line  518)
-Game Number, Menu Item:                        See 3.7.      (line 1246)
-gameListTags, option:                          See 4.5.      (line 2362)
-games, ICS command:                            See 5.        (line 3065)
-gateway, option:                               See 4.4.      (line 1995)
-General Options, Menu Item:                    See 3.7.      (line  804)
-geometry, option:                              See 4.6.      (line 2401)
-Get Move List, Menu Item:                      See 3.7.      (line 1104)
-getMoveList, option:                           See 4.4.      (line 2127)
-Help Menu:                                     See 3.8.      (line 1397)
-help, ICS command:                             See 5.        (line 3050)
-Hide Thinking, Menu Item:                      See 3.7.      (line  877)
-highlight Arrow, option:                       See 4.6.      (line 2564)
-Highlight Last Move, Menu Item:                See 3.7.      (line  887)
-Highlight with Arrow, Menu Item:               See 3.7.      (line  893)
-highlight, option:                             See 4.6.      (line 2560)
-highlightLastMove, option:                     See 4.6.      (line 2560)
-highlightMoveWithArrow, option:                See 4.6.      (line 2564)
-highlightSquareColor, option:                  See 4.6.      (line 2666)
-Hint, Menu Item:                               See 3.6.      (line  767)
-holdingsSize, option:                          See 4.8.      (line 2905)
-iconic, option:                                See 4.6.      (line 2401)
-ICS:                                           See 5.        (line 3021)
-ICS Alarm Time, Menu Item:                     See 3.7.      (line 1152)
-ICS Alarm, Menu Item:                          See 3.7.      (line 1152)
-ICS Client, Menu Item:                         See 3.4.      (line  595)
-ICS Input Box, Menu Item:                      See 3.3.      (line  502)
-ICS options:                                   See 4.4.      (line 1950)
-ICS Options, Menu Item:                        See 3.7.      (line 1046)
-ICS, addresses:                                See 5.        (line 3021)
-ics, option:                                   See 4.4.      (line 1951)
-icsAlarm, option:                              See 4.4.      (line 2131)
-icsAlarmTime, option:                          See 4.4.      (line 2135)
-icscomm, option:                               See 4.4.      (line 2003)
-icshelper, option:                             See 4.4.      (line 1969)
-icshost, option:                               See 4.4.      (line 1956)
-icsinput, option:                              See 4.4.      (line 2060)
-icslogon, option:                              See 4.4.      (line 2045)
-icsport, option:                               See 4.4.      (line 1965)
-inc, option:                                   See 4.1.      (line 1505)
-Info XBoard, Menu Item:                        See 3.8.      (line 1398)
-init, option:                                  See 4.5.      (line 2371)
-initalMode, option:                            See 4.8.      (line 2826)
-initString, option:                            See 4.1.      (line 1643)
-Internet Chess Server:                         See 5.        (line 3021)
-internetChessServerCommPort, option:           See 4.4.      (line 2003)
-internetChessServerHelper, option:             See 4.4.      (line 1969)
-internetChessServerHost, option:               See 4.4.      (line 1956)
-internetChessServerInputBox, option:           See 4.4.      (line 2060)
-internetChessServerLogonScript, option:        See 4.4.      (line 2045)
-internetChessServerMode, option:               See 4.4.      (line 1951)
-internetChessServerPort, option:               See 4.4.      (line 1965)
+bell, option:                                  See 4.6.      (line 2544)
+blackPieceColor, option:                       See 4.6.      (line 2747)
+blind, option:                                 See 4.6.      (line 2682)
+Blindfold, Menu Item:                          See 3.7.      (line  934)
+blindfold, option:                             See 4.6.      (line 2682)
+board size:                                    See 4.6.      (line 2569)
+Board, Menu Item:                              See 3.3.      (line  550)
+boardHeight, option:                           See 4.8.      (line 3016)
+boardSize, option:                             See 4.6.      (line 2569)
+boardWidth, option:                            See 4.8.      (line 3021)
+Book, Menu Item:                               See 3.6.      (line  839)
+bookDepth, option:                             See 4.2.      (line 1921)
+bookVariation, option:                         See 4.2.      (line 1925)
+Bug reports:                                   See 9.        (line 3404)
+Bugs <1>:                                      See 9.        (line 3404)
+Bugs:                                          See 8.        (line 3349)
+buttons, option:                               See 4.6.      (line 2639)
+Call Flag, Menu Item:                          See 3.5.      (line  733)
+checkMates, option:                            See 4.7.      (line 2873)
+Chess engine options:                          See 4.1.      (line 1602)
+CHESSDIR:                                      See 7.        (line 3340)
+clock, option:                                 See 4.1.      (line 1619)
+clockFont, option:                             See 4.6.      (line 2703)
+clockMode, option:                             See 4.1.      (line 1619)
+CloneTourney, Menu Item:                       See 3.7.      (line 1369)
+cmail:                                         See 11.       (line 3474)
+colorChallenge, option:                        See 4.4.      (line 2305)
+colorChannel, option:                          See 4.4.      (line 2305)
+colorChannel1, option:                         See 4.4.      (line 2305)
+colorCShout, option:                           See 4.4.      (line 2305)
+Colorize Messages, Menu Item:                  See 3.7.      (line 1246)
+colorize, option:                              See 4.4.      (line 2289)
+colorizeMessages, option:                      See 4.4.      (line 2289)
+colorKibitz, option:                           See 4.4.      (line 2305)
+colorNickNames, option:                        See 4.8.      (line 3076)
+colorNormal, option:                           See 4.4.      (line 2305)
+colorRequest, option:                          See 4.4.      (line 2305)
+Colors <1>:                                    See 4.6.      (line 2747)
+Colors:                                        See 4.4.      (line 2289)
+colorSeek, option:                             See 4.4.      (line 2305)
+colorShout, option:                            See 4.4.      (line 2305)
+colorSShout, option:                           See 4.4.      (line 2305)
+colorTell, option:                             See 4.4.      (line 2305)
+Comments, Menu Item:                           See 3.3.      (line  526)
+Common Engine, Menu Item:                      See 3.7.      (line 1083)
+Contributors:                                  See 10.       (line 3422)
+coordFont, option:                             See 4.6.      (line 2709)
+coords, option:                                See 4.6.      (line 2609)
+Copy Game List, Menu Item:                     See 3.2.      (line  285)
+Copy Game, Menu Item:                          See 3.2.      (line  266)
+Copy Position, Menu Item:                      See 3.2.      (line  275)
+cy, option:                                    See 4.3.      (line 2022)
+darkBackTextureFile, option:                   See 4.6.      (line 2783)
+darkSquareColor, option:                       See 4.6.      (line 2747)
+dateThreshold, option:                         See 4.8.      (line 3137)
+debug, option:                                 See 4.8.      (line 3083)
+debugFile, option:                             See 4.8.      (line 3086)
+debugMode, option:                             See 4.8.      (line 3083)
+decline, ICS command:                          See 5.        (line 3199)
+Decline, Menu Item:                            See 3.5.      (line  727)
+Default number of Games, Menu Item:            See 3.7.      (line 1311)
+defaultCacheSizeEGTB, option:                  See 4.2.      (line 1956)
+defaultFrcPosition, option:                    See 4.8.      (line 3036)
+defaultHashSize, option:                       See 4.2.      (line 1950)
+defaultMatchGames, option:                     See 4.3.      (line 1995)
+defaultPathEGTB, option:                       See 4.2.      (line 1962)
+defaultTourneyName, option:                    See 4.3.      (line 2039)
+delayAfterQuit, option:                        See 4.8.      (line 3121)
+delayBeforeQuit, option:                       See 4.8.      (line 3121)
+Disable own engine bools be default, Menu Item:See 3.7.      (line 1346)
+discourageOwnBooks, option:                    See 4.2.      (line 1915)
+disguisePromotedPieces, option:                See 4.4.      (line 2253)
+display, option:                               See 4.6.      (line 2499)
+drag, option:                                  See 4.6.      (line 2790)
+draw, ICS command:                             See 5.        (line 3212)
+Draw, Menu Item:                               See 3.5.      (line  739)
+Drop Menu, Menu Item:                          See 3.7.      (line  940)
+dropMenu, option:                              See 4.6.      (line 2820)
+Dual Board, Menu Item:                         See 3.7.      (line 1183)
+dualBoard, option:                             See 4.4.      (line 2244)
+Edit Book, Menu Item:                          See 3.2.      (line  374)
+Edit Comment, Menu Item:                       See 3.2.      (line  367)
+Edit Game, Menu Item:                          See 3.2.      (line  300)
+Edit Menu:                                     See 3.2.      (line  265)
+Edit Position, Menu Item:                      See 3.2.      (line  316)
+Edit Tags, Menu Item:                          See 3.2.      (line  343)
+egtFormats, option:                            See 4.2.      (line 1966)
+Elo of strongest player, Menu Item:            See 3.7.      (line 1388)
+Elo of weakest player, Menu Item:              See 3.7.      (line 1388)
+eloThresholdAny, option:                       See 4.8.      (line 3132)
+eloThresholdBoth, option:                      See 4.8.      (line 3132)
+Enable Variation Trees, Menu Item:             See 3.7.      (line  946)
+Engine #1 Settings, Menu Item:                 See 3.6.      (line  817)
+Engine #2 Settings, Menu Item:                 See 3.6.      (line  817)
+Engine Menu:                                   See 3.6.      (line  785)
+Engine Settings:                               See 4.2.      (line 1859)
+Engine Settings, Menu Item:                    See 3.6.      (line  817)
+engineDebugOutput, option:                     See 4.8.      (line 3093)
+Environment variables:                         See 7.        (line 3340)
+evalThreshold, option:                         See 4.6.      (line 2649)
+evalZoom, option:                              See 4.6.      (line 2645)
+examine, ICS command:                          See 5.        (line 3235)
+Exit, Menu Item:                               See 3.1.      (line  260)
+exit, option:                                  See 4.6.      (line 2549)
+fb, option:                                    See 4.1.      (line 1737)
+fcp, option:                                   See 4.1.      (line 1719)
+fd, option:                                    See 4.1.      (line 1752)
+fe, option:                                    See 4.1.      (line 1726)
+fh, option:                                    See 4.1.      (line 1744)
+File Menu:                                     See 3.1.      (line  129)
+File with Start Positions, Menu Item:          See 3.7.      (line 1330)
+find position, Menu Item:                      See 3.7.      (line 1393)
+finger, ICS command:                           See 5.        (line 3222)
+First Black Move, Menu Item:                   See 3.7.      (line 1221)
+First White Move, Menu Item:                   See 3.7.      (line 1221)
+firstChessProgram, option:                     See 4.1.      (line 1719)
+firstComputerString, option:                   See 4.1.      (line 1787)
+firstDirectory, option:                        See 4.1.      (line 1752)
+firstEngine, option:                           See 4.1.      (line 1726)
+firstHasOwnBookUCI, option:                    See 4.2.      (line 1909)
+firstHost, option:                             See 4.1.      (line 1744)
+firstInitString, option:                       See 4.1.      (line 1761)
+firstIsUCI, option:                            See 4.2.      (line 1861)
+firstLogo, option:                             See 4.6.      (line 2515)
+firstNeedsNoncompliantFEN, option:             See 4.1.      (line 1837)
+firstNPS, option:                              See 4.1.      (line 1642)
+firstOptions, option:                          See 4.1.      (line 1826)
+firstPgnName, option:                          See 4.2.      (line 1944)
+firstPlaysBlack, option:                       See 4.1.      (line 1737)
+firstProtocolVersion, option:                  See 4.1.      (line 1804)
+firstScoreAbs, option:                         See 4.1.      (line 1812)
+firstTimeOdds, option:                         See 4.1.      (line 1660)
+firstXBook, option:                            See 4.2.      (line 1909)
+Flash Moves, Menu Item:                        See 3.7.      (line 1059)
+Flash Rate, Menu Item:                         See 3.7.      (line 1059)
+flash, option:                                 See 4.6.      (line 2665)
+flashCount, option:                            See 4.6.      (line 2665)
+flashRate, option:                             See 4.6.      (line 2665)
+Flip View, Menu Item:                          See 3.3.      (line  476)
+flip, option:                                  See 4.6.      (line 2621)
+flipView, option:                              See 4.6.      (line 2621)
+fn, option:                                    See 4.2.      (line 1944)
+fNoOwnBookUCI, option:                         See 4.2.      (line 1909)
+Font, clock:                                   See 4.6.      (line 2703)
+Font, coordinates:                             See 4.6.      (line 2709)
+Font, message:                                 See 4.6.      (line 2716)
+fontSizeTolerance, option:                     See 4.6.      (line 2722)
+Forward to End, Menu Item:                     See 3.2.      (line  461)
+Forward, Menu Item:                            See 3.2.      (line  429)
+fSAN, option:                                  See 4.6.      (line 2691)
+fUCCI, option:                                 See 4.2.      (line 1871)
+fUCI, option:                                  See 4.2.      (line 1861)
+fUSI, option:                                  See 4.2.      (line 1871)
+Game File with Opening Lines, Menu Item:       See 3.7.      (line 1330)
+Game List Tags, Menu Item <1>:                 See 3.7.      (line 1441)
+Game List Tags, Menu Item:                     See 3.3.      (line  559)
+Game Number, Menu Item:                        See 3.7.      (line 1330)
+gameListTags, option:                          See 4.5.      (line 2460)
+games, ICS command:                            See 5.        (line 3188)
+gateway, option:                               See 4.4.      (line 2126)
+General Options, Menu Item:                    See 3.7.      (line  873)
+geometry, option:                              See 4.6.      (line 2499)
+Get Move List, Menu Item:                      See 3.7.      (line 1188)
+getMoveList, option:                           See 4.4.      (line 2258)
+Help Menu:                                     See 3.8.      (line 1504)
+help, ICS command:                             See 5.        (line 3173)
+Hide Thinking, Menu Item:                      See 3.7.      (line  953)
+highlight Arrow, option:                       See 4.6.      (line 2678)
+Highlight Last Move, Menu Item:                See 3.7.      (line  963)
+Highlight with Arrow, Menu Item:               See 3.7.      (line  969)
+highlight, option:                             See 4.6.      (line 2674)
+highlightLastMove, option:                     See 4.6.      (line 2674)
+highlightMoveWithArrow, option:                See 4.6.      (line 2678)
+highlightSquareColor, option:                  See 4.6.      (line 2747)
+Hint, Menu Item:                               See 3.6.      (line  836)
+holdingsSize, option:                          See 4.8.      (line 3028)
+iconic, option:                                See 4.6.      (line 2499)
+ICS:                                           See 5.        (line 3144)
+ICS Alarm Time, Menu Item:                     See 3.7.      (line 1236)
+ICS Alarm, Menu Item:                          See 3.7.      (line 1236)
+ICS Client, Menu Item:                         See 3.4.      (line  664)
+ICS Input Box, Menu Item:                      See 3.3.      (line  531)
+ICS options:                                   See 4.4.      (line 2081)
+ICS Options, Menu Item:                        See 3.7.      (line 1130)
+ICS, addresses:                                See 5.        (line 3144)
+ics, option:                                   See 4.4.      (line 2082)
+icsAlarm, option:                              See 4.4.      (line 2262)
+icsAlarmTime, option:                          See 4.4.      (line 2266)
+icscomm, option:                               See 4.4.      (line 2134)
+icshelper, option:                             See 4.4.      (line 2100)
+icshost, option:                               See 4.4.      (line 2087)
+icsinput, option:                              See 4.4.      (line 2191)
+icslogon, option:                              See 4.4.      (line 2176)
+icsport, option:                               See 4.4.      (line 2096)
+inc, option:                                   See 4.1.      (line 1612)
+Info XBoard, Menu Item:                        See 3.8.      (line 1505)
+init, option:                                  See 4.5.      (line 2469)
+initalMode, option:                            See 4.8.      (line 2949)
+initString, option:                            See 4.1.      (line 1761)
+Internet Chess Server:                         See 5.        (line 3144)
+internetChessServerCommPort, option:           See 4.4.      (line 2134)
+internetChessServerHelper, option:             See 4.4.      (line 2100)
+internetChessServerHost, option:               See 4.4.      (line 2087)
+internetChessServerInputBox, option:           See 4.4.      (line 2191)
+internetChessServerLogonScript, option:        See 4.4.      (line 2176)
+internetChessServerMode, option:               See 4.4.      (line 2082)
+internetChessServerPort, option:               See 4.4.      (line 2096)
 introduction:
           See ``Introduction''.                              (line    9)
-Keys:                                          See 3.9.      (line 1417)
-legal, option:                                 See 4.6.      (line 2449)
-lgf, option:                                   See 4.5.      (line 2278)
-lgi, option:                                   See 4.5.      (line 2278)
-lightSquareColor, option:                      See 4.6.      (line 2666)
-Limitations:                                   See 8.        (line 3248)
-liteBackTextureFile, option:                   See 4.6.      (line 2690)
-Load and Save options:                         See 4.5.      (line 2276)
-Load Engine, Menu Item:                        See 3.6.      (line  717)
-Load Game Options, Menu Item:                  See 3.7.      (line 1293)
-Load Game, Menu Item:                          See 3.1.      (line  166)
-Load Next Game, Menu Item:                     See 3.9.      (line 1421)
-Load Next Position, Menu Item:                 See 3.1.      (line  208)
-Load Position, Menu Item:                      See 3.1.      (line  199)
-Load Previous Game, Menu Item:                 See 3.9.      (line 1425)
-Load Previous Position, Menu Item:             See 3.1.      (line  212)
-loadGameFile, option:                          See 4.5.      (line 2278)
-loadGameIndex, option:                         See 4.5.      (line 2278)
-loadPositionFile, option:                      See 4.5.      (line 2320)
-loadPositionIndex, option:                     See 4.5.      (line 2320)
-lowTimeWarning, option:                        See 4.4.      (line 2139)
-lowTimeWarningColor, option:                   See 4.6.      (line 2666)
-lpf, option:                                   See 4.5.      (line 2320)
-lpi, option:                                   See 4.5.      (line 2320)
-Machine Black, Menu Item:                      See 3.4.      (line  528)
-Machine match, Menu Item:                      See 3.4.      (line  619)
-Machine White, Menu Item:                      See 3.4.      (line  524)
-Mail Move, Menu Item:                          See 3.1.      (line  239)
+Keys:                                          See 3.9.      (line 1524)
+legal, option:                                 See 4.6.      (line 2565)
+lgf, option:                                   See 4.5.      (line 2373)
+lgi, option:                                   See 4.5.      (line 2373)
+lightSquareColor, option:                      See 4.6.      (line 2747)
+Limitations:                                   See 8.        (line 3349)
+liteBackTextureFile, option:                   See 4.6.      (line 2783)
+Load and Save options:                         See 4.5.      (line 2371)
+Load Engine, Menu Item:                        See 3.6.      (line  786)
+Load Game Options, Menu Item:                  See 3.7.      (line 1377)
+Load Game, Menu Item:                          See 3.1.      (line  173)
+Load Next Game, Menu Item:                     See 3.9.      (line 1528)
+Load Next Position, Menu Item:                 See 3.1.      (line  215)
+Load Position, Menu Item:                      See 3.1.      (line  206)
+Load Previous Game, Menu Item:                 See 3.9.      (line 1532)
+Load Previous Position, Menu Item:             See 3.1.      (line  219)
+loadGameFile, option:                          See 4.5.      (line 2373)
+loadGameIndex, option:                         See 4.5.      (line 2373)
+loadPositionFile, option:                      See 4.5.      (line 2418)
+loadPositionIndex, option:                     See 4.5.      (line 2418)
+logoDir, option:                               See 4.6.      (line 2521)
+logoSize, option:                              See 4.6.      (line 2508)
+lowTimeWarning, option:                        See 4.4.      (line 2270)
+lowTimeWarningColor, option:                   See 4.6.      (line 2747)
+lpf, option:                                   See 4.5.      (line 2418)
+lpi, option:                                   See 4.5.      (line 2418)
+Machine Black, Menu Item:                      See 3.4.      (line  569)
+Machine match, Menu Item:                      See 3.4.      (line  688)
+Machine White, Menu Item:                      See 3.4.      (line  565)
+Mail Move, Menu Item:                          See 3.1.      (line  257)
 Major modes:                                   See 1.        (line   19)
-Man XBoard, Menu Item:                         See 3.8.      (line 1405)
-Match Options, Menu Item:                      See 3.7.      (line 1168)
-matchGames, option:                            See 4.1.      (line 1590)
-matchMode, option:                             See 4.1.      (line 1602)
-matchPause, option:                            See 4.3.      (line 1869)
-materialDraws, option:                         See 4.7.      (line 2786)
-Menu, Action:                                  See 3.5.      (line  651)
-Menu, Edit:                                    See 3.2.      (line  247)
-Menu, Engine:                                  See 3.6.      (line  716)
-Menu, File:                                    See 3.1.      (line  122)
-Menu, Help:                                    See 3.8.      (line 1397)
-Menu, Mode:                                    See 3.4.      (line  523)
-Menu, Options:                                 See 3.7.      (line  803)
-Menu, View:                                    See 3.3.      (line  455)
-Menus:                                         See 3.        (line  119)
-messageFont, option:                           See 4.6.      (line 2602)
-mg, option:                                    See 4.1.      (line 1590)
-mm, option:                                    See 4.1.      (line 1602)
-Mode Menu:                                     See 3.4.      (line  523)
-mode, option:                                  See 4.8.      (line 2826)
-mono, option:                                  See 4.6.      (line 2539)
-monoMode, option:                              See 4.6.      (line 2539)
-Move Now, Menu Item:                           See 3.6.      (line  780)
-Move Sound, Menu Item:                         See 3.7.      (line  898)
-moves, option:                                 See 4.4.      (line 2127)
-movesound, option:                             See 4.6.      (line 2428)
-movesPerSession, option:                       See 4.1.      (line 1501)
-mps, option:                                   See 4.1.      (line 1501)
-msLoginDelay, option:                          See 4.4.      (line 2054)
-nameOfDebugFile, option:                       See 4.8.      (line 2963)
-ncp, option:                                   See 4.8.      (line 2821)
-New Game, Menu Item:                           See 3.1.      (line  123)
-New Shuffle Game, Menu Item:                   See 3.1.      (line  132)
-New variant, Menu Item:                        See 3.1.      (line  147)
-niceEngines, option:                           See 4.1.      (line 1701)
-noChessProgram, option:                        See 4.8.      (line 2821)
-noGUI, option:                                 See 4.6.      (line 2404)
-null move:                                     See 3.4.      (line  536)
-number of consecutive positions, Menu Item:    See 3.7.      (line 1324)
-Number of tourney cycles, Menu Item:           See 3.7.      (line 1227)
-observe, ICS command:                          See 5.        (line 3108)
-oldmoves, ICS command:                         See 5.        (line 3112)
-oldsave, option:                               See 4.5.      (line 2358)
-oldSaveStyle, option:                          See 4.5.      (line 2358)
-One-Click Moving, Menu Item:                   See 3.7.      (line  907)
-oneClickMove, option:                          See 4.6.      (line 2421)
-Options:                                       See 4.        (line 1476)
-Options Menu:                                  See 3.7.      (line  803)
-Options, adjudication:                         See 4.7.      (line 2760)
-options, Chess engine:                         See 4.1.      (line 1495)
-Options, ICS:                                  See 4.4.      (line 1950)
-Options, Load and Save:                        See 4.5.      (line 2276)
-Options, miscellaneous:                        See 4.8.      (line 2820)
-Options, Tournament:                           See 4.3.      (line 1863)
-Options, User interface:                       See 4.6.      (line 2397)
-Other programs:                                See 12.       (line 3571)
-overrideLineGap, option:                       See 4.6.      (line 2488)
-pairingEngine, option:                         See 4.3.      (line 1916)
-participants, option:                          See 4.3.      (line 1895)
-Paste Game, Menu Item:                         See 3.2.      (line  273)
-Paste Position, Menu Item:                     See 3.2.      (line  277)
-Pause, Menu Item:                              See 3.4.      (line  625)
-Periodic Updates, Menu Item:                   See 3.7.      (line  919)
-periodic, option:                              See 4.6.      (line 2572)
-periodicUpdates, option:                       See 4.6.      (line 2572)
-pgnEventHeader, option:                        See 4.5.      (line 2345)
-pgnExtendedInfo, option:                       See 4.5.      (line 2340)
-pgnNumberTag, option:                          See 4.5.      (line 2349)
-pieceMenu, option:                             See 4.6.      (line 2733)
-pieceNickNames, option:                        See 4.8.      (line 2944)
-pieceToCharTable, option:                      See 4.8.      (line 2918)
-pixmap, option:                                See 4.6.      (line 2618)
-pixmapDirectory, option:                       See 4.6.      (line 2618)
-polyglotBook, option:                          See 4.2.      (line 1783)
-polyglotDir, option:                           See 4.2.      (line 1776)
-Ponder Next Move, Menu Item:                   See 3.7.      (line  925)
-ponder, option:                                See 4.1.      (line 1581)
-ponderNextMove, option:                        See 4.1.      (line 1581)
-Popup Exit Message, Menu Item:                 See 3.7.      (line  931)
-Popup Move Errors, Menu Item:                  See 3.7.      (line  937)
-popup, option:                                 See 4.6.      (line 2437)
-popupExitMessage, option:                      See 4.6.      (line 2433)
-popupMoveErrors, option:                       See 4.6.      (line 2437)
-Position Number, Menu Item:                    See 3.7.      (line 1246)
-pre, option:                                   See 4.4.      (line 2143)
-preblack, option:                              See 4.4.      (line 2149)
-Premove Black, Menu Item:                      See 3.7.      (line 1137)
-Premove White, Menu Item:                      See 3.7.      (line 1137)
-Premove, Menu Item:                            See 3.7.      (line 1137)
-premove, option:                               See 4.4.      (line 2143)
-premoveBlack, option:                          See 4.4.      (line 2149)
-premoveBlackText, option:                      See 4.4.      (line 2149)
-premoveHighlightColor, option:                 See 4.6.      (line 2666)
-premoveWhite, option:                          See 4.4.      (line 2149)
-premoveWhiteText, option:                      See 4.4.      (line 2149)
-prewhite, option:                              See 4.4.      (line 2149)
-Problems:                                      See 9.        (line 3303)
-queen, option:                                 See 4.6.      (line 2441)
-Quiet Play, Menu Item:                         See 3.7.      (line 1116)
-quiet, option:                                 See 4.4.      (line 2154)
-quietPlay, option:                             See 4.4.      (line 2154)
-recentEngineList, option:                      See 4.6.      (line 2411)
-recentEngines, option:                         See 4.6.      (line 2411)
-Recently Used Engines, In Menu:                See 3.6.      (line  792)
-Reload CMail Message, Menu Item:               See 3.1.      (line  239)
-Reload Same Game, Menu Item:                   See 3.9.      (line 1430)
-Reload Same Position, Menu Item:               See 3.9.      (line 1435)
-remoteShell, option:                           See 4.8.      (line 2984)
-remoteUser, option:                            See 4.8.      (line 2989)
-Replace Engine, Menu Item:                     See 3.7.      (line 1270)
-Reporting bugs:                                See 9.        (line 3303)
-Reporting problems:                            See 9.        (line 3303)
-Resign, Menu Item:                             See 3.5.      (line  686)
-resource name, option:                         See 4.6.      (line 2401)
-results, option:                               See 4.3.      (line 1902)
-Retract Move, Menu Item:                       See 3.6.      (line  784)
-reuse, option:                                 See 4.1.      (line 1678)
-reuse2, option:                                See 4.1.      (line 1678)
-reuseFirst, option:                            See 4.1.      (line 1678)
-reuseSecond, option:                           See 4.1.      (line 1678)
-Revert, Menu Item:                             See 3.2.      (line  365)
-Rewind Index after, Menu Item:                 See 3.7.      (line 1246)
-ringBellAfterMoves, option:                    See 4.6.      (line 2428)
-rsh, option:                                   See 4.8.      (line 2984)
-ruleMoves, option:                             See 4.7.      (line 2804)
-ruser, option:                                 See 4.8.      (line 2989)
-sameColorGames, option:                        See 4.1.      (line 1606)
-Save Game Options, Menu Item:                  See 3.7.      (line 1338)
-Save Game, Menu Item:                          See 3.1.      (line  217)
-Save Position, Menu Item:                      See 3.1.      (line  229)
-Save Settings Now, Menu Item:                  See 3.7.      (line 1375)
-Save Settings on Exit, Menu Item:              See 3.7.      (line 1389)
-Save Tourney Games, Menu Item:                 See 3.7.      (line 1238)
-saveGameFile, option:                          See 4.5.      (line 2310)
-saveOutOfBookInfo, option:                     See 4.5.      (line 2353)
-savePositionFile, option:                      See 4.5.      (line 2335)
-saveSettingsFile, option:                      See 4.5.      (line 2371)
-saveSettingsOnExit, option:                    See 4.5.      (line 2391)
-Scores in Move List, Menu Item:                See 3.7.      (line  946)
-scoreWhite, option:                            See 4.6.      (line 2753)
-scp, option:                                   See 4.1.      (line 1615)
-sd, option:                                    See 4.1.      (line 1526)
-Search mode, Menu Item:                        See 3.7.      (line 1309)
-searchDepth, option:                           See 4.1.      (line 1526)
-searchMode, option:                            See 4.8.      (line 3004)
-searchTime, option:                            See 4.1.      (line 1519)
-secondChessProgram, option:                    See 4.1.      (line 1615)
-secondComputerString, option:                  See 4.1.      (line 1670)
-secondDirectory, option:                       See 4.1.      (line 1634)
-secondHasOwnBookUCI, option:                   See 4.2.      (line 1792)
-secondHost, option:                            See 4.1.      (line 1626)
-secondInitString, option:                      See 4.1.      (line 1643)
-secondIsUCI, option:                           See 4.2.      (line 1744)
-secondNeedsNoncompliantFEN, option:            See 4.1.      (line 1720)
-secondNPS, option:                             See 4.1.      (line 1535)
-secondOptions, option:                         See 4.1.      (line 1709)
-secondPgnName, option:                         See 4.2.      (line 1813)
-secondProtocolVersion, option:                 See 4.1.      (line 1687)
-secondScoreAbs, option:                        See 4.1.      (line 1695)
-secondTimeOdds, option:                        See 4.1.      (line 1553)
-secondXBook, option:                           See 4.2.      (line 1792)
-seedBase, option:                              See 4.3.      (line 1942)
-Seek Graph, Menu Item:                         See 3.7.      (line 1122)
-seekGraph, option:                             See 4.4.      (line 2084)
-Select Engine, Menu Item:                      See 3.7.      (line 1202)
-set, ICS command:                              See 5.        (line 3105)
-Settings, Engine:                              See 4.2.      (line 1742)
-SettingsFile, option:                          See 4.5.      (line 2371)
-sg, option:                                    See 4.4.      (line 2084)
-sgf, option:                                   See 4.5.      (line 2310)
-sh, option:                                    See 4.1.      (line 1626)
-Shortcut keys:                                 See 3.9.      (line 1417)
-Show Coords, Menu Item:                        See 3.7.      (line  950)
-Show Engine Output, Menu Item:                 See 3.3.      (line  461)
-Show Evaluation Graph, Menu Item:              See 3.3.      (line  482)
-Show Game List, Menu Item:                     See 3.3.      (line  488)
-Show Last Move, Shortcut Key:                  See 3.9.      (line 1418)
-Show Move History, Menu Item:                  See 3.3.      (line  476)
-Show Target Squares, Menu Item:                See 3.7.      (line  954)
-showButtonBar, option:                         See 4.6.      (line 2525)
-showCoords, option:                            See 4.6.      (line 2495)
-showEvalInMoveHistory, option:                 See 4.6.      (line 2584)
-showTargetSquares, option:                     See 4.6.      (line 2544)
-showThinking, option:                          See 4.1.      (line 1571)
-shuffleOpenings, option:                       See 4.1.      (line 1734)
-size, option:                                  See 4.6.      (line 2453)
-sn, option:                                    See 4.2.      (line 1813)
-sNoOwnBookUCI, option:                         See 4.2.      (line 1792)
-Sound Options, Menu Item:                      See 3.7.      (line 1357)
-soundChallenge, option:                        See 4.4.      (line 2226)
-soundChannel, option:                          See 4.4.      (line 2226)
-soundChannel1, option:                         See 4.4.      (line 2226)
-soundCShout, option:                           See 4.4.      (line 2226)
-soundDirectory, option:                        See 4.4.      (line 2213)
-soundIcsAlarm, option:                         See 4.4.      (line 2235)
-soundIcsDraw, option:                          See 4.4.      (line 2246)
-soundIcsLoss, option:                          See 4.4.      (line 2242)
-soundIcsUnfinished, option:                    See 4.4.      (line 2250)
-soundIcsWin, option:                           See 4.4.      (line 2238)
-soundKibitz, option:                           See 4.4.      (line 2226)
-soundMove, option:                             See 4.4.      (line 2232)
-soundProgram, option:                          See 4.4.      (line 2204)
-soundRequest, option:                          See 4.4.      (line 2226)
-Sounds:                                        See 4.4.      (line 2204)
-soundSeek, option:                             See 4.4.      (line 2226)
-soundShout, option:                            See 4.4.      (line 2226)
-soundSShout, option:                           See 4.4.      (line 2226)
-soundTell, option:                             See 4.4.      (line 2226)
-spf, option:                                   See 4.5.      (line 2335)
-sSAN, option:                                  See 4.6.      (line 2577)
-st, option:                                    See 4.1.      (line 1519)
-Stop Examining, Menu Item:                     See 3.5.      (line  695)
-Stop Observing, Menu Item:                     See 3.5.      (line  690)
-sUCCI, option:                                 See 4.2.      (line 1754)
-sUCI, option:                                  See 4.2.      (line 1744)
-sUSI, option:                                  See 4.2.      (line 1754)
-sweepPromotion, option:                        See 4.6.      (line 2445)
-Sync after cycle, Menu Item:                   See 3.7.      (line 1193)
-Sync after round, Menu Item:                   See 3.7.      (line 1193)
-syncAfterCycle, option:                        See 4.3.      (line 1937)
-syncAfterRound, option:                        See 4.3.      (line 1937)
-Tags, Menu Item:                               See 3.3.      (line  492)
-tc, option:                                    See 4.1.      (line 1496)
-td, option:                                    See 4.5.      (line 2304)
-telnet, option:                                See 4.4.      (line 1977)
-telnetProgram, option:                         See 4.4.      (line 1986)
-Test Legality, Menu Item:                      See 3.7.      (line  961)
-testClaims, option:                            See 4.7.      (line 2780)
-testLegality, option:                          See 4.6.      (line 2449)
-tf, option:                                    See 4.3.      (line 1877)
-thinking, option:                              See 4.1.      (line 1571)
-Time Control, Menu Item:                       See 3.7.      (line  989)
-timeControl, option:                           See 4.1.      (line 1496)
-timeDelay, option:                             See 4.5.      (line 2304)
-timeIncrement, option:                         See 4.1.      (line 1505)
-timeOddsMode, option:                          See 4.1.      (line 1559)
-title, option:                                 See 4.6.      (line 2517)
-titleInWindow, option:                         See 4.6.      (line 2517)
-Tournament file, Menu item:                    See 3.7.      (line 1173)
-Tournament Options:                            See 4.3.      (line 1863)
-Tourney participants, Menu Item:               See 3.7.      (line 1202)
-Tourney type, Menu Item:                       See 3.7.      (line 1213)
-tourneyCycles, option:                         See 4.3.      (line 1891)
-tourneyFile, option:                           See 4.3.      (line 1877)
-tourneyType, option:                           See 4.3.      (line 1885)
-Training, Menu Item:                           See 3.4.      (line  585)
-trivialDraws, option:                          See 4.7.      (line 2793)
-Truncate Game, Menu Item:                      See 3.2.      (line  384)
-tt, option:                                    See 4.3.      (line 1885)
-Two Machines, Menu Item:                       See 3.4.      (line  532)
-Upgrade Engine, Menu Item:                     See 3.7.      (line 1270)
-Upload to Examine, Menu Item:                  See 3.5.      (line  700)
-useBoardTexture, option:                       See 4.6.      (line 2690)
-usePolyglotBook, option:                       See 4.2.      (line 1780)
-User interface options:                        See 4.6.      (line 2397)
-userName, option:                              See 4.8.      (line 2993)
-useTelnet, option:                             See 4.4.      (line 1977)
-uxiAdapter, option:                            See 4.2.      (line 1770)
-variant, option:                               See 4.8.      (line 2834)
-variations, option:                            See 4.6.      (line 2742)
-vars, ICS command:                             See 5.        (line 3102)
-View Menu:                                     See 3.3.      (line  455)
-whitePieceColor, option:                       See 4.6.      (line 2666)
-who, ICS command:                              See 5.        (line 3058)
-xflash, option:                                See 4.6.      (line 2551)
-year, Menu Item:                               See 3.7.      (line 1304)
-Zoom factor in Evaluation Graph, Menu Item:    See 3.7.      (line  984)
+Man XBoard, Menu Item:                         See 3.8.      (line 1512)
+Match Options, Menu Item:                      See 3.7.      (line 1252)
+matchGames, option:                            See 4.1.      (line 1697)
+matchMode, option:                             See 4.1.      (line 1709)
+matchPause, option:                            See 4.3.      (line 2000)
+materialDraws, option:                         See 4.7.      (line 2885)
+mcBookMode, option:                            See 4.2.      (line 1929)
+Menu, Action:                                  See 3.5.      (line  720)
+Menu, Edit:                                    See 3.2.      (line  265)
+Menu, Engine:                                  See 3.6.      (line  785)
+Menu, File:                                    See 3.1.      (line  129)
+Menu, Help:                                    See 3.8.      (line 1504)
+Menu, Mode:                                    See 3.4.      (line  564)
+Menu, Options:                                 See 3.7.      (line  872)
+Menu, View:                                    See 3.3.      (line  475)
+Menus:                                         See 3.        (line  126)
+messageFont, option:                           See 4.6.      (line 2716)
+mg, option:                                    See 4.1.      (line 1697)
+mm, option:                                    See 4.1.      (line 1709)
+Mode Menu:                                     See 3.4.      (line  564)
+mode, option:                                  See 4.8.      (line 2949)
+mono, option:                                  See 4.6.      (line 2653)
+monoMode, option:                              See 4.6.      (line 2653)
+Move Now, Menu Item:                           See 3.6.      (line  849)
+Move Sound, Menu Item:                         See 3.7.      (line  974)
+moves, option:                                 See 4.4.      (line 2258)
+movesound, option:                             See 4.6.      (line 2544)
+movesPerSession, option:                       See 4.1.      (line 1608)
+mps, option:                                   See 4.1.      (line 1608)
+msLoginDelay, option:                          See 4.4.      (line 2185)
+nameOfDebugFile, option:                       See 4.8.      (line 3086)
+narrow, Menu Item:                             See 3.7.      (line 1393)
+ncp, option:                                   See 4.8.      (line 2920)
+New Game, Menu Item:                           See 3.1.      (line  130)
+New Shuffle Game, Menu Item:                   See 3.1.      (line  139)
+New variant, Menu Item:                        See 3.1.      (line  154)
+niceEngines, option:                           See 4.1.      (line 1818)
+noChessProgram, option:                        See 4.8.      (line 2920)
+noGUI, option:                                 See 4.6.      (line 2502)
+null move:                                     See 3.4.      (line  577)
+number of consecutive positions, Menu Item:    See 3.7.      (line 1411)
+Number of tourney cycles, Menu Item:           See 3.7.      (line 1311)
+observe, ICS command:                          See 5.        (line 3231)
+oldmoves, ICS command:                         See 5.        (line 3235)
+oldsave, option:                               See 4.5.      (line 2456)
+oldSaveStyle, option:                          See 4.5.      (line 2456)
+One-Click Moving, Menu Item:                   See 3.7.      (line  983)
+oneClickMove, option:                          See 4.6.      (line 2537)
+onlyOwnGames, option:                          See 4.5.      (line 2414)
+Open Chat Window, Menu Item:                   See 3.3.      (line  538)
+Options:                                       See 4.        (line 1583)
+Options Menu:                                  See 3.7.      (line  872)
+Options, adjudication:                         See 4.7.      (line 2859)
+options, Chess engine:                         See 4.1.      (line 1602)
+Options, ICS:                                  See 4.4.      (line 2081)
+Options, Load and Save:                        See 4.5.      (line 2371)
+Options, miscellaneous:                        See 4.8.      (line 2919)
+Options, Tournament:                           See 4.3.      (line 1994)
+Options, User interface:                       See 4.6.      (line 2495)
+Other programs:                                See 12.       (line 3672)
+overrideLineGap, option:                       See 4.6.      (line 2602)
+pairingEngine, option:                         See 4.3.      (line 2047)
+participants, option:                          See 4.3.      (line 2026)
+Paste Game, Menu Item:                         See 3.2.      (line  291)
+Paste Position, Menu Item:                     See 3.2.      (line  295)
+Pause, Menu Item:                              See 3.4.      (line  694)
+Periodic Updates, Menu Item:                   See 3.7.      (line  995)
+periodic, option:                              See 4.6.      (line 2686)
+periodicUpdates, option:                       See 4.6.      (line 2686)
+pgnEventHeader, option:                        See 4.5.      (line 2443)
+pgnExtendedInfo, option:                       See 4.5.      (line 2438)
+pgnNumberTag, option:                          See 4.5.      (line 2447)
+pid, option:                                   See 4.6.      (line 2731)
+pieceImageDirectory, option:                   See 4.6.      (line 2731)
+pieceMenu, option:                             See 4.6.      (line 2826)
+pieceNickNames, option:                        See 4.8.      (line 3067)
+pieceToCharTable, option:                      See 4.8.      (line 3041)
+Play Move(s) of Clicked PV, Menu Item:         See 3.7.      (line 1001)
+polyglotBook, option:                          See 4.2.      (line 1900)
+polyglotDir, option:                           See 4.2.      (line 1893)
+Ponder Next Move, Menu Item:                   See 3.7.      (line 1009)
+ponder, option:                                See 4.1.      (line 1688)
+ponderNextMove, option:                        See 4.1.      (line 1688)
+Popup Exit Message, Menu Item:                 See 3.7.      (line 1015)
+Popup Move Errors, Menu Item:                  See 3.7.      (line 1021)
+popup, option:                                 See 4.6.      (line 2553)
+popupExitMessage, option:                      See 4.6.      (line 2549)
+popupMoveErrors, option:                       See 4.6.      (line 2553)
+Position Number, Menu Item:                    See 3.7.      (line 1330)
+pre, option:                                   See 4.4.      (line 2274)
+preblack, option:                              See 4.4.      (line 2280)
+Premove Black, Menu Item:                      See 3.7.      (line 1221)
+Premove White, Menu Item:                      See 3.7.      (line 1221)
+Premove, Menu Item:                            See 3.7.      (line 1221)
+premove, option:                               See 4.4.      (line 2274)
+premoveBlack, option:                          See 4.4.      (line 2280)
+premoveBlackText, option:                      See 4.4.      (line 2280)
+premoveHighlightColor, option:                 See 4.6.      (line 2747)
+premoveWhite, option:                          See 4.4.      (line 2280)
+premoveWhiteText, option:                      See 4.4.      (line 2280)
+prewhite, option:                              See 4.4.      (line 2280)
+Problems:                                      See 9.        (line 3404)
+queen, option:                                 See 4.6.      (line 2557)
+Quiet Play, Menu Item:                         See 3.7.      (line 1200)
+quiet, option:                                 See 4.4.      (line 2285)
+quietPlay, option:                             See 4.4.      (line 2285)
+recentEngineList, option:                      See 4.6.      (line 2527)
+recentEngines, option:                         See 4.6.      (line 2527)
+Recently Used Engines, In Menu:                See 3.6.      (line  861)
+Reload CMail Message, Menu Item:               See 3.1.      (line  257)
+Reload Same Game, Menu Item:                   See 3.9.      (line 1537)
+Reload Same Position, Menu Item:               See 3.9.      (line 1542)
+remoteShell, option:                           See 4.8.      (line 3107)
+remoteUser, option:                            See 4.8.      (line 3112)
+Replace Engine, Menu Item:                     See 3.7.      (line 1354)
+Reporting bugs:                                See 9.        (line 3404)
+Reporting problems:                            See 9.        (line 3404)
+Resign, Menu Item:                             See 3.5.      (line  755)
+resource name, option:                         See 4.6.      (line 2499)
+results, option:                               See 4.3.      (line 2033)
+Retract Move, Menu Item:                       See 3.6.      (line  853)
+reuse, option:                                 See 4.1.      (line 1795)
+reuse2, option:                                See 4.1.      (line 1795)
+reuseFirst, option:                            See 4.1.      (line 1795)
+reuseSecond, option:                           See 4.1.      (line 1795)
+Revert, Menu Item:                             See 3.2.      (line  385)
+Rewind Index after, Menu Item:                 See 3.7.      (line 1330)
+ringBellAfterMoves, option:                    See 4.6.      (line 2544)
+rsh, option:                                   See 4.8.      (line 3107)
+ruleMoves, option:                             See 4.7.      (line 2903)
+ruser, option:                                 See 4.8.      (line 3112)
+sameColorGames, option:                        See 4.1.      (line 1713)
+Save Game Options, Menu Item:                  See 3.7.      (line 1425)
+Save Game, Menu Item:                          See 3.1.      (line  224)
+Save Games as Book, Menu Item:                 See 3.1.      (line  245)
+Save Position, Menu Item:                      See 3.1.      (line  236)
+Save Settings Now, Menu Item:                  See 3.7.      (line 1463)
+Save Settings on Exit, Menu Item:              See 3.7.      (line 1496)
+Save Tourney Games, Menu Item:                 See 3.7.      (line 1322)
+saveGameFile, option:                          See 4.5.      (line 2405)
+saveOutOfBookInfo, option:                     See 4.5.      (line 2451)
+savePositionFile, option:                      See 4.5.      (line 2433)
+saveSettingsFile, option:                      See 4.5.      (line 2469)
+saveSettingsOnExit, option:                    See 4.5.      (line 2489)
+Scores in Move List, Menu Item:                See 3.7.      (line 1030)
+scoreWhite, option:                            See 4.6.      (line 2852)
+scp, option:                                   See 4.1.      (line 1722)
+sd, option:                                    See 4.1.      (line 1633)
+se, option:                                    See 4.1.      (line 1734)
+Search mode, Menu Item:                        See 3.7.      (line 1393)
+searchDepth, option:                           See 4.1.      (line 1633)
+searchMode, option:                            See 4.8.      (line 3127)
+searchTime, option:                            See 4.1.      (line 1626)
+secondChessProgram, option:                    See 4.1.      (line 1722)
+secondComputerString, option:                  See 4.1.      (line 1787)
+secondDirectory, option:                       See 4.1.      (line 1752)
+secondEngine, option:                          See 4.1.      (line 1734)
+secondHasOwnBookUCI, option:                   See 4.2.      (line 1909)
+secondHost, option:                            See 4.1.      (line 1744)
+secondInitString, option:                      See 4.1.      (line 1761)
+secondIsUCI, option:                           See 4.2.      (line 1861)
+secondLogo, option:                            See 4.6.      (line 2515)
+secondNeedsNoncompliantFEN, option:            See 4.1.      (line 1837)
+secondNPS, option:                             See 4.1.      (line 1642)
+secondOptions, option:                         See 4.1.      (line 1826)
+secondPgnName, option:                         See 4.2.      (line 1944)
+secondProtocolVersion, option:                 See 4.1.      (line 1804)
+secondScoreAbs, option:                        See 4.1.      (line 1812)
+secondTimeOdds, option:                        See 4.1.      (line 1660)
+secondXBook, option:                           See 4.2.      (line 1909)
+seedBase, option:                              See 4.3.      (line 2073)
+Seek Graph, Menu Item:                         See 3.7.      (line 1206)
+seekGraph, option:                             See 4.4.      (line 2215)
+Select Engine, Menu Item:                      See 3.7.      (line 1286)
+set, ICS command:                              See 5.        (line 3228)
+Settings, Engine:                              See 4.2.      (line 1859)
+SettingsFile, option:                          See 4.5.      (line 2469)
+sg, option:                                    See 4.4.      (line 2215)
+sgf, option:                                   See 4.5.      (line 2405)
+sh, option:                                    See 4.1.      (line 1744)
+Shortcut keys:                                 See 3.9.      (line 1524)
+Show Coords, Menu Item:                        See 3.7.      (line 1034)
+Show Engine Output, Menu Item:                 See 3.3.      (line  481)
+Show Evaluation Graph, Menu Item:              See 3.3.      (line  511)
+Show Game List, Menu Item:                     See 3.3.      (line  517)
+Show Last Move, Shortcut Key:                  See 3.9.      (line 1525)
+Show Move History, Menu Item:                  See 3.3.      (line  505)
+Show Target Squares, Menu Item:                See 3.7.      (line 1038)
+showButtonBar, option:                         See 4.6.      (line 2639)
+showCoords, option:                            See 4.6.      (line 2609)
+showEvalInMoveHistory, option:                 See 4.6.      (line 2698)
+showTargetSquares, option:                     See 4.6.      (line 2658)
+showThinking, option:                          See 4.1.      (line 1678)
+shuffleOpenings, option:                       See 4.1.      (line 1851)
+size, option:                                  See 4.6.      (line 2569)
+sn, option:                                    See 4.2.      (line 1944)
+sNoOwnBookUCI, option:                         See 4.2.      (line 1909)
+Sound Options, Menu Item:                      See 3.7.      (line 1445)
+soundChallenge, option:                        See 4.4.      (line 2340)
+soundChannel, option:                          See 4.4.      (line 2340)
+soundChannel1, option:                         See 4.4.      (line 2340)
+soundCShout, option:                           See 4.4.      (line 2340)
+soundDirectory, option:                        See 4.4.      (line 2327)
+soundIcsAlarm, option:                         See 4.4.      (line 2349)
+soundIcsDraw, option:                          See 4.4.      (line 2360)
+soundIcsLoss, option:                          See 4.4.      (line 2356)
+soundIcsUnfinished, option:                    See 4.4.      (line 2364)
+soundIcsWin, option:                           See 4.4.      (line 2352)
+soundKibitz, option:                           See 4.4.      (line 2340)
+soundMove, option:                             See 4.4.      (line 2346)
+soundProgram, option:                          See 4.4.      (line 2318)
+soundRequest, option:                          See 4.4.      (line 2340)
+Sounds:                                        See 4.4.      (line 2318)
+soundSeek, option:                             See 4.4.      (line 2340)
+soundShout, option:                            See 4.4.      (line 2340)
+soundSShout, option:                           See 4.4.      (line 2340)
+soundTell, option:                             See 4.4.      (line 2340)
+spf, option:                                   See 4.5.      (line 2433)
+sSAN, option:                                  See 4.6.      (line 2691)
+st, option:                                    See 4.1.      (line 1626)
+Stop Examining, Menu Item:                     See 3.5.      (line  764)
+Stop Observing, Menu Item:                     See 3.5.      (line  759)
+sUCCI, option:                                 See 4.2.      (line 1871)
+sUCI, option:                                  See 4.2.      (line 1861)
+sUSI, option:                                  See 4.2.      (line 1871)
+sweepPromotion, option:                        See 4.6.      (line 2561)
+Sync after cycle, Menu Item:                   See 3.7.      (line 1277)
+Sync after round, Menu Item:                   See 3.7.      (line 1277)
+syncAfterCycle, option:                        See 4.3.      (line 2068)
+syncAfterRound, option:                        See 4.3.      (line 2068)
+Tags, Menu Item:                               See 3.3.      (line  521)
+tc, option:                                    See 4.1.      (line 1603)
+td, option:                                    See 4.5.      (line 2399)
+telnet, option:                                See 4.4.      (line 2108)
+telnetProgram, option:                         See 4.4.      (line 2117)
+Test Legality, Menu Item:                      See 3.7.      (line 1045)
+testClaims, option:                            See 4.7.      (line 2879)
+testLegality, option:                          See 4.6.      (line 2565)
+tf, option:                                    See 4.3.      (line 2008)
+thinking, option:                              See 4.1.      (line 1678)
+Time Control, Menu Item:                       See 3.7.      (line 1073)
+timeControl, option:                           See 4.1.      (line 1603)
+timeDelay, option:                             See 4.5.      (line 2399)
+timeIncrement, option:                         See 4.1.      (line 1612)
+timeOddsMode, option:                          See 4.1.      (line 1666)
+title, option:                                 See 4.6.      (line 2631)
+titleInWindow, option:                         See 4.6.      (line 2631)
+Tournament file, Menu item:                    See 3.7.      (line 1257)
+Tournament Options:                            See 4.3.      (line 1994)
+Tourney participants, Menu Item:               See 3.7.      (line 1286)
+Tourney type, Menu Item:                       See 3.7.      (line 1297)
+tourneyCycles, option:                         See 4.3.      (line 2022)
+tourneyFile, option:                           See 4.3.      (line 2008)
+tourneyOptions, option:                        See 4.8.      (line 2940)
+tourneyType, option:                           See 4.3.      (line 2016)
+Training, Menu Item:                           See 3.4.      (line  654)
+trivialDraws, option:                          See 4.7.      (line 2892)
+trueColors, option:                            See 4.6.      (line 2776)
+Truncate Game, Menu Item:                      See 3.2.      (line  404)
+tt, option:                                    See 4.3.      (line 2016)
+Two Machines, Menu Item:                       See 3.4.      (line  573)
+Upgrade Engine, Menu Item:                     See 3.7.      (line 1354)
+Upload to Examine, Menu Item:                  See 3.5.      (line  769)
+useBoardTexture, option:                       See 4.6.      (line 2783)
+usePolyglotBook, option:                       See 4.2.      (line 1897)
+User interface options:                        See 4.6.      (line 2495)
+userName, option:                              See 4.8.      (line 3116)
+useTelnet, option:                             See 4.4.      (line 2108)
+uxiAdapter, option:                            See 4.2.      (line 1887)
+variant, option:                               See 4.8.      (line 2957)
+variations, option:                            See 4.6.      (line 2835)
+vars, ICS command:                             See 5.        (line 3225)
+View Menu:                                     See 3.3.      (line  475)
+viewer, option:                                See 4.8.      (line 2926)
+viewerOptions, option:                         See 4.8.      (line 2926)
+whitePieceColor, option:                       See 4.6.      (line 2747)
+who, ICS command:                              See 5.        (line 3181)
+xflash, option:                                See 4.6.      (line 2665)
+year, Menu Item:                               See 3.7.      (line 1388)
+Zoom factor in Evaluation Graph, Menu Item:    See 3.7.      (line 1068)
 Table of Contents
 *****************
 
diff --git a/manual/xboard.txt.gz b/manual/xboard.txt.gz
index 834a36b..42bdfeb 100644
Binary files a/manual/xboard.txt.gz and b/manual/xboard.txt.gz differ