updatd manual, added FAQ

[xboard.git] / manual / html_node / Chess-engine-options.html

diff --git a/manual/html_node/Chess-engine-options.html b/manual/html_node/Chess-engine-options.html
index 727dfdb..bd81af0 100644 (file)
--- a/manual/html_node/Chess-engine-options.html
+++ b/manual/html_node/Chess-engine-options.html
@@ -184,13 +184,23 @@ Important when XBoard uses the score for adjudications, or in PGN reporting.
 so that the generally insatiable hunger for CPU time of chess engines does not interfere so much \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
+<br><dt>-firstOptions string<dt>-secondOptions string<dd><a name="index-firstOptions_002c-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
+<br><dt>-firstNeedsNoncompliantFEN string<dt>-secondNeedsNoncompliantFEN string<dd><a name="index-firstNeedsNoncompliantFEN_002c-option-170"></a><a name="index-secondNeedsNoncompliantFEN_002c-option-171"></a>The castling rights and e.p. fields of the FEN sent to the mentioned engine \r
+with the setboard command will be replaced by the given string. This can for \r
+instance be used to run engines that do not understand Chess960 FENs in \r
+variant fischerandom, to make them at least understand the opening position, \r
+through setting the string to “KQkq -”. (Note you also have to give the e.p. field!) \r
+Other possible applications are to provide work-arounds for engines that want to see \r
+castling and e.p. fields in variants that do not have castling or e.p. \r
+(shatranj, courier, xiangqi, shogi) so that WinBoard would normally omit them \r
+(string = “- -“), or to add variant-specific fields that are not yet supported by WinBoard \r
+(e.g. to indicate the number of checks in 3check).\r
 </dl>
    \r