summaryrefslogtreecommitdiff
path: root/Documentation/git-fmt-merge-msg.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/git-fmt-merge-msg.txt')
-rw-r--r--Documentation/git-fmt-merge-msg.txt57
1 files changed, 42 insertions, 15 deletions
diff --git a/Documentation/git-fmt-merge-msg.txt b/Documentation/git-fmt-merge-msg.txt
index a70eb3994a..55a9a4b93a 100644
--- a/Documentation/git-fmt-merge-msg.txt
+++ b/Documentation/git-fmt-merge-msg.txt
@@ -8,32 +8,59 @@ git-fmt-merge-msg - Produce a merge commit message
SYNOPSIS
--------
-'git-fmt-merge-msg' <$GIT_DIR/FETCH_HEAD
+[verse]
+'git fmt-merge-msg' [-m <message>] [--log[=<n>] | --no-log] <$GIT_DIR/FETCH_HEAD
+'git fmt-merge-msg' [-m <message>] [--log[=<n>] | --no-log] -F <file>
DESCRIPTION
-----------
Takes the list of merged objects on stdin and produces a suitable
commit message to be used for the merge commit, usually to be
-passed as the '<merge-message>' argument of `git-merge`.
+passed as the '<merge-message>' argument of 'git merge'.
-This script is intended mostly for internal use by scripts
-automatically invoking `git-merge`.
+This command is intended mostly for internal use by scripts
+automatically invoking 'git merge'.
+OPTIONS
+-------
-SEE ALSO
---------
-gitlink:git-merge[1]
+--log[=<n>]::
+ In addition to branch names, populate the log message with
+ one-line descriptions from the actual commits that are being
+ merged. At most <n> commits from each merge parent will be
+ used (20 if <n> is omitted). This overrides the `merge.log`
+ configuration variable.
+
+--no-log::
+ Do not list one-line descriptions from the actual commits being
+ merged.
+
+--[no-]summary::
+ Synonyms to --log and --no-log; these are deprecated and will be
+ removed in the future.
+
+-m <message>::
+--message <message>::
+ Use <message> instead of the branch names for the first line
+ of the log message. For use with `--log`.
+-F <file>::
+--file <file>::
+ Take the list of merged objects from <file> instead of
+ stdin.
-Author
-------
-Written by Junio C Hamano <junkio@cox.net>
+CONFIGURATION
+-------------
+include::fmt-merge-msg-config.txt[]
-Documentation
---------------
-Documentation by Petr Baudis, Junio C Hamano and the git-list <git@vger.kernel.org>.
+merge.summary::
+ Synonym to `merge.log`; this is deprecated and will be removed in
+ the future.
+
+SEE ALSO
+--------
+linkgit:git-merge[1]
GIT
---
-Part of the gitlink:git[7] suite
-
+Part of the linkgit:git[1] suite