Merge branch 'cn/cherry-pick-range-docs' into maint
authorJunio C Hamano <gitster@pobox.com>
Wed, 11 Jul 2012 19:45:34 +0000 (12:45 -0700)
committerJunio C Hamano <gitster@pobox.com>
Wed, 11 Jul 2012 19:45:34 +0000 (12:45 -0700)
The documentation for "git cherry-pick A B..C" was misleading.

* cn/cherry-pick-range-docs:
git-cherry-pick.txt: clarify the use of revision range notation
Documentation: --no-walk is no-op if range is specified

Documentation/git-cherry-pick.txt
Documentation/rev-list-options.txt
index 9f3dae631e5437662e9fb3583b24f414c93bb140..0e170a51cac1de3f20b31f8dba7f832c292b815c 100644 (file)
@@ -47,7 +47,9 @@ OPTIONS
        linkgit:gitrevisions[7].
        Sets of commits can be passed but no traversal is done by
        default, as if the '--no-walk' option was specified, see
-       linkgit:git-rev-list[1].
+       linkgit:git-rev-list[1]. Note that specifying a range will
+       feed all <commit>... arguments to a single revision walk
+       (see a later example that uses 'maint master..next').
 
 -e::
 --edit::
@@ -149,6 +151,15 @@ EXAMPLES
        Apply the changes introduced by all commits that are ancestors
        of master but not of HEAD to produce new commits.
 
+`git cherry-pick maint next ^master`::
+`git cherry-pick maint master..next`::
+
+       Apply the changes introduced by all commits that are
+       ancestors of maint or next, but not master or any of its
+       ancestors.  Note that the latter does not mean `maint` and
+       everything between `master` and `next`; specifically,
+       `maint` will not be used if it is included in `master`.
+
 `git cherry-pick master~4 master~2`::
 
        Apply the changes introduced by the fifth and third last
index 1ae3c899ef4bb6d37bc5cbcb25ed927011378d90..84e34b1abaf23ef87fcccd21b0500fd21c5a1912 100644 (file)
@@ -622,6 +622,7 @@ These options are mostly targeted for packing of git repositories.
 --no-walk::
 
        Only show the given revs, but do not traverse their ancestors.
+       This has no effect if a range is specified.
 
 --do-walk::