如何參與LINUX內核開發

英文版: http://www.kernel.org/doc/Documentation/HOWTO
英文版維護者: Greg Kroah-Hartman <[email protected]>

翻譯者: 李陽   Li Yang <[email protected]>
維護者: 李陽   Li Yang <[email protected]>
校譯者: 鍾宇   TripleX Chung <[email protected]>
          陳琦   Maggie Chen <[email protected]>
王聰 Wang Cong <[email protected]>

以下爲正文
---------------------------------------------------------------------

如何參與Linux內核開發
---------------------

這是一篇將如何參與Linux內核開發的相關問題一網打盡的終極祕笈。它將指導你
成爲一名Linux內核開發者,並且學會如何同Linux內核開發社區合作。它儘可能不
包括任何關於內核編程的技術細節,但會給你指引一條獲得這些知識的正確途徑。

如果這篇文章中的任何內容不再適用,請給文末列出的文件維護者發送補丁。


入門
----

你想了解如何成爲一名Linux內核開發者?或者老闆吩咐你“給這個設備寫個Linux
驅動程序”?這篇文章的目的就是教會你達成這些目標的全部訣竅,它將描述你需
要經過的流程以及給出如何同內核社區合作的一些提示。它還將試圖解釋內核社區
爲何這樣運作。

Linux內核大部分是由C語言寫成的,一些體系結構相關的代碼用到了彙編語言。要
參與內核開發,你必須精通C語言。除非你想爲某個架構開發底層代碼,否則你並
不需要了解(任何體系結構的)彙編語言。下面列舉的書籍雖然不能替代紮實的C
語言教育和多年的開發經驗,但如果需要的話,做爲參考還是不錯的:
- "The C Programming Language" by Kernighan and Ritchie [Prentice Hall]
    《C程序設計語言(第2版·新版)》(徐寶文 李志 譯)[機械工業出版社]
- "Practical C Programming" by Steve Oualline [O'Reilly]
    《實用C語言編程(第三版)》(郭大海 譯)[中國電力出版社]
- "C:   A Reference Manual" by Harbison and Steele [Prentice Hall]
    《C語言參考手冊(原書第5版)》(邱仲潘 等譯)[機械工業出版社]

Linux內核使用GNU C和GNU工具鏈開發。雖然它遵循ISO C89標準,但也用到了一些
標準中沒有定義的擴展。內核是自給自足的C環境,不依賴於標準C庫的支持,所以
並不支持C標準中的部分定義。比如long long類型的大數除法和浮點運算就不允許
使用。有時候確實很難弄清楚內核對工具鏈的要求和它所使用的擴展,不幸的是目
前還沒有明確的參考資料可以解釋它們。請查閱gcc信息頁(使用“info gcc”命令
顯示)獲得一些這方面信息。

請記住你是在學習怎麼和已經存在的開發社區打交道。它由一羣形形色色的人組成,
他們對代碼、風格和過程有着很高的標準。這些標準是在長期實踐中總結出來的,
適應於地理上分散的大型開發團隊。它們已經被很好得整理成檔,建議你在開發
之前儘可能多的學習這些標準,而不要期望別人來適應你或者你公司的行爲方式。


法律問題
--------

Linux內核源代碼都是在GPL(通用公共許可證)的保護下發布的。要了解這種許可
的細節請查看源代碼主目錄下的COPYING文件。如果你對它還有更深入問題請聯繫
律師,而不要在Linux內核郵件組上提問。因爲郵件組裏的人並不是律師,不要期
望他們的話有法律效力。

對於GPL的常見問題和解答,請訪問以下鏈接:
     http://www.gnu.org/licenses/gpl-faq.html


文檔
----

Linux內核代碼中包含有大量的文檔。這些文檔對於學習如何與內核社區互動有着
不可估量的價值。當一個新的功能被加入內核,最好把解釋如何使用這個功能的文
檔也放進內核。當內核的改動導致面向用戶空間的接口發生變化時,最好將相關信
息或手冊頁(manpages)的補丁發到[email protected],以向手冊頁(manpages)
的維護者解釋這些變化。

以下是內核代碼中需要閱讀的文檔:
   README
     文件簡要介紹了Linux內核的背景,並且描述瞭如何配置和編譯內核。內核的
     新用戶應該從這裏開始。

   Documentation/Changes
     文件給出了用來編譯和使用內核所需要的最小軟件包列表。

   Documentation/CodingStyle
     描述Linux內核的代碼風格和理由。所有新代碼需要遵守這篇文檔中定義的規
     範。大多數維護者只會接收符合規定的補丁,很多人也只會幫忙檢查符合風格
     的代碼。

   Documentation/SubmittingPatches
   Documentation/SubmittingDrivers
     這兩份文檔明確描述如何創建和發送補丁,其中包括(但不僅限於):
        - 郵件內容
        - 郵件格式
        - 選擇收件人
     遵守這些規定並不能保證提交成功(因爲所有補丁需要通過嚴格的內容和風格
     審查),但是忽視他們幾乎就意味着失敗。

     其他關於如何正確地生成補丁的優秀文檔包括:
     "The Perfect Patch"
         http://www.zip.com.au/~akpm/linux/patches/stuff/tpp.txt
     "Linux kernel patch submission format"
         http://linux.yyz.us/patch-format.html

   Documentation/stable_api_nonsense.txt
     論證內核爲什麼特意不包括穩定的內核內部API,也就是說不包括像這樣的特
     性:
        - 子系統中間層(爲了兼容性?)
        - 在不同操作系統間易於移植的驅動程序
        - 減緩(甚至阻止)內核代碼的快速變化
     這篇文檔對於理解Linux的開發哲學至關重要。對於將開發平臺從其他操作系
     統轉移到Linux的人來說也很重要。

   Documentation/SecurityBugs
     如果你認爲自己發現了Linux內核的安全性問題,請根據這篇文檔中的步驟來
     提醒其他內核開發者並幫助解決這個問題。

   Documentation/ManagementStyle
     描述內核維護者的工作方法及其共有特點。這對於剛剛接觸內核開發(或者對
     它感到好奇)的人來說很重要,因爲它解釋了很多對於內核維護者獨特行爲的
     普遍誤解與迷惑。

   Documentation/stable_kernel_rules.txt
     解釋了穩定版內核發佈的規則,以及如何將改動放入這些版本的步驟。

   Documentation/kernel-docs.txt
     有助於內核開發的外部文檔列表。如果你在內核自帶的文檔中沒有找到你想找
     的內容,可以查看這些文檔。

   Documentation/applying-patches.txt
     關於補丁是什麼以及如何將它打在不同內核開發分支上的好介紹

內核還擁有大量從代碼自動生成的文檔。它包含內核內部API的全面介紹以及如何
妥善處理加鎖的規則。生成的文檔會放在 Documentation/DocBook/目錄下。在內
核源碼的主目錄中使用以下不同命令將會分別生成PDF、Postscript、HTML和手冊
頁等不同格式的文檔:
     make pdfdocs
     make psdocs
     make htmldocs
     make mandocs


如何成爲內核開發者
------------------
如果你對Linux內核開發一無所知,你應該訪問“Linux內核新手”計劃:
     http://kernelnewbies.org
它擁有一個可以問各種最基本的內核開發問題的郵件列表(在提問之前一定要記得
查找已往的郵件,確認是否有人已經回答過相同的問題)。它還擁有一個可以獲得
實時反饋的IRC聊天頻道,以及大量對於學習Linux內核開發相當有幫助的文檔。

網站簡要介紹了源代碼組織結構、子系統劃分以及目前正在進行的項目(包括內核
中的和單獨維護的)。它還提供了一些基本的幫助信息,比如如何編譯內核和打補
丁。

如果你想加入內核開發社區並協助完成一些任務,卻找不到從哪裏開始,可以訪問
“Linux內核看護人”計劃:
     http://janitor.kernelnewbies.org/
這是極佳的起點。它提供一個相對簡單的任務列表,列出內核代碼中需要被重新
整理或者改正的地方。通過和負責這個計劃的開發者們一同工作,你會學到將補丁
集成進內核的基本原理。如果還沒有決定下一步要做什麼的話,你還可能會得到方
向性的指點。

如果你已經有一些現成的代碼想要放到內核中,但是需要一些幫助來使它們擁有正
確的格式。請訪問“內核導師”計劃。這個計劃就是用來幫助你完成這個目標的。它
是一個郵件列表,地址如下:
     http://selenic.com/mailman/listinfo/kernel-mentors

在真正動手修改內核代碼之前,理解要修改的代碼如何運作是必需的。要達到這個
目的,沒什麼辦法比直接讀代碼更有效了(大多數花招都會有相應的註釋),而且
一些特製的工具還可以提供幫助。例如,“Linux代碼交叉引用”項目就是一個值得
特別推薦的幫助工具,它將源代碼顯示在有編目和索引的網頁上。其中一個更新及
時的內核源碼庫,可以通過以下地址訪問:
     http://sosdg.org/~coywolf/lxr/


開發流程
--------

目前Linux內核開發流程包括幾個“主內核分支”和很多子系統相關的內核分支。這
些分支包括:
   - 2.6.x主內核源碼樹
   - 2.6.x.y -stable內核源碼樹
   - 2.6.x -git內核補丁集
   - 2.6.x -mm內核補丁集
   - 子系統相關的內核源碼樹和補丁集


2.6.x內核主源碼樹
-----------------
2.6.x內核是由Linus Torvalds(Linux的創造者)親自維護的。你可以在
kernel.org網站的pub/linux/kernel/v2.6/目錄下找到它。它的開發遵循以下步
驟:
   - 每當一個新版本的內核被髮布,爲期兩週的集成窗口將被打開。在這段時間裏
     維護者可以向Linus提交大段的修改,通常這些修改已經被放到-mm內核中幾個
     星期了。提交大量修改的首選方式是使用git工具(內核的代碼版本管理工具
     ,更多的信息可以在http://git.or.cz/獲取),不過使用普通補丁也是可以
     的。
   - 兩個星期以後-rc1版本內核發佈。之後只有不包含可能影響整個內核穩定性的
     新功能的補丁纔可能被接受。請注意一個全新的驅動程序(或者文件系統)有
     可能在-rc1後被接受是因爲這樣的修改完全獨立,不會影響其他的代碼,所以
     沒有造成內核退步的風險。在-rc1以後也可以用git向Linus提交補丁,不過所
     有的補丁需要同時被髮送到相應的公衆郵件列表以徵詢意見。
   - 當Linus認爲當前的git源碼樹已經達到一個合理健全的狀態足以發佈供人測試
     時,一個新的-rc版本就會被髮布。計劃是每週都發布新的-rc版本。
   - 這個過程一直持續下去直到內核被認爲達到足夠穩定的狀態,持續時間大概是
     6個星期。

關於內核發佈,值得一提的是Andrew Morton在linux-kernel郵件列表中如是說:
     “沒有人知道新內核何時會被髮布,因爲發佈是根據已知bug的情況來決定
     的,而不是根據一個事先制定好的時間表。”


2.6.x.y -stable(穩定版)內核源碼樹
-----------------------------------
由4個數字組成的內核版本號說明此內核是-stable版本。它們包含基於2.6.x版本
內核的相對較小且至關重要的修補,這些修補針對安全性問題或者嚴重的內核退步。

這種版本的內核適用於那些期望獲得最新的穩定版內核並且不想參與測試開發版或
者實驗版的用戶。

如果沒有2.6.x.y版本內核存在,那麼最新的2.6.x版本內核就相當於是當前的穩定
版內核。

2.6.x.y版本由“穩定版”小組(郵件地址<[email protected]& amp; gt;)維護,一般隔週發
布新版本。

內核源碼中的Documentation/stable_kernel_rules.txt文件具體描述了可被穩定
版內核接受的修改類型以及發佈的流程。


2.6.x -git補丁集
----------------
Linus的內核源碼樹的每日快照,這個源碼樹是由git工具管理的(由此得名)。這
些補丁通常每天更新以反映Linus的源碼樹的最新狀態。它們比-rc版本的內核源碼
樹更具試驗性質,因爲這個補丁集是全自動生成的,沒有任何人來確認其是否真正
健全。


2.6.x -mm補丁集
---------------
這是由Andrew Morton維護的試驗性內核補丁集。Andrew將所有子系統的內核源碼
和補丁拼湊到一起,並且加入了大量從linux-kernel郵件列表中採集的補丁。這個
源碼樹是新功能和補丁的試煉場。當補丁在-mm補丁集裏證明了其價值以後Andrew
或者相應子系統的維護者會將補丁發給Linus以便集成進主內核源碼樹。

在將所有新補丁發給Linus以集成到主內核源碼樹之前,我們非常鼓勵先把這些補
丁放在-mm版內核源碼樹中進行測試。

這些內核版本不適合在需要穩定運行的系統上運行,因爲運行它們比運行任何其他
內核分支都更具有風險。

如果你想爲內核開發進程提供幫助,請嘗試並使用這些內核版本,並在
linux-kernel郵件列表中提供反饋,告訴大家你遇到了問題還是一切正常。

通常-mm版補丁集不光包括這些額外的試驗性補丁,還包括髮布時-git版主源碼樹
中的改動。

-mm版內核沒有固定的發佈週期,但是通常在每兩個-rc版內核發佈之間都會有若干
個-mm版內核發佈(一般是1至3個)。


子系統相關內核源碼樹和補丁集
----------------------------
相當一部分內核子系統開發者會公開他們自己的開發源碼樹,以便其他人能瞭解內
核的不同領域正在發生的事情。如上所述,這些源碼樹會被集成到-mm版本內核中。

下面是目前可用的一些內核源碼樹的列表:
   通過git管理的源碼樹:
     - Kbuild開發源碼樹, Sam Ravnborg <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/sam/kbuild.git

     - ACPI開發源碼樹, Len Brown <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/lenb/linux-acpi-2.6.git

     - 塊設備開發源碼樹, Jens Axboe <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/axboe/linux-2.6-block.git

     - DRM開發源碼樹, Dave Airlie <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/airlied/drm-2.6.git

     - ia64開發源碼樹, Tony Luck <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/aegl/linux-2.6.git

     - ieee1394開發源碼樹, Jody McIntyre <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/scjody/ieee1394.git

     - infiniband開發源碼樹, Roland Dreier <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/roland/infiniband.git

     - libata開發源碼樹, Jeff Garzik <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/jgarzik/libata-dev.git

     - 網絡驅動程序開發源碼樹, Jeff Garzik <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/jgarzik/netdev-2.6.git

     - pcmcia開發源碼樹, Dominik Brodowski <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/brodo/pcmcia-2.6.git

     - SCSI開發源碼樹, James Bottomley <[email protected]>
     git.kernel.org:/pub/scm/linux/kernel/git/jejb/scsi-misc-2.6.git

   使用quilt管理的補丁集:
     - USB, PCI, 驅動程序核心和I2C, Greg Kroah-Hartman <[email protected]>
     kernel.org/pub/linux/kernel/people/gregkh/gregkh-2.6/
     - x86-64, 部分i386, Andi Kleen <[email protected]>
     ftp.firstfloor.org:/pub/ak/x86_64/quilt/

   其他內核源碼樹可以在http://git.kernel.org的列表中和MAINTAINERS文件裏
   找到。

報告bug
-------

bugzilla.kernel.org是Linux內核開發者們用來跟蹤內核Bug的網站。我們鼓勵用
戶在這個工具中報告找到的所有bug。如何使用內核bugzilla的細節請訪問:
     http://test.kernel.org/bugzilla/faq.html

內核源碼主目錄中的REPORTING-BUGS文件裏有一個很好的模板。它指導用戶如何報
告可能的內核bug以及需要提供哪些信息來幫助內核開發者們找到問題的根源。


利用bug報告
-----------

練習內核開發技能的最好辦法就是修改其他人報告的bug。你不光可以幫助內核變
得更加穩定,還可以學會如何解決實際問題從而提高自己的技能,並且讓其他開發
者感受到你的存在。修改bug是贏得其他開發者讚譽的最好辦法,因爲並不是很多
人都喜歡浪費時間去修改別人報告的bug。

要嘗試修改已知的bug,請訪問http://bugzilla.kernel.org網址。如果你想獲得
最新bug的通知,可以訂閱bugme-new郵件列表(只有新的bug報告會被寄到這裏)
或者訂閱bugme-janitor郵件列表(所有bugzilla的變動都會被寄到這裏)。

     http://lists.osdl.org/mailman/listinfo/bugme-new
     http://lists.osdl.org/mailman/listinfo/bugme-janitors


郵件列表
--------

正如上面的文檔所描述,大多數的骨幹內核開發者都加入了Linux Kernel郵件列
表。如何訂閱和退訂列表的細節可以在這裏找到:
     http://vger.kernel.org/vger-lists.html#linux-kernel
網上很多地方都有這個郵件列表的存檔(archive)。可以使用搜索引擎來找到這些
存檔。比如:
     http://dir.gmane.org/gmane.linux.kernel
在發信之前,我們強烈建議你先在存檔中搜索你想要討論的問題。很多已經被詳細
討論過的問題只在郵件列表的存檔中可以找到。

大多數內核子系統也有自己獨立的郵件列表來協調各自的開發工作。從
MAINTAINERS文件中可以找到不同話題對應的郵件列表。

很多郵件列表架設在kernel.org服務器上。這些列表的信息可以在這裏找到:
     http://vger.kernel.org/vger-lists.html

在使用這些郵件列表時,請記住保持良好的行爲習慣。下面的鏈接提供了與這些列
表(或任何其它郵件列表)交流的一些簡單規則,雖然內容有點濫竽充數。
     http://www.albion.com/netiquette/

當有很多人回覆你的郵件時,郵件的抄送列表會變得很長。請不要將任何人從抄送
列表中刪除,除非你有足夠的理由這麼做。也不要只回復到郵件列表。請習慣於同
一封郵件接收兩次(一封來自發送者一封來自郵件列表),而不要試圖通過添加一
些奇特的郵件頭來解決這個問題,人們不會喜歡的。

記住保留你所回覆內容的上下文和源頭。在你回覆郵件的頂部保留“某某某說到…… ”
這幾行。將你的評論加在被引用的段落之間而不要放在郵件的頂部。

如果你在郵件中附帶補丁,請確認它們是可以直接閱讀的純文本(如
Documentation/SubmittingPatches文檔中所述)。內核開發者們不希望遇到附件
或者被壓縮了的補丁。只有這樣才能保證他們可以直接評論你的每行代碼。請確保
你使用的郵件發送程序不會修改空格和製表符。一個防範性的測試方法是先將郵件
發送給自己,然後自己嘗試是否可以順利地打上收到的補丁。如果測試不成功,請
調整或者更換你的郵件發送程序直到它正確工作爲止。

總而言之,請尊重其他的郵件列表訂閱者。


同內核社區合作
----------------

內核社區的目標就是提供盡善盡美的內核。所以當你提交補丁期望被接受進內核的
時候,它的技術價值以及其他方面都將被評審。那麼你可能會得到什麼呢?
   - 批評
   - 評論
   - 要求修改
   - 要求證明修改的必要性
   - 沉默

要記住,這些是把補丁放進內核的正常情況。你必須學會聽取對補丁的批評和評論,
從技術層面評估它們,然後要麼重寫你的補丁要麼簡明扼要地論證修改是不必要
的。如果你發的郵件沒有得到任何迴應,請過幾天後再試一次,因爲有時信件會湮
沒在茫茫信海中。

你不應該做的事情:
   - 期望自己的補丁不受任何質疑就直接被接受
   - 翻臉
   - 忽略別人的評論
   - 沒有按照別人的要求做任何修改就重新提交

在一個努力追尋最好技術方案的社區裏,對於一個補丁有多少好處總會有不同的見
解。你必須要抱着合作的態度,願意改變自己的觀點來適應內核的風格。或者至少
願意去證明你的想法是有價值的。記住,犯錯誤是允許的,只要你願意朝着正確的
方案去努力。

如果你的第一個補丁換來的是一堆修改建議,這是很正常的。這並不代表你的補丁
不會被接受,也不意味着有人和你作對。你只需要改正所有提出的問題然後重新發
送你的補丁。

內核社區和公司文化的差異
------------------------

內核社區的工作模式同大多數傳統公司開發隊伍的工作模式並不相同。下面這些例
子,可以幫助你避免某些可能發生問題:
   用這些話介紹你的修改提案會有好處:
     - 它同時解決了多個問題
     - 它刪除了2000行代碼
     - 這是補丁,它已經解釋了我想要說明的
     - 我在5種不同的體系結構上測試過它……
     - 這是一系列小補丁用來……
     - 這個修改提高了普通機器的性能……

   應該避免如下的說法:
     - 我們在AIX/ptx/Solaris就是這麼做的,所以這麼做肯定是好的……
     - 我做這行已經20年了,所以……
     - 爲了我們公司賺錢考慮必須這麼做
     - 這是我們的企業產品線所需要的
     - 這裏是描述我觀點的1000頁設計文檔
     - 這是一個5000行的補丁用來……
     - 我重寫了現在亂七八糟的代碼,這就是……
     - 我被規定了最後期限,所以這個補丁需要立刻被接受

另外一個內核社區與大部分傳統公司的軟件開發隊伍不同的地方是無法面對面地交
流。使用電子郵件和IRC聊天工具做爲主要溝通工具的一個好處是性別和種族歧視
將會更少。Linux內核的工作環境更能接受婦女和少數族羣,因爲每個人在別人眼
裏只是一個郵件地址。國際化也幫助了公平的實現,因爲你無法通過姓名來判斷人
的性別。男人有可能叫李麗,女人也有可能叫王剛。大多數在Linux內核上工作過
並表達過看法的女性對在linux上工作的經歷都給出了正面的評價。

對於一些不習慣使用英語的人來說,語言可能是一個引起問題的障礙。在郵件列表
中要正確地表達想法必需良好地掌握語言,所以建議你在發送郵件之前最好檢查一
下英文寫得是否正確。


拆分修改
--------

Linux內核社區並不喜歡一下接收大段的代碼。修改需要被恰當地介紹、討論並且
拆分成獨立的小段。這幾乎完全和公司中的習慣背道而馳。你的想法應該在開發最
開始的階段就讓大家知道,這樣你就可以及時獲得對你正在進行的開發的反饋。這
樣也會讓社區覺得你是在和他們協作,而不是僅僅把他們當作傾銷新功能的對象。
無論如何,你不要一次性地向郵件列表發送50封信,你的補丁序列應該永遠用不到
這麼多。

將補丁拆開的原因如下:

1) 小的補丁更有可能被接受,因爲它們不需要太多的時間和精力去驗證其正確性。
    一個5行的補丁,可能在維護者看了一眼以後就會被接受。而500行的補丁則
    需要數個小時來審查其正確性(所需時間隨補丁大小增加大約呈指數級增長)。

    當出了問題的時候,小的補丁也會讓調試變得非常容易。一個一個補丁地回溯
    將會比仔細剖析一個被打上的大補丁(這個補丁破壞了其他東西)容易得多。

2)不光發送小的補丁很重要,在提交之前重新編排、化簡(或者僅僅重新排列)
    補丁也是很重要的。

這裏有內核開發者Al Viro打的一個比方:
     “想象一個老師正在給學生批改數學作業。老師並不希望看到學生爲了得
     到正確解法所進行的嘗試和產生的錯誤。他希望看到的是最乾淨最優雅的
     解答。好學生了解這點,絕不會把最終解決之前的中間方案提交上去。”

     內核開發也是這樣。維護者和評審者不希望看到一個人在解決問題時的思
     考過程。他們只希望看到簡單和優雅的解決方案。

直接給出一流的解決方案,和社區一起協作討論尚未完成的工作,這兩者之間似乎
很難找到一個平衡點。所以最好儘早開始收集有利於你進行改進的反饋;同時也要
保證修改分成很多小塊,這樣在整個項目都準備好被包含進內核之前,其中的一部
分可能會先被接收。

必須瞭解這樣做是不可接受的:試圖將未完成的工作提交進內核,然後再找時間修
復。


證明修改的必要性
----------------
除了將補丁拆成小塊,很重要的一點是讓Linux社區瞭解他們爲什麼需要這樣修改。
你必須證明新功能是有人需要的並且是有用的。


記錄修改
--------

當你發送補丁的時候,需要特別留意郵件正文的內容。因爲這裏的信息將會做爲補
丁的修改記錄(ChangeLog),會被一直保留以備大家查閱。它需要完全地描述補丁,
包括:
   - 爲什麼需要這個修改
   - 補丁的總體設計
   - 實現細節
   - 測試結果

想了解它具體應該看起來像什麼,請查閱以下文檔中的“ChangeLog”章節:
   “The Perfect Patch”
       http://www.zip.com.au/~akpm/linux/patches/stuff/tpp.txt


這些事情有時候做起來很難。要在任何方面都做到完美可能需要好幾年時間。這是
一個持續提高的過程,它需要大量的耐心和決心。只要不放棄,你一定可以做到。
很多人已經做到了,而他們都曾經和現在的你站在同樣的起點上。


---------------
感謝Paolo Ciarrocchi允許“開發流程”部分基於他所寫的文章
(http://linux.tar.bz/articles/2.6-development_process),感謝Randy
Dunlap和Gerrit Huizenga完善了應該說和不該說的列表。感謝Pat Mochel, Hanna
Linder, Randy Dunlap, Kay Sievers, Vojtech Pavlik, Jan Kara, Josh Boyer,
Kees Cook, Andrew Morton, Andi Kleen, Vadim Lobanov, Jesper Juhl, Adrian
Bunk, Keri Harris, Frans Pop, David A. Wheeler, Junio Hamano, Michael
Kerrisk和Alex Shepard的評審、建議和貢獻。沒有他們的幫助,這篇文檔是不可
能完成的。



英文版維護者: Greg Kroah-Hartman [email protected]

 

 

發佈了2 篇原創文章 · 獲贊 6 · 訪問量 2萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章