diff --git a/Documentation/translations/zh_CN/process/howto.rst b/Documentation/translations/zh_CN/process/howto.rst index 246f76a97eafa0e597d9cc1c7c2dc62c1f341ccf..cb41336ccb805ccc0dfe446357485d8b735d7535 100644 --- a/Documentation/translations/zh_CN/process/howto.rst +++ b/Documentation/translations/zh_CN/process/howto.rst @@ -63,9 +63,11 @@ Linuxå†…æ ¸ä½¿ç”¨GNU Cå’ŒGNU工具链开å‘。虽然它éµå¾ªISO C89æ ‡å‡†ï¼Œä½† -------- Linuxå†…æ ¸æºä»£ç 都是在GPL(通用公共许å¯è¯ï¼‰çš„ä¿æŠ¤ä¸‹å‘布的。è¦äº†è§£è¿™ç§è®¸å¯ -的细节请查看æºä»£ç 主目录下的COPYINGæ–‡ä»¶ã€‚å¦‚æžœä½ å¯¹å®ƒè¿˜æœ‰æ›´æ·±å…¥é—®é¢˜è¯·è”ç³» -律师,而ä¸è¦åœ¨Linuxå†…æ ¸é‚®ä»¶ç»„ä¸Šæé—®ã€‚å› ä¸ºé‚®ä»¶ç»„é‡Œçš„äººå¹¶ä¸æ˜¯å¾‹å¸ˆï¼Œä¸è¦æœŸ -望他们的è¯æœ‰æ³•å¾‹æ•ˆåŠ›ã€‚ +的细节请查看æºä»£ç 主目录下的COPYING文件。Linuxå†…æ ¸è®¸å¯å‡†åˆ™å’Œå¦‚果使用 +`SPDC <https://spdx.org/>` æ ‡å¿—ç¬¦è¯´æ˜Žåœ¨æ–‡ä»¶ +:ref:`Documentation/process/license-rules.rst <kernel_licensing>` +å¦‚æžœä½ å¯¹å®ƒè¿˜æœ‰æ›´æ·±å…¥é—®é¢˜è¯·è”系律师,而ä¸è¦åœ¨Linuxå†…æ ¸é‚®ä»¶ç»„ä¸Šæé—®ã€‚å› ä¸º +邮件组里的人并ä¸æ˜¯å¾‹å¸ˆï¼Œä¸è¦æœŸæœ›ä»–们的è¯æœ‰æ³•å¾‹æ•ˆåŠ›ã€‚ 对于GPL的常è§é—®é¢˜å’Œè§£ç”,请访问以下链接: http://www.gnu.org/licenses/gpl-faq.html @@ -177,19 +179,13 @@ Linuxå†…æ ¸ä»£ç ä¸åŒ…å«æœ‰å¤§é‡çš„文档。这些文档对于å¦ä¹ 如何与 集æˆè¿›å†…æ ¸çš„åŸºæœ¬åŽŸç†ã€‚如果还没有决定下一æ¥è¦åšä»€ä¹ˆçš„è¯ï¼Œä½ 还å¯èƒ½ä¼šå¾—到方 å‘性的指点。 -å¦‚æžœä½ å·²ç»æœ‰ä¸€äº›çŽ°æˆçš„代ç 想è¦æ”¾åˆ°å†…æ ¸ä¸ï¼Œä½†æ˜¯éœ€è¦ä¸€äº›å¸®åŠ©æ¥ä½¿å®ƒä»¬æ‹¥æœ‰æ£ -ç¡®çš„æ ¼å¼ã€‚è¯·è®¿é—®â€œå†…æ ¸å¯¼å¸ˆâ€è®¡åˆ’。这个计划就是用æ¥å¸®åŠ©ä½ 完æˆè¿™ä¸ªç›®æ ‡çš„。它 -是一个邮件列表,地å€å¦‚下: - - http://selenic.com/mailman/listinfo/kernel-mentors - 在真æ£åŠ¨æ‰‹ä¿®æ”¹å†…æ ¸ä»£ç 之å‰ï¼Œç†è§£è¦ä¿®æ”¹çš„代ç 如何è¿ä½œæ˜¯å¿…需的。è¦è¾¾åˆ°è¿™ä¸ª 目的,没什么办法比直接读代ç 更有效了(大多数花招都会有相应的注释),而且 一些特制的工具还å¯ä»¥æ供帮助。例如,“Linux代ç 交å‰å¼•ç”¨â€é¡¹ç›®å°±æ˜¯ä¸€ä¸ªå€¼å¾— 特别推è的帮助工具,它将æºä»£ç 显示在有编目和索引的网页上。其ä¸ä¸€ä¸ªæ›´æ–°åŠ æ—¶çš„å†…æ ¸æºç 库,å¯ä»¥é€šè¿‡ä»¥ä¸‹åœ°å€è®¿é—®ï¼š - http://sosdg.org/~coywolf/lxr/ + https://elixir.bootlin.com/ å¼€å‘æµç¨‹ @@ -198,17 +194,16 @@ Linuxå†…æ ¸ä»£ç ä¸åŒ…å«æœ‰å¤§é‡çš„文档。这些文档对于å¦ä¹ 如何与 ç›®å‰Linuxå†…æ ¸å¼€å‘æµç¨‹åŒ…æ‹¬å‡ ä¸ªâ€œä¸»å†…æ ¸åˆ†æ”¯â€å’Œå¾ˆå¤šåç³»ç»Ÿç›¸å…³çš„å†…æ ¸åˆ†æ”¯ã€‚è¿™ 些分支包括: - - 2.6.xä¸»å†…æ ¸æºç æ ‘ - - 2.6.x.y -stableå†…æ ¸æºç æ ‘ - - 2.6.x -mmå†…æ ¸è¡¥ä¸é›† - - åç³»ç»Ÿç›¸å…³çš„å†…æ ¸æºç æ ‘å’Œè¡¥ä¸é›† + - Linus çš„å†…æ ¸æºç æ ‘ + - 多个主è¦ç‰ˆæœ¬çš„ç¨³å®šç‰ˆå†…æ ¸æ ‘ + - åç³»ç»Ÿç›¸å…³çš„å†…æ ¸æ ‘ + - linux-next 集æˆæµ‹è¯•æ ‘ -2.6.xå†…æ ¸ä¸»æºç æ ‘ ------------------ -2.6.xå†…æ ¸æ˜¯ç”±Linus Torvalds(Linuxçš„åˆ›é€ è€…ï¼‰äº²è‡ªç»´æŠ¤çš„ã€‚ä½ å¯ä»¥åœ¨ -kernel.org网站的pub/linux/kernel/v2.6/目录下找到它。它的开å‘éµå¾ªä»¥ä¸‹æ¥ -骤: +ä¸»çº¿æ ‘ +------ +ä¸»çº¿æ ‘æ˜¯ç”±Linus Torvalds ç»´æŠ¤çš„ã€‚ä½ å¯ä»¥åœ¨https://kernel.org 网站或者代ç +库ä¸ä¸‹æ‰¾åˆ°å®ƒã€‚它的开å‘éµå¾ªä»¥ä¸‹æ¥éª¤ï¼š - æ¯å½“ä¸€ä¸ªæ–°ç‰ˆæœ¬çš„å†…æ ¸è¢«å‘布,为期两周的集æˆçª—å£å°†è¢«æ‰“开。在这段时间里 维护者å¯ä»¥å‘Linusæ交大段的修改,通常这些修改已ç»è¢«æ”¾åˆ°-mmå†…æ ¸ä¸å‡ 个 @@ -229,96 +224,49 @@ kernel.org网站的pub/linux/kernel/v2.6/目录下找到它。它的开å‘éµå¾ª “没有人知é“æ–°å†…æ ¸ä½•æ—¶ä¼šè¢«å‘å¸ƒï¼Œå› ä¸ºå‘å¸ƒæ˜¯æ ¹æ®å·²çŸ¥bug的情况æ¥å†³å®š 的,而ä¸æ˜¯æ ¹æ®ä¸€ä¸ªäº‹å…ˆåˆ¶å®šå¥½çš„时间表。†+åç³»ç»Ÿç‰¹å®šæ ‘ +------------ -2.6.x.y -stableï¼ˆç¨³å®šç‰ˆï¼‰å†…æ ¸æºç æ ‘ ------------------------------------ -ç”±4个数å—组æˆçš„å†…æ ¸ç‰ˆæœ¬å·è¯´æ˜Žæ¤å†…æ ¸æ˜¯-stable版本。它们包å«åŸºäºŽ2.6.x版本 -å†…æ ¸çš„ç›¸å¯¹è¾ƒå°ä¸”至关é‡è¦çš„修补,这些修补针对安全性问题或者严é‡çš„å†…æ ¸é€€æ¥ã€‚ - -è¿™ç§ç‰ˆæœ¬çš„å†…æ ¸é€‚ç”¨äºŽé‚£äº›æœŸæœ›èŽ·å¾—æœ€æ–°çš„ç¨³å®šç‰ˆå†…æ ¸å¹¶ä¸”ä¸æƒ³å‚与测试开å‘版或 -者实验版的用户。 - -如果没有2.6.x.yç‰ˆæœ¬å†…æ ¸å˜åœ¨ï¼Œé‚£ä¹ˆæœ€æ–°çš„2.6.xç‰ˆæœ¬å†…æ ¸å°±ç›¸å½“äºŽæ˜¯å½“å‰çš„稳定 -ç‰ˆå†…æ ¸ã€‚ - -2.6.x.y版本由“稳定版â€å°ç»„(邮件地å€<stable@vger.kernel.org>ï¼‰ç»´æŠ¤ï¼Œä¸€èˆ¬éš”å‘¨å‘ -布新版本。 - -å†…æ ¸æºç ä¸çš„ :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>` -文件具体æ述了å¯è¢«ç¨³å®šç‰ˆå†…æ ¸æŽ¥å—的修改类型以åŠå‘布的æµç¨‹ã€‚ - - -2.6.x -mmè¡¥ä¸é›† ---------------- -这是由Andrew Mortonç»´æŠ¤çš„è¯•éªŒæ€§å†…æ ¸è¡¥ä¸é›†ã€‚Andrew将所有åç³»ç»Ÿçš„å†…æ ¸æºç -和补ä¸æ‹¼å‡‘åˆ°ä¸€èµ·ï¼Œå¹¶ä¸”åŠ å…¥äº†å¤§é‡ä»Žlinux-kernel邮件列表ä¸é‡‡é›†çš„è¡¥ä¸ã€‚这个 -æºç æ ‘æ˜¯æ–°åŠŸèƒ½å’Œè¡¥ä¸çš„试炼场。当补ä¸åœ¨-mmè¡¥ä¸é›†é‡Œè¯æ˜Žäº†å…¶ä»·å€¼ä»¥åŽAndrew -或者相应å系统的维护者会将补ä¸å‘ç»™Linus以便集æˆè¿›ä¸»å†…æ ¸æºç æ ‘ã€‚ - -在将所有新补ä¸å‘ç»™Linus以集æˆåˆ°ä¸»å†…æ ¸æºç æ ‘ä¹‹å‰ï¼Œæˆ‘们éžå¸¸é¼“励先把这些补 -ä¸æ”¾åœ¨-mmç‰ˆå†…æ ¸æºç æ ‘ä¸è¿›è¡Œæµ‹è¯•ã€‚ +å„ç§å†…æ ¸å系统的维护者——以åŠè®¸å¤šå†…æ ¸å系统开å‘人员——在æºä»£ç 库ä¸å…¬å¼€äº†ä»–们 +当å‰çš„å¼€å‘状æ€ã€‚è¿™æ ·ï¼Œå…¶ä»–äººå°±å¯ä»¥çœ‹åˆ°å†…æ ¸çš„ä¸åŒåŒºåŸŸå‘生了什么。在开å‘速度 +很快的领域,å¯èƒ½ä¼šè¦æ±‚å¼€å‘人员将æäº¤çš„å†…å®¹å»ºç«‹åœ¨è¿™æ ·çš„åç³»ç»Ÿå†…æ ¸æ ‘ä¸Šï¼Œè¿™æ · +å°±é¿å…了æ交与其他已ç»è¿›è¡Œçš„工作之间的冲çªã€‚ -è¿™äº›å†…æ ¸ç‰ˆæœ¬ä¸é€‚åˆåœ¨éœ€è¦ç¨³å®šè¿è¡Œçš„系统上è¿è¡Œï¼Œå› 为è¿è¡Œå®ƒä»¬æ¯”è¿è¡Œä»»ä½•å…¶ä»– -å†…æ ¸åˆ†æ”¯éƒ½æ›´å…·æœ‰é£Žé™©ã€‚ +这些å˜å‚¨åº“ä¸çš„大多数都是Gitæ ‘ï¼Œä½†æ˜¯ä¹Ÿæœ‰å…¶ä»–çš„scm在使用,或者补ä¸é˜Ÿåˆ—被å‘布 +为Quilt系列。这些å系统å˜å‚¨åº“的地å€åˆ—在MAINTAINERS文件ä¸ã€‚å…¶ä¸è®¸å¤šå¯ä»¥åœ¨ +https://git.kernel.org/上æµè§ˆã€‚ -å¦‚æžœä½ æƒ³ä¸ºå†…æ ¸å¼€å‘进程æ供帮助,请å°è¯•å¹¶ä½¿ç”¨è¿™äº›å†…æ ¸ç‰ˆæœ¬ï¼Œå¹¶åœ¨ -linux-kernel邮件列表ä¸æä¾›åé¦ˆï¼Œå‘Šè¯‰å¤§å®¶ä½ é‡åˆ°äº†é—®é¢˜è¿˜æ˜¯ä¸€åˆ‡æ£å¸¸ã€‚ +在将一个建议的补ä¸æäº¤åˆ°è¿™æ ·çš„åç³»ç»Ÿæ ‘ä¹‹å‰ï¼Œéœ€è¦å¯¹å®ƒè¿›è¡Œå®¡æŸ¥ï¼Œå®¡æŸ¥ä¸»è¦å‘生 +在邮件列表上(请å‚è§ä¸‹é¢ç›¸åº”çš„éƒ¨åˆ†ï¼‰ã€‚å¯¹äºŽå‡ ä¸ªå†…æ ¸å系统,这个审查过程是通 +过工具补ä¸è·Ÿè¸ªçš„。Patchworkæ供了一个Webç•Œé¢ï¼Œæ˜¾ç¤ºè¡¥ä¸å‘布ã€å¯¹è¡¥ä¸çš„任何评 +论或修订,维护人员å¯ä»¥å°†è¡¥ä¸æ ‡è®°ä¸ºæ£åœ¨å®¡æŸ¥ã€æŽ¥å—或拒ç»ã€‚大多数补ä¸ç½‘站都列 +在 https://patchwork.kernel.org/ -通常-mm版补ä¸é›†ä¸å…‰åŒ…括这些é¢å¤–的试验性补ä¸ï¼Œè¿˜åŒ…括å‘布时-git版主æºç æ ‘ -ä¸çš„改动。 +Linux-next 集æˆæµ‹è¯•æ ‘ +--------------------- --mmç‰ˆå†…æ ¸æ²¡æœ‰å›ºå®šçš„å‘布周期,但是通常在æ¯ä¸¤ä¸ª-rcç‰ˆå†…æ ¸å‘布之间都会有若干 -个-mmç‰ˆå†…æ ¸å‘布(一般是1至3个)。 +在将åç³»ç»Ÿæ ‘çš„æ›´æ–°åˆå¹¶åˆ°ä¸»çº¿æ ‘之å‰ï¼Œéœ€è¦å¯¹å®ƒä»¬è¿›è¡Œé›†æˆæµ‹è¯•ã€‚为æ¤ï¼Œå˜åœ¨ä¸€ä¸ª +特殊的测试å˜å‚¨åº“,其ä¸å‡ 乎æ¯å¤©éƒ½ä¼šæå–所有åç³»ç»Ÿæ ‘ï¼š + https://git.kernel.org/?p=linux/kernel/git/next/linux-next.git -åç³»ç»Ÿç›¸å…³å†…æ ¸æºç æ ‘å’Œè¡¥ä¸é›† ----------------------------- -ç›¸å½“ä¸€éƒ¨åˆ†å†…æ ¸å系统开å‘者会公开他们自己的开å‘æºç æ ‘ï¼Œä»¥ä¾¿å…¶ä»–äººèƒ½äº†è§£å†… -æ ¸çš„ä¸åŒé¢†åŸŸæ£åœ¨å‘生的事情。如上所述,这些æºç æ ‘ä¼šè¢«é›†æˆåˆ°-mmç‰ˆæœ¬å†…æ ¸ä¸ã€‚ +通过这ç§æ–¹å¼ï¼ŒLinux-next 对下一个åˆå¹¶é˜¶æ®µå°†è¿›å…¥ä¸»çº¿å†…æ ¸çš„å†…å®¹ç»™å‡ºäº†ä¸€ä¸ªæ¦‚è¦ +展望。éžå¸¸æ¬¢å†’险的测试者è¿è¡Œæµ‹è¯•Linux-next。 -下é¢æ˜¯ç›®å‰å¯ç”¨çš„ä¸€äº›å†…æ ¸æºç æ ‘çš„åˆ—è¡¨ï¼š - 通过git管ç†çš„æºç æ ‘ï¼š - - Kbuildå¼€å‘æºç æ ‘ï¼Œ Sam Ravnborg <sam@ravnborg.org> - git.kernel.org:/pub/scm/linux/kernel/git/sam/kbuild.git - - - ACPIå¼€å‘æºç æ ‘, Len Brown <len.brown@intel.com> - git.kernel.org:/pub/scm/linux/kernel/git/lenb/linux-acpi-2.6.git - - - å—设备开å‘æºç æ ‘, Jens Axboe <axboe@suse.de> - git.kernel.org:/pub/scm/linux/kernel/git/axboe/linux-2.6-block.git - - - DRMå¼€å‘æºç æ ‘, Dave Airlie <airlied@linux.ie> - git.kernel.org:/pub/scm/linux/kernel/git/airlied/drm-2.6.git - - - ia64å¼€å‘æºç æ ‘, Tony Luck <tony.luck@intel.com> - git.kernel.org:/pub/scm/linux/kernel/git/aegl/linux-2.6.git - - - ieee1394å¼€å‘æºç æ ‘, Jody McIntyre <scjody@modernduck.com> - git.kernel.org:/pub/scm/linux/kernel/git/scjody/ieee1394.git - - - infinibandå¼€å‘æºç æ ‘, Roland Dreier <rolandd@cisco.com> - git.kernel.org:/pub/scm/linux/kernel/git/roland/infiniband.git - - - libataå¼€å‘æºç æ ‘, Jeff Garzik <jgarzik@pobox.com> - git.kernel.org:/pub/scm/linux/kernel/git/jgarzik/libata-dev.git - - - 网络驱动程åºå¼€å‘æºç æ ‘, Jeff Garzik <jgarzik@pobox.com> - git.kernel.org:/pub/scm/linux/kernel/git/jgarzik/netdev-2.6.git +多个主è¦ç‰ˆæœ¬çš„ç¨³å®šç‰ˆå†…æ ¸æ ‘ +----------------------------------- +ç”±3个数å—组æˆçš„å†…æ ¸ç‰ˆæœ¬å·è¯´æ˜Žæ¤å†…æ ¸æ˜¯-stable版本。它们包å«å†…æ ¸çš„ç›¸å¯¹è¾ƒå°ä¸” +至关é‡è¦çš„修补,这些修补针对安全性问题或者严é‡çš„å†…æ ¸é€€æ¥ã€‚ - - pcmciaå¼€å‘æºç æ ‘, Dominik Brodowski <linux@dominikbrodowski.net> - git.kernel.org:/pub/scm/linux/kernel/git/brodo/pcmcia-2.6.git +è¿™ç§ç‰ˆæœ¬çš„å†…æ ¸é€‚ç”¨äºŽé‚£äº›æœŸæœ›èŽ·å¾—æœ€æ–°çš„ç¨³å®šç‰ˆå†…æ ¸å¹¶ä¸”ä¸æƒ³å‚与测试开å‘版或 +者实验版的用户。 - - SCSIå¼€å‘æºç æ ‘, James Bottomley <James.Bottomley@SteelEye.com> - git.kernel.org:/pub/scm/linux/kernel/git/jejb/scsi-misc-2.6.git +ç¨³å®šç‰ˆå†…æ ¸æ ‘ç‰ˆæœ¬ç”±â€œç¨³å®šç‰ˆâ€å°ç»„(邮件地å€<stable@vger.kernel.org>)维护,一般 +隔周å‘布新版本。 - 使用quilt管ç†çš„è¡¥ä¸é›†ï¼š - - USB, PCI, 驱动程åºæ ¸å¿ƒå’ŒI2C, Greg Kroah-Hartman <gregkh@linuxfoundation.org> - kernel.org/pub/linux/kernel/people/gregkh/gregkh-2.6/ - - x86-64, 部分i386, Andi Kleen <ak@suse.de> - ftp.firstfloor.org:/pub/ak/x86_64/quilt/ +å†…æ ¸æºç ä¸çš„ :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>` +文件具体æ述了å¯è¢«ç¨³å®šç‰ˆå†…æ ¸æŽ¥å—的修改类型以åŠå‘布的æµç¨‹ã€‚ - å…¶ä»–å†…æ ¸æºç æ ‘å¯ä»¥åœ¨ http://git.kernel.org 的列表ä¸å’ŒMAINTAINERS文件里 - 找到。 报告bug ------- @@ -328,8 +276,9 @@ bugzilla.kernel.org是Linuxå†…æ ¸å¼€å‘者们用æ¥è·Ÿè¸ªå†…æ ¸Bug的网站。 http://test.kernel.org/bugzilla/faq.html -å†…æ ¸æºç 主目录ä¸çš„admin-guide/reporting-bugs.rst文件里有一个很好的模æ¿ã€‚它指导用户如何报 -å‘Šå¯èƒ½çš„å†…æ ¸bug以åŠéœ€è¦æ供哪些信æ¯æ¥å¸®åŠ©å†…æ ¸å¼€å‘è€…ä»¬æ‰¾åˆ°é—®é¢˜çš„æ ¹æºã€‚ +å†…æ ¸æºç 主目录ä¸çš„:ref:`admin-guide/reporting-bugs.rst <reportingbugs>` +文件里有一个很好的模æ¿ã€‚它指导用户如何报告å¯èƒ½çš„å†…æ ¸bug以åŠéœ€è¦æä¾›å“ªäº›ä¿¡æ¯ +æ¥å¸®åŠ©å†…æ ¸å¼€å‘è€…ä»¬æ‰¾åˆ°é—®é¢˜çš„æ ¹æºã€‚ 利用bug报告 @@ -340,12 +289,7 @@ bugzilla.kernel.org是Linuxå†…æ ¸å¼€å‘者们用æ¥è·Ÿè¸ªå†…æ ¸Bug的网站。 者感å—åˆ°ä½ çš„å˜åœ¨ã€‚修改bug是赢得其他开å‘è€…èµžèª‰çš„æœ€å¥½åŠžæ³•ï¼Œå› ä¸ºå¹¶ä¸æ˜¯å¾ˆå¤š 人都喜欢浪费时间去修改别人报告的bug。 -è¦å°è¯•ä¿®æ”¹å·²çŸ¥çš„bug,请访问 http://bugzilla.kernel.org 网å€ã€‚å¦‚æžœä½ æƒ³èŽ·å¾— -最新bug的通知,å¯ä»¥è®¢é˜…bugme-new邮件列表(åªæœ‰æ–°çš„bug报告会被寄到这里) -或者订阅bugme-janitor邮件列表(所有bugzillaçš„å˜åŠ¨éƒ½ä¼šè¢«å¯„到这里)。 - - https://lists.linux-foundation.org/mailman/listinfo/bugme-new - https://lists.linux-foundation.org/mailman/listinfo/bugme-janitors +è¦å°è¯•ä¿®æ”¹å·²çŸ¥çš„bug,请访问 http://bugzilla.kernel.org 网å€ã€‚ 邮件列表