From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=91.218.175.99 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1794216543; b=U2An5JnAHkHum4VT7FwU+0TcnfcumtNKbnQFoBFrTcAhx1ajSicm/NKcWMxm3fArhwpV li/HNYM+4apZ4Ry53xOjyKU5FVfIwMdu9OPRlWtVCEIxgupoPd7aScPeVKZyzKGy82E+v 4cA2A7WHtIyP6L/utLIPpLWk6I448F7K2NhICscjfYzxsobo/E0HqH+0W7iBKxoCfHljX 4SI3kMXEctUbwxIXN4TaQfZb4mQhx41bmkLP0xyNaAIQWos0jlnn5NF4K0j4PLfwYKf/9 576WsM3AHesDA5Pf+Q3/+4YNiSQJ/o6GvxbhQlcDxq0+LobEOey0Xu9hAjEI4j7UzZQ== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794216543; h=DMARC-Filter:X-Envelope-To:DKIM-Signature:X-Envelope-To:Received: X-Mizu-Trace-ID:X-Migadu-Flow:From:Date:Subject:MIME-Version: Content-Type:Content-Transfer-Encoding:Message-Id:References: In-Reply-To:To:Cc:X-Mailer; bh=9WWa6vHRRlsGCpt4EhE12L4/Z9gVzBMyiy9P3klk1Lg=; b=KsQAStR90IxVJFtrXxrzaINL9p1cCAXSX14LnGTfsN+rC0WHQBwwe5xvVx3yLu3tRgCu 7Ui683qwzr+im4l92ruDZBF8sSF0BTk0cbTAj7LfXNubTFGN1lmM8R6CO5xqgvllEukaw 3VeVsDbZRO0SE33d3yrI2U+bNzvmNv2Zyo6uItJtvYUbr66l80vM0NVMYHaSPcXGeUbP5 Nw3JJFKRc/HWL0g3jGt7CkLpgFM802YKHh+NKh4lyQ5/DqIVZvsQ1zYIn2fyPgg3t7Ir/ 0OoYFaBN42MbfyOMXtmlb3rbEbBICV4R+0hTJCtBxE6r8dR09QoANOAhKIsabj9M/Mw== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=wyuan.org; spf=pass smtp.mailfrom=wyuan.org; dkim=pass header.d=wyuan.org header.i=@wyuan.org header.a=rsa-sha256 header.s=key1 header.b=Q+UdGHWP; arc=none smtp.remote-ip=91.218.175.99 Received: from mta0.migadu.com (out-99.mta0.migadu.com [91.218.175.99]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E9A1960A2628 for ; Mon, 9 Nov 2026 09:29:02 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org E9A1960A2628 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=wyuan.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=wyuan.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key, unprotected) header.d=wyuan.org header.i=@wyuan.org header.a=rsa-sha256 header.s=key1 header.b=Q+UdGHWP X-Envelope-To: linux-kernel@vger.kernel.org DKIM-Signature: a=rsa-sha256; bh=iATVAbcV3iVsbKF0tyc2nICOD1Q9plaH4H9qOm9imOA=; c=simple/simple; d=wyuan.org; h=from:to:subject:date:message-id:mime-version:content-type; s=key1; t=1794216541; v=1; x=1794821341; b=Q+UdGHWPtR0yu9Uj4DjmGQ+/wa2YYBHivAnqmLTMGSOYrSvPJGaN3jszTMcxtnHctfLZQPhw +nc5JX6mJjw+KVZ/b5E6kkfI9ak2cwFnqYO9QoOZW0+Bw5mUm+rYkf5vG2VgYsnaOEP8KRvIGdL P4aeHUXfUyPiM8G6N22HlM/fLpOP6xQeW7U3/GSnsgmGhweRFvNAkeZPHRBv9Rf/9mYTm+hpAiS KvIiLNpg4GVqi255C+qYGasuzSCukk/d/a+PQGwpOSQE4SNnm78FSd13TW52v7v2VWa5LxgS2Xl 0IUmLa0c+78r3EJPxnLp1Fa0iNy3UvkrBOm//1CwKBrlw== X-Envelope-To: linux-kernel@vger.kernel.org Received: by smtp.migadu.com with ESMTPS id d80e2b56fc3d547c; Mon, 09 Nov 2026 09:29:00 +0000 X-Mizu-Trace-ID: d80e2b56fc3d547c X-Migadu-Flow: FLOW_OUT From: Weijie Yuan Date: Mon, 09 Nov 2026 17:28:31 +0800 Subject: [PATCH v3 2/2] docs/zh_CN: improve maintainer/pull-requests translation X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8bit Message-Id: <20261109-configure-git-v3-2-d7807bb8e8c7@wyuan.org> References: <20261109-configure-git-v3-0-d7807bb8e8c7@wyuan.org> In-Reply-To: <20261109-configure-git-v3-0-d7807bb8e8c7@wyuan.org> To: Alex Shi , Yanteng Si , Dongliang Mu , Jonathan Corbet , Shuah Khan , Randy Dunlap Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org X-Mailer: b4 0.16.0 After the last update to the Chinese translation, the English document removed the explicit section label, replaced the configure-git cross-reference with a direct path, and changed "tree for forever" to "tree forever". Remove the abandoned Chinese section label and point the configure-git reference to the Chinese translation. Some of the existing wording did not read very smoothly, so polish a few expressions and also correct some Git terminology. Update the translation through commit 3a1b9c4d8edb ("docs: Remove redundant word "for""). Signed-off-by: Weijie Yuan --- .../zh_CN/maintainer/pull-requests.rst | 127 +++++++++++---------- 1 file changed, 66 insertions(+), 61 deletions(-) diff --git a/Documentation/translations/zh_CN/maintainer/pull-requests.rst b/Documentation/translations/zh_CN/maintainer/pull-requests.rst index ce9725f4674c..4509ec2a2bea 100644 --- a/Documentation/translations/zh_CN/maintainer/pull-requests.rst +++ b/Documentation/translations/zh_CN/maintainer/pull-requests.rst @@ -5,19 +5,18 @@ :译者: 吴想成 Wu XiangCheng - -.. _pullrequests_zh: + 袁维杰 Weijie Yuan 如何创建拉取请求 ================ -本章描述维护人员如何创建并向其他维护人员提交拉取请求。这对将更改从一个维护者 -树转移到另一个维护者树非常有用。 +本章介绍维护者如何创建拉取请求并将其提交给其他维护者。这适用于将更改从一棵 +维护者树转移到另一棵维护者树。 -本文档由Tobin C. Harding（当时他尚不是一名经验丰富的维护人员）编写，内容主要 -来自Greg Kroah Hartman和Linus Torvalds在LKML上的评论。Jonathan Corbet和Mauro -Carvalho Chehab提出了一些建议和修改。错误不可避免，如有问题，请找Tobin C. -Harding 。 +本文档由 Tobin C. Harding（当时他尚不是一名经验丰富的维护者）编写，主要依据 +Greg Kroah-Hartman 和 Linus Torvalds 在 LKML 上的评论。Jonathan Corbet 和 +Mauro Carvalho Chehab 提出了建议和修正。曲解原意并非有意，却在所难免；请将 +责难发送给 Tobin C. Harding 。 原始邮件线程:: @@ -27,54 +26,58 @@ Harding 。 创建分支 -------- -首先，您需要将希望包含拉取请求里的所有更改都放在单独分支中。通常您将基于某开发 -人员树的一个分支，一般是打算向其发送拉取请求的开发人员。 +首先，你需要将希望包含在拉取请求中的所有更改放在一个单独的分支上。通常，这个 +分支会基于你准备向其发送拉取请求的开发者树中的某个分支。 -为了创建拉取请求，您必须首先标记刚刚创建的分支。建议您选择一个有意义的标记名， -以即使过了一段时间您和他人仍能理解的方式。在名称中包含源子系统和目标内核版本 -的指示也是一个好的做法。 +要创建拉取请求，必须先给刚刚创建的分支打标签。建议选择一个有意义的标签名称， +使你和其他人在一段时间后仍能理解其含义。一种良好做法是在名称中指明来源子系统 +和目标内核版本。 -Greg提供了以下内容。对于一个含有drivers/char中混杂事项、将应用于4.15-rc1内核的 -拉取请求，可以命名为 ``char-misc-4.15-rc1`` 。如果要在 ``char-misc-next`` 分支 -上打上此标记，您可以使用以下命令:: +Greg 给出了以下示例。对于一个包含 drivers/char 杂项、准备应用到 4.15-rc1 +内核版本的拉取请求，可以将其命名为 ``char-misc-4.15-rc1``。如果要从名为 +``char-misc-next`` 的分支创建该标签，可以使用以下命令:: git tag -s char-misc-4.15-rc1 char-misc-next -这将在 ``char-misc-next`` 分支的最后一个提交上创建一个名为 ``char-misc-4.15-rc1`` -的标记，并用您的gpg密钥签名（参见 Documentation/maintainer/configure-git.rst ）。 +该命令会基于 ``char-misc-next`` 分支的最后一个提交创建名为 +``char-misc-4.15-rc1`` 的签名标签，并使用你的 GPG 密钥签名（参见 +Documentation/translations/zh_CN/maintainer/configure-git.rst）。 -Linus只接受基于签名过的标记的拉取请求。其他维护者可能会有所不同。 +Linus 只接受基于签名标签的拉取请求。其他维护者的要求可能不同。 -当您运行上述命令时 ``git`` 会打开编辑器要求你描述一下这个标记。在本例中您需要 -描述拉取请求，所以请概述一下包含的内容，为什么要合并，是否完成任何测试。所有 -这些信息都将留在标记中，然后在维护者合并拉取请求时保留在合并提交中。所以把它 -写好，它将永远留在内核中。 +运行上述命令时，``git`` 会打开编辑器并要求你描述该标签。在本例中，你描述的是 +一个拉取请求，因此应概述其中包含什么、为何应当合并，以及做过哪些测试（如有）。 +所有这些信息都会保存在标签本身中；如果维护者合并了拉取请求，它们还会进入维护者 +创建的合并提交。因此请认真撰写，因为它将永远保留在内核树中。 -正如Linus所说:: +正如 Linus 所说:: - 不管怎么样，至少对我来说，重要的是 *信息* 。我需要知道我在拉取什么、 - 为什么我要拉取。我也希望将此消息用于合并消息，因此它不仅应该对我有 - 意义，也应该可以成为一个有意义的历史记录。 + 总之，至少对我而言，重要的是 *说明文字*。我想知道自己 + 正在拉取什么，以及为什么应当拉取。我还希望把这段说明用作合并说明， + 所以它不但要让我看得明白，还应当能成为有意义的历史记录。 - 注意，如果拉取请求有一些不寻常的地方，请详细说明。如果你修改了并非 - 由你维护的文件，请解释 **为什么** 。我总会在差异中看到的，如果你不 - 提的话，我只会觉得分外可疑。当你在合并窗口后给我发新东西的时候， - （甚至是比较重大的错误修复），不仅需要解释做了什么、为什么这么做， - 还请解释一下 **时间问题** 。为什么错过了合并窗口…… + 请注意，如果拉取请求中有什么异常，就非常应该在说明中写清楚。 + 如果你改动了自己并不维护的文件，请解释 _为什么_。无论如何，我会在 + 差异统计中看到它；如果你没提到，我只会更加怀疑。当你在合并窗口 + 结束后给我发送新内容（甚至是错误修复，但看起来很吓人的那种）时， + 不仅要解释它们做了什么、为什么这样做，还要解释这个 _时机_。 + 发生了什么，导致它没能通过合并窗口进入…… - 我会看你写在拉取请求邮件和签名标记里面的内容，所以根据你的工作流， - 你可以在签名标记里面描述工作内容（也会自动放进拉取请求邮件），也 - 可以只在标记里面放个占位符，稍后在你实际发给我拉取请求时描述工作内容。 + 我会采用你写在拉取请求邮件 _和_ 签名标签中的内容。因此， + 取决于你的工作流程，你可以在签名标签中描述自己的工作（这些内容也会 + 自动进入拉取请求邮件），也可以让签名标签仅仅作为一个没有实质内容的 + 占位符，等到真正向我发送拉取请求时再描述这项工作。 - 是的，我会编辑这些消息。部分因为我需要做一些琐碎的格式调整（整体缩进、 - 括号等），也因为此消息可能对我有意义（描述了冲突或一些个人问题）而对 - 合并提交信息上下文没啥意义，因此我需要尽力让它有意义起来。我也会 - 修复一些拼写和语法错误，特别是非母语者（母语者也是;^）。但我也会删掉 - 或增加一些内容。 + 没错，我会编辑这段说明。一方面是因为我通常会做些简单的格式调整（整体 + 缩进、引用等）；另一方面，其中一些内容在我拉取时可能很有用（例如描述 + 冲突，以及你此时发送请求所面临的个人问题），但放在合并提交说明的上下文 + 中可能没有意义，所以我会尽量使它通顺。我也会修正看到的拼写错误和糟糕 + 语法，尤其是非英语母语者写的内容（英语母语者也一样 ;^）。 + 不过，我也可能会漏掉一些，甚至再添上一些。 Linus -Greg给出了一个拉取请求的例子:: +Greg 给出了一个拉取请求示例:: Char/Misc patches for 4.15-rc1 @@ -104,9 +107,10 @@ Greg给出了一个拉取请求的例子:: Signed-off-by: Your-name-here -此标记消息格式就像一个git提交。顶部有一行“总结标题”， 一定要在下面sign-off。 +标签说明的格式与 Git 提交说明相同：顶部用一行作为“摘要主题”， +并确保在底部添加签署信息。 -现在您已经有了一个本地签名标记，您需要将它推送到可以被拉取的位置:: +现在本地已有签名标签，需要将其推送到可供拉取的位置:: git push origin char-misc-4.15-rc1 @@ -114,35 +118,36 @@ Greg给出了一个拉取请求的例子:: 创建拉取请求 ------------ -最后要做的是创建拉取请求消息。可以使用 ``git request-pull`` 命令让 ``git`` -为你做这件事，但它需要确定你想拉取什么，以及拉取针对的基础（显示正确的拉取 -更改和变更状态）。以下命令将生成一个拉取请求:: +最后要做的是编写拉取请求消息。``git`` 可以方便地用 ``git request-pull`` +命令代劳，但需要获得一些帮助，以确定你希望对方拉取什么，以及拉取内容应以什么为 +基础（从而显示正确的待拉取更改和差异统计）。以下命令会生成一个拉取请求:: git request-pull master git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/char-misc.git/ char-misc-4.15-rc1 -引用Greg的话:: +引用 Greg 的话:: - 此命令要求git比较从“char-misc-4.15-rc1”标记位置到“master”分支头（上述 - 例子中指向了我从Linus的树分叉的地方，通常是-rc发布）的差异，并去使用 - git:// 协议拉取。如果你希望使用 https:// 协议，也可以用在这里（但是请 - 注意，部分人由于防火墙问题没法用https协议拉取）。 + 这个命令要求 Git 比较“char-misc-4.15-rc1”标签所在位置与“master”分支 + 顶端之间的差异（在我的例子中，“master”指向我与 Linus 的树发生分叉前 + 的最后位置，通常是一个 -rc 版本），并使用 git:// 协议拉取。如果希望使用 + https://，也可以在这里使用（但请注意，一些位于防火墙后的用户使用 HTTPS + 方式拉取 Git 仓库时会遇到问题）。 - 如果char-misc-4.15-rc1标记没有出现在我要求拉取的仓库中，git会提醒 - 它不在那里，所以记得推送到公开地方。 + 如果请求拉取的仓库中没有“char-misc-4.15-rc1”标签，Git 会抱怨说找不到 + 它。这可以方便地提醒你，确实需要把标签推送到一个公开位置。 - “git request-pull”会包含git树的地址和需要拉取的特定标记，以及标记 - 描述全文（详尽描述标记）。同时它也会创建此拉取请求的差异状态和单个 - 提交的缩短日志。 + “git request-pull”的输出会包含要拉取的 Git 树位置和具体标签，以及 + 该标签的完整说明文字（这正是需要在标签中提供充分信息的原因）。它还会 + 生成拉取请求的差异统计，以及拉取请求所含各个提交的简短日志。 -Linus回复说他倾向于 ``git://`` 协议。其他维护者可能有不同的偏好。另外，请注意 -如果你创建的拉取请求没有签名标记， ``https://`` 可能是更好的选择。完整的讨论 -请看原邮件。 +Linus 回复说他倾向于使用 ``git://`` 协议。其他维护者可能有不同偏好。另请注意， +如果创建拉取请求时不使用签名标签，那么 ``https://`` 可能是更好的选择。完整讨论 +请参阅原始邮件线程。 提交拉取请求 ------------ -拉取请求的提交方式与普通补丁相同。向维护人员发送内联电子邮件并抄送LKML以及 -任何必要特定子系统的列表。对Linus的拉取请求通常有如下主题行:: +拉取请求的提交方式与普通补丁相同。通过邮件正文将其发送给维护者，并视需要抄送 +LKML 和相关子系统的邮件列表。发给 Linus 的拉取请求通常使用类似下面的主题行:: [GIT PULL] changes for v4.15-rc1 -- 2.56.0.438.g30c3f27cb8