0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 .. _tw_process_howto:
0004
0005 .. include:: ../disclaimer-zh_TW.rst
0006
0007 :Original: :ref:`Documentation/process/howto.rst <process_howto>`
0008
0009 譯者::
0010
0011 英文版維護者: Greg Kroah-Hartman <greg@kroah.com>
0012 中文版維護者: 李陽 Li Yang <leoyang.li@nxp.com>
0013 中文版翻譯者: 李陽 Li Yang <leoyang.li@nxp.com>
0014 時奎亮 Alex Shi <alex.shi@linux.alibaba.com>
0015 中文版校譯者:
0016 鍾宇 TripleX Chung <xxx.phy@gmail.com>
0017 陳琦 Maggie Chen <chenqi@beyondsoft.com>
0018 王聰 Wang Cong <xiyou.wangcong@gmail.com>
0019 胡皓文 Hu Haowen <src.res@email.cn>
0020
0021 如何參與Linux內核開發
0022 =====================
0023
0024 這是一篇將如何參與Linux內核開發的相關問題一網打盡的終極祕笈。它將指導你
0025 成爲一名Linux內核開發者,並且學會如何同Linux內核開發社區合作。它儘可能不
0026 包括任何關於內核編程的技術細節,但會給你指引一條獲得這些知識的正確途徑。
0027
0028 如果這篇文章中的任何內容不再適用,請給文末列出的文件維護者發送補丁。
0029
0030
0031 入門
0032 ----
0033
0034 你想了解如何成爲一名Linux內核開發者?或者老闆吩咐你「給這個設備寫個Linux
0035 驅動程序」?這篇文章的目的就是教會你達成這些目標的全部訣竅,它將描述你需
0036 要經過的流程以及給出如何同內核社區合作的一些提示。它還將試圖解釋內核社區
0037 爲何這樣運作。
0038
0039 Linux內核大部分是由C語言寫成的,一些體系結構相關的代碼用到了彙編語言。要
0040 參與內核開發,你必須精通C語言。除非你想爲某個架構開發底層代碼,否則你並
0041 不需要了解(任何體系結構的)彙編語言。下面列舉的書籍雖然不能替代紮實的C
0042 語言教育和多年的開發經驗,但如果需要的話,做爲參考還是不錯的:
0043
0044 - "The C Programming Language" by Kernighan and Ritchie [Prentice Hall]
0045 《C程序設計語言(第2版·新版)》(徐寶文 李志 譯)[機械工業出版社]
0046 - "Practical C Programming" by Steve Oualline [O'Reilly]
0047 《實用C語言編程(第三版)》(郭大海 譯)[中國電力出版社]
0048 - "C: A Reference Manual" by Harbison and Steele [Prentice Hall]
0049 《C語言參考手冊(原書第5版)》(邱仲潘 等譯)[機械工業出版社]
0050
0051 Linux內核使用GNU C和GNU工具鏈開發。雖然它遵循ISO C89標準,但也用到了一些
0052 標準中沒有定義的擴展。內核是自給自足的C環境,不依賴於標準C庫的支持,所以
0053 並不支持C標準中的部分定義。比如long long類型的大數除法和浮點運算就不允許
0054 使用。有時候確實很難弄清楚內核對工具鏈的要求和它所使用的擴展,不幸的是目
0055 前還沒有明確的參考資料可以解釋它們。請查閱gcc信息頁(使用「info gcc」命令
0056 顯示)獲得一些這方面信息。
0057
0058 請記住你是在學習怎麼和已經存在的開發社區打交道。它由一羣形形色色的人組成,
0059 他們對代碼、風格和過程有著很高的標準。這些標準是在長期實踐中總結出來的,
0060 適應於地理上分散的大型開發團隊。它們已經被很好得整理成檔,建議你在開發
0061 之前儘可能多的學習這些標準,而不要期望別人來適應你或者你公司的行爲方式。
0062
0063
0064 法律問題
0065 --------
0066
0067 Linux內核原始碼都是在GPL(通用公共許可證)的保護下發布的。要了解這種許可
0068 的細節請查看原始碼主目錄下的COPYING文件。Linux內核許可準則和如何使用
0069 `SPDX <https://spdx.org/>` 標誌符說明在這個文件中
0070 :ref:`Documentation/translations/zh_TW/process/license-rules.rst <tw_kernel_licensing>`
0071 如果你對它還有更深入問題請聯繫律師,而不要在Linux內核郵件組上提問。因爲
0072 郵件組裡的人並不是律師,不要期望他們的話有法律效力。
0073
0074 對於GPL的常見問題和解答,請訪問以下連結:
0075 https://www.gnu.org/licenses/gpl-faq.html
0076
0077
0078 文檔
0079 ----
0080
0081 Linux內核代碼中包含有大量的文檔。這些文檔對於學習如何與內核社區互動有著
0082 不可估量的價值。當一個新的功能被加入內核,最好把解釋如何使用這個功能的文
0083 檔也放進內核。當內核的改動導致面向用戶空間的接口發生變化時,最好將相關信
0084 息或手冊頁(manpages)的補丁發到mtk.manpages@gmail.com,以向手冊頁(manpages)
0085 的維護者解釋這些變化。
0086
0087 以下是內核代碼中需要閱讀的文檔:
0088 :ref:`Documentation/admin-guide/README.rst <readme>`
0089 文件簡要介紹了Linux內核的背景,並且描述了如何配置和編譯內核。內核的
0090 新用戶應該從這裡開始。
0091
0092
0093 :ref:`Documentation/process/changes.rst <changes>`
0094 文件給出了用來編譯和使用內核所需要的最小軟體包列表。
0095
0096 :ref:`Documentation/translations/zh_TW/process/coding-style.rst <tw_codingstyle>`
0097 描述Linux內核的代碼風格和理由。所有新代碼需要遵守這篇文檔中定義的規
0098 范。大多數維護者只會接收符合規定的補丁,很多人也只會幫忙檢查符合風格
0099 的代碼。
0100
0101 :ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>`
0102
0103 這兩份文檔明確描述如何創建和發送補丁,其中包括(但不僅限於):
0104 - 郵件內容
0105 - 郵件格式
0106 - 選擇收件人
0107
0108 遵守這些規定並不能保證提交成功(因爲所有補丁需要通過嚴格的內容和風格
0109 審查),但是忽視他們幾乎就意味著失敗。
0110
0111 其他關於如何正確地生成補丁的優秀文檔包括:
0112 "The Perfect Patch"
0113
0114 https://www.ozlabs.org/~akpm/stuff/tpp.txt
0115
0116 "Linux kernel patch submission format"
0117
0118 https://web.archive.org/web/20180829112450/http://linux.yyz.us/patch-format.html
0119
0120 :ref:`Documentation/translations/zh_TW/process/stable-api-nonsense.rst <tw_stable_api_nonsense>`
0121 論證內核爲什麼特意不包括穩定的內核內部API,也就是說不包括像這樣的特
0122 性:
0123
0124 - 子系統中間層(爲了兼容性?)
0125 - 在不同作業系統間易於移植的驅動程序
0126 - 減緩(甚至阻止)內核代碼的快速變化
0127
0128 這篇文檔對於理解Linux的開發哲學至關重要。對於將開發平台從其他操作系
0129 統轉移到Linux的人來說也很重要。
0130
0131 :ref:`Documentation/admin-guide/security-bugs.rst <securitybugs>`
0132 如果你認爲自己發現了Linux內核的安全性問題,請根據這篇文檔中的步驟來
0133 提醒其他內核開發者並幫助解決這個問題。
0134
0135 :ref:`Documentation/translations/zh_TW/process/management-style.rst <tw_managementstyle>`
0136
0137 描述內核維護者的工作方法及其共有特點。這對於剛剛接觸內核開發(或者對
0138 它感到好奇)的人來說很重要,因爲它解釋了很多對於內核維護者獨特行爲的
0139 普遍誤解與迷惑。
0140
0141 :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>`
0142 解釋了穩定版內核發布的規則,以及如何將改動放入這些版本的步驟。
0143
0144 :ref:`Documentation/process/kernel-docs.rst <kernel_docs>`
0145 有助於內核開發的外部文檔列表。如果你在內核自帶的文檔中沒有找到你想找
0146 的內容,可以查看這些文檔。
0147
0148 :ref:`Documentation/process/applying-patches.rst <applying_patches>`
0149 關於補丁是什麼以及如何將它打在不同內核開發分支上的好介紹
0150
0151 內核還擁有大量從代碼自動生成或者從 ReStructuredText(ReST) 標記生成的文檔,
0152 比如這個文檔,它包含內核內部API的全面介紹以及如何妥善處理加鎖的規則。所有
0153 這些文檔都可以通過運行以下命令從內核代碼中生成爲PDF或HTML文檔::
0154
0155 make pdfdocs
0156 make htmldocs
0157
0158 ReST格式的文檔會生成在 Documentation/output. 目錄中。
0159 它們也可以用下列命令生成 LaTeX 和 ePub 格式文檔::
0160
0161 make latexdocs
0162 make epubdocs
0163
0164 如何成爲內核開發者
0165 ------------------
0166 如果你對Linux內核開發一無所知,你應該訪問「Linux內核新手」計劃:
0167
0168 https://kernelnewbies.org
0169
0170 它擁有一個可以問各種最基本的內核開發問題的郵件列表(在提問之前一定要記得
0171 查找已往的郵件,確認是否有人已經回答過相同的問題)。它還擁有一個可以獲得
0172 實時反饋的IRC聊天頻道,以及大量對於學習Linux內核開發相當有幫助的文檔。
0173
0174 網站簡要介紹了原始碼組織結構、子系統劃分以及目前正在進行的項目(包括內核
0175 中的和單獨維護的)。它還提供了一些基本的幫助信息,比如如何編譯內核和打補
0176 丁。
0177
0178 如果你想加入內核開發社區並協助完成一些任務,卻找不到從哪裡開始,可以訪問
0179 「Linux內核房管員」計劃:
0180
0181 https://kernelnewbies.org/KernelJanitors
0182
0183 這是極佳的起點。它提供一個相對簡單的任務列表,列出內核代碼中需要被重新
0184 整理或者改正的地方。通過和負責這個計劃的開發者們一同工作,你會學到將補丁
0185 集成進內核的基本原理。如果還沒有決定下一步要做什麼的話,你還可能會得到方
0186 向性的指點。
0187
0188 在真正動手修改內核代碼之前,理解要修改的代碼如何運作是必需的。要達到這個
0189 目的,沒什麼辦法比直接讀代碼更有效了(大多數花招都會有相應的注釋),而且
0190 一些特製的工具還可以提供幫助。例如,「Linux代碼交叉引用」項目就是一個值得
0191 特別推薦的幫助工具,它將原始碼顯示在有編目和索引的網頁上。其中一個更新及
0192 時的內核源碼庫,可以通過以下地址訪問:
0193
0194 https://elixir.bootlin.com/
0195
0196
0197 開發流程
0198 --------
0199
0200 目前Linux內核開發流程包括幾個「主內核分支」和很多子系統相關的內核分支。這
0201 些分支包括:
0202
0203 - Linus 的內核源碼樹
0204 - 多個主要版本的穩定版內核樹
0205 - 子系統相關的內核樹
0206 - linux-next 集成測試樹
0207
0208
0209 主線樹
0210 ------
0211 主線樹是由Linus Torvalds 維護的。你可以在https://kernel.org 網站或者代碼
0212 庫中下找到它。它的開發遵循以下步驟:
0213
0214 - 每當一個新版本的內核被發布,爲期兩周的集成窗口將被打開。在這段時間裡
0215 維護者可以向Linus提交大段的修改,通常這些修改已經被放到-mm內核中幾個
0216 星期了。提交大量修改的首選方式是使用git工具(內核的代碼版本管理工具
0217 ,更多的信息可以在 https://git-scm.com/ 獲取),不過使用普通補丁也是
0218 可以的。
0219 - 兩個星期以後-rc1版本內核發布。之後只有不包含可能影響整個內核穩定性的
0220 新功能的補丁才可能被接受。請注意一個全新的驅動程序(或者文件系統)有
0221 可能在-rc1後被接受是因爲這樣的修改完全獨立,不會影響其他的代碼,所以
0222 沒有造成內核退步的風險。在-rc1以後也可以用git向Linus提交補丁,不過所
0223 有的補丁需要同時被發送到相應的公衆郵件列表以徵詢意見。
0224 - 當Linus認爲當前的git源碼樹已經達到一個合理健全的狀態足以發布供人測試
0225 時,一個新的-rc版本就會被發布。計劃是每周都發布新的-rc版本。
0226 - 這個過程一直持續下去直到內核被認爲達到足夠穩定的狀態,持續時間大概是
0227 6個星期。
0228
0229 關於內核發布,值得一提的是Andrew Morton在linux-kernel郵件列表中如是說:
0230 「沒有人知道新內核何時會被發布,因爲發布是根據已知bug的情況來決定
0231 的,而不是根據一個事先制定好的時間表。」
0232
0233 子系統特定樹
0234 ------------
0235
0236 各種內核子系統的維護者——以及許多內核子系統開發人員——在原始碼庫中公開了他們
0237 當前的開發狀態。這樣,其他人就可以看到內核的不同區域發生了什麼。在開發速度
0238 很快的領域,可能會要求開發人員將提交的內容建立在這樣的子系統內核樹上,這樣
0239 就避免了提交與其他已經進行的工作之間的衝突。
0240
0241 這些存儲庫中的大多數都是Git樹,但是也有其他的scm在使用,或者補丁隊列被發布
0242 爲Quilt系列。這些子系統存儲庫的地址列在MAINTAINERS文件中。其中許多可以在
0243 https://git.kernel.org/上瀏覽。
0244
0245 在將一個建議的補丁提交到這樣的子系統樹之前,需要對它進行審查,審查主要發生
0246 在郵件列表上(請參見下面相應的部分)。對於幾個內核子系統,這個審查過程是通
0247 過工具補丁跟蹤的。Patchwork提供了一個Web界面,顯示補丁發布、對補丁的任何評
0248 論或修訂,維護人員可以將補丁標記爲正在審查、接受或拒絕。大多數補丁網站都列
0249 在 https://patchwork.kernel.org/
0250
0251 Linux-next 集成測試樹
0252 ---------------------
0253
0254 在將子系統樹的更新合併到主線樹之前,需要對它們進行集成測試。爲此,存在一個
0255 特殊的測試存儲庫,其中幾乎每天都會提取所有子系統樹:
0256
0257 https://git.kernel.org/?p=linux/kernel/git/next/linux-next.git
0258
0259 通過這種方式,Linux-next 對下一個合併階段將進入主線內核的內容給出了一個概要
0260 展望。非常歡冒險的測試者運行測試Linux-next。
0261
0262 多個主要版本的穩定版內核樹
0263 -----------------------------------
0264 由3個數字組成的內核版本號說明此內核是-stable版本。它們包含內核的相對較小且
0265 至關重要的修補,這些修補針對安全性問題或者嚴重的內核退步。
0266
0267 這種版本的內核適用於那些期望獲得最新的穩定版內核並且不想參與測試開發版或
0268 者實驗版的用戶。
0269
0270 穩定版內核樹版本由「穩定版」小組(郵件地址<stable@vger.kernel.org>)維護,一般
0271 隔周發布新版本。
0272
0273 內核源碼中的 :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>`
0274 文件具體描述了可被穩定版內核接受的修改類型以及發布的流程。
0275
0276
0277 報告bug
0278 -------
0279
0280 bugzilla.kernel.org是Linux內核開發者們用來跟蹤內核Bug的網站。我們鼓勵用
0281 戶在這個工具中報告找到的所有bug。如何使用內核bugzilla的細節請訪問:
0282
0283 http://test.kernel.org/bugzilla/faq.html
0284
0285 內核源碼主目錄中的:ref:`admin-guide/reporting-bugs.rst <reportingbugs>`
0286 文件里有一個很好的模板。它指導用戶如何報告可能的內核bug以及需要提供哪些信息
0287 來幫助內核開發者們找到問題的根源。
0288
0289
0290 利用bug報告
0291 -----------
0292
0293 練習內核開發技能的最好辦法就是修改其他人報告的bug。你不光可以幫助內核變
0294 得更加穩定,還可以學會如何解決實際問題從而提高自己的技能,並且讓其他開發
0295 者感受到你的存在。修改bug是贏得其他開發者讚譽的最好辦法,因爲並不是很多
0296 人都喜歡浪費時間去修改別人報告的bug。
0297
0298 要嘗試修改已知的bug,請訪問 http://bugzilla.kernel.org 網址。
0299
0300
0301 郵件列表
0302 --------
0303
0304 正如上面的文檔所描述,大多數的骨幹內核開發者都加入了Linux Kernel郵件列
0305 表。如何訂閱和退訂列表的細節可以在這裡找到:
0306
0307 http://vger.kernel.org/vger-lists.html#linux-kernel
0308
0309 網上很多地方都有這個郵件列表的存檔(archive)。可以使用搜尋引擎來找到這些
0310 存檔。比如:
0311
0312 http://dir.gmane.org/gmane.linux.kernel
0313
0314 在發信之前,我們強烈建議你先在存檔中搜索你想要討論的問題。很多已經被詳細
0315 討論過的問題只在郵件列表的存檔中可以找到。
0316
0317 大多數內核子系統也有自己獨立的郵件列表來協調各自的開發工作。從
0318 MAINTAINERS文件中可以找到不同話題對應的郵件列表。
0319
0320 很多郵件列表架設在kernel.org伺服器上。這些列表的信息可以在這裡找到:
0321
0322 http://vger.kernel.org/vger-lists.html
0323
0324 在使用這些郵件列表時,請記住保持良好的行爲習慣。下面的連結提供了與這些列
0325 表(或任何其它郵件列表)交流的一些簡單規則,雖然內容有點濫竽充數。
0326
0327 http://www.albion.com/netiquette/
0328
0329 當有很多人回覆你的郵件時,郵件的抄送列表會變得很長。請不要將任何人從抄送
0330 列表中刪除,除非你有足夠的理由這麼做。也不要只回復到郵件列表。請習慣於同
0331 一封郵件接收兩次(一封來自發送者一封來自郵件列表),而不要試圖通過添加一
0332 些奇特的郵件頭來解決這個問題,人們不會喜歡的。
0333
0334 記住保留你所回復內容的上下文和源頭。在你回覆郵件的頂部保留「某某某說到……」
0335 這幾行。將你的評論加在被引用的段落之間而不要放在郵件的頂部。
0336
0337 如果你在郵件中附帶補丁,請確認它們是可以直接閱讀的純文本(如
0338 :ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>`
0339 文檔中所述)。內核開發者們不希望遇到附件或者被壓縮了的補丁。只有這樣才能
0340 保證他們可以直接評論你的每行代碼。請確保你使用的郵件發送程序不會修改空格
0341 和制表符。一個防範性的測試方法是先將郵件發送給自己,然後自己嘗試是否可以
0342 順利地打上收到的補丁。如果測試不成功,請調整或者更換你的郵件發送程序直到
0343 它正確工作爲止。
0344
0345 總而言之,請尊重其他的郵件列表訂閱者。
0346
0347
0348 同內核社區合作
0349 ----------------
0350
0351 內核社區的目標就是提供盡善盡美的內核。所以當你提交補丁期望被接受進內核的
0352 時候,它的技術價值以及其他方面都將被評審。那麼你可能會得到什麼呢?
0353
0354 - 批評
0355 - 評論
0356 - 要求修改
0357 - 要求證明修改的必要性
0358 - 沉默
0359
0360 要記住,這些是把補丁放進內核的正常情況。你必須學會聽取對補丁的批評和評論,
0361 從技術層面評估它們,然後要麼重寫你的補丁要麼簡明扼要地論證修改是不必要
0362 的。如果你發的郵件沒有得到任何回應,請過幾天後再試一次,因爲有時信件會湮
0363 沒在茫茫信海中。
0364
0365 你不應該做的事情:
0366
0367 - 期望自己的補丁不受任何質疑就直接被接受
0368 - 翻臉
0369 - 忽略別人的評論
0370 - 沒有按照別人的要求做任何修改就重新提交
0371
0372 在一個努力追尋最好技術方案的社區里,對於一個補丁有多少好處總會有不同的見
0373 解。你必須要抱著合作的態度,願意改變自己的觀點來適應內核的風格。或者至少
0374 願意去證明你的想法是有價值的。記住,犯錯誤是允許的,只要你願意朝著正確的
0375 方案去努力。
0376
0377 如果你的第一個補丁換來的是一堆修改建議,這是很正常的。這並不代表你的補丁
0378 不會被接受,也不意味著有人和你作對。你只需要改正所有提出的問題然後重新發
0379 送你的補丁。
0380
0381 內核社區和公司文化的差異
0382 ------------------------
0383
0384 內核社區的工作模式同大多數傳統公司開發隊伍的工作模式並不相同。下面這些例
0385 子,可以幫助你避免某些可能發生問題:
0386 用這些話介紹你的修改提案會有好處:
0387
0388 - 它同時解決了多個問題
0389 - 它刪除了2000行代碼
0390 - 這是補丁,它已經解釋了我想要說明的
0391 - 我在5種不同的體系結構上測試過它……
0392 - 這是一系列小補丁用來……
0393 - 這個修改提高了普通機器的性能……
0394
0395 應該避免如下的說法:
0396
0397 - 我們在AIX/ptx/Solaris就是這麼做的,所以這麼做肯定是好的……
0398 - 我做這行已經20年了,所以……
0399 - 爲了我們公司賺錢考慮必須這麼做
0400 - 這是我們的企業產品線所需要的
0401 - 這裡是描述我觀點的1000頁設計文檔
0402 - 這是一個5000行的補丁用來……
0403 - 我重寫了現在亂七八糟的代碼,這就是……
0404 - 我被規定了最後期限,所以這個補丁需要立刻被接受
0405
0406 另外一個內核社區與大部分傳統公司的軟體開發隊伍不同的地方是無法面對面地交
0407 流。使用電子郵件和IRC聊天工具做爲主要溝通工具的一個好處是性別和種族歧視
0408 將會更少。Linux內核的工作環境更能接受婦女和少數族羣,因爲每個人在別人眼
0409 里只是一個郵件地址。國際化也幫助了公平的實現,因爲你無法通過姓名來判斷人
0410 的性別。男人有可能叫李麗,女人也有可能叫王剛。大多數在Linux內核上工作過
0411 並表達過看法的女性對在linux上工作的經歷都給出了正面的評價。
0412
0413 對於一些不習慣使用英語的人來說,語言可能是一個引起問題的障礙。在郵件列表
0414 中要正確地表達想法必需良好地掌握語言,所以建議你在發送郵件之前最好檢查一
0415 下英文寫得是否正確。
0416
0417
0418 拆分修改
0419 --------
0420
0421 Linux內核社區並不喜歡一下接收大段的代碼。修改需要被恰當地介紹、討論並且
0422 拆分成獨立的小段。這幾乎完全和公司中的習慣背道而馳。你的想法應該在開發最
0423 開始的階段就讓大家知道,這樣你就可以及時獲得對你正在進行的開發的反饋。這
0424 樣也會讓社區覺得你是在和他們協作,而不是僅僅把他們當作傾銷新功能的對象。
0425 無論如何,你不要一次性地向郵件列表發送50封信,你的補丁序列應該永遠用不到
0426 這麼多。
0427
0428 將補丁拆開的原因如下:
0429
0430 1) 小的補丁更有可能被接受,因爲它們不需要太多的時間和精力去驗證其正確性。
0431 一個5行的補丁,可能在維護者看了一眼以後就會被接受。而500行的補丁則
0432 需要數個小時來審查其正確性(所需時間隨補丁大小增加大約呈指數級增長)。
0433
0434 當出了問題的時候,小的補丁也會讓調試變得非常容易。一個一個補丁地回溯
0435 將會比仔細剖析一個被打上的大補丁(這個補丁破壞了其他東西)容易得多。
0436
0437 2)不光發送小的補丁很重要,在提交之前重新編排、化簡(或者僅僅重新排列)
0438 補丁也是很重要的。
0439
0440 這裡有內核開發者Al Viro打的一個比方:
0441 「想像一個老師正在給學生批改數學作業。老師並不希望看到學生爲了得
0442 到正確解法所進行的嘗試和產生的錯誤。他希望看到的是最乾淨最優雅的
0443 解答。好學生了解這點,絕不會把最終解決之前的中間方案提交上去。」
0444
0445 內核開發也是這樣。維護者和評審者不希望看到一個人在解決問題時的思
0446 考過程。他們只希望看到簡單和優雅的解決方案。
0447
0448 直接給出一流的解決方案,和社區一起協作討論尚未完成的工作,這兩者之間似乎
0449 很難找到一個平衡點。所以最好儘早開始收集有利於你進行改進的反饋;同時也要
0450 保證修改分成很多小塊,這樣在整個項目都準備好被包含進內核之前,其中的一部
0451 分可能會先被接收。
0452
0453 必須了解這樣做是不可接受的:試圖將未完成的工作提交進內核,然後再找時間修
0454 復。
0455
0456
0457 證明修改的必要性
0458 ----------------
0459 除了將補丁拆成小塊,很重要的一點是讓Linux社區了解他們爲什麼需要這樣修改。
0460 你必須證明新功能是有人需要的並且是有用的。
0461
0462
0463 記錄修改
0464 --------
0465
0466 當你發送補丁的時候,需要特別留意郵件正文的內容。因爲這裡的信息將會做爲補
0467 丁的修改記錄(ChangeLog),會被一直保留以備大家查閱。它需要完全地描述補丁,
0468 包括:
0469
0470 - 爲什麼需要這個修改
0471 - 補丁的總體設計
0472 - 實現細節
0473 - 測試結果
0474
0475 想了解它具體應該看起來像什麼,請查閱以下文檔中的「ChangeLog」章節:
0476 「The Perfect Patch」
0477 https://www.ozlabs.org/~akpm/stuff/tpp.txt
0478
0479
0480 這些事情有時候做起來很難。要在任何方面都做到完美可能需要好幾年時間。這是
0481 一個持續提高的過程,它需要大量的耐心和決心。只要不放棄,你一定可以做到。
0482 很多人已經做到了,而他們都曾經和現在的你站在同樣的起點上。
0483
0484
0485 感謝
0486 ----
0487 感謝Paolo Ciarrocchi允許「開發流程」部分基於他所寫的文章
0488 (http://www.kerneltravel.net/newbie/2.6-development_process),感謝Randy
0489 Dunlap和Gerrit Huizenga完善了應該說和不該說的列表。感謝Pat Mochel, Hanna
0490 Linder, Randy Dunlap, Kay Sievers, Vojtech Pavlik, Jan Kara, Josh Boyer,
0491 Kees Cook, Andrew Morton, Andi Kleen, Vadim Lobanov, Jesper Juhl, Adrian
0492 Bunk, Keri Harris, Frans Pop, David A. Wheeler, Junio Hamano, Michael
0493 Kerrisk和Alex Shepard的評審、建議和貢獻。沒有他們的幫助,這篇文檔是不可
0494 能完成的。
0495
0496
0497
0498 英文版維護者: Greg Kroah-Hartman <greg@kroah.com>
0499