X-Git-Url: http://winboard.nl/cgi-bin?a=blobdiff_plain;f=engine-intf.html;h=058f14755665abffa4c473dd43720876e274f409;hb=a47dabb3f4384723d696aaf26d5ce87b35df533f;hp=4f4af46779274c342d1450582bdde4abe6391f58;hpb=7b022c2db89d4b4454a4f74ca6e66d59f782e6f9;p=xboard.git
diff --git a/engine-intf.html b/engine-intf.html
index 4f4af46..058f147 100644
--- a/engine-intf.html
+++ b/engine-intf.html
@@ -1591,11 +1591,23 @@ The PIECETOCHAR element would ensure a Bishop would not be accepted as promotion
piece ID PIECEDESC
-This command is already reserved for future protocol extension.
-The engine can send it in response to a variant command in order to specify that the piece
-indicated by its pieceToChar letter ID moves in a non-standard way in this variant.
-(This to enable the GUI to reliably perform made detection, and produce good SAN.)
-The format of PIECEDESC is subject to future specification.
+The engine can send one or more piece commands
+in response to a variant command, in order to specify that the piece
+indicated by ID moves in a non-standard way in this variant.
+(This to enable the GUI to reliably perform mate detection, and produce good SAN.)
+Like in FEN the ID is a case-sensitive letter, specifying the color.
+When it is a capital suffixed by &, the description is valid for both colors.
+PIECEDESC describes the moves in 'Betza notation',
+basically a concatenation of one-letter (upper-case) codes for all of its moves.
+These codes can be prefixed with lower-case 'modifiers' to indicate directional sub-sets
+(combinations of fblrvs, if the piece is not totally symmetric),
+move modality (non-capture, capture, e.p. capture; mce),
+and whether the move can jump directly to its destination,
+or can be blocked (n).
+Moves only valid for a virgin piece are prefixed by 'i'.
+An optional numeric suffix on the move indicates the maximum number of times
+the move can be repeated in the same direction,
+to indicate sliders / riders (with the convention 0 = infinite).