From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f180.google.com (mail-pl1-f180.google.com [209.85.214.180]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7406337D100 for ; Mon, 7 Sep 2026 05:39:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.180 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788759576; cv=none; b=Fbr3Kly3Kh8wDYIETJXbITLbSv+m5vVjOwESl6fkEOzqrAShl0I/SMdIv6ktzRQV2gjRlQVzuFmJT9t3T4miFbxIejhYU3gjwWCdFwKMH3hrM1snu2wnSmldbEuJxh+79q3PeWsaxcoVpqjicH5Z+DZCPI3XD4JNqo3+/hq1dTI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788759576; c=relaxed/simple; bh=a0Bcu+lT36QX4vk+ppmH/K5l9MrLihLpvh9X6ygca7I=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=eI/VuzQH09x9EAlIm5z+WbPsY0kHvk5P0wUh2202szAnyeLc41FWC7YD+0bGEOTarsQWfodq1CYx1jSitd4/PfZXflhRwKNyDCUI+Tw6l9DG6lTkm3GzND2t+S+Hlr6kqWptes58YB8kpW2KWbPMXAinZ+Ysqnd4dwO038pk6cM= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=PdEzqXEw; arc=none smtp.client-ip=209.85.214.180 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="PdEzqXEw" Received: by mail-pl1-f180.google.com with SMTP id d9443c01a7336-2d7195706f1so33601155ad.0 for ; Sun, 06 Sep 2026 22:39:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1788759575; x=1789364375; darn=vger.kernel.org; h=content-transfer-encoding:content-type:in-reply-to:content-language :from:references:cc:to:subject:user-agent:mime-version:date :message-id:from:to:cc:subject:date:message-id:reply-to:content-type; bh=KRD5YcVDqWb/QziR/ykVQXiAyMnu27xu7XUdKE8PQd8=; b=PdEzqXEwRM/hAEaOCwHn256bf+PS6ABMieCtTu+fSepAvMQgPf2pQjeJKk2nnCZ20M FXiWzMmVn+Er2ZUDj4ecBNojNjUPY2RleJM/rxGd7VXWJm3XuiTm0yoVIQrhimrGD7ko WuEsu3tXeZEmkqADz+TlF8bv0hldU4iE2zNF2jwENaiyrOBWzCS7l+kVIO9qBpZ59/U5 ArmyQIccPJ8Ro9djhjGpYMBDtwZ/Itf9Ugmi8d2HLlWlDzhKWkufs6TavOi2F3SrQhTZ UcNqbQmx4/Ip8i9M/Bsss2mH8tPMlzStYzlQDkXu3HM9Wo7NH69ROH5nDvDYXCE29fcu n/Fw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1788759575; x=1789364375; h=content-transfer-encoding:content-type:in-reply-to:content-language :from:references:cc:to:subject:user-agent:mime-version:date :message-id:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=KRD5YcVDqWb/QziR/ykVQXiAyMnu27xu7XUdKE8PQd8=; b=f2XmS8xxoL1NTmhs91B4xG0wB1PeH11HRSEMO3iP8jS0r9Ux/G8DdfpFfeXZpj75Nd x2pu1lb7+f5bbaCF9SdtyN+jl4WnVytFoZIEdkNR7MuK04KTrVrVLMf+DDZPHicTSe7d SdOVb1DwRLScnePm936btS3X/X0jg8i9X9GhWPmGnMRm+Nc3sbWVKf/+kf5Fz/uDvXVh prxaFt5ALcGlDc0mAk+O79XHCvrsEp38nNGoeD8X9nS4mbQX4Yp/cv+mch92hEPi16/0 6TSSMJAMqZ+CSZI58ZMPbnUw+SMJw6G5LBxDH27liRXrMJTT80Xa3/0PRhy3ug485NyE 8wCw== X-Gm-Message-State: AFuF++nOxPUWNTlwNznKO2ypwHkAQKruEbndlle1rDhYp4d6Tb/tp3Je 4gZowVclCwxcRiwFJRSuFM5Af/jpDOF01pilSCr8FEZC/BFZRVxHEL2x X-Gm-Gg: AYBFou2kY8RHmOG5vGme/wjU++IEh3I8I6qzMrSliQ8oXoZjdKbrTsCCHI5vQBktMLS QGgEsNF/VMl/NmmjPE4O/6l8wJI/v9T18FAdtEx8z8oG+miH87UDfNujoe5uupBMuCKeIGVGhST FNfvB3T8D/qkrBJGNiY8Kf/mzMyXaYEEwmMsVFTIXOYw+svMChxebvi3lYrgJFyoBcjTEpzRVNc vA+AYsALWwa9MOxikmMcvoSPUgMkwvujB3GTG1HXfS56HB7Hd4/k6hRkAtniyCM8iKodJSBR5iX Z5EiBA0mTDOGF9wvRQDnvmcy21/qtto51VFSXTplX3siPfP+/QKIGc3dfXCtYIlNmFpMagJbQwt asBcB1gGNZXvBURY5pFxwJTSZ84WjHDz306gMdkzzUoH+3oEkKiWrkvLVl2Z9rAAhryz6pkN9xF yYKFGrX9wPYKfXhkY5XQUjBKrCKX/g2kJ9h5mKnsOP1kv/6xR15OlhV/ZAlMYMXBgcmmoPTT7zp TqoHE+2cDWn7vu3c4o9vGDlrw== X-Received: by 2002:a17:90b:4c8b:b0:38f:2168:b9cb with SMTP id 98e67ed59e1d1-39b260f4180mr31653630a91.9.1788759574591; Sun, 06 Sep 2026 22:39:34 -0700 (PDT) Received: from [192.168.2.166] (104.194.78.75.16clouds.com. [104.194.78.75]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-39b08cacba5sm25786766a91.12.2026.09.06.22.39.29 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 06 Sep 2026 22:39:34 -0700 (PDT) Message-ID: <15c96f0d-3b6e-4cd2-9d48-9b7a639cf3d5@gmail.com> Date: Mon, 7 Sep 2026 13:39:27 +0800 Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v3 0/2] docs/zh_CN: translate process/applying-patches.rst into Chinese To: Weijie Yuan , Mauro Carvalho Chehab , Mauro Carvalho Chehab , =?UTF-8?B?TsOtY29sYXMgRi4gUi4gQS4gUHJhZG8=?= , Alex Shi , Yanteng Si , Dongliang Mu , Jonathan Corbet , Shuah Khan Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org References: <20260817-apply-patches-v3-0-45e3bd2b1ccc@wyuan.org> From: Alex Shi Content-Language: en-US In-Reply-To: <20260817-apply-patches-v3-0-45e3bd2b1ccc@wyuan.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Applied, thanks! On 2026/8/17 01:47, Weijie Yuan wrote: > This series adds a Simplified Chinese translation of > Documentation/process/applying-patches.rst. > > The first patch adds the translation and includes it in the zh_CN process > toctree. Its :Original: field uses the original document path directly; > no translation-specific reference label is introduced. > > _Changes in v3_ > > The second patch updates existing zh_CN references to point to the new > translation. In ordinary paragraphs, the absolute Documentation/...rst > path is used and is handled by automarkup. The entry in process/howto.rst > is a definition-list term, which automarkup does not process. It therefore > uses the named :doc: form as the minimal explicit-link exception, without > reintroducing a cn_applying_patches label and using :ref:. > > RFC: > > I considered the two competing preferences for cross-references. Jon > recommends using a plain absolute Documentation/...rst path, while > another view (I found the discussion in 2021, so I added your email > addresses, thanks.) is to avoid :doc: markup where automarkup can create > the link automatically. I follow both rules where they apply: the plain > path is used in normal paragraphs. However, this particular entry is a > definition-list term, which automarkup does not process, so the plain > path is rendered as text rather than a link. The named :doc: form is > therefore used only for this narrow exception, without adding a > translation-specific label. (Seems to be a workaround) > > I would welcome guidance on one stylistic point. (Since I missed > previous discussions) The surrounding entries in this definition list > use :ref:, while this new entry uses the named :doc: form because it > links to a whole document without a translation-specific label. Does > this look out of place here? If so, I am happy to follow the preferred > cross-reference style. > > [Words are polished by LLM, but I think it's what I want to say] > > Thanks! > > Sorry Mauro, I don't know which address you'll prefer, so I add both. > > --- > Changes in v3: > - Deal with the ref style, see above > - Link to v2:https://patch.msgid.link/20260815-apply-patches-v2-0-3fdd873d31cc@wyuan.org > > Changes in v2: > - Merge first two patches into one. > - Remove self-ref (.. _cn.rst) and changes ref style from 'ref' to > direct file name > - Link to v1:https://patch.msgid.link/cover.1784289654.git.wy@wyuan.org > > To: Mauro Carvalho Chehab > To: Mauro Carvalho Chehab > To: Nícolas F. R. A. Prado > To: Alex Shi > To: Yanteng Si > To: Dongliang Mu > To: Jonathan Corbet > To: Shuah Khan > Cc:linux-doc@vger.kernel.org > Cc:linux-kernel@vger.kernel.org > > --- > Weijie Yuan (2): > docs/zh_CN: add process/applying-patches Chinese translation > docs/zh_CN: link to Chinese applying-patches translation > > .../translations/zh_CN/admin-guide/README.rst | 2 +- > .../zh_CN/process/applying-patches.rst | 390 +++++++++++++++++++++ > Documentation/translations/zh_CN/process/howto.rst | 2 +- > Documentation/translations/zh_CN/process/index.rst | 2 +- > 4 files changed, 393 insertions(+), 3 deletions(-) > > Range-diff versus v2: > > 1: 596ec00ba7c5 = 1: 13da5addcb90 docs/zh_CN: add process/applying-patches Chinese translation > 2: b3a9c4893250 ! 2: 7c156c1d41b7 docs/zh_CN: link to Chinese applying-patches translation > @@ Documentation/translations/zh_CN/admin-guide/README.rst: Linux内核6.x版本 并且希望跳转到6.0.3，那么在应用6.0.3补丁之前，必须首先撤销6.0.2补丁 > （即patch -R）。更多关于这方面的内容，请阅读 > - :ref:`Documentation/process/applying-patches.rst ` 。 > -+ :ref:`Documentation/translations/zh_CN/process/applying-patches.rst ` 。 > ++ Documentation/translations/zh_CN/process/applying-patches.rst 。 > > 或者，脚本 patch-kernel 可以用来自动化这个过程。它能确定当前内核版本并 > 应用找到的所有补丁:: > @@ Documentation/translations/zh_CN/process/howto.rst: Linux内核代码中包含 > 的内容，可以查看这些文档。 > > - :ref:`Documentation/process/applying-patches.rst ` > -+ :ref:`Documentation/translations/zh_CN/process/applying-patches.rst ` > ++ :doc:`Documentation/translations/zh_CN/process/applying-patches.rst ` > 关于补丁是什么以及如何将它打在不同内核开发分支上的好介绍 > > 内核还拥有大量从代码自动生成或者从 ReStructuredText(ReST) 标记生成的文档， > > --- > base-commit: 1a0364f09c1311dad5ad1ccba7e169a412f6b547 > change-id: 20260815-apply-patches-601ad9b42f27 >