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

From: Harry Wei
Date: Sat Jul 16 2011 - 04:37:26 EST


From: Harry Wei <harryxiyou@xxxxxxxxx>

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@xxxxxxxxx>
---
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@xxxxxxxxx>
---------------------------------------------------------------------
-Documentation/SubmitChecklist ?????ķ???
+Documentation/SubmitChecklist 的中文翻译

-?????????ۻ????±??ĵ????ݣ???ֱ??ϵԭ?ĵ???ά???ߡ???????ʹ??Ӣ??
-???????ѵĻ???Ҳ?????????İ?ά??????????????????²???ʱ???߷?
-?????????⣬??ϵ???İ?ά???ߡ?
+如果想评论或更新本文的内容,请直接联系原文档的维护者。如果你使用英文
+交流有困难的话,也可以向中文版维护者求助。如果本翻译更新不及时或者翻
+译存在问题,请联系中文版维护者。

-???İ?ά???ߣ? ?????? Harry Wei <harryxiyou@xxxxxxxxx>
-???İ淭???ߣ? ?????? Harry Wei <harryxiyou@xxxxxxxxx>
-???İ?У???ߣ? ?????? Harry Wei <harryxiyou@xxxxxxxxx>
+中文版维护者: 贾威威 Harry Wei <harryxiyou@xxxxxxxxx>
+中文版翻译者: 贾威威 Harry Wei <harryxiyou@xxxxxxxxx>
+中文版校译者: 贾威威 Harry Wei <harryxiyou@xxxxxxxxx>


-????Ϊ????
+以下为正文
---------------------------------------------------------------------
-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@xxxxxxxxxxxxxxx??
+19:所有的用户空间接口更新都被记录到Documentation/ABI/。查看Documentation/ABI/README
+ 可以获得更多的信息。改变用户空间接口的补丁应该被邮件抄送给linux-api@xxxxxxxxxxxxxxx。

-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

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/