path: root/Documentation/git-format-patch.txt
diff options
authorEric Sunshine <>2018-07-22 09:57:16 (GMT)
committerJunio C Hamano <>2018-08-14 21:27:05 (GMT)
commit8631bf1cdd7296684deebab2708761bfc8085fc2 (patch)
tree2aaa3d26b0a0f847db6b518c65a755ebda0fe63f /Documentation/git-format-patch.txt
parent4ee99689410cf7275f21833779da89626eb6edd6 (diff)
format-patch: add --creation-factor tweak for --range-diff
When generating a range-diff, matching up commits between two version of a patch series involves heuristics, thus may give unexpected results. git-range-diff allows tweaking the heuristic via --creation-factor. Follow suit by accepting --creation-factor in combination with --range-diff when generating a range-diff for a cover-letter. Signed-off-by: Eric Sunshine <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/git-format-patch.txt')
1 files changed, 7 insertions, 1 deletions
diff --git a/Documentation/git-format-patch.txt b/Documentation/git-format-patch.txt
index 425145f..9b2e172 100644
--- a/Documentation/git-format-patch.txt
+++ b/Documentation/git-format-patch.txt
@@ -24,7 +24,7 @@ SYNOPSIS
[--to=<email>] [--cc=<email>]
[--[no-]cover-letter] [--quiet] [--notes[=<ref>]]
- [--range-diff=<previous>]
+ [--range-diff=<previous> [--creation-factor=<percent>]]
[<common diff options>]
[ <since> | <revision range> ]
@@ -250,6 +250,12 @@ feeding the result to `git send-email`.
disjoint (for example `git format-patch --cover-letter
--range-diff=feature/v1~3..feature/v1 -3 feature/v2`).
+ Used with `--range-diff`, tweak the heuristic which matches up commits
+ between the previous and current series of patches by adjusting the
+ creation/deletion cost fudge factor. See linkgit:git-range-diff[1])
+ for details.
Append the notes (see linkgit:git-notes[1]) for the commit
after the three-dash line.