mirrors/git
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Documentation: reworded the "Description" section of git-bisect.txt.

Browse Source 
Added fixes missing from 2364259.

Signed-off-by: David J. Mellor <dmellor@whistlingcat.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
David J. Mellor
2009-03-19 00:00:12 -07:00
committed by Junio C Hamano
parent e5ac1217eb
commit ee9cf14d25
1 changed files with 9 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
Documentation/git-bisect.txt
View File

@ -114,21 +114,22 @@ $ git bisect view --stat
Bisect log and bisect replay Bisect log and bisect replay
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The good/bad input is logged, and: After having marked revisions as good or bad, then:
------------ ------------
$ git bisect log $ git bisect log
------------ ------------
shows what you have done so far. You can truncate its output somewhere shows what you have done so far. If you discover that you made a mistake
and save it in a file, and run: in specifying the status of a revision, you can save the output of this
command to a file, edit it to remove the incorrect entries, and then issue
the following commands to return to a corrected state:
------------ ------------
$ git bisect reset
$ git bisect replay that-file $ git bisect replay that-file
------------ ------------
if you find later that you made a mistake specifying revisions as good/bad.
Avoiding testing a commit Avoiding testing a commit
~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~
@ -141,7 +142,7 @@ want to find a nearby commit and try that instead.
For example: For example:
------------ ------------
$ git bisect good/bad # previous round was good/bad. $ git bisect good/bad # previous round was good or bad.
Bisecting: 337 revisions left to test after this Bisecting: 337 revisions left to test after this
$ git bisect visualize # oops, that is uninteresting. $ git bisect visualize # oops, that is uninteresting.
$ git reset --hard HEAD~3 # try 3 revisions before what $ git reset --hard HEAD~3 # try 3 revisions before what
@ -149,7 +150,7 @@ $ git reset --hard HEAD~3 # try 3 revisions before what
------------ ------------
Then compile and test the chosen revision. Afterwards the revision Then compile and test the chosen revision. Afterwards the revision
is marked as good/bad in the usual manner. is marked as good or bad in the usual manner.
Bisect skip Bisect skip
~~~~~~~~~~~~ ~~~~~~~~~~~~
@ -240,7 +241,7 @@ before compiling, run the real test, and afterwards decide if the
revision (possibly with the needed patch) passed the test and then revision (possibly with the needed patch) passed the test and then
rewind the tree to the pristine state. Finally the script should exit rewind the tree to the pristine state. Finally the script should exit
with the status of the real test to let the "git bisect run" command loop with the status of the real test to let the "git bisect run" command loop
to determine the eventual outcome of the bisect session. determine the eventual outcome of the bisect session.
EXAMPLES EXAMPLES
-------- --------