Browse Source

Merge branch 'cn/cherry-pick-range-docs'

The command line argument of "git cherry-pick maint master..next" is
just an ordinary revision range, which is unintuitive and at least
deserves documentation.

* 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
maint
Junio C Hamano 13 years ago
parent
commit
a913b56fcb
  1. 13
      Documentation/git-cherry-pick.txt
  2. 1
      Documentation/rev-list-options.txt

13
Documentation/git-cherry-pick.txt

@ -47,7 +47,9 @@ OPTIONS @@ -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 @@ -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

1
Documentation/rev-list-options.txt

@ -622,6 +622,7 @@ These options are mostly targeted for packing of git repositories. @@ -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::


Loading…
Cancel
Save