Update ChageLog and README
authorH.G.Muller <hgm@hgm-xboard.(none)>
Fri, 10 Oct 2014 10:17:03 +0000 (12:17 +0200)
committerH.G.Muller <hgm@hgm-xboard.(none)>
Fri, 10 Oct 2014 12:41:11 +0000 (14:41 +0200)
ChangeLog
README

index 6a87077..49caed5 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,8 +1,17 @@
+=========2.0.2==================
+- The Polyglot Affinity option was activated to set the proces affinity mask on Windows, and turned into a string option to allow it to be given in hexadecimal.
+- The makefile for building with MSVC was repaired, and several docs updated.
+- The default name for engines that do not emit an "id name" was changed to "unknown".
+- Fail-low and fail-high info provided by the engine is realyed in thinking output as trailing ? and ! on the PV.
+- The UCI option SyzygyPath is recognized as special, and connected to the XBoard 'egtpath' command.
+- Tablebase hits, selective depth and nodes/sec can be shown in thinking output, subject to the Polyglot option ShowTbHits.
+- XBoard commands wrapped as info strings ("info string xboard XXX") will now be passed to the GUI (as "XXX").
+- Hash size is now capped at the engine-specified maximum, even when the XBoard memory command allows more tha that.
 - The exclude-moves feature now fully supports the WB protocol extension for this (exclude MOVE|all, include MOVE|all).
 =========2.0.1==================
-- This is the first of a fork initiated by HGM. It starts by reverting the previous book-learning change, as the reasons for it seem invalid. Peopl do not use book learning for making better opening books, but for adapting a book to one specific engine, and provide diversity in on-line play, to prevent human opponents from exploiting a likely line they once won by repeating it again and again.
+- This is the first of a fork initiated by HGM. It starts by reverting the previous book-learning change, as the reasons for it seem invalid. People do not use book learning for making better opening books, but for adapting a book to one specific engine, and provide diversity in on-line play, to prevent human opponents from exploiting a likely line they once won by repeating it again and again.
 - Polyglot was now also made to use the learn info it updates, for promoting diversity and avoidance of lines with a poor result record.
-- An option to refrain from resigning while you till have a Queen (QueenNeverResigns) was added
+- An option to refrain from resigning while you still have a Queen (QueenNeverResigns) was added
 - Option to accept draw offers (HandleDraws and ContemptScore) were added.
 - A first onset towards an exclude-moves feature was made.
 ========1.4.67b=================
diff --git a/README b/README
index 339c1f4..3ea6a20 100644 (file)
--- a/README
+++ b/README
@@ -32,8 +32,7 @@ SYNOPSIS
        polyglot perft [-fen fen] [-max-depth depth]
 
 DESCRIPTION
-       PolyGlot as adapter and book engine
-
+   PolyGlot as adapter and book engine
        PolyGlot is a "UCI adapter".  It connects a GUI interface (such as
        XBoard, Winboard, Arena or Chessbase) to a UCI chess engine.
 
@@ -64,13 +63,12 @@ DESCRIPTION
        NOTE: Not all options are exported, only those that make sense in the
        given mode.
 
-       Book making utilities
-
+   Book making utilities
        PolyGlot supports the "PolyGlot opening book format". This is the
        defacto standard non-proprietary opening book format. It is fully
        documented here
 
-       http://alpha.uhasselt.be/Research/Algebra/Toga/book_format.html
+       http://hgm.nubati.net/book_format.html
 
        Roughly speaking a PolyGlot opening book is a collection of triples
        (position, move, weight). A "position" is represented by a 64-bit
@@ -111,14 +109,12 @@ DESCRIPTION
        Due to the possibility of transpositions this is not a fool proof
        method.
 
-       Epd test mode
-
+   Epd test mode
        In epd test mode, PolyGlot will search positions in an epd file and
        record the number of times the right best move was found.  The
        arguments specify when to stop the search in any given position.
 
-       Perft counts
-
+   Perft counts
        A perft count is the number of legal move sequence in a given position
        up to a given depth. PolyGlot can perform such perft counts. It is
        however much slower than other more dedicated programs.
@@ -159,8 +155,7 @@ OPTIONS
 
        When invoked as
 
-       polyglot make-book
-
+   polyglot make-book
        PolyGlot supports the following options
 
        -pgn (default: "book.pgn")
@@ -193,8 +188,7 @@ OPTIONS
 
        When invoked as
 
-       polyglot merge-book
-
+   polyglot merge-book
        PolyGlot supports the following options
 
        -in1
@@ -212,8 +206,7 @@ OPTIONS
 
        When invoked as
 
-       polyglot dump-book
-
+   polyglot dump-book
        PolyGlot supports the following options
 
        -bin (default: book.bin)
@@ -227,8 +220,7 @@ OPTIONS
 
        When invoked as
 
-       polyglot info-book
-
+   polyglot info-book
        PolyGlot supports the following options
 
        -bin (default: book.bin)
@@ -240,8 +232,7 @@ OPTIONS
 
        When invoked as
 
-       polyglot epd-test
-
+   polyglot epd-test
        (possibly with a config file as first argument) PolyGlot supports
        besides the generic options described above the following additional
        options.
@@ -267,8 +258,7 @@ OPTIONS
 
        When invoked as
 
-       polyglot perft
-
+   polyglot perft
        PolyGlot supports the following options
 
        -fen (default: starting position)
@@ -297,8 +287,7 @@ CONFIG FILE FORMAT
        "Quoting" other characters in this way has no effect. In particular the
        use of '\' as a path separator in windows should normally not affected.
 
-       [PolyGlot] section
-
+   [PolyGlot] section
        This section is used by PolyGlot only.  The engine is unaware of these
        options.  The list of available options is detailed below.
 
@@ -357,12 +346,30 @@ CONFIG FILE FORMAT
            This is the score in centipawns that will trigger resign
            "counting".
 
+       QueenNeverResigns (default: true)
+           Suppresses resigning irrespective of the score, as long as the
+           engine still has a Queen (hoping for a perpetual).
+
+       HandleDraws (default: false)
+           When set Polyglot can accept draw offers on behalf of the engine,
+           when the last reported engine score is below Polyglot's contempt.
+
+       ContemptScore (default: 30)
+           This is the score in centipawns that the engine must minimally see
+           in its own disadvantage before Polyglot will accept a draw offer.
+
        ShowPonder (default: true)
            Show search information during engine pondering.  Turning this off
            might be better for interactive use in some interfaces.
 
+       ShowTbHits (default: false)
+           Reports extra info on selective depth, search speed (knps) and
+           tablebase hits at the beginning of the PV field in the thinking
+           output of WinBoard protocol, just before the real PV.
+
        ScoreWhite (default: true)
-           Report score from white's point of view in xboard mode.
+           Report score from white's point of view in xboard mode. (Wrecks
+           XBoard...).
 
        KibitzMove (default: false)
            Whether to kibitz when playing a move.
@@ -410,7 +417,15 @@ CONFIG FILE FORMAT
            move with the highest weight is selected.
 
        BookLearn (default: false)
-           This is a noop.
+           Switches on updating of the 'learn fields' of the opening book,
+           which for each move record the number of times the move was played,
+           and the number of half-points scored with it.  It also switches on
+           making use of this information already in the book, for altering
+           the move-selection probabilities from those specified by the book
+           weights.  (Rarely played moves will be favored, moves with a
+           significant poor performance will be shunned.)  This option must be
+           set before the book is specified, or the updating of the learn info
+           will not work!
 
        BookDepth (default: 256)
            Stop using the book after this number of moves.
@@ -445,8 +460,7 @@ CONFIG FILE FORMAT
            If true then PolyGlot restricts the options it sends to those that
            are potentially useful for WinBoard.
 
-       Work arounds
-
+   Work arounds
        Work arounds are identical to options except that they should be used
        only when necessary.  Their purpose is to try to hide problems with
        various software (not just engines).
@@ -489,8 +503,7 @@ CONFIG FILE FORMAT
            to the way kibitzing is implemented, KibitzMove is disabled in that
            case.
 
-       [Engine] section
-
+   [Engine] section
        This section contains engine UCI options.  PolyGlot does not understand
        them, but sends the information to the engine at startup (converted to
        UCI form).  You can add any UCI option that makes sense to the engine
@@ -505,6 +518,9 @@ CONFIG FILE FORMAT
            Hash
            NalimovPath
            NalimovCache
+           GaviotaPath
+           GaviotaCache
+           SyzygyPath
            OwnBook
 
        Hidden options like "Ponder" or "UCI_xxx" are automatic and should not
@@ -568,4 +584,4 @@ SEE ALSO
 
 
 
-                                  2011-06-01                       POLYGLOT(6)
+                                  2014-09-08                       POLYGLOT(6)