[FFmpeg-cvslog] doc/git-howto: expand format-patch and send-email notes.

[Anton Khirnov]

ffmpeg | branch: master | Anton Khirnov <anton at khirnov.net> | Tue Nov  8 08:07:51 2011 +0100| [8a691dfdabc03b85255d9bd16337de737e5285c8] | committer: Anton Khirnov

doc/git-howto: expand format-patch and send-email notes.

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=8a691dfdabc03b85255d9bd16337de737e5285c8
---

 doc/git-howto.txt |   17 +++++++++++++++--
 1 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/doc/git-howto.txt b/doc/git-howto.txt
index ba377c9..036b567 100644
--- a/doc/git-howto.txt
+++ b/doc/git-howto.txt
@@ -205,8 +205,19 @@ I. BASICS:
 
     git format-patch <commit> [-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 <commit> 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