git-fmt-merge-msg

生成合并提交消息

概要

'git fmt-merge-msg' [-m <message>] [--into-name <branch>] [--log[=<n>] | --no-log]
'git fmt-merge-msg' [-m <message>] [--log[=<n>] | --no-log] -F <file>

描述

从 stdin 接收合并对象的列表，并生成适合用于合并提交的提交消息，通常作为 'git merge' 的 '<merge-message>' 参数传递。

此命令主要供自动调用 'git merge' 的脚本内部使用。

选项

• --log[=<n>] 除了分支名称外，还用正在合并的实际提交的单行描述填充日志消息。每个合并父提交最多使用 <n> 个提交（省略 <n> 时为 20）。这覆盖 merge.log 配置变量。

• --no-log 不列出正在合并的实际提交的单行描述。

• --summary, --no-summary --log 和 --no-log 的同义词；这些已弃用，将来会被移除。

• -m <message>, --message <message> 使用 <message> 代替分支名称作为日志消息的第一行。与 --log 一起使用。

• --into-name <branch> 准备合并消息，就像合并到分支 <branch> 一样，而不是合并到的实际分支的名称。

• -F <file>, --file <file> 从 <file> 而不是 stdin 获取合并对象的列表。

配置

• merge.branchdesc - 除了分支名称外，还用与之关联的分支描述文本填充日志消息。默认为 false。

• merge.log - 除了分支名称外，还用正在合并的实际提交的最多指定数量的单行描述填充日志消息。默认为 false，true 是 20 的同义词。

• merge.suppressDest - 通过向此多值配置变量添加匹配集成分支名称的 glob，为合并到这些集成分支计算的默认合并消息将从标题中省略 "into <branch-name>"。 空值元素可用于清除从先前配置条目积累的 glob 列表。当没有定义 merge.suppressDest 变量时，为了向后兼容使用 master 的默认值。

• merge.summary - merge.log 的同义词；这已弃用，将来会被移除。

示例

$ git fetch origin master
$ git fmt-merge-msg --log <$GIT_DIR/FETCH_HEAD

打印描述从 "origin" 远程合并 "master" 分支的日志消息。

另请参阅

git-merge(1)

Git

git(1) 套件的一部分