-void TimeManager::init(const Search::LimitsType& limits, int currentPly, Color us)
-{
- /* We support four different kinds of time controls:
+/// init() is called at the beginning of the search and calculates the allowed
+/// thinking time out of the time control and current game ply. We support four
+/// different kinds of time controls, passed in 'limits':
+///
+/// inc == 0 && movestogo == 0 means: x basetime [sudden death!]
+/// inc == 0 && movestogo != 0 means: x moves in y minutes
+/// inc > 0 && movestogo == 0 means: x basetime + z increment
+/// inc > 0 && movestogo != 0 means: x moves in y minutes + z increment