summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorEric Sunshine <sunshine@sunshineco.com>2014-12-30 23:30:30 (GMT)
committerJunio C Hamano <gitster@pobox.com>2015-01-07 18:21:17 (GMT)
commit860109937386f2d103a71d3f703ad34cc1ebd136 (patch)
tree2aaf10186656972774135fdaceee7a86cd2f50b9 /Documentation
parentc2e8e4b9da4d007b15faa2e3d407b2fd279f0572 (diff)
downloadgit-860109937386f2d103a71d3f703ad34cc1ebd136.zip
git-860109937386f2d103a71d3f703ad34cc1ebd136.tar.gz
git-860109937386f2d103a71d3f703ad34cc1ebd136.tar.bz2
SubmittingPatches: explain rationale for using --notes with format-patch
While here, also change grammatically poor "three dash lines" to "three-dash line". Suggested-by: Stefan Beller <sbeller@google.com> Signed-off-by: Eric Sunshine <sunshine@sunshineco.com> Signed-off-by: Stefan Beller <sbeller@google.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/SubmittingPatches7
1 files changed, 5 insertions, 2 deletions
diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
index fa71b5f..85bc071 100644
--- a/Documentation/SubmittingPatches
+++ b/Documentation/SubmittingPatches
@@ -175,8 +175,11 @@ message starts, you can put a "From: " line to name that person.
You often want to add additional explanation about the patch,
other than the commit message itself. Place such "cover letter"
-material between the three dash lines and the diffstat. Git-notes
-can also be inserted using the `--notes` option.
+material between the three-dash line and the diffstat. For
+patches requiring multiple iterations of review and discussion,
+an explanation of changes between each iteration can be kept in
+Git-notes and inserted automatically following the three-dash
+line via `git format-patch --notes`.
Do not attach the patch as a MIME attachment, compressed or not.
Do not let your e-mail client send quoted-printable. Do not let