path: root/Documentation
diff options
authorJunio C Hamano <>2011-03-20 04:46:06 (GMT)
committerJunio C Hamano <>2011-03-20 04:46:24 (GMT)
commit958bf6b768aa10fa3985886d312bd0365dee7677 (patch)
treebae8ecc99a6a2bd3a3d02923067750cb0afb72db /Documentation
parentb547ce0b184f152938f2ea709b9932fa0d6181f8 (diff)
bisect: explain the rationale behind 125
Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation')
1 files changed, 6 insertions, 1 deletions
diff --git a/Documentation/git-bisect.txt b/Documentation/git-bisect.txt
index c39d957..1701e42 100644
--- a/Documentation/git-bisect.txt
+++ b/Documentation/git-bisect.txt
@@ -241,7 +241,12 @@ exit(3) manual page), as the value is chopped with "& 0377".
The special exit code 125 should be used when the current source code
cannot be tested. If the script exits with this code, the current
-revision will be skipped (see `git bisect skip` above).
+revision will be skipped (see `git bisect skip` above). 125 was chosen
+as the highest sensible value to use for this purpose, because 126 and 127
+are used by POSIX shells to signal specific error status (127 is for
+command not found, 126 is for command found but not executable---these
+details do not matter, as they are normal errors in the script, as far as
+"bisect run" is concerned).
You may often find that during a bisect session you want to have
temporary modifications (e.g. s/#define DEBUG 0/#define DEBUG 1/ in a