undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Documentation: update descriptions of revision options related to '--bisect'

Browse Source 
In commit ad3f9a7 (Add '--bisect' revision machinery argument) the
'--bisect' option was added to easily pass bisection refs to commands
using the revision machinery.

This patch updates the documentation of the related options to describe
the new behavior.

Signed-off-by: Christian Couder <chriscool@tuxfamily.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Christian Couder 2009-11-24 07:54:44 +01:00 committed by Junio C Hamano
parent fe3b2b7b82
commit af06e93a3e
1 changed files with 27 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
Documentation/rev-list-options.txt
View File

@ -243,6 +243,15 @@ endif::git-rev-list[]
Pretend as if all the refs in `$GIT_DIR/refs/remotes` are listed Pretend as if all the refs in `$GIT_DIR/refs/remotes` are listed
on the command line as '<commit>'. on the command line as '<commit>'.
ifndef::git-rev-list[]
--bisect::
Pretend as if the bad bisection ref `$GIT_DIR/refs/bisect/bad`
was listed and as if it was followed by `--not` and the good
bisection refs `$GIT_DIR/refs/bisect/good-*` on the command
line.
endif::git-rev-list[]
--stdin:: --stdin::
In addition to the '<commit>' listed on the command In addition to the '<commit>' listed on the command
@ -538,7 +547,11 @@ Bisection Helpers
--bisect:: --bisect::
Limit output to the one commit object which is roughly halfway between Limit output to the one commit object which is roughly halfway between
the included and excluded commits. Thus, if included and excluded commits. Note that the bad bisection ref
`$GIT_DIR/refs/bisect/bad` is added to the included commits (if it
exists) and the good bisection refs `$GIT_DIR/refs/bisect/good-*` are
added to the excluded commits (if they exist). Thus, supposing there
are no refs in `$GIT_DIR/refs/bisect/`, if
----------------------------------------------------------------------- -----------------------------------------------------------------------
$ git rev-list --bisect foo ^bar ^baz $ git rev-list --bisect foo ^bar ^baz
@ -558,22 +571,24 @@ one.
--bisect-vars:: --bisect-vars::
This calculates the same as `--bisect`, but outputs text ready This calculates the same as `--bisect`, except that refs in
to be eval'ed by the shell. These lines will assign the name of `$GIT_DIR/refs/bisect/` are not used, and except that this outputs
the midpoint revision to the variable `bisect_rev`, and the text ready to be eval'ed by the shell. These lines will assign the
expected number of commits to be tested after `bisect_rev` is name of the midpoint revision to the variable `bisect_rev`, and the
tested to `bisect_nr`, the expected number of commits to be expected number of commits to be tested after `bisect_rev` is tested
tested if `bisect_rev` turns out to be good to `bisect_good`, to `bisect_nr`, the expected number of commits to be tested if
the expected number of commits to be tested if `bisect_rev` `bisect_rev` turns out to be good to `bisect_good`, the expected
turns out to be bad to `bisect_bad`, and the number of commits number of commits to be tested if `bisect_rev` turns out to be bad to
we are bisecting right now to `bisect_all`. `bisect_bad`, and the number of commits we are bisecting right now to
`bisect_all`.
--bisect-all:: --bisect-all::
This outputs all the commit objects between the included and excluded This outputs all the commit objects between the included and excluded
commits, ordered by their distance to the included and excluded commits, ordered by their distance to the included and excluded
commits. The farthest from them is displayed first. (This is the only commits. Refs in `$GIT_DIR/refs/bisect/` are not used. The farthest
one displayed by `--bisect`.) from them is displayed first. (This is the only one displayed by
`--bisect`.)
+ +
This is useful because it makes it easy to choose a good commit to This is useful because it makes it easy to choose a good commit to
test when you want to avoid to test some of them for some reason (they test when you want to avoid to test some of them for some reason (they