git-rebase: add keep_empty flag
[gitweb.git] / Documentation / git-cherry-pick.txt
index 730237ab27a5e0244c1708eb2546123cc711d233..3d25a20b67a0dbe9dbb463c6d7bdc53a16fd96e6 100644 (file)
@@ -110,7 +110,17 @@ effect to your index in a row.
        behavior, allowing empty commits to be preserved automatically
        in a cherry-pick. Note that when "--ff" is in effect, empty
        commits that meet the "fast-forward" requirement will be kept
-       even without this option.
+       even without this option.  Note also, that use of this option only
+       keeps commits that were initially empty (i.e. the commit recorded the
+       same tree as its parent).  Commits which are made empty due to a
+       previous commit are dropped.  To force the inclusion of those commits
+       use `--keep-redundant-commits`.
+
+--keep-redundant-commits::
+       If a commit being cherry picked duplicates a commit already in the
+       current history, it will become empty.  By default these
+       redundant commits are ignored.  This option overrides that behavior and
+       creates an empty commit object.  Implies `--allow-empty`.
 
 --strategy=<strategy>::
        Use the given merge strategy.  Should only be used once.