Man and Info Page Fix

[xboard.git] / engine-intf.html

diff --git a/engine-intf.html b/engine-intf.html
index c04678b..058f147 100644 (file)
--- a/engine-intf.html
+++ b/engine-intf.html
@@ -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,31 @@ 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">The engine can send one or more piece commands\r
+in response to a variant command, in order to specify that the piece\r
+indicated by ID moves in a non-standard way in this variant.\r
+(This to enable the GUI to reliably perform mate detection, and produce good SAN.)\r
+Like in FEN the ID is a case-sensitive letter, specifying the color.\r
+When it is a capital suffixed by &, the description is valid for both colors.\r
+PIECEDESC describes the moves in 'Betza notation',\r
+basically a concatenation of one-letter (upper-case) codes for all of its moves.\r
+These codes can be prefixed with lower-case 'modifiers' to indicate directional sub-sets\r
+(combinations of fblrvs, if the piece is not totally symmetric),\r
+move modality (non-capture, capture, e.p. capture; mce),\r
+and whether the move can jump directly to its destination,\r
+or can be blocked (n).\r
+Moves only valid for a virgin piece are prefixed by 'i'.\r
+An optional numeric suffix on the move indicates the maximum number of times\r
+the move can be repeated in the same direction,\r
+to indicate sliders / riders (with the convention 0 = infinite).\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