Documentation: describe how to "bisect skip" a range of commits

Signed-off-by: Christian Couder <chriscool@tuxfamily.org>

diff --git a/Documentation/git-bisect.txt b/Documentation/git-bisect.txt
index 39034ec7d6dff42f4be282c4216a7e13ff255d91..147ea381977a459f1fa624408cc3af3e9b9f3bd5 100644 (file)
--- a/Documentation/git-bisect.txt
+++ b/Documentation/git-bisect.txt
@@ -19,7 +19,7 @@ on the subcommand:
  git bisect start [<bad> [<good>...]] [--] [<paths>...]
  git bisect bad [<rev>]
  git bisect good [<rev>...]
  git bisect start [<bad> [<good>...]] [--] [<paths>...]
  git bisect bad [<rev>]
  git bisect good [<rev>...]

- git bisect skip [<rev>...]
+ git bisect skip [(<rev>|<range>)...]

  git bisect reset [<branch>]
  git bisect visualize
  git bisect replay <logfile>
  git bisect reset [<branch>]
  git bisect visualize
  git bisect replay <logfile>


@@ -164,6 +164,25 @@ But computing the commit to test may be slower afterwards and git may
 eventually not be able to tell the first bad among a bad and one or
 more "skip"ped commits.
 
 eventually not be able to tell the first bad among a bad and one or
 more "skip"ped commits.
 

+You can even skip a range of commits, instead of just one commit,
+using the "'<commit1>'..'<commit2>'" notation. For example:
+
+------------
+$ git bisect skip v2.5..v2.6
+------------
+
+would mean that no commit between `v2.5` excluded and `v2.6` included
+can be tested.
+
+Note that if you want to also skip the first commit of a range you can
+use something like:
+
+------------
+$ git bisect skip v2.5 v2.5..v2.6
+------------
+
+and the commit pointed to by `v2.5` will be skipped too.
+

 Cutting down bisection by giving more parameters to bisect start
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Cutting down bisection by giving more parameters to bisect start
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

diff --git a/git-bisect.sh b/git-bisect.sh
index ddbdba8af1e75e22630a3077830edf1175ce4027..17a35f6adc79480d0533a4ff98b2817c836a7e78 100755 (executable)
--- a/git-bisect.sh
+++ b/git-bisect.sh
@@ -9,7 +9,7 @@ git bisect bad [<rev>]
         mark <rev> a known-bad revision.
 git bisect good [<rev>...]
         mark <rev>... known-good revisions.
         mark <rev> a known-bad revision.
 git bisect good [<rev>...]
         mark <rev>... known-good revisions.

-git bisect skip [<rev>...]
+git bisect skip [(<rev>|<range>)...]

         mark <rev>... untestable revisions.
 git bisect next
         find next bisection to test and check it out.
         mark <rev>... untestable revisions.
 git bisect next
         find next bisection to test and check it out.