1
0
mirror of https://github.com/git/git.git synced 2025-03-16 11:55:16 +00:00

Doc User-Manual: Patch cover letter, three dashes, and --notes

Show that git format-patch can have a cover letter, include patch
commentary below the three dashes, and notes can also be
included.

Signed-off-by: Philip Oakley <philipoakley@iee.org>
Signed-off-by: Jeff King <peff@peff.net>
This commit is contained in:
Philip Oakley 2012-10-21 22:34:08 +01:00 committed by Jeff King
parent 6454d9f166
commit d84cef1817

View File

@ -1787,6 +1787,13 @@ $ git format-patch origin
will produce a numbered series of files in the current directory, one will produce a numbered series of files in the current directory, one
for each patch in the current branch but not in origin/HEAD. for each patch in the current branch but not in origin/HEAD.
`git format-patch` can include an initial "cover letter". You can insert
commentary on individual patches after the three dash line which
`format-patch` places after the commit message but before the patch
itself. If you use `git notes` to track your cover letter material,
`git format-patch --notes` will include the commit's notes in a similar
manner.
You can then import these into your mail client and send them by You can then import these into your mail client and send them by
hand. However, if you have a lot to send at once, you may prefer to hand. However, if you have a lot to send at once, you may prefer to
use the linkgit:git-send-email[1] script to automate the process. use the linkgit:git-send-email[1] script to automate the process.