author | Junio C Hamano <gitster@pobox.com> | |
Sun, 22 Mar 2009 06:24:46 +0000 (23:24 -0700) | ||
committer | Junio C Hamano <gitster@pobox.com> | |
Sun, 22 Mar 2009 06:24:46 +0000 (23:24 -0700) |
* dm/maint-docco:
Documentation: reword example text in git-bisect.txt.
Documentation: reworded the "Description" section of git-bisect.txt.
Documentation: minor grammatical fixes in git-branch.txt.
Documentation: minor grammatical fixes in git-blame.txt.
Documentation: reword the "Description" section of git-bisect.txt.
Documentation: minor grammatical fixes in git-archive.txt.
Documentation: reword example text in git-bisect.txt.
Documentation: reworded the "Description" section of git-bisect.txt.
Documentation: minor grammatical fixes in git-branch.txt.
Documentation: minor grammatical fixes in git-blame.txt.
Documentation: reword the "Description" section of git-bisect.txt.
Documentation: minor grammatical fixes in git-archive.txt.
1 | 2 | |||
---|---|---|---|---|
Documentation/blame-options.txt | patch | | diff1 | | diff2 | | blob | history |
Documentation/git-archive.txt | patch | | diff1 | | diff2 | | blob | history |
Documentation/git-bisect.txt | patch | | diff1 | | diff2 | | blob | history |
Documentation/git-branch.txt | patch | | diff1 | | diff2 | | blob | history |
diff --cc Documentation/blame-options.txt
Simple merge
diff --cc Documentation/git-archive.txt
index 0eeefe00603814fcabc7d537d5c04e5801591c56,ad38f7f39db8d3b973f0ede255f65bb0627bb416..c1adf594972884b77c1f049b35a983688601a343
--prefix=<prefix>/::
Prepend <prefix>/ to each filename in the archive.
+--output=<file>::
+ Write the archive to <file> instead of stdout.
+
<extra>::
- This can be any options that the archiver backend understand.
+ This can be any options that the archiver backend understands.
See next section.
--remote=<repo>::
diff --cc Documentation/git-bisect.txt
index e65c1cae8b3da4efae7571628c1586cbb56151ae,ec9594eda37b339119b5a24c23db22e4789c898e..93d9fc0299c0f4aeeb97f6ec228415d67c398dcb
~~~~~~~~~~
If you have a script that can tell if the current source code is good
- or bad, you can automatically bisect using:
+ or bad, you can bisect by issuing the command:
------------
-$ git bisect run my_script
+$ git bisect run my_script arguments
------------
- Note that the "run" script (`my_script` in the above example) should
- exit with code 0 in case the current source code is good. Exit with a
+ Note that the script (`my_script` in the above example) should
+ exit with code 0 if the current source code is good, and exit with a
code between 1 and 127 (inclusive), except 125, if the current
source code is bad.
$ git bisect run ~/test.sh
------------
+
- Here "check_test_case.sh" should "exit 0", if the test case passes,
- and "exit 1" (for example) otherwise.
+ Here "check_test_case.sh" should "exit 0" if the test case passes,
+ and "exit 1" otherwise.
+
- It's safer if both "test.sh" and "check_test_case.sh" scripts are
- outside the repo to prevent interactions between the bisect, make and
- test processes and the scripts.
+ It is safer if both "test.sh" and "check_test_case.sh" scripts are
+ outside the repository to prevent interactions between the bisect,
+ make and test processes and the scripts.
+* Automatically bisect a broken test suite:
++
+------------
+$ git bisect start HEAD HEAD~10 -- # culprit is among the last 10
+$ git bisect run sh -c "make || exit 125; ~/check_test_case.sh"
+------------
++
+Does the same as the previous example, but on a single line.
+
Author
------
Written by Linus Torvalds <torvalds@osdl.org>
diff --cc Documentation/git-branch.txt
Simple merge