hg bisect [-gbsr] [-U] [-c КОМАНДА] [РЕВИЗИЯ]

поиск ревизии методом деления пополам

Эта команда полезна при поиске ревизии, в которой была внесена ошибка. Для этого самая ранняя ревизия, про которую известно, что она содержит ошибку, помечается как плохая, после чего самая поздняя ревизия, не содержащая эту ошибку, помечается как хорошая. Bisect обновит рабочий каталог до ревизии для тестирования (если не указан -U/--update). После того, как тесты проведены, ревизия помечается как хорошая или плохая в зависимости от результата, и bisect либо обновит каталог до новой ревизии-кандидата, либо объявит, что нашел плохую ревизию.

Для краткости можно также использовать номер ревизии в качестве параметра, чтобы пометить ревизию как плохую или хорошую, не обновляя до нее предварительно рабочий каталог.

Если вы укажите команду, она будет использована для автоматической бисекции. Переменная окружения HG_NODE будет содержать ID тестируемой ревизии. Код возврата команды будет использован чтобы пометить ревизию как плохую или хорошую: код 0 - хорошая, код 125 означает пропустить ревизию, 127 (команда не найдена) отменяет поиск, любой другой код возврата означает плохую ревизию.

Несколько примеров:

• начать бисекцию с известной плохой ревизией 34, хорошей 12:

  hg bisect --bad 34
  hg bisect --good 12
  

• продвинуть текущую бисекцию, пометив текущую ревизию как плохую или хорошую:

  hg bisect --good
  hg bisect --bad
  

• пометить текущую или известную ревизию для пропуска (например, потому что ее нельзя использовать из-за другой проблемы):

  hg bisect --skip
  hg bisect --skip 23
  

• пропустить все ревизии, которые не затрагивают директории "foo" или "bar":

  hg bisect --skip "!( file('path:foo') & file('path:bar') )"
  

• забыть текущую бисекцию:

  hg bisect --reset
  

• использовать команду 'make && make tests' для автоматического поиска первой нерабочей ревизии:

  hg bisect --reset
  hg bisect --bad 34
  hg bisect --good 12
  hg bisect --command "make && make tests"
  

• посмотреть все наборы изменений, чьи состояния уже известны в текущей бисекции:

  hg log -r "bisect(pruned)"
  

• посмотреть ревизию, над которой в данный момент выполняется бисекция (особенно полезно при запуске с -U/--noupdate):

  hg log -r "bisect(current)"
  

• посмотреть все наборы изменений, которые участвовали в текущей бисекции:

  hg log -r "bisect(range)"
  

• вы даже можете получить симпатичный граф:

  hg log --graph -r "bisect(range)"
  

See 'hg help revisions.bisect' for more about the 'bisect()' predicate.

В случае успеха возвращает 0.

options:

global options ([+] can be repeated):