Skip to content

Commit

Permalink
Documentation: decribe format-patch --notes
Browse files Browse the repository at this point in the history
Even though I coded this, I am not sure what use scenarios would benefit
from this option, so the description is unnecessarily negative at this
moment. People who do want to use this feature need to come up with a
more plausible use case and replace it.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
  • Loading branch information
Junio C Hamano committed Oct 19, 2012
1 parent bd1470b commit e422c0c
Showing 1 changed file with 14 additions and 1 deletion.
15 changes: 14 additions & 1 deletion Documentation/git-format-patch.txt
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ SYNOPSIS
[--ignore-if-in-upstream]
[--subject-prefix=Subject-Prefix]
[--to=<email>] [--cc=<email>]
[--cover-letter] [--quiet]
[--cover-letter] [--quiet] [--notes[=<ref>]]
[<common diff options>]
[ <since> | <revision range> ]

Expand Down Expand Up @@ -191,6 +191,19 @@ will want to ensure that threading is disabled for `git send-email`.
containing the shortlog and the overall diffstat. You can
fill in a description in the file before sending it out.

--notes[=<ref>]::
Append the notes (see linkgit:git-notes[1]) for the commit
after the three-dash line.
+
The expected use case of this is to write supporting explanation for
the commit that does not belong to the commit log message proper
when (or after) you create the commit, and include it in your patch
submission. But if you can plan ahead and write it down, there may
not be a good reason not to write it in your commit message, and if
you can't, you can always edit the output of format-patch before
sending it out, so the practical value of this option is somewhat
dubious, unless your workflow is broken.

--[no]-signature=<signature>::
Add a signature to each message produced. Per RFC 3676 the signature
is separated from the body by a line with '-- ' on it. If the
Expand Down

0 comments on commit e422c0c

Please sign in to comment.