X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=Documentation%2Fgit-format-patch.txt;h=7a3abec02e5b07533d11322b2ab9a3a89d2bd0d6;hb=650e4be59b9f385f56e5829d97d09e8440f174b8;hp=a1483ffd0f865eb486686d7c8050090b389a81c3;hpb=348c4c66dacb1810a9bcd592e72f98a465233488;p=git.git
diff --git a/Documentation/git-format-patch.txt b/Documentation/git-format-patch.txt
index a1483ffd..7a3abec0 100644
--- a/Documentation/git-format-patch.txt
+++ b/Documentation/git-format-patch.txt
@@ -8,7 +8,7 @@ git-format-patch - Prepare patches for e-mail submission.
SYNOPSIS
--------
-'git-format-patch' [-n][-o
][-k][--mbox][--diff-options] []
+'git-format-patch' [-n][-o |--stdout][-k][--mbox][--diff-options] []
DESCRIPTION
-----------
@@ -54,6 +54,30 @@ OPTIONS
concatenated together and fed to `git-applymbox`.
Implies --author and --date.
+--stdout::
+ This flag generates the mbox formatted output to the
+ 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
------