[Patch Resend]Fix the messy code file Documentation/zh_CN/SubmitChecklist

[Patch Resend]Fix the messy code file Documentation/zh_CN/SubmitChecklist

[Harry Wei]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=unknown-8bit, Size: 9629 bytes --]

From: Harry Wei <harryxiyou@gmail.com>

This patch can fix the messy code file Documentation/zh_CN/SubmitChecklist.

Signed-off-by: Harry Wei <harryxiyou@gmail.com>

Index: linux-3.0-rc2/Documentation/zh_CN/SubmitChecklist
===================================================================
--- linux-3.0-rc2.orig/Documentation/zh_CN/SubmitChecklist	2011-06-12 11:21:59.016740957 +0800
+++ linux-3.0-rc2/Documentation/zh_CN/SubmitChecklist	2011-06-12 11:22:27.904778610 +0800
@@ -1,109 +1,110 @@
-Chinese translated version of Documentation/SubmitChecklist
-
+Chinese translated version of Documentation/SubmitChecklist
+
 If you have any comment or update to the content, please contact the
 original document maintainer directly.  However, if you have a problem
 communicating in English you can also ask the Chinese maintainer for
 help.  Contact the Chinese maintainer if this translation is outdated
 or if there is a problem with the translation.
-
+
 Chinese maintainer: Harry Wei <harryxiyou@gmail.com>
 ---------------------------------------------------------------------
-Documentation/SubmitChecklist ?????Ä·???
-
-?????????Û»????±??ĵ????Ý£???Ö±??ÁªÏµÔ­?ĵ???ά???ß¡???????ʹ??Ó¢??
-??????À§?ѵĻ???Ò²?????????Ä°?ά?????????????û±¾·­?????²???ʱ???ß·?
-?????????⣬??ÁªÏµ???Ä°?ά???ß¡?
-
-???İ?ά???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
-???İ淭???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
-???İ?У???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
-
-
-????Ϊ????
+Documentation/SubmitChecklist 的中文翻译
+
+如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文
+交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻
+译存在问题，请联系中文版维护者。
+
+中文版维护者： 贾威威 Harry Wei <harryxiyou@gmail.com>
+中文版翻译者： 贾威威 Harry Wei <harryxiyou@gmail.com>
+中文版校译者： 贾威威 Harry Wei <harryxiyou@gmail.com>
+
+
+以下为正文
 ---------------------------------------------------------------------
-Linux?Úº??á½»?åµ¥
+Linux内核提交清单
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+这里有一些内核开发者应该做的基本事情，如果他们想看到自己的内核补丁提交
+被接受的更快。
+
+这些都是超出Documentation/SubmittingPatches文档里所提供的以及其他
+关于提交Linux内核补丁的说明。
+
+1：如果你使用了一个功能那么就#include定义/声明那个功能的那个文件。
+  不要依靠其他间接引入定义/声明那个功能的头文件。
+
+2：构建简洁适用或者更改CONFIG选项 =y，=m，或者=n。
+  不要有编译警告/错误， 不要有链接警告/错误。
+
+2b：通过 allnoconfig, allmodconfig
+
+2c：当使用 0=builddir 成功地构建
+
+3：通过使用本地交叉编译工具或者其他一些构建产所，在多CPU框架上构建。
+
+4：ppc64 是一个很好的检查交叉编译的框架，因为它往往把‘unsigned long’
+   当64位值来使用。
+
+5：按照Documentation/CodingStyle文件里的详细描述，检查你补丁的整体风格。
+  使用补丁风格检查琐碎的违规(scripts/checkpatch.pl)，审核员优先提交。
+  你应该调整遗留在你补丁中的所有违规。
+
+6：任何更新或者改动CONFIG选项都不能打乱配置菜单。
+
+7：所有的Kconfig选项更新都要有说明文字。
+
+8：已经认真地总结了相关的Kconfig组合。这是很难通过测试做好的--脑力在这里下降。
+
+9：检查具有简洁性。
+
+10：使用'make checkstack'和'make namespacecheck'检查，然后修改所找到的问题。
+    注意：堆栈检查不会明确地出现问题，但是任何的一个函数在堆栈上使用多于512字节
+    都要准备修改。
+
+11：包含kernel-doc到全局内核APIs文件。（不要求静态的函数，但是包含也无所谓。）
+   使用'make htmldocs'或者'make mandocs'来检查kernel-doc，然后修改任何
+   发现的问题。
+
+12：已经通过CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT,
+   CONFIG_DEBUG_SLAB, CONFIG_DEBUG_PAGEALLOC, CONFIG_DEBUG_MUTEXES,
+   CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_SPINLOCK_SLEEP测试，并且同时都
+   使能。
+
+13：已经都构建并且使用或者不使用 CONFIG_SMP 和 CONFIG_PREEMPT测试执行时间。
+
+14：如果补丁影响IO/Disk，等等：已经通过使用或者不使用 CONFIG_LBDAF 测试。
+
+15：所有的codepaths已经行使所有lockdep启用功能。
+
+16：所有的/proc记录更新都要作成文件放在Documentation/目录下。
+
+17：所有的内核启动参数更新都被记录到Documentation/kernel-parameters.txt文件中。
+
+18：所有的模块参数更新都用MODULE_PARM_DESC()记录。
+
+19：所有的用户空间接口更新都被记录到Documentation/ABI/。查看Documentation/ABI/README
+    可以获得更多的信息。改变用户空间接口的补丁应该被邮件抄送给linux-api@vger.kernel.org。
+
+20：检查它是不是都通过`make headers_check'。
+
+21：已经通过至少引入slab和page-allocation失败检查。查看Documentation/fault-injection/。
+
+22：新加入的源码已经通过`gcc -W'（使用"make EXTRA_CFLAGS=-W"）编译。这样将产生很多烦恼，
+   但是对于寻找漏洞很有益处，例如:"warning: comparison between signed and unsigned"。
+
+23：当它被合并到-mm补丁集后再测试，用来确定它是否还和补丁队列中的其他补丁一起工作以及在VM，VFS
+   和其他子系统中各个变化。
+
+24：所有的内存屏障{e.g., barrier(), rmb(), wmb()}需要在源代码中的一个注释来解释他们都是干什么的
+   以及原因。
+
+25：如果有任何输入输出控制的补丁被添加，也要更新Documentation/ioctl/ioctl-number.txt。
+
+26：如果你的更改代码依靠或者使用任何的内核APIs或者与下面的kconfig符号有关系的功能，你就要
+   使用相关的kconfig符号关闭， and/or =m（如果选项提供）[在同一时间不是所用的都启用，仅仅各个或者自由
+   组合他们]：
+
+	CONFIG_SMP, CONFIG_SYSFS, CONFIG_PROC_FS, CONFIG_INPUT, CONFIG_PCI,
+	CONFIG_BLOCK, CONFIG_PM, CONFIG_HOTPLUG, CONFIG_MAGIC_SYSRQ,
+	CONFIG_NET, CONFIG_INET=n (后一个使用 CONFIG_NET=y)
 
-??????һЩ?ں˿?????Ӧ?????Ļ??????飬?????????뿴???Լ????ں˲????ύ
-?????ܵĸ??졣
-
-??Щ???dz???Documentation/SubmittingPatches?ĵ??????ṩ???Լ?????
-?????ύLinux?ں˲?????˵????
-
-1????????ʹ????һ????????ô??#include????/?????Ǹ????ܵ??Ǹ??ļ???
-   ??Òª?À¿????????????붨??/?????Ǹ????ܵ?Í·?ļ???
-
-2?????????????û??߸???CONFIGѡ?? =y??=m??????=n??
-   ??Òª?б??뾯??/?????? ??Òª??Á´?Ó¾???/??????
-
-2b??ͨ?? allnoconfig, allmodconfig
-
-2c????ʹ?? 0=builddir ?ɹ??ع???
-
-3??ͨ??ʹ?ñ??ؽ??????빤?߻???????һЩ???????????ڶ?CPU?????Ϲ?????
-
-4??ppc64 ??һ???ܺõļ??齻???????Ŀ??ܣ???Ϊ???????ѡ?unsigned long??
-   ??64λֵÀ´Ê¹?á?
-
-5??????Documentation/CodingStyle?ļ???????ϸ???ö£¬¼????ã²¹??????????????
-   ʹ?ò?????????????????Υ??(scripts/checkpatch.pl)??????Ա?????ύ??
-   ??Ӧ?õ??????????㲹???е?????Υ?档
-
-6???κθ??»??߸Ķ?CONFIGѡ????ܴ??????ò˵???
-
-7?????е?Kconfigѡ?????¶?Ҫ??˵?????֡?
-
-8???Ѿ????????ܽ??????ص?Kconfig???Ï¡????Ǻ???ͨ?????????õ?--??Á¦???????½???
-
-9?????????м????ԡ?
-
-10??ʹ??'make checkstack'??'make namespacecheck'???飬Ȼ???޸????ҵ??????⡣
-    ע?⣺??ջ???鲻????ȷ?س??????⣬?????κε?һ???????ڶ?ջ??ʹ?ö???512?ֽ?
-    ??Ҫ׼???޸ġ?
-
-11??????kernel-doc??ȫ???ں?APIs?ļ???????Ҫ????̬?ĺ????????ǰ???Ҳ????ν????
-    ʹ??'make htmldocs'????'make mandocs'À´????kernel-doc??È»???Þ¸??κ?
-    ???Öµ????â¡£
-
-12???Ѿ?ͨ??CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT,
-    CONFIG_DEBUG_SLAB, CONFIG_DEBUG_PAGEALLOC, CONFIG_DEBUG_MUTEXES,
-    CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_SPINLOCK_SLEEP???ԣ?????ͬʱ??
-    ʹ?ܡ?
-
-13???Ѿ???????????ʹ?û??߲?ʹ?? CONFIG_SMP ?? CONFIG_PREEMPT????ִ??ʱ?䡣
-
-14?????û²¹¶¡Ó°??IO/Disk???ȵȣ??Ѿ?ͨ??ʹ?û??ß²?ʹ?? CONFIG_LBDAF ???Ô¡?
-
-15?????е?codepaths?Ѿ???ʹ????lockdep???ù??ܡ?
-
-16?????е?/proc??¼???¶?Ҫ?????ļ?????Documentation/Ŀ¼?¡?
-
-17?????е??Úº??ô¶¯²??????¶?????¼??Documentation/kernel-parameters.txt?ļ??С?
-
-18?????е?ģ?????????¶???MODULE_PARM_DESC()??¼??
-
-19?????е??û??ռ??ӿڸ??¶?????¼??Documentation/ABI/???鿴Documentation/ABI/README
-    ???Ի??ø???????Ϣ???ı??û??ռ??ӿڵIJ???Ӧ?ñ??ʼ????͸?linux-api@vger.kernel.org??
-
-20?????????Dz??Ƕ?ͨ??`make headers_check'??
-
-21???Ѿ?ͨ??????????slab??page-allocationʧ?ܼ??顣?鿴Documentation/fault-injection/??
-
-22???¼?????Դ???Ѿ?ͨ??`gcc -W'??ʹ??"make EXTRA_CFLAGS=-W"?????롣???????????ܶෳ?գ?
-    ???Ƕ???Ѱ??©???????洦??????:"warning: comparison between signed and unsigned"??
-
-23?????????ϲ???-mm?????????Ù²??Ô£???À´È·?????Ç·ñ»¹ºÍ²????????е????û²¹¶¡Ò»???????Ô¼???VM??VFS
-    ????????ϵͳ?и????仯??
-
-24?????е??Ú´?????{e.g., barrier(), rmb(), wmb()}??Òª??Ô´?????е?Ò»??×¢??À´???????Ƕ??Ǹ?ʲô??
-    ?Ô¼?Ô­????
-
-25?????????κ????????????ƵIJ????????ӣ?ҲҪ????Documentation/ioctl/ioctl-number.txt??
-
-26?????????ĸ??Ä´????À¿?????ʹ???κε??Úº?APIs????????????kconfig?????й?ϵ?Ĺ??Ü£?????Òª
-    ʹ?????ص?kconfig???Źرգ? and/or =m??????ѡ???ṩ??[??ͬһʱ?䲻?????õĶ????ã?????????????????
-    ????????]??
-
-    CONFIG_SMP, CONFIG_SYSFS, CONFIG_PROC_FS, CONFIG_INPUT, CONFIG_PCI,
-    CONFIG_BLOCK, CONFIG_PM, CONFIG_HOTPLUG, CONFIG_MAGIC_SYSRQ,
-    CONFIG_NET, CONFIG_INET=n (??һ??ʹ?? CONFIG_NET=y)

Re: [Patch Resend]Fix the messy code file Documentation/zh_CN/SubmitChecklist

[Amos Kong]

2011/7/10 Harry Wei <jiaweiwei.xiyou@gmail.com>:
> From: Harry Wei <harryxiyou@gmail.com>
>
> This patch can fix the messy code file Documentation/zh_CN/SubmitChecklist.
>
> Signed-off-by: Harry Wei <harryxiyou@gmail.com>
>
> Index: linux-3.0-rc2/Documentation/zh_CN/SubmitChecklist
> ===================================================================
> --- linux-3.0-rc2.orig/Documentation/zh_CN/SubmitChecklist      2011-06-12 11:21:59.016740957 +0800
> +++ linux-3.0-rc2/Documentation/zh_CN/SubmitChecklist   2011-06-12 11:22:27.904778610 +0800
> @@ -1,109 +1,110 @@
> -Chinese translated version of Documentation/SubmitChecklist
> -
> +Chinese translated version of Documentation/SubmitChecklist
> +
>  If you have any comment or update to the content, please contact the
>  original document maintainer directly.  However, if you have a problem
>  communicating in English you can also ask the Chinese maintainer for
>  help.  Contact the Chinese maintainer if this translation is outdated
>  or if there is a problem with the translation.
> -
> +
>  Chinese maintainer: Harry Wei <harryxiyou@gmail.com>
>  ---------------------------------------------------------------------
> -Documentation/SubmitChecklist ?????ķ???
> -
> -?????????ۻ????±??ĵ????ݣ???ֱ??��ϵԭ?ĵ???ά???ߡ???????ʹ??Ӣ??
> -??????�§?ѵĻ???Ҳ?????????İ?ά?????????????����­?????²???ʱ???߷?
> -?????????⣬??��ϵ???İ?ά???ߡ?
> -
> -???İ?ά???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
> -???İ淭???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
> -???İ?У???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
> -
> -
> -????Ϊ????
> +Documentation/SubmitChecklist 的中文翻译
> +

FYI, I can realize the Chinese now.
You can send the patch to yourself for checking before sending it to
the public maillist.

[Patch Resend]Fix the messy code file Documentation/zh_CN/SubmitChecklist

[Harry Wei]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=unknown-8bit, Size: 8999 bytes --]

From: Harry Wei <harryxiyou@gmail.com>

This patch can fix the messy code file Documentation/zh_CN/SubmitChecklist.

Signed-off-by: Harry Wei <harryxiyou@gmail.com>
---
 Documentation/zh_CN/SubmitChecklist |  118 +++++++++++++++++-----------------
 1 files changed, 59 insertions(+), 59 deletions(-)

diff --git a/Documentation/zh_CN/SubmitChecklist b/Documentation/zh_CN/SubmitChecklist
index 951415b..7f41713 100644
--- a/Documentation/zh_CN/SubmitChecklist
+++ b/Documentation/zh_CN/SubmitChecklist
@@ -8,102 +8,102 @@ or if there is a problem with the translation.
 
 Chinese maintainer: Harry Wei <harryxiyou@gmail.com>
 ---------------------------------------------------------------------
-Documentation/SubmitChecklist ?????Ä·???
+Documentation/SubmitChecklist 的中文翻译
 
-?????????Û»????±??ĵ????Ý£???Ö±??ÁªÏµÔ­?ĵ???ά???ß¡???????ʹ??Ó¢??
-??????À§?ѵĻ???Ò²?????????Ä°?ά?????????????û±¾·­?????²???ʱ???ß·?
-?????????⣬??ÁªÏµ???Ä°?ά???ß¡?
+如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文
+交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻
+译存在问题，请联系中文版维护者。
 
-???İ?ά???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
-???İ淭???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
-???İ?У???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
+中文版维护者： 贾威威 Harry Wei <harryxiyou@gmail.com>
+中文版翻译者： 贾威威 Harry Wei <harryxiyou@gmail.com>
+中文版校译者： 贾威威 Harry Wei <harryxiyou@gmail.com>
 
 
-????Ϊ????
+以下为正文
 ---------------------------------------------------------------------
-Linux?Úº??á½»?åµ¥
+Linux内核提交清单
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-??????һЩ?ں˿?????Ӧ?????Ļ??????飬?????????뿴???Լ????ں˲????ύ
-?????ܵĸ??졣
+这里有一些内核开发者应该做的基本事情，如果他们想看到自己的内核补丁提交
+被接受的更快。
 
-??Щ???dz???Documentation/SubmittingPatches?ĵ??????ṩ???Լ?????
-?????ύLinux?ں˲?????˵????
+这些都是超出Documentation/SubmittingPatches文档里所提供的以及其他
+关于提交Linux内核补丁的说明。
 
-1????????ʹ????һ????????ô??#include????/?????Ǹ????ܵ??Ǹ??ļ???
-   ??Òª?À¿????????????붨??/?????Ǹ????ܵ?Í·?ļ???
+1：如果你使用了一个功能那么就#include定义/声明那个功能的那个文件。
+   不要依靠其他间接引入定义/声明那个功能的头文件。
 
-2?????????????û??߸???CONFIGѡ?? =y??=m??????=n??
-   ??Òª?б??뾯??/?????? ??Òª??Á´?Ó¾???/??????
+2：构建简洁适用或者更改CONFIG选项 =y，=m，或者=n.   
+   不要有编译警告/错误， 不要有链接警告/错误.
 
-2b??ͨ?? allnoconfig, allmodconfig
+2b：通过 allnoconfig, allmodconfig
 
-2c????ʹ?? 0=builddir ?ɹ??ع???
+2c：当使用 0=builddir 成功地构建
 
-3??ͨ??ʹ?ñ??ؽ??????빤?߻???????һЩ???????????ڶ?CPU?????Ϲ?????
+3：通过使用本地交叉编译工具或者其他一些构建产所，在多CPU框架上构建。
 
-4??ppc64 ??һ???ܺõļ??齻???????Ŀ??ܣ???Ϊ???????ѡ?unsigned long??
-   ??64λֵÀ´Ê¹?á?
+4：ppc64 是一个很好的检查交叉编译的框架，因为它往往把‘unsigned long’
+   当64位值来使用。
 
-5??????Documentation/CodingStyle?ļ???????ϸ???ö£¬¼????ã²¹??????????????
-   ʹ?ò?????????????????Υ??(scripts/checkpatch.pl)??????Ա?????ύ??
-   ??Ӧ?õ??????????㲹???е?????Υ?档
+5：按照Documentation/CodingStyle文件里的详细描述，检查你补丁的整体风格。
+   使用补丁风格检查琐碎的违规(scripts/checkpatch.pl)，审核员优先提交。
+   你应该调整遗留在你补丁中的所有违规。
 
-6???κθ??»??߸Ķ?CONFIGѡ????ܴ??????ò˵???
+6：任何更新或者改动CONFIG选项都不能打乱配置菜单。
 
-7?????е?Kconfigѡ?????¶?Ҫ??˵?????֡?
+7：所有的Kconfig选项更新都要有说明文字。
 
-8???Ѿ????????ܽ??????ص?Kconfig???Ï¡????Ǻ???ͨ?????????õ?--??Á¦???????½???
+8：已经认真地总结了相关的Kconfig组合。这是很难通过测试做好的--脑力在这里下降。
 
-9?????????м????ԡ?
+9：检查具有简洁性。
 
-10??ʹ??'make checkstack'??'make namespacecheck'???飬Ȼ???޸????ҵ??????⡣
-    ע?⣺??ջ???鲻????ȷ?س??????⣬?????κε?һ???????ڶ?ջ??ʹ?ö???512?ֽ?
-    ??Ҫ׼???޸ġ?
+10：使用'make checkstack'和'make namespacecheck'检查，然后修改所找到的问题。
+    注意：堆栈检查不会明确地出现问题，但是任何的一个函数在堆栈上使用多于512字节
+    都要准备修改。
 
-11??????kernel-doc??ȫ???ں?APIs?ļ???????Ҫ????̬?ĺ????????ǰ???Ҳ????ν????
-    ʹ??'make htmldocs'????'make mandocs'À´????kernel-doc??È»???Þ¸??κ?
-    ???Öµ????â¡£
+11：包含kernel-doc到全局内核APIs文件。（不要求静态的函数，但是包含也无所谓。）
+    使用'make htmldocs'或者'make mandocs'来检查kernel-doc，然后修改任何
+    发现的问题。
 
-12???Ѿ?ͨ??CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT,
+12：已经通过CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT,
     CONFIG_DEBUG_SLAB, CONFIG_DEBUG_PAGEALLOC, CONFIG_DEBUG_MUTEXES,
-    CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_SPINLOCK_SLEEP???ԣ?????ͬʱ??
-    ʹ?ܡ?
+    CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_SPINLOCK_SLEEP测试，并且同时都
+    使能。
 
-13???Ѿ???????????ʹ?û??߲?ʹ?? CONFIG_SMP ?? CONFIG_PREEMPT????ִ??ʱ?䡣
+13：已经都构建并且使用或者不使用 CONFIG_SMP 和 CONFIG_PREEMPT测试执行时间。
 
-14?????û²¹¶¡Ó°??IO/Disk???ȵȣ??Ѿ?ͨ??ʹ?û??ß²?ʹ?? CONFIG_LBDAF ???Ô¡?
+14：如果补丁影响IO/Disk，等等：已经通过使用或者不使用 CONFIG_LBDAF 测试。
 
-15?????е?codepaths?Ѿ???ʹ????lockdep???ù??ܡ?
+15：所有的codepaths已经行使所有lockdep启用功能。
 
-16?????е?/proc??¼???¶?Ҫ?????ļ?????Documentation/Ŀ¼?¡?
+16：所有的/proc记录更新都要作成文件放在Documentation/目录下。
 
-17?????е??Úº??ô¶¯²??????¶?????¼??Documentation/kernel-parameters.txt?ļ??С?
+17：所有的内核启动参数更新都被记录到Documentation/kernel-parameters.txt文件中。
 
-18?????е?ģ?????????¶???MODULE_PARM_DESC()??¼??
+18：所有的模块参数更新都用MODULE_PARM_DESC()记录。
 
-19?????е??û??ռ??ӿڸ??¶?????¼??Documentation/ABI/???鿴Documentation/ABI/README
-    ???Ի??ø???????Ϣ???ı??û??ռ??ӿڵIJ???Ӧ?ñ??ʼ????͸?linux-api@vger.kernel.org??
+19：所有的用户空间接口更新都被记录到Documentation/ABI/。查看Documentation/ABI/README
+    可以获得更多的信息。改变用户空间接口的补丁应该被邮件抄送给linux-api@vger.kernel.org。
 
-20?????????Dz??Ƕ?ͨ??`make headers_check'??
+20：检查它是不是都通过`make headers_check'。
 
-21???Ѿ?ͨ??????????slab??page-allocationʧ?ܼ??顣?鿴Documentation/fault-injection/??
+21：已经通过至少引入slab和page-allocation失败检查。查看Documentation/fault-injection/。
 
-22???¼?????Դ???Ѿ?ͨ??`gcc -W'??ʹ??"make EXTRA_CFLAGS=-W"?????롣???????????ܶෳ?գ?
-    ???Ƕ???Ѱ??©???????洦??????:"warning: comparison between signed and unsigned"??
+22：新加入的源码已经通过`gcc -W'（使用"make EXTRA_CFLAGS=-W"）编译。这样将产生很多烦恼，
+    但是对于寻找漏洞很有益处，例如:"warning: comparison between signed and unsigned"。
 
-23?????????ϲ???-mm?????????Ù²??Ô£???À´È·?????Ç·ñ»¹ºÍ²????????е????û²¹¶¡Ò»???????Ô¼???VM??VFS
-    ????????ϵͳ?и????仯??
+23：当它被合并到-mm补丁集后再测试，用来确定它是否还和补丁队列中的其他补丁一起工作以及在VM，VFS
+    和其他子系统中各个变化。
 
-24?????е??Ú´?????{e.g., barrier(), rmb(), wmb()}??Òª??Ô´?????е?Ò»??×¢??À´???????Ƕ??Ǹ?ʲô??
-    ?Ô¼?Ô­????
+24：所有的内存屏障{e.g., barrier(), rmb(), wmb()}需要在源代码中的一个注释来解释他们都是干什么的
+    以及原因。
 
-25?????????κ????????????ƵIJ????????ӣ?ҲҪ????Documentation/ioctl/ioctl-number.txt??
+25：如果有任何输入输出控制的补丁被添加，也要更新Documentation/ioctl/ioctl-number.txt。
 
-26?????????ĸ??Ä´????À¿?????ʹ???κε??Úº?APIs????????????kconfig?????й?ϵ?Ĺ??Ü£?????Òª
-    ʹ?????ص?kconfig???Źرգ? and/or =m??????ѡ???ṩ??[??ͬһʱ?䲻?????õĶ????ã?????????????????
-    ????????]??
+26：如果你的更改代码依靠或者使用任何的内核APIs或者与下面的kconfig符号有关系的功能，你就要
+    使用相关的kconfig符号关闭， and/or =m（如果选项提供）[在同一时间不是所用的都启用，仅仅各个或者自由
+    组合他们]：
 
     CONFIG_SMP, CONFIG_SYSFS, CONFIG_PROC_FS, CONFIG_INPUT, CONFIG_PCI,
     CONFIG_BLOCK, CONFIG_PM, CONFIG_HOTPLUG, CONFIG_MAGIC_SYSRQ,
-    CONFIG_NET, CONFIG_INET=n (??һ??ʹ?? CONFIG_NET=y)
+    CONFIG_NET, CONFIG_INET=n (后一个使用 CONFIG_NET=y)
-- 
1.7.0.4

Re: [Patch Resend]Fix the messy code file Documentation/zh_CN/SubmitChecklist

[Harry Wei]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=unknown-8bit, Size: 9117 bytes --]

From: Harry Wei <harryxiyou@gmail.com>

So sorry with a mistake, which i did not check my patch with
./checkpatch.pl. This one is all well for checkpatch.pl. It 
can fix the messy code file Documentation/zh_CN/SubmitChecklist correctly.

Signed-off-by: Harry Wei <harryxiyou@gmail.com>
---
 Documentation/zh_CN/SubmitChecklist |  118 +++++++++++++++++-----------------
 1 files changed, 59 insertions(+), 59 deletions(-)

diff --git a/Documentation/zh_CN/SubmitChecklist b/Documentation/zh_CN/SubmitChecklist
index 951415b..7f41713 100644
--- a/Documentation/zh_CN/SubmitChecklist
+++ b/Documentation/zh_CN/SubmitChecklist
@@ -8,102 +8,102 @@ or if there is a problem with the translation.
 
 Chinese maintainer: Harry Wei <harryxiyou@gmail.com>
 ---------------------------------------------------------------------
-Documentation/SubmitChecklist ?????Ä·???
+Documentation/SubmitChecklist 的中文翻译
 
-?????????Û»????±??ĵ????Ý£???Ö±??ÁªÏµÔ­?ĵ???ά???ß¡???????ʹ??Ó¢??
-??????À§?ѵĻ???Ò²?????????Ä°?ά?????????????û±¾·­?????²???ʱ???ß·?
-?????????⣬??ÁªÏµ???Ä°?ά???ß¡?
+如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文
+交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻
+译存在问题，请联系中文版维护者。
 
-???İ?ά???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
-???İ淭???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
-???İ?У???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
+中文版维护者： 贾威威 Harry Wei <harryxiyou@gmail.com>
+中文版翻译者： 贾威威 Harry Wei <harryxiyou@gmail.com>
+中文版校译者： 贾威威 Harry Wei <harryxiyou@gmail.com>
 
 
-????Ϊ????
+以下为正文
 ---------------------------------------------------------------------
-Linux?Úº??á½»?åµ¥
+Linux内核提交清单
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-??????һЩ?ں˿?????Ӧ?????Ļ??????飬?????????뿴???Լ????ں˲????ύ
-?????ܵĸ??졣
+这里有一些内核开发者应该做的基本事情，如果他们想看到自己的内核补丁提交
+被接受的更快。
 
-??Щ???dz???Documentation/SubmittingPatches?ĵ??????ṩ???Լ?????
-?????ύLinux?ں˲?????˵????
+这些都是超出Documentation/SubmittingPatches文档里所提供的以及其他
+关于提交Linux内核补丁的说明。
 
-1????????ʹ????һ????????ô??#include????/?????Ǹ????ܵ??Ǹ??ļ???
-   ??Òª?À¿????????????붨??/?????Ǹ????ܵ?Í·?ļ???
+1：如果你使用了一个功能那么就#include定义/声明那个功能的那个文件。
+   不要依靠其他间接引入定义/声明那个功能的头文件。
 
-2?????????????û??߸???CONFIGѡ?? =y??=m??????=n??
-   ??Òª?б??뾯??/?????? ??Òª??Á´?Ó¾???/??????
+2：构建简洁适用或者更改CONFIG选项 =y，=m，或者=n.
+   不要有编译警告/错误， 不要有链接警告/错误.
 
-2b??ͨ?? allnoconfig, allmodconfig
+2b：通过 allnoconfig, allmodconfig
 
-2c????ʹ?? 0=builddir ?ɹ??ع???
+2c：当使用 0=builddir 成功地构建
 
-3??ͨ??ʹ?ñ??ؽ??????빤?߻???????һЩ???????????ڶ?CPU?????Ϲ?????
+3：通过使用本地交叉编译工具或者其他一些构建产所，在多CPU框架上构建。
 
-4??ppc64 ??һ???ܺõļ??齻???????Ŀ??ܣ???Ϊ???????ѡ?unsigned long??
-   ??64λֵÀ´Ê¹?á?
+4：ppc64 是一个很好的检查交叉编译的框架，因为它往往把‘unsigned long’
+   当64位值来使用。
 
-5??????Documentation/CodingStyle?ļ???????ϸ???ö£¬¼????ã²¹??????????????
-   ʹ?ò?????????????????Υ??(scripts/checkpatch.pl)??????Ա?????ύ??
-   ??Ӧ?õ??????????㲹???е?????Υ?档
+5：按照Documentation/CodingStyle文件里的详细描述，检查你补丁的整体风格。
+   使用补丁风格检查琐碎的违规(scripts/checkpatch.pl)，审核员优先提交。
+   你应该调整遗留在你补丁中的所有违规。
 
-6???κθ??»??߸Ķ?CONFIGѡ????ܴ??????ò˵???
+6：任何更新或者改动CONFIG选项都不能打乱配置菜单。
 
-7?????е?Kconfigѡ?????¶?Ҫ??˵?????֡?
+7：所有的Kconfig选项更新都要有说明文字。
 
-8???Ѿ????????ܽ??????ص?Kconfig???Ï¡????Ǻ???ͨ?????????õ?--??Á¦???????½???
+8：已经认真地总结了相关的Kconfig组合。这是很难通过测试做好的--脑力在这里下降。
 
-9?????????м????ԡ?
+9：检查具有简洁性。
 
-10??ʹ??'make checkstack'??'make namespacecheck'???飬Ȼ???޸????ҵ??????⡣
-    ע?⣺??ջ???鲻????ȷ?س??????⣬?????κε?һ???????ڶ?ջ??ʹ?ö???512?ֽ?
-    ??Ҫ׼???޸ġ?
+10：使用'make checkstack'和'make namespacecheck'检查，然后修改所找到的问题。
+    注意：堆栈检查不会明确地出现问题，但是任何的一个函数在堆栈上使用多于512字节
+    都要准备修改。
 
-11??????kernel-doc??ȫ???ں?APIs?ļ???????Ҫ????̬?ĺ????????ǰ???Ҳ????ν????
-    ʹ??'make htmldocs'????'make mandocs'À´????kernel-doc??È»???Þ¸??κ?
-    ???Öµ????â¡£
+11：包含kernel-doc到全局内核APIs文件。（不要求静态的函数，但是包含也无所谓。）
+    使用'make htmldocs'或者'make mandocs'来检查kernel-doc，然后修改任何
+    发现的问题。
 
-12???Ѿ?ͨ??CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT,
+12：已经通过CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT,
     CONFIG_DEBUG_SLAB, CONFIG_DEBUG_PAGEALLOC, CONFIG_DEBUG_MUTEXES,
-    CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_SPINLOCK_SLEEP???ԣ?????ͬʱ??
-    ʹ?ܡ?
+    CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_SPINLOCK_SLEEP测试，并且同时都
+    使能。
 
-13???Ѿ???????????ʹ?û??߲?ʹ?? CONFIG_SMP ?? CONFIG_PREEMPT????ִ??ʱ?䡣
+13：已经都构建并且使用或者不使用 CONFIG_SMP 和 CONFIG_PREEMPT测试执行时间。
 
-14?????û²¹¶¡Ó°??IO/Disk???ȵȣ??Ѿ?ͨ??ʹ?û??ß²?ʹ?? CONFIG_LBDAF ???Ô¡?
+14：如果补丁影响IO/Disk，等等：已经通过使用或者不使用 CONFIG_LBDAF 测试。
 
-15?????е?codepaths?Ѿ???ʹ????lockdep???ù??ܡ?
+15：所有的codepaths已经行使所有lockdep启用功能。
 
-16?????е?/proc??¼???¶?Ҫ?????ļ?????Documentation/Ŀ¼?¡?
+16：所有的/proc记录更新都要作成文件放在Documentation/目录下。
 
-17?????е??Úº??ô¶¯²??????¶?????¼??Documentation/kernel-parameters.txt?ļ??С?
+17：所有的内核启动参数更新都被记录到Documentation/kernel-parameters.txt文件中。
 
-18?????е?ģ?????????¶???MODULE_PARM_DESC()??¼??
+18：所有的模块参数更新都用MODULE_PARM_DESC()记录。
 
-19?????е??û??ռ??ӿڸ??¶?????¼??Documentation/ABI/???鿴Documentation/ABI/README
-    ???Ի??ø???????Ϣ???ı??û??ռ??ӿڵIJ???Ӧ?ñ??ʼ????͸?linux-api@vger.kernel.org??
+19：所有的用户空间接口更新都被记录到Documentation/ABI/。查看Documentation/ABI/README
+    可以获得更多的信息。改变用户空间接口的补丁应该被邮件抄送给linux-api@vger.kernel.org。
 
-20?????????Dz??Ƕ?ͨ??`make headers_check'??
+20：检查它是不是都通过`make headers_check'。
 
-21???Ѿ?ͨ??????????slab??page-allocationʧ?ܼ??顣?鿴Documentation/fault-injection/??
+21：已经通过至少引入slab和page-allocation失败检查。查看Documentation/fault-injection/。
 
-22???¼?????Դ???Ѿ?ͨ??`gcc -W'??ʹ??"make EXTRA_CFLAGS=-W"?????롣???????????ܶෳ?գ?
-    ???Ƕ???Ѱ??©???????洦??????:"warning: comparison between signed and unsigned"??
+22：新加入的源码已经通过`gcc -W'（使用"make EXTRA_CFLAGS=-W"）编译。这样将产生很多烦恼，
+    但是对于寻找漏洞很有益处，例如:"warning: comparison between signed and unsigned"。
 
-23?????????ϲ???-mm?????????Ù²??Ô£???À´È·?????Ç·ñ»¹ºÍ²????????е????û²¹¶¡Ò»???????Ô¼???VM??VFS
-    ????????ϵͳ?и????仯??
+23：当它被合并到-mm补丁集后再测试，用来确定它是否还和补丁队列中的其他补丁一起工作以及在VM，VFS
+    和其他子系统中各个变化。
 
-24?????е??Ú´?????{e.g., barrier(), rmb(), wmb()}??Òª??Ô´?????е?Ò»??×¢??À´???????Ƕ??Ǹ?ʲô??
-    ?Ô¼?Ô­????
+24：所有的内存屏障{e.g., barrier(), rmb(), wmb()}需要在源代码中的一个注释来解释他们都是干什么的
+    以及原因。
 
-25?????????κ????????????ƵIJ????????ӣ?ҲҪ????Documentation/ioctl/ioctl-number.txt??
+25：如果有任何输入输出控制的补丁被添加，也要更新Documentation/ioctl/ioctl-number.txt。
 
-26?????????ĸ??Ä´????À¿?????ʹ???κε??Úº?APIs????????????kconfig?????й?ϵ?Ĺ??Ü£?????Òª
-    ʹ?????ص?kconfig???Źرգ? and/or =m??????ѡ???ṩ??[??ͬһʱ?䲻?????õĶ????ã?????????????????
-    ????????]??
+26：如果你的更改代码依靠或者使用任何的内核APIs或者与下面的kconfig符号有关系的功能，你就要
+    使用相关的kconfig符号关闭， and/or =m（如果选项提供）[在同一时间不是所用的都启用，仅仅各个或者自由
+    组合他们]：
 
     CONFIG_SMP, CONFIG_SYSFS, CONFIG_PROC_FS, CONFIG_INPUT, CONFIG_PCI,
     CONFIG_BLOCK, CONFIG_PM, CONFIG_HOTPLUG, CONFIG_MAGIC_SYSRQ,
-    CONFIG_NET, CONFIG_INET=n (??һ??ʹ?? CONFIG_NET=y)
+    CONFIG_NET, CONFIG_INET=n (后一个使用 CONFIG_NET=y)
-- 
1.7.0.4

Re: [Patch Resend]Fix the messy code file Documentation/zh_CN/SubmitChecklist

[Li Zefan]

16:36, Harry Wei wrote:
> From: Harry Wei <harryxiyou@gmail.com>
> 
> So sorry with a mistake, which i did not check my patch with
> ./checkpatch.pl. This one is all well for checkpatch.pl. It 
> can fix the messy code file Documentation/zh_CN/SubmitChecklist correctly.
> 

I'm not fond of kernel documentation translation.. but after a quick
look, I don't think the quality of this translation is satisfying..

I'm not going to review the whole doc, just a few comments below.

> Signed-off-by: Harry Wei <harryxiyou@gmail.com>
> ---
>  Documentation/zh_CN/SubmitChecklist |  118 +++++++++++++++++-----------------
>  1 files changed, 59 insertions(+), 59 deletions(-)
> 
> diff --git a/Documentation/zh_CN/SubmitChecklist b/Documentation/zh_CN/SubmitChecklist
> index 951415b..7f41713 100644
> --- a/Documentation/zh_CN/SubmitChecklist
> +++ b/Documentation/zh_CN/SubmitChecklist
> @@ -8,102 +8,102 @@ or if there is a problem with the translation.
>  
>  Chinese maintainer: Harry Wei <harryxiyou@gmail.com>
>  ---------------------------------------------------------------------
> -Documentation/SubmitChecklist ?????ķ???
> +Documentation/SubmitChecklist 的中文翻译
>  
> -?????????ۻ????±??ĵ????ݣ???ֱ??�ϵԭ?ĵ???ά???ߡ???????ʹ??Ӣ??
> -??????�?ѵĻ???Ҳ?????????İ?ά?????????????�?????²???ʱ???߷?
> -?????????⣬??�ϵ???İ?ά???ߡ?
> +如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文
> +交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻
> +译存在问题，请联系中文版维护者。
>  
> -???İ?ά???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
> -???İ淭???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
> -???İ?У???ߣ? ?????? Harry Wei <harryxiyou@gmail.com>
> +中文版维护者： 贾威威 Harry Wei <harryxiyou@gmail.com>
> +中文版翻译者： 贾威威 Harry Wei <harryxiyou@gmail.com>
> +中文版校译者： 贾威威 Harry Wei <harryxiyou@gmail.com>

I don't think you can be the reviewer as well as the translator.

>  
>  
> -????Ϊ????
> +以下为正文
>  ---------------------------------------------------------------------
> -Linux?ں??ύ?嵥
> +Linux内核提交清单
>  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>  
> -??????һЩ?ں˿?????Ӧ?????Ļ??????飬?????????뿴???Լ????ں˲????ύ
> -?????ܵĸ??졣
> +这里有一些内核开发者应该做的基本事情，如果他们想看到自己的内核补丁提交
> +被接受的更快。

You're a bit rigid in translation. I believe this should be better:

如果他们想看到自己提交的内核补丁被接受的更快。

[snip]

>  
> -15?????е?codepaths?Ѿ???ʹ????lockdep???ù??ܡ?
> +15：所有的codepaths已经行使所有lockdep启用功能。

I suspect you don't really understand the original sentence, because
the translated text isn't understandable at all.

"在打开lockdep功能的情况下，所有的代码路径都被运行过。"

>  
[snip]

Re: [Patch Resend]Fix the messy code file Documentation/zh_CN/SubmitChecklist

[Harry Wei]

On Sat, Jul 16, 2011 at 05:26:53PM +0800, Li Zefan wrote:
> 16:36, Harry Wei wrote:
> > From: Harry Wei <harryxiyou@gmail.com>
> > 
> > So sorry with a mistake, which i did not check my patch with
> > ./checkpatch.pl. This one is all well for checkpatch.pl. It 
> > can fix the messy code file Documentation/zh_CN/SubmitChecklist correctly.
> > 
> 
> I'm not fond of kernel documentation translation.. but after a quick
> look, I don't think the quality of this translation is satisfying..
This translation is a little worse, but we can proofread it again and again til well.
You can not expect anything to be perfect in the first time.

> 
> I'm not going to review the whole doc, just a few comments below.
> 
> > Signed-off-by: Harry Wei <harryxiyou@gmail.com>
> > ---
> >  Documentation/zh_CN/SubmitChecklist |  118 +++++++++++++++++-----------------
> >  1 files changed, 59 insertions(+), 59 deletions(-)
> > 
> > diff --git a/Documentation/zh_CN/SubmitChecklist b/Documentation/zh_CN/SubmitChecklist
> > index 951415b..7f41713 100644
> > --- a/Documentation/zh_CN/SubmitChecklist
> > +++ b/Documentation/zh_CN/SubmitChecklist
> > @@ -8,102 +8,102 @@ or if there is a problem with the translation.
> >  
> >  Chinese maintainer: Harry Wei <harryxiyou@gmail.com>
> >  ---------------------------------------------------------------------
> > -Documentation/SubmitChecklist ??????????
> > +Documentation/SubmitChecklist ???????????????
> >  
> > -?????????????????????????????????????????????????????????????????????
> > -???????????????????????????????????????????????????????????????????
> > -?????????????????????????????????
> > +??????????????????????????????????????????????????????????????????????????????????????????????????????
> > +??????????????????????????????????????????????????????????????????????????????????????????????????????
> > +????????????????????????????????????????????????
> >  
> > -?????????????? ?????? Harry Wei <harryxiyou@gmail.com>
> > -?????????????? ?????? Harry Wei <harryxiyou@gmail.com>
> > -?????????????? ?????? Harry Wei <harryxiyou@gmail.com>
> > +????????????????????? ????????? Harry Wei <harryxiyou@gmail.com>
> > +????????????????????? ????????? Harry Wei <harryxiyou@gmail.com>
> > +????????????????????? ????????? Harry Wei <harryxiyou@gmail.com>
> 
> I don't think you can be the reviewer as well as the translator.
I will try my best.
> 
> >  
> >  
> > -??????????
> > +???????????????
> >  ---------------------------------------------------------------------
> > -Linux????????????
> > +Linux??????????????????
> >  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> >  
> > -??????????????????????????????????????????????????????????????????????
> > -??????????????
> > +?????????????????????????????????????????????????????????????????????????????????????????????????????????
> > +?????????????????????
> 
> You're a bit rigid in translation. I believe this should be better:
True, i will change my translation to yours.
> 
> ?????????????????????????????????????????????????????????????????????
> 
> [snip]
> 
> >  
> > -15????????codepaths????????????lockdep??????????
> > +15????????????codepaths??????????????????lockdep???????????????
> 
> I suspect you don't really understand the original sentence, because
> the translated text isn't understandable at all.
Okay, i will proofread it with others who are all kernel lovers by
linux-kernel@zh-kernel.org. The translation of this document is only
translated and proofread by me so there are some improper portions.
Now i prepare to proofread it again til okay.
Thanks for your correction, i will try my best to translate
documentations correctly.

Comments?
> 
> "?????????lockdep????????????????????????????????????????????????????????????"
> 
> >  
> [snip]