Documentation / git-fmt-merge-msg.txton commit graph: add commit graph design document (ae30d7b)
   1git-fmt-merge-msg(1)
   2====================
   3
   4NAME
   5----
   6git-fmt-merge-msg - Produce a merge commit message
   7
   8
   9SYNOPSIS
  10--------
  11[verse]
  12'git fmt-merge-msg' [-m <message>] [--log[=<n>] | --no-log]
  13'git fmt-merge-msg' [-m <message>] [--log[=<n>] | --no-log] -F <file>
  14
  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
  19passed as the '<merge-message>' argument of 'git merge'.
  20
  21This command is intended mostly for internal use by scripts
  22automatically invoking 'git merge'.
  23
  24OPTIONS
  25-------
  26
  27--log[=<n>]::
  28        In addition to branch names, populate the log message with
  29        one-line descriptions from the actual commits that are being
  30        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.
  33
  34--no-log::
  35        Do not list one-line descriptions from the actual commits being
  36        merged.
  37
  38--[no-]summary::
  39        Synonyms to --log and --no-log; these are deprecated and will be
  40        removed in the future.
  41
  42-m <message>::
  43--message <message>::
  44        Use <message> instead of the branch names for the first line
  45        of the log message.  For use with `--log`.
  46
  47-F <file>::
  48--file <file>::
  49        Take the list of merged objects from <file> instead of
  50        stdin.
  51
  52CONFIGURATION
  53-------------
  54include::fmt-merge-msg-config.txt[]
  55
  56merge.summary::
  57        Synonym to `merge.log`; this is deprecated and will be removed in
  58        the future.
  59
  60EXAMPLE
  61-------
  62
  63---------
  64$ git fetch origin master
  65$ git fmt-merge-msg --log <$GIT_DIR/FETCH_HEAD
  66---------
  67
  68Print a log message describing a merge of the "master" branch from
  69the "origin" remote.
  70
  71
  72SEE ALSO
  73--------
  74linkgit:git-merge[1]
  75
  76GIT
  77---
  78Part of the linkgit:git[1] suite