Gomill

-------------------------

* Make :doc:`playoff tournaments <playoffs>` use control file order when
choosing which matchup to play from next (thanks to Seth Troisi)

* Added the :setting:`skip_player_checks` setting (thanks to Seth Troisi).

* Added the :setting:`sgf_player_name_from_gtp` setting (thanks to Seth
Troisi).

-------------------------

* :ref:`SGF parsing <parsing_details>`: the parser now permits lower-case
letters in *PropIdents*.

* Bug fix: :meth:`.Tree_node.set` didn't check its ``identifier`` parameter
was a well-formed *PropIdent*.

* Made the |gtp| :gtp:`protocol_version` check more lenient: it now
accepts ``2.0`` and similar forms as equivalent to ``2``.

-------------------------

* The :setting:`!candidate_colour` setting
:mc-setting:`[1] <candidate_colour>`
:ce-setting:`[2] <candidate_colour>`
for the Monte Carlo tuner and cross-entropy tuner can now be ``"random"``.

* Bug fix: :ce-setting:`candidate_colour` was being ignored for the
cross-entropy tuner (the candidate always played black).

* Bug fix: :class:`!Game_job_result.engine_descriptions` in 0.8 was using
colours rather than player codes for its keys. The effect was crashes with
``cem_tuner`` and ``mc_tuner``, and mangled player descriptions at the end
of tournament report files.

* Updated documentation to build with Sphinx 1.4

-----------------------

* :ref:`SGF parsing <parsing_details>`: increased the length limit on
*PropIdents* from 8 to 64.

* Reworked the :mod:`~!gomill.gtp_games` interface and implementation,
splitting out the :mod:`~!gomill.gameplay` module and
:class:`!gtp_controllers.Game_controller`. Visible behaviour changes:

* Gomill reports game results, rather than treating games as void, in more
cases when a player exits unexpectedly after the result has been
determined.

* Gomill now ignores |gtp| failure responses from :gtp:`!play` for a
game-ending pass.

* |gtp| :gtp:`!move` commands now send the vertex in upper case.

* Text descriptions of forfeits (eg in :attr:`.Game_result.detail`) have
changed slightly.

Updated the :script:`twogtp` example script to show the new programming
interface. :script:`twogtp` now supports playing multiple games and |sgf|
output.

* Engine comments (from :gtp:`gomill-explain_last_move`) for resignations and
forfeits are now included in |sgf| records.

* Improved player descriptions in |sgf| files and competition reports when the
|gtp| :gtp:`!name` command isn't implemented.

* Added the :attr:`.Game_result.is_unknown` attribute.

* Documented the :attr:`.Game_result.cpu_times` attribute.

* :func:`~.ascii_boards.interpret_diagram` now ignores leading whitespace (it
already ignored trailing whitespace).

* :class:`.Board` methods now raise :exc:`IndexError` for out-of-range
coordinates (previously behaviour was explicitly unspecified).

-------------------------

* Added the :envvar:`GOMILL_GAME_ID` and :envvar:`GOMILL_SLOT` environment
variables.

* :mod:`~!gomill.gtp_games` now permits free-handicap games with the maximum
number of handicap stones permitted by |gtp| (the previous restriction was
one less).

* Bug fix: :meth:`.Board.is_empty()` was wrong after a self-capture which
leaves the board empty.

* Documentation correction: the example in :ref:`using_the_api_in_scripts`
showed :meth:`!Ringmaster.tournament_results` rather than
:meth:`!Ringmaster.get_tournament_results`.

-------------------------

Bug-fix release.

* Made the documentation (index page) build properly with Sphinx v1.1.

* Documentation correction: failure responses from
:setting:`startup_gtp_commands` are not ignored.

* Bug fix: internal scorer with
:setting:`internal_scorer_handicap_compensation` ``"short"`` was off by one in
a non-handicap game.

* Bug fix: :meth:`.Tree_node.new_child` was failing if it was called with an
explicitly-specified index on the root node of an :class:`.Sgf_game` which
was loaded from a string and had not otherwise had its structure modified.