Reserve piece command in protocol specs
authorH.G.Muller <hgm@hgm-xboard.(none)>
Wed, 10 Sep 2014 17:52:12 +0000 (19:52 +0200)
committerH.G.Muller <hgm@hgm-xboard.(none)>
Wed, 10 Sep 2014 17:52:12 +0000 (19:52 +0200)
engine-intf.html

index c04678b..4f4af46 100644 (file)
@@ -1514,6 +1514,7 @@ terminated by feature done=1.
 (The effect of sending an option feature for an option with the same name as was defined before, \r
 without first receiving a -reset option command, is undefined.)\r
 </span>\r
+</dd>\r
 \r
 <dt class="version47">exclude (boolean, default 0)</dt>\r
 <dd class="version47">\r
@@ -1545,6 +1546,7 @@ in this case, you must set done=1 before xboard will enter normal operation.
 </dd>\r
 </dl>\r
 </dd>\r
+</p>\r
 \r
 <dt>setup FEN</dt>\r
 <dt>setup (PIECETOCHAR) FEN</dt>\r
@@ -1566,8 +1568,8 @@ and any setup commands received from the latter will always be ignored.
 When no initial position is known, such as for 'catch-all' variants like fairy,\r
 or whenever the board width is overruled to a non-standard value,\r
 the FEN will be used as default initial position even when legality testing is on.\r
-</dd>\r
-<dd>Optionally the meaning of the piece ID letters in the FEN can be defined\r
+<p>\r
+Optionally the meaning of the piece ID letters in the FEN can be defined\r
 between parentheses; this will be interpreted as if it was the value of a\r
 -pieceToCharTable command-line option, mapping letters to GUI piece types.\r
 Also optionally behind that, the setup command can specify board width W,\r
@@ -1585,8 +1587,19 @@ could be used by an engine for Los-Alamos Chess in response to 'variant losalamo
 and would automatically switch the GUI to this variant as soon as the user\r
 selected it from the GUI menu.\r
 The PIECETOCHAR element would ensure a Bishop would not be accepted as promotion choice. \r
+</p>\r
 </dd>\r
 \r
+<dt><span class="version48">piece ID PIECEDESC</span></dt>\r
+<dd><span class="version48">This command is already reserved for future protocol extension.\r
+The engine can send it in response to a variant command in order to specify that the piece\r
+indicated by its pieceToChar letter ID moves in a non-standard way in this variant.\r
+(This to enable the GUI to reliably perform made detection, and produce good SAN.)\r
+The format of PIECEDESC is subject to future specification.\r
+</span>\r
+</dd>\r
+</p>\r
+\r
 <dt>Illegal move: MOVE</dt>\r
 <dt>Illegal move (REASON): MOVE</dt>\r
 <dd>If your engine receives a MOVE command that is recognizably a move\r