From: Chen-Yu Yeh <chenyou910331@gmail.com>
To: Jonathan Corbet <corbet@lwn.net>, Alex Shi <alexs@kernel.org>
Cc: Dongliang Mu <dzm91@hust.edu.cn>,
Yanteng Si <si.yanteng@linux.dev>, Weijie Yuan <wy@wyuan.org>,
Hu Haowen <2023002089@link.tyut.edu.cn>,
linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
Chen-Yu Yeh <chenyou910331@gmail.com>
Subject: [PATCH 08/16] docs/zh_TW: process: localize terminology in stable-kernel-rules.rst
Date: Wed, 22 Jul 2026 05:55:34 +0800 [thread overview]
Message-ID: <20260721215542.98435-9-chenyou910331@gmail.com> (raw)
In-Reply-To: <20260721215542.98435-1-chenyou910331@gmail.com>
Retranslate from the current English text, which was heavily
restructured upstream (three submission options, stable tag variants,
tree list), and localize mainland terms to Taiwanese Mandarin
(內核→核心, 隊列→佇列, 數據→資料, ...).
update to commit 10466b17af65 ("docs: stable-kernel-rules: fix typo sent->send")
Signed-off-by: Chen-Yu Yeh <chenyou910331@gmail.com>
---
.../zh_TW/process/stable-kernel-rules.rst | 256 ++++++++++++++----
1 file changed, 208 insertions(+), 48 deletions(-)
diff --git a/Documentation/translations/zh_TW/process/stable-kernel-rules.rst b/Documentation/translations/zh_TW/process/stable-kernel-rules.rst
index 2f8f064f8629..7d286ad54f2e 100644
--- a/Documentation/translations/zh_TW/process/stable-kernel-rules.rst
+++ b/Documentation/translations/zh_TW/process/stable-kernel-rules.rst
@@ -6,7 +6,7 @@
:Original: :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>`
-如果想評論或更新本文的內容,請直接聯繫原文檔的維護者。如果你使用英文
+如果想評論或更新本文的內容,請直接聯繫原文件的維護者。如果你使用英文
交流有困難的話,也可以向中文版維護者求助。如果本翻譯更新不及時或者翻
譯存在問題,請聯繫中文版維護者::
@@ -16,53 +16,213 @@
- 李陽 Li Yang <leoyang.li@nxp.com>
- Kangkai Yin <e12051@motorola.com>
- 胡皓文 Hu Haowen <2023002089@link.tyut.edu.cn>
+ - 葉宸佑 Chen-Yu Yeh <chenyou910331@gmail.com>
-所有你想知道的事情 - 關於linux穩定版發佈
-========================================
-
-關於Linux 2.6穩定版發佈,所有你想知道的事情。
-
-關於哪些類型的補丁可以被接收進入穩定版代碼樹,哪些不可以的規則:
-----------------------------------------------------------------
-
- - 必須是顯而易見的正確,並且經過測試的。
- - 連同上下文,不能大於100行。
- - 必須只修正一件事情。
- - 必須修正了一個給大家帶來麻煩的真正的bug(不是“這也許是一個問題...”
- 那樣的東西)。
- - 必須修正帶來如下後果的問題:編譯錯誤(對被標記爲CONFIG_BROKEN的例外),
- 內核崩潰,掛起,數據損壞,真正的安全問題,或者一些類似“哦,這不
- 好”的問題。簡短的說,就是一些致命的問題。
- - 沒有“理論上的競爭條件”,除非能給出競爭條件如何被利用的解釋。
- - 不能存在任何的“瑣碎的”修正(拼寫修正,去掉多餘空格之類的)。
- - 必須被相關子系統的維護者接受。
- - 必須遵循Documentation/translations/zh_CN/process/submitting-patches.rst裏的規則。
-
-向穩定版代碼樹提交補丁的過程:
-------------------------------
-
- - 在確認了補丁符合以上的規則後,將補丁發送到stable@vger.kernel.org。
- - 如果補丁被接受到隊列裏,發送者會收到一個ACK回覆,如果沒有被接受,收
- 到的是NAK回覆。回覆需要幾天的時間,這取決於開發者的時間安排。
- - 被接受的補丁會被加到穩定版本隊列裏,等待其他開發者的審查。
- - 安全方面的補丁不要發到這個列表,應該發送到security@kernel.org。
-
-審查週期:
-----------
+所有你想知道的事情 - 關於Linux -stable 版本發布
+===============================================
+
+關於哪些類型的補丁會被接收進入 "-stable" 樹、哪些不會被接收的規則:
+
+- 該補丁或一個等效的修復必須已經存在於Linux主線(上游)。
+- 它必須是顯而易見正確的,並且經過測試的。
+- 連同上下文,它不能大於100行。
+- 它必須遵循
+ :ref:`Documentation/process/submitting-patches.rst <submittingpatches>`
+ 裡的規則。
+- 它必須要麼修復一個困擾人們的真實的缺陷,要麼只是添加一個裝置ID。
+ 對於前者,詳細來說:
+
+ - 它修復的問題,像是oops、當機、資料損壞、真實的安全問題、硬體怪癖
+ (hardware quirk)、建置錯誤(但不包括標記為CONFIG_BROKEN的東西),
+ 或者一些“喔,這可不好”之類的問題。
+ - 發行版核心的使用者所報告的嚴重問題,如果修復的是顯著的效能或互動性
+ 問題,也可以被考慮。由於這些修復不那麼顯而易見,並且有較高的風險引入
+ 不易察覺的迴歸,它們應該只由發行版核心的維護者提交,並附上補充說明,
+ 給出指向bugzilla條目(如果存在)的連結,以及關於使用者可見影響的額外
+ 資訊。
+ - 不接受“這可能是一個問題...”之類的東西,比如“理論上的競爭條件”,除非
+ 同時提供了缺陷如何被利用的解釋。
+ - 不接受對使用者沒有好處的“瑣碎”修復(拼寫更改、空白清理等)。
+
+
+向 -stable 樹提交補丁的流程
+---------------------------
+
+.. note::
+
+ 安全補丁不應(只)由 -stable 審查流程處理,而應遵循
+ :ref:`Documentation/process/security-bugs.rst <securitybugs>`
+ 的流程。
+
+要向 -stable 樹提交更改,有三個選項:
+
+1. 在你隨後提交到主線的補丁的描述中,加上一個“stable標籤”。
+2. 請求穩定版團隊撿取一個已經合併到主線的補丁。
+3. 向穩定版團隊提交一個與已合併到主線的更改等效的補丁。
+
+以下小節更詳細地描述每個選項。
+
+:ref:`tw_option_1` 是 **強烈** 推薦的做法,它最簡單也最常見。
+:ref:`tw_option_2` 主要用於提交時沒有考慮向後移植的更改。 :ref:`tw_option_3`
+是前兩個選項之外的替代方案,用於已合併到主線的補丁需要調整才能套用到較舊系列
+的情況(例如由於API變化)。
+
+使用選項2或3時,可以要求將你的更改包含到特定的穩定版系列中。這麼做時,要確保
+該修復或等效修復適用於、已提交到、或已經存在於所有仍在維護的較新穩定版樹中。
+這是為了防止使用者日後更新時可能遇到的迴歸,例如一個合併於5.19-rc1的修復被
+向後移植到5.10.y,卻沒有移植到5.15.y。
+
+.. _tw_option_1:
+
+選項1
+*****
+
+要讓你提交到主線的補丁之後被自動撿取到穩定版樹,請在簽署(sign-off)區加上
+這個標籤::
+
+ Cc: stable@vger.kernel.org
+
+當修復未公開的漏洞時,請改用 ``Cc: stable@kernel.org``:它可以降低透過
+'git send-email' 意外將修復公開的機會,因為發送到該地址的郵件不會被投遞到
+任何地方。
+
+補丁合併到主線後,它將被套用到穩定版樹,而無需作者或子系統維護者再做任何
+事情。
+
+要向穩定版團隊發送額外的指示,可使用shell風格的行內註解來傳遞任意的或預定義
+的備註:
+
+* 指明揀選(cherry pick)所需的額外補丁前置條件::
+
+ Cc: <stable@vger.kernel.org> # 3.3.x: a1f84a3: sched: Check for idle
+ Cc: <stable@vger.kernel.org> # 3.3.x: 1b9508f: sched: Rate-limit newidle
+ Cc: <stable@vger.kernel.org> # 3.3.x: fd21073: sched: Fix affinity logic
+ Cc: <stable@vger.kernel.org> # 3.3.x
+ Signed-off-by: Ingo Molnar <mingo@elte.hu>
+
+ 上面標籤序列的含義為::
+
+ git cherry-pick a1f84a3
+ git cherry-pick 1b9508f
+ git cherry-pick fd21073
+ git cherry-pick <this commit>
+
+ 注意,對於一個補丁系列,你不必把系列中已有的補丁列為前置條件。例如,如果
+ 你有如下補丁系列::
+
+ patch1
+ patch2
+
+ 其中patch2依賴patch1,如果你已經把patch1標記為穩定版收錄,就不必再把它列
+ 為patch2的前置條件。
+
+* 指出核心版本的前置條件::
+
+ Cc: <stable@vger.kernel.org> # 3.3.x
+
+ 該標籤的含義為::
+
+ git cherry-pick <this commit>
+
+ 對每個從指定版本開始的“-stable”樹執行。
+
+ 注意,如果穩定版團隊可以從Fixes:標籤推導出適當的版本,則無需這樣標記。
+
+* 延遲補丁的撿取::
- - 當穩定版的維護者決定開始一個審查週期,補丁將被髮送到審查委員會,以
- 及被補丁影響的領域的維護者(除非提交者就是該領域的維護者)並且抄送
- 到linux-kernel郵件列表。
- - 審查委員會有48小時的時間,用來決定給該補丁回覆ACK還是NAK。
- - 如果委員會中有成員拒絕這個補丁,或者linux-kernel列表上有人反對這個
- 補丁,並提出維護者和審查委員會之前沒有意識到的問題,補丁會從隊列中
- 丟棄。
- - 在審查週期結束的時候,那些得到ACK回應的補丁將會被加入到最新的穩定版
- 發佈中,一個新的穩定版發佈就此產生。
- - 安全性補丁將從內核安全小組那裏直接接收到穩定版代碼樹中,而不是通過
- 通常的審查週期。請聯繫內核安全小組以獲得關於這個過程的更多細節。
-
-審查委員會:
-------------
- - 由一些自願承擔這項任務的內核開發者,和幾個非志願的組成。
+ Cc: <stable@vger.kernel.org> # after -rc3
+
+* 指出已知的問題::
+
+ Cc: <stable@vger.kernel.org> # see patch description, needs adjustments for <= 6.3
+
+此外,stable標籤還有一種變體,可以讓穩定版團隊的向後移植工具(例如AUTOSEL
+或尋找含有'Fixes:'標籤的提交的腳本)忽略一個更改::
+
+ Cc: <stable+noautosel@kernel.org> # reason goes here, and must be present
+
+.. _tw_option_2:
+
+選項2
+*****
+
+如果補丁已經合併到主線,請發送一封電子郵件到stable@vger.kernel.org,內容
+包含補丁的標題、提交ID、你認為它應該被套用的原因,以及你希望它被套用到哪些
+核心版本。
+
+.. _tw_option_3:
+
+選項3
+*****
+
+在確認補丁符合上述規則後,將補丁發送到stable@vger.kernel.org,並註明你希望
+它被套用到的核心版本。這麼做時,你必須在你所提交補丁的更改日誌中註明上游的
+提交ID,並在提交說明文字上方以單獨一行標註,像這樣::
+
+ commit <sha1> upstream.
+
+或者::
+
+ [ Upstream commit <sha1> ]
+
+如果提交的補丁與原始的上游補丁有出入(例如因為需要為較舊的API調整),則必須
+在補丁描述中非常清楚地記錄並說明理由。
+
+
+提交之後
+--------
+
+當補丁被接受進入佇列後,發送者會收到一個ACK;如果補丁被拒絕,則會收到NAK。
+這個回覆可能需要幾天時間,取決於穩定版團隊成員的日程安排。
+
+如果被接受,補丁將被加入 -stable 佇列,供其他開發人員和相關子系統維護者
+審查。
+
+
+審查週期
+--------
+
+- 當 -stable 維護者決定進行審查週期時,補丁將被發送到審查委員會,以及補丁
+ 影響領域的維護者(除非提交者就是該領域的維護者),並抄送到linux-kernel
+ 郵件列表。
+- 審查委員會有48小時的時間對補丁作出ACK或NAK。
+- 如果補丁被委員會成員拒絕,或者linux-kernel列表上的成員反對這個補丁並提出
+ 了維護者和委員會成員沒有意識到的問題,補丁將從佇列中移除。
+- 通過ACK的補丁將作為釋出候選(-rc)版本的一部分再次發布,以供開發人員和
+ 測試人員測試。
+- 通常只會產生一個 -rc 版本,然而如果存在未解決的問題,某些補丁可能會被修改
+ 或移除,或者有額外的補丁進入佇列。此後會發布更多的 -rc 版本並加以測試,
+ 直到不再發現問題為止。
+- 可以在郵件列表上發送帶有任何所需測試資訊的“Tested-by:”郵件來回覆 -rc
+ 版本。“Tested-by:”標籤將被收集並加入到發布提交中。
+- 在審查週期結束時,新的 -stable 版本將被發布,其中包含所有排隊的、經過測試
+ 的補丁。
+- 安全補丁將由核心安全團隊直接接受進入 -stable 樹,而不經過正常的審查週期。
+ 關於這一流程的更多細節,請聯繫核心安全團隊。
+
+
+樹
+--
+
+- 已完成版本和進行中版本的補丁佇列可以在以下位置找到:
+
+ https://git.kernel.org/pub/scm/linux/kernel/git/stable/stable-queue.git
+
+- 所有穩定版核心的最終定版並打上標籤的版本,可以在以下位置的每個版本各自的
+ 分支中找到:
+
+ https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
+
+- 所有穩定版核心版本的釋出候選版本可以在以下位置找到:
+
+ https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable-rc.git/
+
+ .. warning::
+ -stable-rc 樹是stable-queue樹在某個時間點的快照,會頻繁變動,因此會經常
+ 被rebase。它只應被用於測試目的(例如供CI系統使用)。
+
+
+審查委員會
+----------
+- 審查委員會由一些自願承擔這項任務的核心開發人員組成,還有幾位不是自願的。
--
2.43.0
next prev parent reply other threads:[~2026-07-21 21:57 UTC|newest]
Thread overview: 20+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-21 21:55 [PATCH 00/16] docs/zh_TW: localize terminology and sync process/ documents Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 01/16] docs/zh_TW: process: localize terminology in 7.AdvancedTopics.rst Chen-Yu Yeh
2026-07-22 5:56 ` Weijie Yuan
2026-07-22 8:48 ` Weijie Yuan
2026-07-21 21:55 ` [PATCH 02/16] docs/zh_TW: process: localize terminology in 1.Intro.rst Chen-Yu Yeh
2026-07-22 7:42 ` Weijie Yuan
2026-07-21 21:55 ` [PATCH 03/16] docs/zh_TW: process: localize terminology in code-of-conduct-interpretation.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 04/16] docs/zh_TW: process: localize terminology in license-rules.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 05/16] docs/zh_TW: process: localize terminology in email-clients.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 06/16] docs/zh_TW: process: localize terminology in programming-language.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 07/16] docs/zh_TW: process: localize terminology in coding-style.rst Chen-Yu Yeh
2026-07-21 21:55 ` Chen-Yu Yeh [this message]
2026-07-21 21:55 ` [PATCH 09/16] docs/zh_TW: process: localize terminology in 5.Posting.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 10/16] docs/zh_TW: process: localize terminology in 2.Process.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 11/16] docs/zh_TW: process: localize terminology in howto.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 12/16] docs/zh_TW: process: localize terminology in embargoed-hardware-issues.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 13/16] docs/zh_TW: process: localize terminology in submitting-patches.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 14/16] docs/zh_TW: process: localize terminology in 8.Conclusion.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 15/16] docs/zh_TW: process: localize terminology in index.rst Chen-Yu Yeh
2026-07-21 21:55 ` [PATCH 16/16] docs/zh_TW: Add a glossary for Traditional Chinese translations Chen-Yu Yeh
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260721215542.98435-9-chenyou910331@gmail.com \
--to=chenyou910331@gmail.com \
--cc=2023002089@link.tyut.edu.cn \
--cc=alexs@kernel.org \
--cc=corbet@lwn.net \
--cc=dzm91@hust.edu.cn \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=si.yanteng@linux.dev \
--cc=wy@wyuan.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.