1Chinese translated version of Documentation/SubmittingPatches 2 3If you have any comment or update to the content, please contact the 4original document maintainer directly. However, if you have a problem 5communicating in English you can also ask the Chinese maintainer for 6help. Contact the Chinese maintainer if this translation is outdated 7or if there is a problem with the translation. 8 9Chinese maintainer: TripleX Chung <triplex@zh-kernel.org> 10--------------------------------------------------------------------- 11Documentation/SubmittingPatches ��������������� 12 13������������������������������������������������������������������������������������������������������ 14������������������������������������������������������������������������������������������������������ 15������������������������������������������������ 16 17��������������������� ������ TripleX Chung <triplex@zh-kernel.org> 18��������������������� ������ TripleX Chung <triplex@zh-kernel.org> 19��������������������� ������ Li Yang <leo@zh-kernel.org> 20 ������ Wang Cong <xiyou.wangcong@gmail.com> 21 22��������������� 23--------------------------------------------------------------------- 24 25 ��������������������������������� 26 ������ 27 ��������������� Linus Torvalds ������������������ 28---------------------------------- 29 30������������������������������ Linux ������������������������������������������������������������������ 31��������������������������������������������������������������������������������������������������������� 32������������������������������ 33������ Documentation/SubmitChecklist ������������������������������������������������������ 34��������������������������������������������������������������������� 35Documentation/SubmittingDrivers ��� 36 37 38-------------------------- 39��������� - ��������������������������� 40-------------------------- 41 421) "diff -up" 43----------- 44 45������ "diff -up" ������ "diff -uprN" ������������������ 46 47��������������������������������������������������������������������� diff(1) ������������������������ 48��������������������������� "unified diff" ��������������������������������� diff(1) ��� '-u' 49��������������������������������� '-p' ���������������������������������������������C��������������� 50��������������������������������������������������������������������������������������������������������� 51��������������� 52������������������������������������������������������������������������ 53 54 SRCTREE= linux-2.6 55 MYFILE= drivers/net/mydriver.c 56 57 cd $SRCTREE 58 cp $MYFILE $MYFILE.orig 59 vi $MYFILE # make your change 60 cd .. 61 diff -up $SRCTREE/$MYFILE{.orig,} > /tmp/patch 62 63��������������������������������������������������������������������������������������������������������� 64������������������������ diff ������������ 65 66 MYSRC= /devel/linux-2.6 67 68 tar xvfz linux-2.6.12.tar.gz 69 mv linux-2.6.12 linux-2.6.12-vanilla 70 diff -uprN -X linux-2.6.12-vanilla/Documentation/dontdiff \ 71 linux-2.6.12-vanilla $MYSRC > /tmp/patch 72 73"dontdiff" ��������������������������������������������������������������������������� diff(1) 74���������������������������������"dontdiff" ������������������2.6.12������������������������������ 75������������������������������������������������������ 76<http://www.xenotime.net/linux/doc/dontdiff> ������������ 77������������������������������������������������������������������������������������������������diff(1) 78������������������������������������������������������������ 79��������������������������������������������������������������������������������������������������������� 80��������������������������������������������������������������������������������������������������������� 81������������������������������������������������������������������������������������������ 82Quilt: 83http://savannah.nongnu.org/projects/quilt 84 852)��������������������� 86������������������������������������������ 87 88��������������������������������������������������������������������������������������������������������� 89���������������������������������������bug��������������������������������������������������������������� 90������������ 91 92������������������������������������������������������������������������������������������3��������� 93��������� 94 953)������������������ 96 97������������������������������������������������������������������ 98 99���������������������������������������bug��������������������������������������������������������������� 100���������������������������������������������������������API��������������������������������������������� 101���������������API��������������������������������������������� 102 103��������������������������������������������������������������������������������������������������������� 104��������������������������������������������������������������������������������������������������� 105 106��������������������������������������������������������������������������������������������������������� 107��������������������������������������������������������������� 108 109������������������������������������������������������������������������������15������������������������ 110������������ 111 1124)������ e-mail ������������ 113 114��������� MAINTAINERS ������������������������������������������������������������������������������ 115������������������������������������������e-mail��� 116 117��������������������������������������������������������������������������������������������������������� 118��������� linux-kernel@vger.kernel.org������������������������������������������������������ 119��������������������������������� 120 121������������������������15������������ vger ��������������������� 122 123Linus Torvalds ��������������������������� Linux ��������������������������������� e-mail 124��������� <torvalds@linux-foundation.org> ��������������� e-mail ��������������������� 125��������������������������� e-mail��� 126 127������������bug������������������������������������������������������������������������������������������ 128������������CC���Linus��������������������������������������������������������������������������������� 129linux-kernel���������������������������������������������������������������������Linus��� 130 1315)������CC( e-mail ������)������ 132 133���������������������������������������CC linux-kernel@vger.kernel.org��� 134 135������ Linus ������������������������������������������������������������������������������������������ 136������������������������������������������linux-kernel ��� Linux ������������������������������ 137������������������������������������������������������������������ USB���framebuffer ������������ 138������������������SCSI ��������������������������� MAINTAINERS ��������������������������������� 139��������������������� 140 141Majordomo lists of VGER.KERNEL.ORG at: 142 <http://vger.kernel.org/vger-lists.html> 143 144������������������������������������������������������������������ MAN-PAGES ��������������������� 145MAINTAINERS ���������������������������������������man-pages��������������������������������������� 146������������������������������������������������ 147 148��������������������������������������������������������������������������������������������������������� 149������������������������������CC������������ 150 151���������������������������������CC��� Adrian Bunk ������������������������������������������ 152(Trivial Patch Monkey)trivial@kernel.org��������������������������������������������������� 153��������������������������������������������� 154 ������������������������ 155 ������������������ grep(1) ������������ 156 ������������������(���������������������������������������������) 157 ������������������������������������������������������������������������������ 158 ��������������������������������������������������� 159 ���������������������������������/������������(������ check_region���) 160 ������������������������������ 161 ������������������������������������������������������������������������������������������������������ 162 ������������������������������������ 163 ���������������������/��������������������������������������� patch monkey ��������������������� 164 165EMAIL: trivial@kernel.org 166 167(������������������������������������������������������������������������������������������������������������������ 168������������������������"trivial"������������������������������������������������������������������������������ 169���������������������������������������������������NULL������������������������������������������������������ 170���������������������������NULL��������������������������������������������������������������������������������� 171��������������������������������������������������������������������������������� 172���simple, localized & easy to verify������������������������������������������������������������ 173trivial@kernel.org������������������������������������������������������������������������������������ 174������������������������) 175 1766)������ MIME ������������������������������������������������������������������������ 177 178Linus ������������������������������������������������������������������������������������������������ 179������������������������������������������������������������ e-mail ��������������������������������� 180������������������������������������ 181 182��������������������������������������������������� e-mail ��������������������� 183������������������������������-��������������������������������������������������������������������������� 184��������� 185 186��������������������� MIME ������������������������������������������������������ e-mail ��������� 187��������������������� MIME ��������������������������������������������������������������������������� 188������������������������������MIME ��������������������� Linus ������������������������������������ 189��������������������������������������������� 190 191������������������������������������ Mozilla ������������������������������������������ 192---- ��������� ---- 193Content-Type: text/plain; charset=us-ascii; format=flowed 194---- ��������� ---- 195������������ ���format=flowed��� ������������������������������������������������������������������ 196��������������������������������������������������������������������������������������������������������� 197��������� 198 199������������������������������������������ mozilla ��� defaults/pref/mailnews.js ������ 200������ 201pref("mailnews.send_plaintext_flowed", false); // RFC 2646======= 202��������� 203pref("mailnews.display.disable_format_flowed_support", true); 204��������������� 205 2067) e-mail ��������� 207 208��� Linus ���������������������������������������6������������������ 209 210��������������������������������������������������������������������������������������������������������� 211������������������������40kB������������������������������������������������ internet ������������ 212������������������������������������������ URL ��������� 213 2148) ������������������������ 215 216��������������������������������������������������������������������������������������������� 217 218���������������������������������������������������������������Linus ������������������������ 219 2209) ������������������������������ 221 222������������������������������������������������������ Linus ������������������������������������������ 223������������������������������������������������ 224 225��������������������������������������������������������������������������������������������������������� 226������������������������������������������������������������������������������������ 227 228Linus��������������������������������������������������������������������������������������������������� 229��������������������������������������������������������������������������� 230* ��������������������������������������������������������������� 231* ��������������� linux-kernel ��������������������������������������������� 232* ������������������������2��������� 233* ������������������������������������ 234* ������������������������������ 235* ��������������������� e-mail������������������������������������ 236* ������������������ 237 238������������������������ linux-kernel ������������������������������ 239 24010) ������������������ PATCH ��������� 241 242Linus ��� linux-kernel ��������������� e-mail ��������������������������������������������� 243��������� [PATCH] ������������������������ Linus ������������������������������������ e-mail 244������������������������������������������������ 245 24611������������������������ 247 248��������������������������������������������������������������������������������������������������������� 249������������������������������������������ ���sign-off��� ������������ 250 251"sign-off" ������������������������������������������������������������������������������������������ 252��������������������������������������������������������������������������������������������������������� 253��� 254 ��������������������� 1.1 255 ��������������������������������������������������� 256 ���a������������������������������������������������������������������������������������ 257 ��������������������������������������������� 258 ���b��������������������������������������������������������������������������������������������� 259 ������������������������������������������������������������������������������������������ 260 ������������������������������������������������������������������������������������������������ 261 ��������������������������������������������������������������������������������� 262 ���c���������������������������a���������b������������c��������������������������������� 263 ������������������������ 264 ���d������������������������������������������������������������������������������������ 265 ������������������������������������ sign-off ��������������������������������������������� 266 ������������������������������������������������������ 267 ��������������������������� 268 Signed-off-by: Random J Developer <random@developer.example.org> 269 270������������������������������������������������������������������ 271 272��������������������������������������������������������������������������������������������������������� 273������������������������������������������ sign-off ������������������������ 274 27512��������������������� 276 277��������������������������������� 278 Subject: [PATCH 001/123] ���������:��������������� 279 280������������������������������������������ 281 282 - ������ "from" ������������������������ 283 284 - ������������ 285 286 - ��������������������������������������������������������������������������������������������� 287 288 - ���������"---"������������������ 289 290 - ��������������������������������������������������� 291 292 - ���������������diff ��������� 293 294������������������������������������������������������������������������ - ������ e-mail ������������ 295������������ - ������������������������������������������������������������������������������������������ 296 297e-mail ������������������������������������������������������������������������ 298 299e-mail ������������������������������������������������ e-mail ������������������������������������ 300��������������������������������������������������������������������������������������������������������� 301������������������������������������������������������������������������ 302 303������ e-mail ��������������������������������������������������������������������������������� git 304��������������������������������������������������������������������������������������������������������� 305��������������������������� google ���������"���������������"��������������������������������������� 306������ 307 308������������������������ 309 310 Subject: [patch 2/5] ext2: improve scalability of bitmap searching 311 Subject: [PATCHv2 001/207] x86: fix eflags tracking 312 313"from" ��������������������������������������������������������� 314 From: Original Author <author@example.com> 315 316"from" ��������������������������������������������������������������������������� "from" ��������� 317������������������ "From: " ������������������������������������������������ 318 319��������������������������������������������������������������������������������������������������������� 320��������������������������������������������������������������������������������� 321 322"---" ������������������������������������������������������������������������������������������������ 323������ 324 325������ "---" ��������������������������������������������������������������� diffstat������������ 326������������������������������������������������������������������������diffstat ��������������������� 327��������������������������������������������������������������������������������������������������������� 328��������������������������������������� 329������ diffstat��������� "-p 1 -w 70" ��������������������������������������������������������� 330������������������������������������������������80��������������������������������������������� 331 332��������������������������������������������������������������������������� 333 334------------------------------- 335��������� ������������������������ 336------------------------------- 337 338���������������������������������������������������������������"������"������������������������...������ 339������������������������������������������������������������������Linus������������������������������ 340 3411) ��� Document/CodingStyle 342 343Nuff ��������������������������������������������������������������������������������������������������� 344��������������������������������� 345 3462) #ifdef ������������ 347��������� ifdef ������������������������������������������������������������������������ ifdef ��� 348������������������������������������ "static inline" ��������������������������������������������� 349���������������������������"���������"������������ 350 351������������������������������������������ 352 353 dev = alloc_etherdev (sizeof(struct funky_private)); 354 if (!dev) 355 return -ENODEV; 356 #ifdef CONFIG_NET_FUNKINESS 357 init_funky_net(dev); 358 #endif 359 360������������������: 361 362(������������) 363 #ifndef CONFIG_NET_FUNKINESS 364 static inline void init_funky_net (struct net_device *d) {} 365 #endif 366 367(���������������) 368 dev = alloc_etherdev (sizeof(struct funky_private)); 369 if (!dev) 370 return -ENODEV; 371 init_funky_net(dev); 372 3733) 'static inline' ��������� 374 375Static inline ������������������������������������������������Static inline ��������������� 376������������������������������������������������������������ gcc ��������������������������� 377 378��������� static inline ���������������������������[��� fast paths ������������������������ 379������]��������������������� static inline ���������������[���������������������]��� 380��������� 'static inline' ��������� 'static __inline__', 'extern inline' ��� 381'extern __inline__' ��� 382 3834) ������������������ 384 385������������������������������������������������������������������������������������"��������������������� 386���������������������������"��� 387 388---------------- 389��������� ������������ 390---------------- 391 392Andrew Morton, "The perfect patch" (tpp). 393 <http://www.ozlabs.org/~akpm/stuff/tpp.txt> 394 395Jeff Garzik, "Linux kernel patch submission format". 396 <http://linux.yyz.us/patch-format.html> 397 398Greg Kroah-Hartman, "How to piss off a kernel subsystem maintainer". 399 <http://www.kroah.com/log/2005/03/31/> 400 <http://www.kroah.com/log/2005/07/08/> 401 <http://www.kroah.com/log/2005/10/19/> 402 <http://www.kroah.com/log/2006/01/11/> 403 404NO!!!! No more huge patch bombs to linux-kernel@vger.kernel.org people! 405 <https://lkml.org/lkml/2005/7/11/336> 406 407Kernel Documentation/CodingStyle: 408 <http://sosdg.org/~coywolf/lxr/source/Documentation/CodingStyle> 409 410Linus Torvalds's mail on the canonical patch format: 411 <http://lkml.org/lkml/2005/4/7/183> 412-- 413