git-interpret-trailers - 云端在线

程序：

您的姓名

git-interpret-trailers - 帮助将结构化信息添加到提交消息中

概要

混帐 口译预告片 [--trim-empty] [(--拖车[(=|:) ])...] [ ...]

商品描述

帮助添加 拖车 行，看起来类似于 RFC 822 电子邮件标头，位于
否则是提交消息的自由形式部分。

此命令从以下任一位置读取一些补丁或提交消息论据或
标准输入如果没有被指定。 然后这个命令应用传递的参数
将 --trailer 选项（如果有）用于每个输入文件的提交消息部分。 这
结果在标准输出上发出。

一些配置变量控制 --trailer 参数应用于每个
提交消息以及提交消息中任何现有预告片的更改方式。 他们
还可以自动添加一些预告片。

默认情况下， = or ： 使用 --trailer 给出的参数将是
仅当最后一个预告片具有不同的 ( ,
) 对（或者如果没有现有的预告片）。 这和部分将是
修剪以删除开头和结尾的空格，并修剪结果和
将出现在消息中，如下所示：

代币：价值

这意味着修剪和将被 ':'（一个冒号
后跟一个空格）。

默认情况下，新预告片将出现在所有现有预告片的末尾。 如果有
没有存在的预告片，新的预告片将出现在提交消息部分之后
输出，并且，如果在提交消息部分的末尾没有只有空格的行，
在新预告片之前将添加一个空行。

通过查找一组一个或多个从输入消息中提取现有的预告片
包含冒号的更多行（默认情况下），其中该组前面有一个或多个
空（或仅空格）行。 该组必须位于消息的末尾或
以开头的行之前的最后一个非空白行 ---. 这三个减号
开始消息的补丁部分。

阅读预告片时，token前后可以有空格，分隔符
和价值。 令牌和值中也可以有空格。

需要注意的是 拖车 不遵循也不打算遵循 RFC 822 的许多规则
标题。 例如，它们不遵循折行规则、编码规则和
可能还有许多其他规则。

配置

--修剪空
如果任何预告片的一部分只包含空格，整个预告片将是
从结果消息中删除。 这适用于现有拖车以及新拖车
拖车。

- 预告片[(=|:) ]
指定一个 ( , ) 应该作为预告片应用于输入的对
消息。 请参阅此命令的说明。

配置 变数

拖车分离器
此选项指示哪些字符被识别为尾符分隔符。 默认情况下
仅由 : 被识别为拖车分隔符，除了 = 总是被接受
与其他 git 命令兼容的命令行。

此选项给出的第一个字符将是以下情况下使用的默认字符
此预告片的配置中未指定另一个分隔符。

例如，如果此选项的值为“%=$”，则只有使用格式的行
和包含 %, = or $ 然后将考虑空格
拖车。 和 % 将是使用的默认分隔符，因此默认情况下会出现预告片
喜欢： % （令牌之间会出现一个百分号和一个空格
和价值）。

拖车.where
此选项说明将添加新预告片的位置。

这可以是结束，这是默认值，开始，之后或之前。

如果是结尾，则每个新预告片将出现在现有预告片的末尾。

如果是开始，那么每个新预告片都会出现在开头，而不是结尾
现有的拖车。

如果在之后，则每个新预告片将出现在最后一个预告片之后，带有
相同的.

如果是之前，那么每个新预告片将出现在第一个预告片之前
相同.

拖车如果存在
此选项使您可以选择在出现以下情况时将执行的操作
已经至少有一辆拖车在消息中。

此选项的有效值为：addIfDifferentNeighbor（这是默认值），
addIfDifferent、添加、覆盖或什么都不做。

使用 addIfDifferentNeighbor，只有当没有带有
相同的 （ , ) 对位于新拖车所在线的上方或下方
补充说。

使用 addIfDifferent，仅当没有相同的预告片时才会添加新预告片
( , ) 对已在消息中。

使用 add 会添加一个新的预告片，即使某些预告片具有相同的 ( ,
) 对已经在消息中。

与替换，现有拖车相同将被删除，新的
将添加预告片。 删除的预告片将是最接近的预告片（具有相同的
) 到将添加新的位置。

有了 doNothing，什么都不会做； 如果有的话，不会添加新的预告片
已经是同一个在消息中。

拖车.ifmissing
此选项使您可以选择在出现以下情况时将执行的操作
还没有任何相同的预告片在消息中。

此选项的有效值为：add（这是默认值）和 doNothing。

随着添加，将添加一个新的预告片。

使用 doNothing，什么都不会做。

预告片。 。钥匙
将使用此密钥代替在拖车里。 在这个键的末尾，一个
分隔符可以出现，然后是一些空格字符。 默认情况下唯一有效的
分隔符是 :，但这可以使用tailor.separators 配置变量进行更改。

如果有分隔符，则将使用密钥而不是两者和
添加预告片时的默认分隔符。

预告片。 。在哪里
此选项采用与 拖车.where 配置变量和它
使用指定的拖车覆盖该选项指定的内容.

预告片。 .ifexist
此选项采用与 拖车如果存在 配置变量和它
使用指定的拖车覆盖该选项指定的内容.

预告片。 .ifmissing
此选项采用与 拖车.ifmissing 配置变量和
它覆盖了该选项为具有指定的拖车指定的内容.

预告片。 。命令
此选项可用于指定将被调用的 shell 命令
自动添加或修改具有指定的预告片.

指定此选项时，行为就像一个特殊的 =
在命令行的开头添加了参数，其中被认为是
带有任何前导和尾随空格的指定命令的标准输出
修剪掉。

如果命令包含 $ARG 字符串，该字符串将被替换为
现有拖车的一部分，如果有的话，在命令之前
上马。

如果一些 = 参数也会在命令行上传递，当
预告片。 。命令 配置后，该命令也将针对每个
这些论点。 而这些参数的一部分（如果有的话）将用于
替换命令中的 $ARG 字符串。

示例

· 配置一个 签署 拖车 签字人 键，然后添加其中两个预告片
留言：

$ git config Trailer.sign.key “签字人”
$猫味精.txt
主题

的话
$猫味精.txt | git interpret-trailers --trailer '符号：爱丽丝[电子邮件保护]>' --trailer '签名：鲍勃[电子邮件保护]>'
主题

的话

签字人：爱丽丝[电子邮件保护]>
签字人：鲍勃[电子邮件保护]>

· 提取最后一次提交作为补丁，并添加一个 Cc 的网络 审核人 拖车到它：

$ git 格式补丁 -1
0001-foo.补丁
$ git interpret-trailers --trailer '抄送：爱丽丝[电子邮件保护]>' --trailer '审核人：鲍勃[电子邮件保护]>' 0001-foo.patch >0001-bar.patch

· 配置一个 签署 带有命令的预告片以自动添加“签字人：”
仅当没有 'Signed-off-by:' 时才显示作者信息，并显示它是如何
工作原理：

$ git config Trailer.sign.key“签字人：”
$ git config Trailer.sign.ifmissing 添加
$ git 配置拖车.sign.ifexists doNothing
$ git config tail.sign.command 'echo "$(git config user.name) <$(git config user.email)>"'
$ git 解释拖车 <
> EOF

签字人：鲍勃[电子邮件保护]>
$ git 解释拖车 <
> 签字人：Alice[电子邮件保护]>
> EOF

签字人：爱丽丝[电子邮件保护]>

· 配置一个 固定 带有包含一个键的预告片 # 在这之后没有空间
字符，并展示它是如何工作的：

$ git config Trailer.separators ":#"
$ git config Trailer.fix.key "Fix #"
$ echo "主题" | git 解释拖车 --trailer fix=42
主题

修复#42

· 配置一个 看到 带有命令的预告片以显示提交的主题
相关，并展示它是如何工作的：

$ git config Trailer.see.key "另见："
$ git config Trailer.see.ifExists“替换”
$ git 配置拖车.see.ifMissing "doNothing"
$ git config tail.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git 解释拖车 <
> 主题
>
>留言
>
> 见：头~2
> EOF
主题

的话

另见：fe3187489d69c4（相关提交的主题）

· 使用一些带有空值的预告片配置提交模板（使用 sed 显示
并将尾随空格保留在预告片的末尾），然后配置一个 commit-msg
使用的钩子 混帐 口译预告片 删除带有空值的拖车并添加
a git 版本 拖车：

$ sed -e 's/ Z$//' >commit_template.txt <
> ***主题***
>
> ***留言***
>
> 修正：Z
> 抄送：Z
> 审核人：Z
> 签字人：Z
> EOF
$ git config commit.template commit_template.txt
$ cat >.git/hooks/commit-msg <
> #!/ bin / sh的
> git interpret-trailers --trim-empty --trailer "git-version: \$(git describe)" "\$1" > "\$1.new"
> mv "\$1.new" "\$1"
> EOF
$ chmod +x .git/hooks/commit-msg

使用 onworks.net 服务在线使用 git-interpret-trailers