From 8a691dfdabc03b85255d9bd16337de737e5285c8 Mon Sep 17 00:00:00 2001 From: Anton Khirnov Date: Tue, 8 Nov 2011 08:07:51 +0100 Subject: [PATCH] doc/git-howto: expand format-patch and send-email notes. --- doc/git-howto.txt | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/doc/git-howto.txt b/doc/git-howto.txt index ba377c99e0..036b567084 100644 --- a/doc/git-howto.txt +++ b/doc/git-howto.txt @@ -205,8 +205,19 @@ I. BASICS: git format-patch [-o directory] - will generate a set of patches out of the current branch starting from - commit. By default the patches are created in the current directory. + will generate a set of patches for each commit between and + current HEAD. E.g. + + git format-patch origin/master + + will generate patches for all commits on current branch which are not + present in upstream. + A useful shortcut is also + + git format-patch -n + + which will generate patches from last n commits. + By default the patches are created in the current directory. 11. Sending patches for review @@ -215,6 +226,8 @@ I. BASICS: will send the patches created by git format-patch or directly generates them. All the email fields can be configured in the global/local configuration or overridden by command line. + Note that this tool must often be installed separately (e.g. git-email + package on Debian-based distros). 12. Pushing changes to remote trees