summaryrefslogtreecommitdiff
path: root/Documentation/git-format-patch.txt
diff options
context:
space:
mode:
authorJunio C Hamano <junkio@cox.net>2005-11-05 02:55:18 -0800
committerJunio C Hamano <junkio@cox.net>2005-11-05 02:55:18 -0800
commit28ffb8987af97e28accc707c724207fbd745b027 (patch)
treeed8d6f8291803792bc247e72a8ffafeb63fc0cc1 /Documentation/git-format-patch.txt
parentbd7c8aab7098e6e340060c0d7f1fab8595905b2d (diff)
downloadgit-28ffb8987af97e28accc707c724207fbd745b027.tar.gz
Documentation: format-patch
Add examples section and talk about using this to cherry-pick commits. Signed-off-by: Junio C Hamano <junkio@cox.net>
Diffstat (limited to 'Documentation/git-format-patch.txt')
-rw-r--r--Documentation/git-format-patch.txt20
1 files changed, 20 insertions, 0 deletions
diff --git a/Documentation/git-format-patch.txt b/Documentation/git-format-patch.txt
index f3ef4c1e04..7a3abec02e 100644
--- a/Documentation/git-format-patch.txt
+++ b/Documentation/git-format-patch.txt
@@ -59,6 +59,26 @@ OPTIONS
standard output, instead of saving them into a file per
patch and implies --mbox.
+
+EXAMPLES
+--------
+
+git-format-patch -k --stdout R1..R2 | git-am -3 -k::
+ Extract commits between revisions R1 and R2, and apply
+ them on top of the current branch using `git-am` to
+ cherry-pick them.
+
+git-format-patch origin::
+ Extract commits the current branch accumulated since it
+ pulled from origin the last time in a patch form for
+ e-mail submission.
+
+
+See Also
+--------
+gitlink:git-am[1], gitlink:git-send-email
+
+
Author
------
Written by Junio C Hamano <junkio@cox.net>