Update readme.txt for new position format

[bonanza.git] / readme.txt

diff --git a/readme.txt b/readme.txt
index 4754a5a..c845b0d 100644 (file)
--- a/readme.txt
+++ b/readme.txt
@@ -366,6 +366,13 @@ directory to dump log files.
 5. Command List
 ---------------
 
+- analyze
+    Starts to ponder on the current position, until a command is
+    received. After a 'move', 'undo' command pondering will continue
+    in the new position, while 'excdude', 'include' and 'mpv' will
+    continue analysis of the same position in the new mode. To get out
+    of this mode without side effects, you can use the 'exit' command.
+
 - beep on
 - beep off
     These commands enable (on) or disable (off) a beep when Bonanza
@@ -432,6 +439,13 @@ directory to dump log files.
     becomes effective when DFPN_CLIENT macro is defined in the
     Makefile.
 
+- exclude ['str']
+- include ['str']
+    The move 'str' will be excluded from search in the current
+    position, or included again. The list of excluded move will
+    be cleared as soon as we alter the position by the move, undo,
+    or new command.
+
 - display ['num']
     This command prints the shogi board. If you want to flip the
     board, set 'num' to 2. If not, set it to 1.
@@ -530,6 +544,15 @@ directory to dump log files.
     play a no-handicapped game, set 'str' to "PI" and this is the
     default value. In a handicapped game, specify squares and pieces
     to drop, e.g. "new PI82HI22KA" or "new PI19KY".
+    The argument to 'new' can also start wit 'SU' in stead of 'PI',
+    in which case the mentioned pieces will be added to an empty board,
+    rather than dropped from the initial position. In this case the
+    pieces will be assumed to belong to Sente, untill a '-' in the
+    string will switch to Gote. It is possible to swicth back to Sente
+    by inclusion of a '+' sign. Pieces in hand will be indicated by
+    '00' for their square coordinates.
+    The 'new' command can have a second string argument, '+' or '-',
+    indicating who has the move in the given position.
 
 - peek on
 - peek off
@@ -625,6 +648,10 @@ directory to dump log files.
 - undo
     This command causes the latest move to be taken back.
 
+- xboard
+    Switches Bonanza to using XBoard protocol, rather than the commands
+    described in this list.
+
 - #
     A line beginning with # causes all characters on that line
     to be ignored.