updated documentation
[xboard.git] / manual / html_node / Chess-engine-options.html
index eb60662..727dfdb 100644 (file)
@@ -34,164 +34,165 @@ Up:&nbsp;<a rel="up" accesskey="u" href="Options.html#Options">Options</a>
 
 <p><a name="index-options_002c-Chess-engine-113"></a><a name="index-Chess-engine-options-114"></a>
      <dl>
-<dt>-tc or -timeControl minutes[:seconds]<dd><a name="index-tc_002c-option-115"></a><a name="index-timeControl_002c-option-116"></a>Each player begins with his clock set to the <code>timeControl</code> period. 
-Default: 5 minutes. 
-The additional options <code>movesPerSession</code> and <code>timeIncrement</code>
-are mutually exclusive. 
-<br><dt>-mps or -movesPerSession moves<dd><a name="index-mps_002c-option-117"></a><a name="index-movesPerSession_002c-option-118"></a>When both players have made <code>movesPerSession</code> moves, a
-new <code>timeControl</code> period is added to both clocks.  Default: 40 moves. 
-<br><dt>-inc or -timeIncrement seconds<dd><a name="index-inc_002c-option-119"></a><a name="index-timeIncrement_002c-option-120"></a>If this option is specified, <code>movesPerSession</code> is ignored. 
-Instead, after each player's move, <code>timeIncrement</code> seconds are
-added to his clock. 
-Use &lsquo;<samp><span class="samp">-inc 0</span></samp>&rsquo; if you want to require the entire
-game to be played in one <code>timeControl</code> period, with no increment. 
-Default: -1, which specifies <code>movesPerSession</code> mode. 
-<br><dt>-clock/-xclock or -clockMode true/false<dd><a name="index-clock_002c-option-121"></a><a name="index-clockMode_002c-option-122"></a>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 <code>searchTime</code>
-is set, the chess engine still keeps track of the clock time and uses it to
-determine how fast to make its moves. 
-<br><dt>-st or -searchTime minutes[:seconds]<dd><a name="index-st_002c-option-123"></a><a name="index-searchTime_002c-option-124"></a>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. 
-<br><dt>-depth or -searchDepth number<dd><a name="index-sd_002c-option-125"></a><a name="index-searchDepth_002c-option-126"></a>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. 
-<br><dt>-firstNPS number<dt>-secondNPS number<dd><a name="index-firstNPS_002c-option-127"></a><a name="index-secondNPS_002c-option-128"></a>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. 
-Xboard will manage the clocks in accordance with this, relying on the number
-of nodes reported by the engine in its thinking output. If the given number equals zero,
-it can obviously not be used to convert nodes to seconds, and the time reported
-by the engine is used to decrement the XBoard clock in stead. The engine is supposed to
-report in CPU time it uses, rather than wall-clock time, in this mode. This option
-can provide fairer conditions for engine-engine matches on heavily loaded machines,
-or with very fast games (where the wall clock is too inaccurate). 
-<code>showThinking</code> must be on for this option to work. Default: -1 (off). 
-Not many engines might support this yet! 
-<br><dt>-firstTimeOdds factor<dt>-secondTimeOdds factor<dd><a name="index-firstTimeOdds_002c-option-129"></a><a name="index-secondTimeOdds_002c-option-130"></a>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. 
-<br><dt>-timeOddsMode mode<dd><a name="index-timeOddsMode_002c-option-131"></a>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. 
-<br><dt>-hideThinkingFromHuman true/false<dd>Controls the Hide Thinking option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true. 
-(Relaces the Show-Thinking option of older xboard versions.) 
-<br><dt>-thinking/-xthinking or -showThinking true/false<dd><a name="index-thinking_002c-option-132"></a><a name="index-showThinking_002c-option-133"></a>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
-purposes (adjudication, storing in PGN file) the display of it is now controlled
-by the new option Hide Thinking. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false. 
-(But if xboard needs the thinking output for some purpose,
-it makes the engine send it despite the setting of this option.) 
-<br><dt>-ponder/-xponder or -ponderNextMove true/false<dd><a name="index-ponder_002c-option-134"></a><a name="index-ponderNextMove_002c-option-135"></a>Sets the Ponder Next Move menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true. 
-<br><dt>-smpCores number<dd>Specifies the maxmum nmber of CPUs an SMP engine is allowed to use. 
-Only works for engines that support the WinBoard-protocol cores feature. 
-<br><dt>-mg or -matchGames n<dd><a name="index-mg_002c-option-136"></a><a name="index-matchGames_002c-option-137"></a>Automatically runs an n-game match between two chess engines,
-with alternating colors. 
-If the <code>loadGameFile</code> or <code>loadPositionFile</code> option is set,
-XBoard
-starts each game with the given opening moves or the given position;
-otherwise, the games start with the standard initial chess position. 
-If the <code>saveGameFile</code> option is set, a move record for the
-match is appended to the specified file. If the <code>savePositionFile</code>
-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). 
-<br><dt>-mm/-xmm or -matchMode true/false<dd><a name="index-mm_002c-option-138"></a><a name="index-matchMode_002c-option-139"></a>Setting <code>matchMode</code> to true is equivalent to setting
-<code>matchGames</code> to 1. 
-<br><dt>-sameColorGames n<dd><a name="index-sameColorGames_002c-option-140"></a>Automatically runs an n-game match between two chess engines,
-without alternating colors. 
-Otherwise the same applies as for the &lsquo;<samp><span class="samp">-matchGames</span></samp>&rsquo; option,
-over which it takes precedence if both are specified. (See there.) 
-Default: 0 (do not run a match). 
-<br><dt>-fcp or -firstChessProgram program<dd><a name="index-fcp_002c-option-141"></a><a name="index-firstChessProgram_002c-option-142"></a>Name of first chess engine. 
-Default: <samp><span class="file">Fairy-Max</span></samp>. 
-<br><dt>-scp or -secondChessProgram program<dd><a name="index-scp_002c-option-143"></a><a name="index-secondChessProgram_002c-option-144"></a>Name of second chess engine, if needed. 
-A second chess engine is started only in Two Machines (match) mode. 
-Default: <samp><span class="file">Fairy-Max</span></samp>. 
-<br><dt>-fb/-xfb or -firstPlaysBlack true/false<dd><a name="index-fb_002c-option-145"></a><a name="index-firstPlaysBlack_002c-option-146"></a>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. 
-<br><dt>-fh or -firstHost host<dt>-sh or -secondHost host<dd><a name="index-fh_002c-option-147"></a><a name="index-firstHost_002c-option-148"></a><a name="index-sh_002c-option-149"></a><a name="index-secondHost_002c-option-150"></a>Hosts on which the chess engines are to run. The default for
-each is <samp><span class="file">localhost</span></samp>. If you specify another host, XBoard
-uses <samp><span class="file">rsh</span></samp> to run the chess engine there. (You can substitute a
-different remote shell program for rsh using the <code>remoteShell</code>
-option described below.) 
-<br><dt>-fd or -firstDirectory dir<dt>-sd or -secondDirectory dir<dd><a name="index-fd_002c-option-151"></a><a name="index-firstDirectory_002c-option-152"></a><a name="index-sd_002c-option-153"></a><a name="index-secondDirectory_002c-option-154"></a>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. 
-<br><dt>-initString string<dt>-secondInitString string<dd><a name="index-initString_002c-option-155"></a><a name="index-secondInitString_002c-option-156"></a>The string that is sent to initialize each chess engine for a new game. 
-Default:
-
-     <pre class="example">          new
-          random
+<dt>-tc or -timeControl minutes[:seconds]<dd><a name="index-tc_002c-option-115"></a><a name="index-timeControl_002c-option-116"></a>Each player begins with his clock set to the <code>timeControl</code> period.\r
+Default: 5 minutes.\r
+The additional options <code>movesPerSession</code> and <code>timeIncrement</code>\r
+are mutually exclusive.  \r
+<br><dt>-mps or -movesPerSession moves<dd><a name="index-mps_002c-option-117"></a><a name="index-movesPerSession_002c-option-118"></a>When both players have made <code>movesPerSession</code> moves, a\r
+new <code>timeControl</code> period is added to both clocks.  Default: 40 moves.\r
+<br><dt>-inc or -timeIncrement seconds<dd><a name="index-inc_002c-option-119"></a><a name="index-timeIncrement_002c-option-120"></a>If this option is specified, <code>movesPerSession</code> is ignored.\r
+Instead, after each player's move, <code>timeIncrement</code> seconds are\r
+added to his clock.  \r
+Use &lsquo;<samp><span class="samp">-inc 0</span></samp>&rsquo; if you want to require the entire\r
+game to be played in one <code>timeControl</code> period, with no increment.\r
+Default: -1, which specifies <code>movesPerSession</code> mode.\r
+<br><dt>-clock/-xclock or -clockMode true/false<dd><a name="index-clock_002c-option-121"></a><a name="index-clockMode_002c-option-122"></a>Determines whether or not to display the chess clocks. If clockMode is\r
+false, the clocks are not shown, but the side that is to play next\r
+is still highlighted. Also, unless <code>searchTime</code>\r
+is set, the chess engine still keeps track of the clock time and uses it to\r
+determine how fast to make its moves.\r
+<br><dt>-st or -searchTime minutes[:seconds]<dd><a name="index-st_002c-option-123"></a><a name="index-searchTime_002c-option-124"></a>Tells the chess engine to spend at most the given amount of time\r
+searching for each of its moves. Without this option, the chess engine\r
+chooses its search time based on the number of moves and amount\r
+of time remaining until the next time control.\r
+Setting this option also sets clockMode to false.\r
+<br><dt>-depth or -searchDepth number<dd><a name="index-sd_002c-option-125"></a><a name="index-searchDepth_002c-option-126"></a>Tells the chess engine to look ahead at most the given number of moves\r
+when searching for a move to make. Without this option, the chess\r
+engine chooses its search depth based on the number of moves and\r
+amount of time remaining until the next time control.  With the option,\r
+the engine will cut off its search early if it reaches the specified depth.\r
+<br><dt>-firstNPS number<dt>-secondNPS number<dd><a name="index-firstNPS_002c-option-127"></a><a name="index-secondNPS_002c-option-128"></a>Tells the chess engine to use an internal time standard based on its node count, \r
+rather then wall-clock time, to make its timing decisions. \r
+The time in virtual seconds should be obtained by dividing the node count \r
+through the given number, like the number was a rate in nodes per second. \r
+Xboard will manage the clocks in accordance with this, relying on the number \r
+of nodes reported by the engine in its thinking output. If the given number equals zero, \r
+it can obviously not be used to convert nodes to seconds, and the time reported \r
+by the engine is used to decrement the XBoard clock in stead. The engine is supposed to \r
+report in CPU time it uses, rather than wall-clock time, in this mode. This option \r
+can provide fairer conditions for engine-engine matches on heavily loaded machines, \r
+or with very fast games (where the wall clock is too inaccurate). \r
+<code>showThinking</code> must be on for this option to work. Default: -1 (off).\r
+Not many engines might support this yet!\r
+<br><dt>-firstTimeOdds factor<dt>-secondTimeOdds factor<dd><a name="index-firstTimeOdds_002c-option-129"></a><a name="index-secondTimeOdds_002c-option-130"></a>Reduces the time given to the mentioned engine by the given factor. \r
+If pondering is off, the effect is indistinguishable from what would happen \r
+if the engine was running on an n-times slower machine. Default: 1.\r
+<br><dt>-timeOddsMode mode<dd><a name="index-timeOddsMode_002c-option-131"></a>This option determines how the case is handled where both engines have a time-odds handicap. \r
+If mode=1, the engine that gets the most time will always get the nominal time, \r
+as specified by the time-control options, and its opponent's time is renormalized accordingly. \r
+If mode=0, both play with reduced time. Default: 0.\r
+<br><dt>-hideThinkingFromHuman true/false<dd>Controls the Hide Thinking option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
+(Relaces the Show-Thinking option of older xboard versions.)\r
+<br><dt>-thinking/-xthinking or -showThinking true/false<dd><a name="index-thinking_002c-option-132"></a><a name="index-showThinking_002c-option-133"></a>Forces the engine to send thinking output to xboard. \r
+Used to be the only way to control if thinking output was displayed \r
+in older xboard versions,\r
+but as the thinking output in xboard 4.3 is also used for several other\r
+purposes (adjudication, storing in PGN file) the display of it is now controlled\r
+by the new option Hide Thinking. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
+(But if xboard needs the thinking output for some purpose,\r
+it makes the engine send it despite the setting of this option.)\r
+<br><dt>-ponder/-xponder or -ponderNextMove true/false<dd><a name="index-ponder_002c-option-134"></a><a name="index-ponderNextMove_002c-option-135"></a>Sets the Ponder Next Move menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
+<br><dt>-smpCores number<dd>Specifies the maxmum nmber of CPUs an SMP engine is allowed to use.\r
+Only works for engines that support the WinBoard-protocol cores feature.\r
+<br><dt>-mg or -matchGames n<dd><a name="index-mg_002c-option-136"></a><a name="index-matchGames_002c-option-137"></a>Automatically runs an n-game match between two chess engines,\r
+with alternating colors.\r
+If the <code>loadGameFile</code> or <code>loadPositionFile</code> option is set,\r
+XBoard\r
+starts each game with the given opening moves or the given position;\r
+otherwise, the games start with the standard initial chess position.\r
+If the <code>saveGameFile</code> option is set, a move record for the\r
+match is appended to the specified file. If the <code>savePositionFile</code>\r
+option is set, the final position reached in each game of the match is appended\r
+to the specified file. When the match is over, XBoard\r
+displays the match score and exits. Default: 0 (do not run a match).\r
+<br><dt>-mm/-xmm or -matchMode true/false<dd><a name="index-mm_002c-option-138"></a><a name="index-matchMode_002c-option-139"></a>Setting <code>matchMode</code> to true is equivalent to setting\r
+<code>matchGames</code> to 1.\r
+<br><dt>-sameColorGames n<dd><a name="index-sameColorGames_002c-option-140"></a>Automatically runs an n-game match between two chess engines,\r
+without alternating colors.\r
+Otherwise the same applies as for the &lsquo;<samp><span class="samp">-matchGames</span></samp>&rsquo; option,\r
+over which it takes precedence if both are specified. (See there.)\r
+Default: 0 (do not run a match).\r
+<br><dt>-fcp or -firstChessProgram program<dd><a name="index-fcp_002c-option-141"></a><a name="index-firstChessProgram_002c-option-142"></a>Name of first chess engine.\r
+Default: <samp><span class="file">Fairy-Max</span></samp>.\r
+<br><dt>-scp or -secondChessProgram program<dd><a name="index-scp_002c-option-143"></a><a name="index-secondChessProgram_002c-option-144"></a>Name of second chess engine, if needed.\r
+A second chess engine is started only in Two Machines (match) mode.\r
+Default: <samp><span class="file">Fairy-Max</span></samp>.\r
+<br><dt>-fb/-xfb or -firstPlaysBlack true/false<dd><a name="index-fb_002c-option-145"></a><a name="index-firstPlaysBlack_002c-option-146"></a>In games between two chess engines, firstChessProgram normally plays\r
+white.  If this option is true, firstChessProgram plays black.  In a\r
+multi-game match, this option affects the colors only for the first\r
+game; they still alternate in subsequent games.\r
+<br><dt>-fh or -firstHost host<dt>-sh or -secondHost host<dd><a name="index-fh_002c-option-147"></a><a name="index-firstHost_002c-option-148"></a><a name="index-sh_002c-option-149"></a><a name="index-secondHost_002c-option-150"></a>Hosts on which the chess engines are to run. The default for\r
+each is <samp><span class="file">localhost</span></samp>. If you specify another host, XBoard\r
+uses <samp><span class="file">rsh</span></samp> to run the chess engine there. (You can substitute a\r
+different remote shell program for rsh using the <code>remoteShell</code>\r
+option described below.)\r
+<br><dt>-fd or -firstDirectory dir<dt>-sd or -secondDirectory dir<dd><a name="index-fd_002c-option-151"></a><a name="index-firstDirectory_002c-option-152"></a><a name="index-sd_002c-option-153"></a><a name="index-secondDirectory_002c-option-154"></a>Working directories in which the chess engines are to be run.\r
+The default is "", which means to run the chess engine\r
+in the same working directory as XBoard\r
+itself.  (See the CHESSDIR environment variable.)\r
+This option is effective only when the chess engine is being run\r
+on the local host; it does not work if the engine is run remotely\r
+using the -fh or -sh option.\r
+<br><dt>-initString string<dt>-secondInitString string<dd><a name="index-initString_002c-option-155"></a><a name="index-secondInitString_002c-option-156"></a>The string that is sent to initialize each chess engine for a new game.\r
+Default:\r
+\r
+     <pre class="example">          new\r
+          random\r
 </pre>
-     <p class="noindent">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 &lsquo;<samp><span class="samp">\</span></samp>&rsquo; character followed by a newline. It is easier to set
-the option from your <samp><span class="file">.Xresources</span></samp> file; in that case you can
-include the character sequence &lsquo;<samp><span class="samp">\n</span></samp>&rsquo; in the string, and it will
-be converted to a newline.
-
-     <p>If you change this option, don't remove the &lsquo;<samp><span class="samp">new</span></samp>&rsquo;
-command; it is required by all chess engines to
-start a new game.
-
-     <p>You can remove the &lsquo;<samp><span class="samp">random</span></samp>&rsquo; command if you like; including it
-causes GNU Chess 4 to randomize its move selection slightly so that it
-doesn't play the same moves in every game.  Even without
-&lsquo;<samp><span class="samp">random</span></samp>&rsquo;, GNU Chess 4 randomizes its choice of moves from its
-opening book.  Many other chess engines ignore this command entirely
-and always (or never) randomize.
-
-     <p>You can also try adding other commands to the initString; see the
-documentation of the chess engine you are using for details. 
-<br><dt>-firstComputerString string<dt>-secondComputerString string<dd><a name="index-firstComputerString_002c-option-157"></a><a name="index-secondComputerString_002c-option-158"></a>The string that is sent to the chess engine if its opponent is another
-computer chess engine.  The default is &lsquo;<samp><span class="samp">computer\n</span></samp>&rsquo;.  Probably the
-only useful alternative is the empty string (&lsquo;<samp></samp>&rsquo;), which keeps the
-engine from knowing that it is playing another computer. 
-<br><dt>-reuse/-xreuse or -reuseFirst true/false<dt>-reuse2/-xreuse2 or -reuseSecond true/false<dd><a name="index-reuse_002c-option-159"></a><a name="index-reuseFirst_002c-option-160"></a><a name="index-reuse2_002c-option-161"></a><a name="index-reuseSecond_002c-option-162"></a>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),
-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. 
-<br><dt>-firstProtocolVersion version-number<dt>-secondProtocolVersion version-number<dd><a name="index-firstProtocolVersion_002c-option-163"></a><a name="index-secondProtocolVersion_002c-option-164"></a>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. 
-<br><dt>-firstScoreAbs true/false<dt>-secondScoreAbs true/false<dd><a name="index-firstScoreAbs_002c-option-165"></a><a name="index-secondScoreAbs_002c-option-166"></a>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. 
-<br><dt>-niceEngines priority<dd><a name="index-niceEngines_002c-option-167"></a>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 WinBoard (or the rest of your system). 
-Negative values could increase the engine priority, which is not recommended. 
-<br><dt>-firstOptions string<dt>-secondOptions string<dd><a name="index-firstOptions-option-168"></a><a name="index-secondOptions_002c-option-169"></a>The given string is a comma-separated list of (option name, option value) pairs,
-like the following example: “style Karpov, blunder rate 0”. 
-If the options announced by the engine at startup through the feature commands of WinBoard protocol
-matches one of the option names (i.e. “style” or “blunder rate”),
-it would be set to the given value (i.e. “Karpov” or 0)
-through a corresponding option command to the engine. 
-This provided that the type of the value (text or numeric) matches as well. 
+     <p class="noindent">Setting this option from the command line is tricky, because you must\r
+type in real newline characters, including one at the very end.\r
+In most shells you can do this by\r
+entering a &lsquo;<samp><span class="samp">\</span></samp>&rsquo; character followed by a newline. It is easier to set\r
+the option from your <samp><span class="file">.Xresources</span></samp> file; in that case you can\r
+include the character sequence &lsquo;<samp><span class="samp">\n</span></samp>&rsquo; in the string, and it will\r
+be converted to a newline.\r
+\r
+If you change this option, don't remove the &lsquo;<samp><span class="samp">new</span></samp>&rsquo; \r
+command; it is required by all chess engines to\r
+start a new game.\r
+\r
+You can remove the &lsquo;<samp><span class="samp">random</span></samp>&rsquo; command if you like; including it\r
+causes GNU Chess 4 to randomize its move selection slightly so that it\r
+doesn't play the same moves in every game.  Even without\r
+&lsquo;<samp><span class="samp">random</span></samp>&rsquo;, GNU Chess 4 randomizes its choice of moves from its\r
+opening book.  Many other chess engines ignore this command entirely\r
+and always (or never) randomize.\r
+\r
+You can also try adding other commands to the initString; see the\r
+documentation of the chess engine you are using for details.\r
+<br><dt>-firstComputerString string<dt>-secondComputerString string<dd><a name="index-firstComputerString_002c-option-157"></a><a name="index-secondComputerString_002c-option-158"></a>The string that is sent to the chess engine if its opponent is another\r
+computer chess engine.  The default is &lsquo;<samp><span class="samp">computer\n</span></samp>&rsquo;.  Probably the\r
+only useful alternative is the empty string (&lsquo;<samp></samp>&rsquo;), which keeps the\r
+engine from knowing that it is playing another computer.\r
+<br><dt>-reuse/-xreuse or -reuseFirst true/false<dt>-reuse2/-xreuse2 or -reuseSecond true/false<dd><a name="index-reuse_002c-option-159"></a><a name="index-reuseFirst_002c-option-160"></a><a name="index-reuse2_002c-option-161"></a><a name="index-reuseSecond_002c-option-162"></a>If the option is false,\r
+XBoard kills off the chess engine after every game and starts\r
+it again for the next game.  \r
+If the option is true (the default), \r
+XBoard starts the chess engine only once\r
+and uses it repeatedly to play multiple games.\r
+Some old chess engines may not work properly when\r
+reuse is turned on, but otherwise games will start faster if it is left on.\r
+<br><dt>-firstProtocolVersion version-number<dt>-secondProtocolVersion version-number<dd><a name="index-firstProtocolVersion_002c-option-163"></a><a name="index-secondProtocolVersion_002c-option-164"></a>This option specifies which version of the chess engine communication\r
+protocol to use.  By default, version-number is 2.  In version 1, the\r
+"protover" command is not sent to the engine; since version 1 is a\r
+subset of version 2, nothing else changes.  Other values for\r
+version-number are not supported.\r
+<br><dt>-firstScoreAbs true/false<dt>-secondScoreAbs true/false<dd><a name="index-firstScoreAbs_002c-option-165"></a><a name="index-secondScoreAbs_002c-option-166"></a>If this option is set, the score reported by the engine is taken to be \r
+that in favor of white, even when the engine plays black. \r
+Important when XBoard uses the score for adjudications, or in PGN reporting. \r
+<br><dt>-niceEngines priority<dd><a name="index-niceEngines_002c-option-167"></a>This option allows you to lower the priority of the engine processes, \r
+so that the generally insatiable hunger for CPU time of chess engines does not interfere so much \r
+with smooth operation of WinBoard (or the rest of your system). \r
+Negative values could increase the engine priority, which is not recommended.\r
+<br><dt>-firstOptions string<dt>-secondOptions string<dd><a name="index-firstOptions-option-168"></a><a name="index-secondOptions_002c-option-169"></a>The given string is a comma-separated list of (option name, option value) pairs, \r
+like the following example: “style=Karpov,blunder rate=0”. \r
+If the options announced by the engine at startup through the feature commands of WinBoard protocol \r
+matches one of the option names (i.e. “style” or “blunder rate”), \r
+it would be set to the given value (i.e. “Karpov” or 0) \r
+through a corresponding option command to the engine. \r
+This provided that the type of the value (text or numeric) matches as well.\r
 </dl>
+   \r
 
    </body></html>