git-fmt-merge-msg.1   [plain text]

'\" t
.\"     Title: git-fmt-merge-msg
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 06/01/2011
.\"    Manual: Git Manual
.\"    Source: Git 1.7.5.4
.\"  Language: English
.\"
.TH "GIT\-FMT\-MERGE\-MSG" "1" "06/01/2011" "Git 1\&.7\&.5\&.4" "Git Manual"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
git-fmt-merge-msg \- Produce a merge commit message
.SH "SYNOPSIS"
.sp
.nf
\fIgit fmt\-merge\-msg\fR [\-m <message>] [\-\-log[=<n>] | \-\-no\-log] <$GIT_DIR/FETCH_HEAD
\fIgit fmt\-merge\-msg\fR [\-m <message>] [\-\-log[=<n>] | \-\-no\-log] \-F <file>
.fi
.sp
.SH "DESCRIPTION"
.sp
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 \fI<merge\-message>\fR argument of \fIgit merge\fR\&.
.sp
This command is intended mostly for internal use by scripts automatically invoking \fIgit merge\fR\&.
.SH "OPTIONS"
.PP
\-\-log[=<n>]
.RS 4
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\&.
.RE
.PP
\-\-no\-log
.RS 4
Do not list one\-line descriptions from the actual commits being merged\&.
.RE
.PP
\-\-summary, \-\-no\-summary
.RS 4
Synonyms to \-\-log and \-\-no\-log; these are deprecated and will be removed in the future\&.
.RE
.PP
\-m <message>, \-\-message <message>
.RS 4
Use <message> instead of the branch names for the first line of the log message\&. For use with
\-\-log\&.
.RE
.PP
\-F <file>, \-\-file <file>
.RS 4
Take the list of merged objects from <file> instead of stdin\&.
.RE
.SH "CONFIGURATION"
.PP
merge\&.log
.RS 4
In addition to branch names, populate the log message with at most the specified number of one\-line descriptions from the actual commits that are being merged\&. Defaults to false, and true is a synonym for 20\&.
.RE
.PP
merge\&.summary
.RS 4
Synonym to
merge\&.log; this is deprecated and will be removed in the future\&.
.RE
.SH "SEE ALSO"
.sp
\fBgit-merge\fR(1)
.SH "GIT"
.sp
Part of the \fBgit\fR(1) suite