X-Git-Url: http://winboard.nl/cgi-bin?a=blobdiff_plain;f=data%2Ffmax.ini;h=1eeb76af64a05c49c100a54186e1743e7cfdf638;hb=53a644a2c385aa2476f0d171ce997c818dfb7639;hp=97fbe64043cc8784786f98186fe13715e5232804;hpb=fdf66eac581c8557076faed62f45ef714ded2edd;p=fairymax.git

diff --git a/data/fmax.ini b/data/fmax.ini
index 97fbe64..1eeb76a 100644
--- a/data/fmax.ini
+++ b/data/fmax.ini
@@ -133,11 +133,24 @@ After that follow upto 18 lines with the description.
 Line 1:     Board size (files x ranks). Ranks must currently still be 8.
 Line 2:     initial setup of white pieces on back rank
 Line 3:     initial setup of black pieces on back rank
-Line 4-10:  Description of pieces present in the opening position
-Line 11-18: Description 8 additional piece types
-
-The rest of the lines is ignored, but some pre-cooked descriptions are
-provided for easy copying into the first positions.
+Line 4-18:  Description of piece types that can occur in the variant
+
+There can be upto 15 piece types per variant, numbered 1 to 15.
+Numbers 1 and 2 are considered Pawns for white and black, respectively,
+and the 2nd and 7th rank of the opening setup will be filled with them.
+These pieces will automatically promote to piece number 7 when they 
+reach last rank. So in normal Chess, piece 7 should be programmed as Queen.
+
+Castling can be done only with the original corner piece as specified
+by line 2 and 3. Any royal piece can in principle castle. (Subject to 
+the normal restrictions on castling, i.e. not passing through check etc.)
+If you don't want that, remove the castling moves from the King description. 
+If the castling initiator does not start in a central file, the results are 
+currently undefined.
+
+Most variant definitions can be seen at the end of this file.
+Other lines in this file (i.e. those not recognized as belonging to a
+variant description) are ignored. They can be used for comments.
 
 
 
@@ -153,6 +166,14 @@ The piece-description lines have the following syntax:
    c) the move-mode descriptor, most easily given in hexadecimal, as the
       individual bits specify the various options
 
+The piece indicator character is used to set up positions, and for the
+promotion choice as 5th character of an input move. (Fairy-Max itself
+always promotes to "Queen", i.e. the 7th piece of the list.)
+If more pieces use the same letter, the first one is used for white,
+and the last one for black. If more than two have the same name, the 
+others cannot be indicated at all, but they could still occur in the
+initial setup (where you specify them by number, not letter).
+
 The individual bits in the move-mode descriptor have the following meaning:
 In the last hexadecimal digit:
     1 capture allowed (of enemy piece; own pieces always block a move)
@@ -208,10 +229,6 @@ black Pawn, respectively, or promotions will have undefined effects. Also
 note that uMax does do primitive evaluation of Pawn structure, which might
 become counter-productive if the Pawn move is changed.
 
-Castling is done with the Rook replacement (the piece that starts in the
-corner, whatever its type). If you don't want that, remove the castling
-moves from the King desription. If the castling initiator does not start
-in a central file, the results are currently undefined.
 
 
 For the truly lazy, a few complete game descriptions can be found below: