Fix multi-leg promotions
[xboard.git] / zippy.README
index acedb9d..065fb74 100644 (file)
@@ -1,6 +1,5 @@
 Zippy README file
 For version xboard/WinBoard 4.2.4 and later only
-$Id: zippy.README,v 2.3 2003/11/17 07:39:44 mann Exp $
 -----------------------------------------------------
 
 Zippy is a program that lets GNU Chess act as a computer player on an
@@ -51,7 +50,7 @@ tends to work poorly because it is dull when shouted in isolated
 
 * * *
 
-Unix: To build the Zippy version of xboard, on most systems just do: 
+Unix: To build the Zippy version of xboard, on most systems just do:
        configure --enable-zippy
        make
 
@@ -127,12 +126,12 @@ NEW OPTIONS
        its sayings file.  You can alias this to whatever you like.
        If XXX is censoring you, he is automatically removed from your
        notify list.
-       
+
        (3) If a player XXX in your notify list logs off, xboard sends
-       the command "farewell XXX" to ICS.  You can alias this to 
+       the command "farewell XXX" to ICS.  You can alias this to
        whatever you like.  Note that the player is already gone, so
        telling him something is futile.
-       
+
        If zippyTalk is on, colorization in the ICS interaction
        window, and the sounds corresponding to colors in that window,
        do not work.  The reply feature captures the tells, etc.,
@@ -224,9 +223,12 @@ NEW OPTIONS
         does not work.  Instead, use the -zippyGameEnd option to have
         a string of several commands sent, with newlines in between.
         For example, you could give WinBoard the command line option
-          -zippyGameEnd='say thanks\nseek 5 0\nseek 2 12\n'
-        You could give xboard the command line option
-          -xrm '*zippyGameEnd: say thanks\nseek 5 0\nseek 2 12\n'
+          -zippyGameEnd=\"say thanks\\nseek 5 0\\nseek 2 12\\n\"
+        Note the extra backslashes: these are essential, because the
+        shell will strip them from the command before passing it to
+        XBoard, and XBoard needs to see the quotes (which would
+        otherwise be stripped by the shell as well), because only within
+        quotes it will recognize the \n as a linefeed.
 
   -zippyAdjourn True/False or -zadj/-xzadj
        Zippy will allow its opponent to adjourn if this option is
@@ -261,7 +263,7 @@ NEW OPTIONS
         partner tells to be relayed to the engine with the ptell
         command.
 
-  -zippyMaxGames int 
+  -zippyMaxGames int
   -zippyReplayTimeout
         If zippyMaxGames > 0, Zippy will play at most the given number
        of consecutive games against the same opponent.  Thereafter,
@@ -278,6 +280,15 @@ NEW OPTIONS
        starts a game between Zippy and the first opponent to respond,
        giving Zippy no choice about whether to accept or decline.
 
+  -zippyShortGame int
+        If zippyShortGame > 0, Zippy will decline all challenges
+       from an opponent that terminated a game before the given number
+       of ply (with an explanatory tell) until either someone else has
+       played or zippyReplayTimeout seconds have elapsed. Do not set
+       the number of moves to large; the number of ply during which
+       opponents can abort a game without rating change would be a
+       good setting. Default: zippyShortGame=0.
+
 =====================
 ENVIRONMENT VARIABLES
 =====================