配置 Git¶
本章描述了维护者级别的 Git 配置。
拉取请求中使用的标记分支(参见创建拉取请求)应该使用开发者的公共 GPG 密钥进行签名。带签名的标签可以通过将 -u <key-id>
传递给 git tag
来创建。然而,由于你通常会为项目使用相同的密钥,你可以在配置中设置它,并使用 -s
标志。要设置默认的 key-id
,请使用
git config user.signingkey "keyname"
或者,手动编辑你的 .git/config
或 ~/.gitconfig
文件
[user]
name = Jane Developer
email = jd@domain.org
signingkey = jd@domain.org
你可能需要告诉 git
使用 gpg2
[gpg]
program = /path/to/gpg2
你可能也想告诉 gpg
使用哪个 tty
(添加到你的 shell rc 文件中)
export GPG_TTY=$(tty)
创建指向 lore.kernel.org 的提交链接¶
网站 https://lore.kernel.org 旨在作为所有关于或影响内核开发的邮件列表流量的宏伟档案。在此存储补丁档案是推荐的做法,当维护者将补丁应用到子系统树时,最好提供一个 Link: 标签,其中包含指向 lore 档案的引用,以便浏览提交历史的人可以找到相关讨论和某个更改背后的理由。链接标签将如下所示
Link: https://lore.kernel.org/r/<message-id>
通过将以下钩子添加到你的 Git 中,可以配置此操作在你每次执行 git am
时自动发生
$ git config am.messageid true
$ cat >.git/hooks/applypatch-msg <<'EOF'
#!/bin/sh
. git-sh-setup
perl -pi -e 's|^Message-I[dD]:\s*<?([^>]+)>?$|Link: https://lore.kernel.org/r/$1|g;' "$1"
test -x "$GIT_DIR/hooks/commit-msg" &&
exec "$GIT_DIR/hooks/commit-msg" ${1+"$@"}
:
EOF
$ chmod a+x .git/hooks/applypatch-msg