简体中文 ▾ 主题 ▾ 最新版本 ▾ git-fmt-merge-msg 最后更新于 2.52.0

名称

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>

描述

从标准输入获取合并对象的列表,并生成一个适合用于合并提交的消息,通常会作为 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> 而不是标准输入获取合并对象的列表。

配置

merge.branchdesc

除了分支名称之外,还用与它们关联的分支描述文本填充日志消息。默认为 false。

merge.log

除了分支名称之外,还会用最多指定数量的实际合并提交的单行描述填充日志消息。默认为 false,true 是 20 的同义词。

merge.suppressDest

通过将匹配集成(integration)分支名称的 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

Git[1] 套件的一部分