Merge branch 'master' into v4.6.x
[xboard.git] / xboard.texi
index e8cfd3c..ca00599 100644 (file)
@@ -183,9 +183,7 @@ and defers reading and writing of user settings to a user-specific
 file like ~/.xboardrc in the user's home directory.
 
 When XBoard is iconized, its graphical icon is a white knight if
-it is White's turn to move, a black knight if it is Black's turn.  See
-Iconize in @ref{Keys} below if you have problems getting this
-feature to work.
+it is White's turn to move, a black knight if it is Black's turn.
 
 @node Menus
 @chapter Menus, buttons, and keys
@@ -658,6 +656,7 @@ Plays a game between two chess engines.
 The @kbd{Ctrl-T} key is a keyboard equivalent.
 @item Analysis Mode
 @cindex Analysis Mode, Menu Item
+@cindex null move
 XBoard tells the chess engine to start analyzing the current game/position
 and shows you the analysis as you move pieces around.
 The @kbd{Ctrl-A} key is a keyboard equivalent.
@@ -675,18 +674,21 @@ clock to tell XBoard which side moves first.
 
 4. Select Analysis Mode from the Mode Menu to start the analysis.
 
+You can now play legal moves to create follow-up positions for the
+engine to analyze, while the moves will be remembered as a stored game,
+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 @samp{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.
-@item Analyze File
-@cindex Analyze File, Menu Item
-This option lets you load a game from a file (PGN, XBoard format, etc.)
-and analyze it. The @kbd{Ctrl-F} key is a keyboard equivalent.
-When you select this menu item, a pop-up window appears
-and asks for a file name to load.
-If the file contains multiple games, another pop up appears that lets
-you select which game you wish to analyze.
-After a game is loaded, XBoard will start auto-playing the game,
+@item Analyze Game
+@cindex Analyze Game, Menu Item
+This option subjects the currently loaded game to aoutomatic
+analysis by the loaded engine.
+The @kbd{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,
@@ -863,9 +865,10 @@ possible arguments on the engine command line
 (if the engine docs say the engine needs any), 
 and the directory where the engine should look for its files
 (if this cannot be deduced automatically from the specification of the engine executable). 
-You will also have specify (with the aid of checkboxes) if the engine is UCI. 
+You will also have to specify (with the aid of checkboxes) if the engine is UCI. 
 If ‘Add this engine to the list’ is ticked (which it is by default), 
 the engine will be added to the list of installed engines in your settings file, 
+(provided you save the settings!),
 so that next time you can select it from the drop-down list. 
 You can also specify a ‘nickname’, 
 under which the engine will then appear in that drop-down list, 
@@ -1014,13 +1017,6 @@ machines, the score is prefixed by @samp{W} or @samp{B} to indicate
 whether it is showing White's thinking or Black's, and only the thinking
 of the engine that is on move is shown.
 The shifted @kbd{Ctrl-H} key is a keyboard equivalent.
-@itemx Highlight Dragging
-@cindex Highlight Dragging, Menu Item
-If Highlight Dragging is on, and the option -showTargetSquares is also on
-in the settings file, 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.
 @itemx Highlight Last Move
 @cindex Highlight Last Move, Menu Item
 If Highlight Last Move is on, after a move is made, the starting and
@@ -1092,8 +1088,10 @@ If this option is on, XBoard displays algebraic coordinates
 along the board's left and bottom edges.
 @itemx Show Target Squares
 @cindex Show Target Squares, Menu Item
-This option must be on for the @samp{Highlight Dragging} described
-above to work.
+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.
 @itemx Test Legality
 @cindex Test Legality, Menu Item
 If this option is on, XBoard tests whether the moves you try to make
@@ -1117,6 +1115,11 @@ The flash-rate setting determines how rapidly this flashing occurs.
 @cindex Animation Speed, Menu Item
 Determines the duration (in msec) of an animation step,
 when @samp{Animate Moving} is swiched on.
+@itemx Zoom factor in Evaluation Graph
+@cindex Zoom factor in Evaluation Graph, Menu Item
+Sets the valueof the @code{evalZoom} option,
+indicating the factor by which the score interval (-1,1) should be
+blown up on the vertical axis of the Evaluation Graph.
 @item Time Control
 @cindex Time Control, Menu Item
 Pops up a sub-menu where you can set the time-control parameters interactively.
@@ -1318,7 +1321,7 @@ matches between two chess programs
 @itemx Tournament file
 @cindex Tournament file, Menu item
 To run a tournament, XBoard needs a file to record its progress, 
-to resume the tourney when it is interrupted.
+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, 
 (i.e. when you select a list of participants), 
@@ -1362,11 +1365,11 @@ 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. 
 In the latter case, you specify the number of gauntlet engines. 
-E.g. if you specified 10 engine, and tourney type = 2, 
+E.g. if you specified 10 engines, and tourney type = 2, 
 the first 2 engines each play the remaining 8. 
 A value of -1 instructs XBoard to play Swiss; for this to work an external
 pairing engine must be specified through the @code{pairingEngine} option.
-Each Swiss round will be concidered a tourney cycle in that case.
+Each Swiss round will be considered a tourney cycle in that case.
 Default:0
 @itemx Number of tourney cycles
 @itemx Default number of Games
@@ -1392,17 +1395,47 @@ File where the tournament games are saved
 @itemx Rewind Index after
 @cindex Game File with Opening Lines, Menu Item
 @cindex File with Start Positions, Menu Item
-@itemx Game Number, Menu Item
-@itemx Position Number, Menu Item
-@itemx Rewind Index after, Menu Item
+@cindex Game Number, Menu Item
+@cindex Position Number, Menu Item
+@cindex Rewind Index after, Menu Item
 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 automatical stepping through all games on the file,
+Here a value -1 means automatic stepping through all games on the file,
 -2 automatic stepping every two games.
 The Rewind-Index parameter causes a stepping index to reset to one after reaching
 a specified value.
+A setting of -2 for the game number will also be effective in a tournament without
+specifying a game file, but playing from the GUI book instead.
+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.
+@itemx Replace Engine
+@itemx Upgrade Engine
+@cindex Replace Engine, Menu Item
+@cindex Upgrade Engine, Menu Item
+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
+by editing the @samp{participants} field.
+(But preserve the order of the others!)
+Pressing the button after that will cause the substitution.
+With the @samp{Upgrade Engine} button the substitution will only affect future games.
+With @samp{Replace Engine} all games the substituted engine has already played will
+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.
+@itemx Clone Tourney
+@cindex CloneTourney, Menu Item
+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'.
 
 @item Load Game Options
 @cindex Load Game Options, Menu Item
@@ -1410,8 +1443,54 @@ Summons a dialog where you can set the @code{autoDisplayComment} and
 @code{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:
+@itemx Elo of strongest player
+@itemx Elo of weakest player
+@itemx year
+@cindex Elo of strongest player, Menu Item
+@cindex Elo of weakest player, Menu Item
+@cindex year, Menu Item
+These numeric fields set thresholds (lower limits) on the Elo rating of the mentioned player,
+or the date the game was played.
+Defaults: 0
+@itemx Search mode
+@cindex Search mode, Menu Item
+@cindex find position, Menu Item
+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 @samp{find position} button in the Game List.
+You can search for an exact match, 
+a position that has all shown material in the same place, 
+but might contain additional material,
+a position that has all Pawns in the same place,
+but can have the shown material anywhere,
+a position that        can have all shown material anywhere,
+or a position that has material between certain limits anywhere.
+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.
+@itemx number of consecutive positions
+@cindex number of consecutive positions, Menu Item
+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.
+@itemx Also match reversed colors
+@itemx Also match left-right flipped position
+@cindex Also match reversed colors, Menu Item
+@cindex Also match left-right flipped position, Menu Item
+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).
+
 @item Save Game Options
-@cindex ave Game Options, Menu Item
+@cindex Save Game Options, Menu Item
 Summons a dialog where you can specify the files on which XBoard should
 automtically save any played or entered games, 
 (the @code{saveGameFile} option), 
@@ -1506,14 +1585,8 @@ Shows the current XBoard version number.
 @cindex Keys
 @cindex Shortcut keys
 @table @asis
-@item Iconize
-Pressing the @kbd{-} key iconizes XBoard. The graphical
-icon displays a white knight if it is White's move, or a black knight
-if it is Black's move. If your X window manager displays only text
-icons, not graphical ones, check its documentation; there is probably
-a way to enable graphical icons.  If you get black and white reversed,
-we would like to hear about it; see @ref{Problems} below for
-instructions on how to report this problem.
+@item Show last move
+By hitting @kbd{Enter} the last move will be re-animated.
 @item Load Next Game
 @cindex Load Next Game, Menu Item
 Loads the next game from the last game record file you loaded.
@@ -1558,7 +1631,7 @@ BlindfoldProc, BookProc, CallFlagProc, CopyGameProc, CopyPositionProc,
 DebugProc, DeclineProc, DrawProc, EditCommentProc, EditGameProc,
 EditPositionProc, EditTagsProc, EnterKeyProc, FlashMovesProc,
 FlipViewProc, ForwardProc, GetMoveListProc, HighlightLastMoveProc,
-HintProc, Iconify, IcsAlarmProc, IcsClientProc, IcsInputBoxProc,
+HintProc, IcsAlarmProc, IcsClientProc, IcsInputBoxProc,
 InfoProc, LoadGameProc, LoadNextGameProc, LoadNextPositionProc,
 LoadPositionProc, LoadPrevGameProc, LoadPrevPositionProc,
 LoadSelectedProc, MachineBlackProc, MachineWhiteProc, MailMoveProc,
@@ -1580,8 +1653,9 @@ ToStartProc, TrainingProc, TruncateGameProc, and TwoMachinesProc.
 
 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 setting them as X resources
-(typically in your @file{.Xresources} file).  Many of the options
+line you use to start XBoard, or by editing the settings file
+(usually ~/.xboardrc) to alter the value of the setting that was
+saved there.  Some of the options
 cannot be changed while XBoard is running; others set the initial
 state of items that can be changed with the @ref{Options} menu.
 
@@ -1594,15 +1668,6 @@ turn the option off (@samp{-xopt}). For options that take strings or
 numbers as values, you can use the long or short option names
 interchangeably.
 
-Each option corresponds to an X resource with the same name, so
-if you like, you can set options in your @file{.Xresources} file
-or in a file named @file{XBoard} in your home directory.
-For options that have two names, the longer one is the name of
-the corresponding X resource; the short name is not recognized.
-To turn a boolean option on or off as an
-X resource, give its long name followed by the value
-true or false (@samp{XBoard*longOptionName: true}).
-
 @menu
 * Chess engine options::        Controlling the chess engine.
 * UCI + WB Engine Settings::    Setting some very common engine parameters
@@ -1783,9 +1848,10 @@ 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.
-@item -initString string
+@item -initString string or -firstInitString
 @itemx -secondInitString string
 @cindex initString, option
+@cindex firstInitString, option
 @cindex secondInitString, option
 The string that is sent to initialize each chess engine for a new game.
 Default:
@@ -1962,13 +2028,29 @@ and XBoard will select the book moves for it. Default: "".
 @cindex firstXBook, option
 @cindex secondXBook, option
 Indicates if the mentioned engine has its own opening book it should play from,
-rather than using the external book through XBoard. Default: false.
+rather than using the external book through XBoard. 
+Default: depends on setting of the option @code{discourageOwnBooks}.
+@item -discourageOwnBooks true/false
+@cindex discourageOwnBooks, option
+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 @code{firstXBook}).
+Default: false.
+@item -bookDepth n
+@cindex bookDepth, option
+Limits the use of the GUI book to the first n moves of each side.
+Default: 12.
+@item -bookVariation n
+@cindex bookVariation, option
+A value n from 0 to 100 tunes the choice of moves from the GUI books
+from totally random to best-only. Default: 50
 @item -fn string or -firstPgnName string
 @itemx -sn string or -secondPgnName string
-@cindex firstPgnName string, option
-@cindex secondPgnName string, option
-@cindex fn string, option
-@cindex sn string, option
+@cindex firstPgnName, option
+@cindex secondPgnName, option
+@cindex fn, option
+@cindex sn, option
 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, 
@@ -2019,6 +2101,19 @@ To change it, edit your settings file with a plain text editor.
 @cindex Tournament Options
 @cindex Options, Tournament
 @table @asis
+@item -defaultMatchGames n
+@cindex defaultMatchGames, option
+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.
+@item -matchPause n
+@cindex matchPause, option
+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.
 @item -tf filename or -tourneyFile filename
 @cindex tf, option
 @cindex tourneyFile, option
@@ -2073,6 +2168,28 @@ 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.
+@item -afterGame string
+@itemx -afterTourney string
+@cindex afterGame, option
+@cindex afterTourney, option
+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: ""
+@item -syncAfterRound true/false
+@itemx -syncAfterCycle true/false
+@cindex syncAfterRound, option
+@cindex syncAfterCycle, option
+Controls whether different instances of XBoard concurrently running the 
+same tournament will wait for each other.
+Defaults: sync after cycle, but not after round.
+@item -seedBase number
+@cindex seedBase, option
+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.
 @end table
 
 @node ICS options
@@ -2277,14 +2394,11 @@ board immediately.
 This feature is still experimental and largely unfinished.
 There is no animation or highlighting of moves on the secondary board.
 Default: false.
-@item -oneClickMove true/false
-@cindex oneClickMove, option
-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.
+@item -disguisePromotedPieces true/false
+@cindex disguisePromotedPieces, option
+When set promoted Pawns in crazyhouse/bughouse are displayed identical
+to primordial pieces of the same type, rather than distinguishable.
+Default: true.
 @item -moves/-xmoves or -getMoveList true/false
 @cindex moves, option
 @cindex getMoveList, option
@@ -2305,19 +2419,34 @@ Controls a color change of the board as a warning your time is running out.
 @cindex pre, option
 @cindex premove, option
 Sets the Premove menu option. @xref{Options Menu}. Default: true.
+@item -prewhite/-xprewhite or -premoveWhite
+@itemx -preblack/-xpreblack or -premoveBlack
+@itemx -premoveWhiteText string
+@itemx -premoveBlackText string
+@cindex prewhite, option
+@cindex premoveWhite, option
+@cindex preblack, option
+@cindex premoveBlack, option
+@cindex premoveWhiteText, option
+@cindex premoveBlackText, option
+Set the menu options for specifying the first move for either color. 
+@xref{Options Menu}. Defaults: false and empty strings, so no pre-moves.
 @item -quiet/-xquiet or -quietPlay true/false
 @cindex quiet, option
 @cindex quietPlay, option
 Sets the Quiet Play menu option.  @xref{Options Menu}.  Default: false.
-@item -colorizeMessages or -colorize
+@item -colorizeMessages or -colorize/-xcolorize
 @cindex Colors
 @cindex colorize, option
+@cindex colorizeMessages, option
 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.
 @item -colorShout foreground,background,bold
 @itemx -colorSShout foreground,background,bold
+@itemx -colorCShout foreground,background,bold
 @itemx -colorChannel1 foreground,background,bold
 @itemx -colorChannel foreground,background,bold
 @itemx -colorKibitz foreground,background,bold
@@ -2329,6 +2458,7 @@ supports ISO 6429 escape sequences for changing text colors.
 @cindex Colors
 @cindex colorShout, option
 @cindex colorSShout, option
+@cindex colorCShout, option
 @cindex colorChannel1, option
 @cindex colorChannel, option
 @cindex colorKibitz, option
@@ -2352,6 +2482,7 @@ is assumed; if bold is omitted, 0 is assumed.
 Here is an example of how to set the colors in your @file{.Xresources} file.
 The colors shown here are the default values; you will get
 them if you turn @code{-colorize} on without specifying your own colors.
+CShout is synonymous with SShout.
 
 @example
 xboard*colorizeMessages: true  
@@ -2383,7 +2514,9 @@ This option specifies where XBoard will look for sound files,
 when these are not given as an absolute path name.
 @item -soundShout filename
 @itemx -soundSShout filename
+@itemx -soundCShout filename
 @itemx -soundChannel filename
+@itemx -soundChannel1 filename
 @itemx -soundKibitz filename
 @itemx -soundTell filename
 @itemx -soundChallenge filename
@@ -2391,7 +2524,9 @@ when these are not given as an absolute path name.
 @itemx -soundSeek filename
 @cindex soundShout, option
 @cindex soundSShout, option
+@cindex soundCShout, option
 @cindex soundChannel, option
+@cindex soundChannel1, option
 @cindex soundKibitz, option
 @cindex soundTell, option
 @cindex soundChallenge, option
@@ -2400,6 +2535,7 @@ when these are not given as an absolute path name.
 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.
 @item -soundMove filename
 @cindex soundMove, option
 This sound is used by the Move Sound menu option.  Default: "$".
@@ -2570,6 +2706,10 @@ 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.
+@item -saveSettingsOnExit true/false
+@cindex saveSettingsOnExit, option
+Controls saving of options on the settings file.  @xref{Options Menu}.
+Default: true.
 @end table
 
 @node User interface options
@@ -2580,16 +2720,26 @@ home directory.
 @item -display
 @itemx -geometry
 @itemx -iconic
+@itemx -name
 @cindex display, option
 @cindex geometry, option
 @cindex iconic, option
+@cindex resource name, option
 These and most other standard Xt options are accepted.
 @item -noGUI
 @cindex noGUI, option
 Suppresses all GUI functions of XBoard 
-(to speed up automated ultra-fast engine-engine games, which you don\92t want to watch). 
+(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.
+@item -oneClickMove true/false
+@cindex oneClickMove, option
+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.
 @item -movesound/-xmovesound or -ringBellAfterMoves true/false
 @cindex movesound, option
 @cindex bell, option
@@ -2658,6 +2808,13 @@ If smallLayout is 1 and @code{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.
+@item -overrideLineGap n
+@cindex overrideLineGap, option
+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.
 @item -coords/-xcoords or -showCoords true/false
 @cindex coords, option
 @cindex showCoords, option
@@ -2698,6 +2855,15 @@ 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.
+@item -evalZoom factor
+@cindex evalZoom, option
+The score interval (-1,1) is blown up on the vertical axis of
+the Evaluation Graph by the given factor.
+Default: 1
+@item -evalThreshold n
+@cindex evalThreshold, option
+Score below n (centiPawn) are plotted as 0 in the Evaluation Graph.
+Default: 25
 @item -mono/-xmono or -monoMode true/false
 @cindex mono, option
 @cindex monoMode, option
@@ -2708,8 +2874,7 @@ specify @code{monoMode}; XBoard will determine if it is necessary.
 @cindex showTargetSquares, option
 Determines whether XBoard can highlight the squares a piece has
 legal moves to, when you grab that piece with the mouse.
-If this option is set, this feature can be controlled through
-the Highlight Dragging menu item.
+Default: false.
 @item -flashCount count
 @itemx -flashRate rate
 @itemx -flash/-xflash
@@ -2742,6 +2907,10 @@ Sets the Highlight with Arrow menu option. @xref{Options Menu}. Default: false.
 @cindex blind, option
 @cindex blindfold, option
 Sets the Blindfold menu option.  @xref{Options Menu}.  Default: false.
+@item -periodic/-xperiodic or -periodicUpdates true/false
+@cindex periodic, option
+@cindex periodicUpdates, option
+Controls updating of current move andnode counts in analysis mode. Default: true.
 @item fSAN
 @itemx sSAN
 @cindex fSAN, option
@@ -2751,6 +2920,11 @@ 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.
+@item -showEvalInMoveHistory true/false
+@cindex showEvalInMoveHistory, option
+Controls whether the evaluation scores and search depth of engine moves
+are displayed with the move in the move-history window.
+Default: true.
 @item -clockFont font
 @cindex clockFont, option
 @cindex Font, clock
@@ -2838,6 +3012,7 @@ sets, see @ref{zic2xpm} below.
 @itemx -lightSquareColor color
 @itemx -darkSquareColor color
 @itemx -highlightSquareColor color
+@itemx -preoveHighlightColor color
 @itemx -lowTimeWarningColor color
 @cindex Colors
 @cindex whitePieceColor, option
@@ -2845,6 +3020,7 @@ sets, see @ref{zic2xpm} below.
 @cindex lightSquareColor, option
 @cindex darkSquareColor, option
 @cindex highlightSquareColor, option
+@cindex premoveHighlightColor, option
 @cindex lowTimeWarningColor, option
 Colors to use for the pieces, squares, and square highlights.
 Defaults:
@@ -2870,6 +3046,18 @@ On a grayscale monitor you might prefer:
 -premoveHighlightColor gray70
 -lowTimeWarningColor   gray70
 @end example
+@item -useBoardTexture true/false
+@itemx -liteBackTextureFile filename
+@itemx -darkBackTextureFile filename
+@cindex useBoardTexture, option
+@cindex liteBackTextureFile, option
+@cindex darkBackTextureFile, option
+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 ""
 @item -drag/-xdrag or -animateDragging true/false
 @cindex drag, option
 @cindex animateDragging, option
@@ -2924,6 +3112,11 @@ 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.
+@item -scoreWhite true|false
+@cindex scoreWhite, option
+When true, scores will always be printed from the white point-of-view, 
+rather than the side-to-move point-of-view.
+Default: False.
 @end table
 
 @node Adjudication Options
@@ -3087,8 +3280,8 @@ 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
-@item -pieceToSquareTable string
-@cindex pieceToSquareTable, option
+@item -pieceToCharTable string
+@cindex pieceToCharTable, option
 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 
@@ -3109,6 +3302,23 @@ 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: ""
+@item -pieceNickNames string
+@cindex pieceNickNames, option
+The characters in the string are interpreted the same way as in the
+@code{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: ""
+@item -colorNickNames string
+@cindex colorNickNames, option
+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: ""
 @item -debug/-xdebug or -debugMode true/false
 @cindex debug, option
 @cindex debugMode, option
@@ -3150,6 +3360,22 @@ Default is the login name on your local computer.
 @cindex delayBeforeQuit, option
 @cindex delayAfterQuit, option
 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.
+@item -searchMode n
+@cindex searchMode, option
+The integer n encodes the mode for the @samp{find position} function.
+Default: 1 (= Exact position match)
+@item -eloThresholdBoth elo
+@itemx -eloThresholdAny elo
+@cindex eloThresholdBoth, option
+@cindex eloThresholdAny, option
+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
+@item -dateThreshold year
+@cindex dateThreshold, option
+Only games not played before the given year will be considered when
+searching for a board position
+
 
 @end table
 
@@ -3615,7 +3841,7 @@ odd number of total games is specified.
 A one-word alias for yourself or your opponent.
 @item -wname <full name>
 @itemx -bname <full name>
-@itemx -name <full name>
+@itemx -myname <full name>
 @itemx -oppname <full name>
 The full name of White, Black, yourself or your opponent.
 @item -wna <net address>