Merge branch 'dm/maint-docco'
authorJunio C Hamano <gitster@pobox.com>
Sun, 22 Mar 2009 06:24:46 +0000 (23:24 -0700)
committerJunio 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.

1  2 
Documentation/blame-options.txt
Documentation/git-archive.txt
Documentation/git-bisect.txt
Documentation/git-branch.txt

Simple merge
index 0eeefe00603814fcabc7d537d5c04e5801591c56,ad38f7f39db8d3b973f0ede255f65bb0627bb416..c1adf594972884b77c1f049b35a983688601a343
@@@ -48,11 -47,8 +48,11 @@@ OPTION
  --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>::
index e65c1cae8b3da4efae7571628c1586cbb56151ae,ec9594eda37b339119b5a24c23db22e4789c898e..93d9fc0299c0f4aeeb97f6ec228415d67c398dcb
@@@ -209,14 -214,14 +214,14 @@@ Bisect ru
  ~~~~~~~~~~
  
  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.
  
@@@ -291,22 -289,13 +296,22 @@@ $ git bisect start HEAD HEAD~10 --   # 
  $ 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>
Simple merge