blob: 3a0f55ec8e273545af3a92a9b886511ac79ba73c [file] [log] [blame]
Petr Baudis3c643142005-11-01 21:45:55 +01001git-fmt-merge-msg(1)
2====================
3
4NAME
5----
6git-fmt-merge-msg - Produce a merge commit message
7
8
9SYNOPSIS
10--------
Matthias Kestenholze448ff82007-05-18 15:39:33 +020011[verse]
Ramkumar Ramachandra96e94202010-09-08 23:29:54 +053012'git fmt-merge-msg' [-m <message>] [--log[=<n>] | --no-log] <$GIT_DIR/FETCH_HEAD
13'git fmt-merge-msg' [-m <message>] [--log[=<n>] | --no-log] -F <file>
Petr Baudis3c643142005-11-01 21:45:55 +010014
15DESCRIPTION
16-----------
17Takes the list of merged objects on stdin and produces a suitable
18commit message to be used for the merge commit, usually to be
Thomas Rast0b444cd2010-01-10 00:33:00 +010019passed as the '<merge-message>' argument of 'git merge'.
Petr Baudis3c643142005-11-01 21:45:55 +010020
Jonathan Nieder0f8a02c2009-10-09 05:16:15 -050021This command is intended mostly for internal use by scripts
22automatically invoking 'git merge'.
Petr Baudis3c643142005-11-01 21:45:55 +010023
Andrew Ruder2bc060c2007-04-26 23:58:57 -050024OPTIONS
25-------
26
Ramkumar Ramachandra96e94202010-09-08 23:29:54 +053027--log[=<n>]::
Andrew Ruder2bc060c2007-04-26 23:58:57 -050028 In addition to branch names, populate the log message with
29 one-line descriptions from the actual commits that are being
Ramkumar Ramachandra96e94202010-09-08 23:29:54 +053030 merged. At most <n> commits from each merge parent will be
31 used (20 if <n> is omitted). This overrides the `merge.log`
32 configuration variable.
Andrew Ruder2bc060c2007-04-26 23:58:57 -050033
SZEDER Gábor6cd9cfe2008-04-06 03:23:45 +020034--no-log::
Andrew Ruder2bc060c2007-04-26 23:58:57 -050035 Do not list one-line descriptions from the actual commits being
36 merged.
37
Stephan Beyer32402402008-06-08 03:36:09 +020038--summary::
39--no-summary::
SZEDER Gábor6cd9cfe2008-04-06 03:23:45 +020040 Synonyms to --log and --no-log; these are deprecated and will be
41 removed in the future.
42
Jonathan Nieder21024402010-08-17 18:00:34 -050043-m <message>::
44--message <message>::
45 Use <message> instead of the branch names for the first line
46 of the log message. For use with `--log`.
47
Stephan Beyer32402402008-06-08 03:36:09 +020048-F <file>::
49--file <file>::
Andrew Ruder2bc060c2007-04-26 23:58:57 -050050 Take the list of merged objects from <file> instead of
51 stdin.
52
53CONFIGURATION
54-------------
55
Junio C Hamano8c80ff32012-02-23 11:20:15 -080056merge.branchdesc::
57 In addition to branch names, populate the log message with
58 the branch description text associated with them. Defaults
59 to false.
60
SZEDER Gábor6cd9cfe2008-04-06 03:23:45 +020061merge.log::
Ramkumar Ramachandrabda3b8f2010-09-08 23:29:55 +053062 In addition to branch names, populate the log message with at
63 most the specified number of one-line descriptions from the
64 actual commits that are being merged. Defaults to false, and
Ralf Wildenhues469bfc92011-01-03 20:03:34 +010065 true is a synonym for 20.
Petr Baudis3c643142005-11-01 21:45:55 +010066
SZEDER Gábor6cd9cfe2008-04-06 03:23:45 +020067merge.summary::
68 Synonym to `merge.log`; this is deprecated and will be removed in
69 the future.
70
Petr Baudis3c643142005-11-01 21:45:55 +010071SEE ALSO
72--------
Dan McGee5162e692007-12-29 00:20:38 -060073linkgit:git-merge[1]
Petr Baudis3c643142005-11-01 21:45:55 +010074
Petr Baudis3c643142005-11-01 21:45:55 +010075GIT
76---
Christian Couder9e1f0a82008-06-06 09:07:32 +020077Part of the linkgit:git[1] suite