diff --git a/Documentation/translations/zh_CN/process/howto.rst b/Documentation/translations/zh_CN/process/howto.rst index 6ab16781232508b854df7a63978d27c384cd91ac..246f76a97eafa0e597d9cc1c7c2dc62c1f341ccf 100644 --- a/Documentation/translations/zh_CN/process/howto.rst +++ b/Documentation/translations/zh_CN/process/howto.rst @@ -81,20 +81,21 @@ Linuxå†…æ ¸ä»£ç ä¸åŒ…嫿œ‰å¤§é‡çš„æ–‡æ¡£ã€‚这些文档对于å¦ä¹ 如何与 的维护者解释这些å˜åŒ–。 ä»¥ä¸‹æ˜¯å†…æ ¸ä»£ç ä¸éœ€è¦é˜…读的文档: - README + :ref:`Documentation/admin-guide/README.rst <readme>` 文件简è¦ä»‹ç»äº†Linuxå†…æ ¸çš„èƒŒæ™¯ï¼Œå¹¶ä¸”æè¿°äº†å¦‚何é…ç½®å’Œç¼–è¯‘å†…æ ¸ã€‚å†…æ ¸çš„ 新用户应该从这里开始。 - Documentation/process/changes.rst + + :ref:`Documentation/process/changes.rst <changes>` 文件给出了用æ¥ç¼–è¯‘å’Œä½¿ç”¨å†…æ ¸æ‰€éœ€è¦çš„æœ€å°è½¯ä»¶åŒ…列表。 - Documentation/process/coding-style.rst + :ref:`Documentation/process/coding-style.rst <codingstyle>` æè¿°Linuxå†…æ ¸çš„ä»£ç é£Žæ ¼å’Œç†ç”±ã€‚所有新代ç 需è¦éµå®ˆè¿™ç¯‡æ–‡æ¡£ä¸å®šä¹‰çš„è§„ 范。大多数维护者åªä¼šæŽ¥æ”¶ç¬¦åˆè§„定的补ä¸ï¼Œå¾ˆå¤šäººä¹Ÿåªä¼šå¸®å¿™æ£€æŸ¥ç¬¦åˆé£Žæ ¼ 的代ç 。 - Documentation/process/submitting-patches.rst - Documentation/process/submitting-drivers.rst + :ref:`Documentation/process/submitting-patches.rst <submittingpatches>` + :ref:`Documentation/process/submitting-drivers.rst <submittingdrivers>` 这两份文档明确æè¿°å¦‚何创建和å‘é€è¡¥ä¸ï¼Œå…¶ä¸åŒ…括(但ä¸ä»…é™äºŽ): - 邮件内容 @@ -113,7 +114,7 @@ Linuxå†…æ ¸ä»£ç ä¸åŒ…嫿œ‰å¤§é‡çš„æ–‡æ¡£ã€‚这些文档对于å¦ä¹ 如何与 http://linux.yyz.us/patch-format.html - Documentation/process/stable-api-nonsense.rst + :ref:`Documentation/process/stable-api-nonsense.rst <stable_api_nonsense>` 论è¯å†…æ ¸ä¸ºä»€ä¹ˆç‰¹æ„ä¸åŒ…æ‹¬ç¨³å®šçš„å†…æ ¸å†…éƒ¨API,也就是说ä¸åŒ…括åƒè¿™æ ·çš„特 性: @@ -124,29 +125,29 @@ Linuxå†…æ ¸ä»£ç ä¸åŒ…嫿œ‰å¤§é‡çš„æ–‡æ¡£ã€‚这些文档对于å¦ä¹ 如何与 这篇文档对于ç†è§£Linux的开å‘哲å¦è‡³å…³é‡è¦ã€‚对于将开å‘å¹³å°ä»Žå…¶ä»–æ“作系 统转移到Linux的人æ¥è¯´ä¹Ÿå¾ˆé‡è¦ã€‚ - Documentation/admin-guide/security-bugs.rst + :ref:`Documentation/admin-guide/security-bugs.rst <securitybugs>` å¦‚æžœä½ è®¤ä¸ºè‡ªå·±å‘现了Linuxå†…æ ¸çš„å®‰å…¨æ€§é—®é¢˜ï¼Œè¯·æ ¹æ®è¿™ç¯‡æ–‡æ¡£ä¸çš„æ¥éª¤æ¥ æé†’å…¶ä»–å†…æ ¸å¼€å‘者并帮助解决这个问题。 - Documentation/process/management-style.rst + :ref:`Documentation/process/management-style.rst <managementstyle>` æè¿°å†…æ ¸ç»´æŠ¤è€…çš„å·¥ä½œæ–¹æ³•åŠå…¶å…±æœ‰ç‰¹ç‚¹ã€‚è¿™å¯¹äºŽåˆšåˆšæŽ¥è§¦å†…æ ¸å¼€å‘(或者对 它感到好奇)的人æ¥è¯´å¾ˆé‡è¦ï¼Œå› ä¸ºå®ƒè§£é‡Šäº†å¾ˆå¤šå¯¹äºŽå†…æ ¸ç»´æŠ¤è€…ç‹¬ç‰¹è¡Œä¸ºçš„ æ™®é误解与迷惑。 - Documentation/process/stable-kernel-rules.rst + :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>` è§£é‡Šäº†ç¨³å®šç‰ˆå†…æ ¸å‘布的规则,以åŠå¦‚何将改动放入这些版本的æ¥éª¤ã€‚ - Documentation/process/kernel-docs.rst + :ref:`Documentation/process/kernel-docs.rst <kernel_docs>` æœ‰åŠ©äºŽå†…æ ¸å¼€å‘çš„å¤–éƒ¨æ–‡æ¡£åˆ—è¡¨ã€‚å¦‚æžœä½ åœ¨å†…æ ¸è‡ªå¸¦çš„æ–‡æ¡£ä¸æ²¡æœ‰æ‰¾åˆ°ä½ 想找 的内容,å¯ä»¥æŸ¥çœ‹è¿™äº›æ–‡æ¡£ã€‚ - Documentation/process/applying-patches.rst + :ref:`Documentation/process/applying-patches.rst <applying_patches>` å…³äºŽè¡¥ä¸æ˜¯ä»€ä¹ˆä»¥åŠå¦‚何将它打在ä¸åŒå†…æ ¸å¼€å‘åˆ†æ”¯ä¸Šçš„å¥½ä»‹ç» å†…æ ¸è¿˜æ‹¥æœ‰å¤§é‡ä»Žä»£ç 自动生æˆçš„æ–‡æ¡£ã€‚它包å«å†…æ ¸å†…éƒ¨API的全é¢ä»‹ç»ä»¥åŠå¦‚何 妥善处ç†åŠ é”的规则。生æˆçš„æ–‡æ¡£ä¼šæ”¾åœ¨ Documentation/DocBook/目录下。在内 æ ¸æºç 的主目录ä¸ä½¿ç”¨ä»¥ä¸‹ä¸åŒå‘½ä»¤å°†ä¼šåˆ†åˆ«ç”ŸæˆPDFã€Postscriptã€HTML和手册 -页ç‰ä¸åŒæ ¼å¼çš„æ–‡æ¡£ï¼š +页ç‰ä¸åŒæ ¼å¼çš„æ–‡æ¡£:: make pdfdocs make htmldocs @@ -212,8 +213,8 @@ kernel.org网站的pub/linux/kernel/v2.6/目录下找到它。它的开å‘éµå¾ª - æ¯å½“ä¸€ä¸ªæ–°ç‰ˆæœ¬çš„å†…æ ¸è¢«å‘布,为期两周的集æˆçª—å£å°†è¢«æ‰“开。在这段时间里 维护者å¯ä»¥å‘Linusæäº¤å¤§æ®µçš„修改,通常这些修改已ç»è¢«æ”¾åˆ°-mmå†…æ ¸ä¸å‡ 个 星期了。æäº¤å¤§é‡ä¿®æ”¹çš„é¦–é€‰æ–¹å¼æ˜¯ä½¿ç”¨gitå·¥å…·ï¼ˆå†…æ ¸çš„ä»£ç 版本管ç†å·¥å…· - ,更多的信æ¯å¯ä»¥åœ¨http://git-scm.com/获å–),ä¸è¿‡ä½¿ç”¨æ™®é€šè¡¥ä¸ä¹Ÿæ˜¯å¯ä»¥ - 的。 + ,更多的信æ¯å¯ä»¥åœ¨ http://git-scm.com/ 获å–),ä¸è¿‡ä½¿ç”¨æ™®é€šè¡¥ä¸ä¹Ÿæ˜¯ + å¯ä»¥çš„。 - 两个星期以åŽ-rc1ç‰ˆæœ¬å†…æ ¸å‘布。之åŽåªæœ‰ä¸åŒ…å«å¯èƒ½å½±å“æ•´ä¸ªå†…æ ¸ç¨³å®šæ€§çš„ æ–°åŠŸèƒ½çš„è¡¥ä¸æ‰å¯èƒ½è¢«æŽ¥å—。请注æ„一个全新的驱动程åºï¼ˆæˆ–者文件系统)有 å¯èƒ½åœ¨-rc1åŽè¢«æŽ¥å—æ˜¯å› ä¸ºè¿™æ ·çš„ä¿®æ”¹å®Œå…¨ç‹¬ç«‹ï¼Œä¸ä¼šå½±å“其他的代ç ,所以 @@ -243,8 +244,8 @@ kernel.org网站的pub/linux/kernel/v2.6/目录下找到它。它的开å‘éµå¾ª 2.6.x.y版本由“稳定版â€å°ç»„(邮件地å€<stable@vger.kernel.org>ï¼‰ç»´æŠ¤ï¼Œä¸€èˆ¬éš”å‘¨å‘ å¸ƒæ–°ç‰ˆæœ¬ã€‚ -å†…æ ¸æºç ä¸çš„Documentation/process/stable-kernel-rules.rst文件具体æè¿°äº†å¯è¢«ç¨³å®š -ç‰ˆå†…æ ¸æŽ¥å—的修改类型以åŠå‘布的æµç¨‹ã€‚ +å†…æ ¸æºç ä¸çš„ :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>` +文件具体æè¿°äº†å¯è¢«ç¨³å®šç‰ˆå†…æ ¸æŽ¥å—的修改类型以åŠå‘布的æµç¨‹ã€‚ 2.6.x -mmè¡¥ä¸é›† @@ -316,7 +317,7 @@ linux-kernelé‚®ä»¶åˆ—è¡¨ä¸æä¾›åé¦ˆï¼Œå‘Šè¯‰å¤§å®¶ä½ é‡åˆ°äº†é—®é¢˜è¿˜æ˜¯ - x86-64, 部分i386, Andi Kleen <ak@suse.de> ftp.firstfloor.org:/pub/ak/x86_64/quilt/ - å…¶ä»–å†…æ ¸æºç æ ‘å¯ä»¥åœ¨http://git.kernel.org的列表ä¸å’ŒMAINTAINERS文件里 + å…¶ä»–å†…æ ¸æºç æ ‘å¯ä»¥åœ¨ http://git.kernel.org 的列表ä¸å’ŒMAINTAINERS文件里 找到。 报告bug @@ -339,7 +340,7 @@ bugzilla.kernel.org是Linuxå†…æ ¸å¼€å‘者们用æ¥è·Ÿè¸ªå†…æ ¸Bug的网站。 者感å—åˆ°ä½ çš„å˜åœ¨ã€‚修改bug是赢得其他开å‘è€…èµžèª‰çš„æœ€å¥½åŠžæ³•ï¼Œå› ä¸ºå¹¶ä¸æ˜¯å¾ˆå¤š 人都喜欢浪费时间去修改别人报告的bug。 -è¦å°è¯•修改已知的bug,请访问http://bugzilla.kernel.org网å€ã€‚å¦‚æžœä½ æƒ³èŽ·å¾— +è¦å°è¯•修改已知的bug,请访问 http://bugzilla.kernel.org 网å€ã€‚å¦‚æžœä½ æƒ³èŽ·å¾— 最新bug的通知,å¯ä»¥è®¢é˜…bugme-newé‚®ä»¶åˆ—è¡¨ï¼ˆåªæœ‰æ–°çš„bug报告会被寄到这里) 或者订阅bugme-janitor邮件列表(所有bugzillaçš„å˜åŠ¨éƒ½ä¼šè¢«å¯„åˆ°è¿™é‡Œï¼‰ã€‚ @@ -384,11 +385,12 @@ MAINTAINERS文件ä¸å¯ä»¥æ‰¾åˆ°ä¸åŒè¯é¢˜å¯¹åº”的邮件列表。 è¿™å‡ è¡Œã€‚å°†ä½ çš„è¯„è®ºåŠ åœ¨è¢«å¼•ç”¨çš„æ®µè½ä¹‹é—´è€Œä¸è¦æ”¾åœ¨é‚®ä»¶çš„顶部。 å¦‚æžœä½ åœ¨é‚®ä»¶ä¸é™„带补ä¸ï¼Œè¯·ç¡®è®¤å®ƒä»¬æ˜¯å¯ä»¥ç›´æŽ¥é˜…读的纯文本(如 -Documentation/process/submitting-patches.rstæ–‡æ¡£ä¸æ‰€è¿°ï¼‰ã€‚å†…æ ¸å¼€å‘者们ä¸å¸Œæœ›é‡åˆ°é™„ä»¶ -或者被压缩了的补ä¸ã€‚åªæœ‰è¿™æ ·æ‰èƒ½ä¿è¯ä»–们å¯ä»¥ç›´æŽ¥è¯„è®ºä½ çš„æ¯è¡Œä»£ç ã€‚è¯·ç¡®ä¿ -ä½ ä½¿ç”¨çš„é‚®ä»¶å‘é€ç¨‹åºä¸ä¼šä¿®æ”¹ç©ºæ ¼å’Œåˆ¶è¡¨ç¬¦ã€‚一个防范性的测试方法是先将邮件 -å‘é€ç»™è‡ªå·±ï¼Œç„¶åŽè‡ªå·±å°è¯•是å¦å¯ä»¥é¡ºåˆ©åœ°æ‰“上收到的补ä¸ã€‚å¦‚æžœæµ‹è¯•ä¸æˆåŠŸï¼Œè¯· -调整或者更æ¢ä½ 的邮件å‘é€ç¨‹åºç›´åˆ°å®ƒæ£ç¡®å·¥ä½œä¸ºæ¢ã€‚ +:ref:`Documentation/process/submitting-patches.rst <submittingpatches>` +æ–‡æ¡£ä¸æ‰€è¿°ï¼‰ã€‚å†…æ ¸å¼€å‘者们ä¸å¸Œæœ›é‡åˆ°é™„件或者被压缩了的补ä¸ã€‚åªæœ‰è¿™æ ·æ‰èƒ½ +ä¿è¯ä»–们å¯ä»¥ç›´æŽ¥è¯„è®ºä½ çš„æ¯è¡Œä»£ç 。请确ä¿ä½ 使用的邮件å‘é€ç¨‹åºä¸ä¼šä¿®æ”¹ç©ºæ ¼ +和制表符。一个防范性的测试方法是先将邮件å‘é€ç»™è‡ªå·±ï¼Œç„¶åŽè‡ªå·±å°è¯•是å¦å¯ä»¥ +顺利地打上收到的补ä¸ã€‚å¦‚æžœæµ‹è¯•ä¸æˆåŠŸï¼Œè¯·è°ƒæ•´æˆ–è€…æ›´æ¢ä½ 的邮件å‘é€ç¨‹åºç›´åˆ° +它æ£ç¡®å·¥ä½œä¸ºæ¢ã€‚ 总而言之,请尊é‡å…¶ä»–的邮件列表订阅者。