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