* modified description to mention chinese chess and other variants
[xboard.git] / manual / html_node / Adjudication-Options.html
1 <html lang="en">
2 <head>
3 <title>Adjudication Options - XBoard</title>
4 <meta http-equiv="Content-Type" content="text/html">
5 <meta name="description" content="XBoard">
6 <meta name="generator" content="makeinfo 4.12">
7 <link title="Top" rel="start" href="index.html#Top">
8 <link rel="up" href="Options.html#Options" title="Options">
9 <link rel="prev" href="User-interface-options.html#User-interface-options" title="User interface options">
10 <link rel="next" href="Other-options.html#Other-options" title="Other options">
11 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
12 <meta http-equiv="Content-Style-Type" content="text/css">
13 <style type="text/css"><!--
14   pre.display { font-family:inherit }
15   pre.format  { font-family:inherit }
16   pre.smalldisplay { font-family:inherit; font-size:smaller }
17   pre.smallformat  { font-family:inherit; font-size:smaller }
18   pre.smallexample { font-size:smaller }
19   pre.smalllisp    { font-size:smaller }
20   span.sc    { font-variant:small-caps }
21   span.roman { font-family:serif; font-weight:normal; } 
22   span.sansserif { font-family:sans-serif; font-weight:normal; } 
23 --></style>
24 </head>
25 <body>
26 <div class="node">
27 <p>
28 <a name="Adjudication-Options"></a>
29 Next:&nbsp;<a rel="next" accesskey="n" href="Other-options.html#Other-options">Other options</a>,
30 Previous:&nbsp;<a rel="previous" accesskey="p" href="User-interface-options.html#User-interface-options">User interface options</a>,
31 Up:&nbsp;<a rel="up" accesskey="u" href="Options.html#Options">Options</a>
32 <hr>
33 </div>
34
35 <h3 class="section">3.6 Adjudication Options</h3>
36
37 <p><a name="index-Options_002c-adjudication-348"></a>
38      <dl>
39 <dt>-adjudicateLossThreshold n<dd><a name="index-adjudicateLossThreshold_002c-option-349"></a>If the given value is non-zero, XBoard adjudicates the game as a loss
40 if both engines agree for a duration of 6 consecutive ply that the score
41 is below the given score threshold for that engine. Make sure the score
42 is interpreted properly by XBoard,
43 using <code>-firstScoreAbs</code> and <code>-secondScoreAbs</code> if needed. 
44 Default: 0 (no adjudication)
45 <br><dt>-adjudicateDrawMoves n<dd><a name="index-adjudicateDrawMoves_002c-option-350"></a>If the given value is non-zero, XBoard adjudicates the game as a draw
46 if after the given number of moves it was not yet decided. Default: 0 (no adjudication)
47 <br><dt>-checkMates true/false<dd><a name="index-checkMates_002c-option-351"></a>If this option is set, XBoard detects all checkmates and stalemates,
48 and ends the game as soon as they occur. 
49 Legality-testing must be switched on for this option to work. 
50 Default: true
51 <br><dt>-testClaims true/false<dd><a name="index-testClaims_002c-option-352"></a>If this option is set, XBoard verifies all result claims made by engines,
52 and those who send false claims will forfeit the game because of it. 
53 Legality-testing must be switched on for this option to work. Default: true
54 <br><dt>-materialDraws true/false<dd><a name="index-materialDraws_002c-option-353"></a>If this option is set, XBoard adjudicates games as draws when there is
55 no sufficient material left to inflict a checkmate. 
56 This applies to KBKB with like bishops (any number, actually), and to KBK, KNK and KK. 
57 Legality-testing must be switched on for this option to work. Default: true
58 <br><dt>-trivialDraws true/false<dd><a name="index-trivialDraws_002c-option-354"></a>If this option is set, XBoard adjudicates games as draws that cannot be
59 usually won without opponent cooperation. This applies to KBKB with unlike bishops,
60 and to KBKN, KNKN, KNNK, KRKR and KQKQ. The draw is called after 6 ply into these end-games,
61 to allow quick mates that can occur in some exceptional positions to be found by the engines. 
62 KQKQ does not really belong in this category, and might be taken out in the future. 
63 (When bitbase-based adjudications are implemented.) 
64 Legality-testing must be on for this option to work. Default: false
65 <br><dt>-ruleMoves n<dd><a name="index-ruleMoves_002c-option-355"></a>If the given value is non-zero, XBoard adjudicates the game as a draw after the given
66 number of consecutive reversible moves. Engine draw claims are always accepted after 50 moves,
67 irrespective of the given value of n. 
68 <br><dt>-repeatsToDraw n<dd>If the given value is non-zero, xboard adjudicates the game as a draw if a position
69 is repeated the given number of times. Engines draw claims are always accepted after 3 repeats,
70 (on the 3rd occurrence, actually), irrespective of the value of n. 
71 Beware that positions that have different castling or en-passant rights do not count
72 as repeats, XBoard is fully e.p. and castling aware! 
73 </dl>
74
75    </body></html>
76