GTP MODIFICATIONS IN MATILDA

This file documents the changes to GTP 2 draft 2 commands as implemented, plus
the private command extensions supported.

1. Standard Commands

Reference: http://www.lysator.liu.se/~gunnar/gtp/gtp2-spec-draft2/gtp2-spec.html


boardsize -- the command fails if the board size requested is different than the
value set at compile time. Furthermore, if no argument is given the command
succeeds and returns the current board size.


komi -- the command also accepts no parameters, returning the current komidashi.


loadsgf -- the command fails if the game to be loaded uses a board size
different from the value set at compile time.


final_status_list -- Matilda may prefer playing to passing and, as such, kill
dead groups; when answering this command it will always mark all stones as
alive, not identifying life in seki.



2. Private Commands

2.1 KGS Go Server Commands

References: http://www.gokgs.com/download.jsp
            http://www.gokgs.com/help/timesystems.html

kgs-game_over


kgs-genmove_cleanup


kgs-time_settings



2.2 GNU Go 3.8 Commands

Reference: https://www.gnu.org/software/gnugo/gnugo_19.html

clear_cache


cputime


echo


echo_err


gg-undo


help


printsgf



2.3 GoMill 0.7.4 Commands

Reference: http://mjw.woodcraft.me.uk/gomill/doc/0.7.4/gtp_extensions.html

gomill-cpu_time


gomill-describe_engine



2.4 Matilda Commands

mtld-game_info -- display current game information including the sequence of all
plays, player names and game result if any.
Arguments: none
Fails: never


mtld-last_evaluation -- returns in multi-line format the last full board
evaluation. It may not cover all plays if the last strategy ran only evaluated
part of them.
Arguments: none
Fails: never


mtld-time_left -- exactly the same as the standard time_left command, except for
the time being specified in milliseconds instead of seconds.
Arguments: player color, number of milliseconds remaining in the current period,
number of stones for the current period, or 0 if currently in main time
Fails: syntax error


exit -- alias to quit command.
Arguments: none
Fails: never