[PATCH 38/42] docs/zh_CN: update to latest submitting-patches.rst
From: Alex Shi
Date: Wed Mar 27 2019 - 09:03:55 EST
Updated huge changes for this docs. Seems we forget this for decades.
And use local stub to pointer this Chinese docs.
Signed-off-by: Alex Shi <alex.shi@xxxxxxxxxxxxxxxxx>
Cc: Harry Wei <harryxiyou@xxxxxxxxx>
Cc: Jonathan Corbet <corbet@xxxxxxx>
Cc: Tom Levy <tomlevy93@xxxxxxxxx>
Cc: linux-doc@xxxxxxxxxxxxxxx
Cc: linux-kernel@xxxxxxxxxxxxxxx
---
.../zh_CN/process/submitting-patches.rst | 614 ++++++++++++------
1 file changed, 431 insertions(+), 183 deletions(-)
diff --git a/Documentation/translations/zh_CN/process/submitting-patches.rst b/Documentation/translations/zh_CN/process/submitting-patches.rst
index 1bd64832b424..5fa716584598 100644
--- a/Documentation/translations/zh_CN/process/submitting-patches.rst
+++ b/Documentation/translations/zh_CN/process/submitting-patches.rst
@@ -1,4 +1,4 @@
-.. _cn_process_submittingpatches:
+.. _cn_submittingpatches:
.. include:: ../disclaimer-zh_CN.rst
@@ -19,15 +19,34 @@
åäæèåæåæäå Linux åæçääæèååæèïåæäçæâèçâï
æäçæçäèäçæãææææéääçååèïèäåèåäååçæéä
-çæåèæåçæäã
-éè Documentation/process/submit-checklist.rst æèååæääçåéèææçéççå
-èãåæäåæäääéåçåïéäåæéèää
-Documentation/process/submitting-drivers.rst ã
+çæåèæåçæä.
+ääææåæåéçæçåèï åäèèï
+:ref:`Documentation/process <development_process_main>`
+åæï:ref:`Documentation/process/submit-checklist.rst <submitchecklist>`
+çååæääçåéèææçéççåèãåæäåæäääéåçåïéä
+åæéèää:
+:ref:`Documentation/process/submitting-drivers.rst <submittingdrivers>`
----------------------------
-çäè - ååååéäçæå
----------------------------
+åäèåæéæèäGitçææåçççéèèäïåææäçGitæååèäï
+æååçåäæåæçåéåææåäïåçæäçéèåååèåäçåçç
+èäãäèæèïäçgitåäæääåæååäåççææèæã
+
+
+0) èåååæçæ
+-----------------
+
+åææææääåääçåååææäççåååïèäçgitèåääãæåè
+ääçåååååïååäéèääæåèå::
+
+ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
+
+äæïèææïæåèäåæçæéåäçæèèååãååæåçççæäåè
+èèåçæïååæçåéåèäæååçèäãèåèMAINTAINERSæääåç
+çç **T:** éäææèæïæèçååèéçæèèææåæååäååã
+
+äçåäéètarballsäèåæçæïåääèæèïïäèæèèåæååç
+äçåéçæåã
1) "diff -up"
-------------
@@ -39,9 +58,10 @@ Documentation/process/submitting-drivers.rst ã
åæçæãèäïèäç '-p' åæïéæäæçæäæåæåçCåæïäå
äççèäåæèååãèäåèåäåææäçæçæçåïèäæéèçä
äåçåã
+
äääåççæäååèäïäèæèèæåååä::
- SRCTREE=linux-2.6
+ SRCTREE=linux
MYFILE=drivers/net/mydriver.c
cd $SRCTREE
@@ -53,38 +73,103 @@ Documentation/process/submitting-drivers.rst ã
äåäæäååèäïäåäèåääææäæèçåææäçæïçååäè
åçäçæäéå diff ãäå::
- MYSRC=/devel/linux-2.6
+ MYSRC=/devel/linux
- tar xvfz linux-2.6.12.tar.gz
- mv linux-2.6.12 linux-2.6.12-vanilla
- diff -uprN -X linux-2.6.12-vanilla/Documentation/dontdiff \
- linux-2.6.12-vanilla $MYSRC > /tmp/patch
+ tar xvfz linux-3.19.tar.gz
+ mv linux-3.19 linux-3.19-vanilla
+ diff -uprN -X linux-3.19-vanilla/Documentation/dontdiff \
+ linux-3.19-vanilla $MYSRC > /tmp/patch
"dontdiff" æåæåçèçæåäççæäçåèïåèäçæäå diff(1)
-äççèäéäèèèã"dontdiff" æäèååå2.6.12åäåçæçåææä
-çæäãåäææçåæçæïäåää
-<http://www.xenotime.net/linux/doc/dontdiff> èååã
+äççèäéäèèèã
+
çåäçèäéææååäääåäèæèäæäçéåæäãèååçdiff(1)
çæèääåïåéäæèäïäçäåçã
+
åæäçæååæäïäåèççääåäåèäååæçççéåïåæåå
åæäçååäéèçæéãèææåæèåäåæååèåæïåæäæäç
-èäèæåïèæåéèçãäéèäèæèåååäåèääæï
-Quilt:
-http://savannah.nongnu.org/projects/quilt
+èäèæåïèæåéèçãèåéï
+:ref:`cn_split_changes`
+
+åæäç ``git`` , ``git rebase -i`` åäååäèäçãåæääç ``git``,
+``quilt`` <http://savannah.nongnu.org/projects/quilt> ååääæèçéæã
+
+.. _cn_describe_changes:
+
+2) æèäçæå
+---------------
+
+æèäçééãæèæçèäæäèéèäåèæ5000èæåèïéåéæääæå
+çééæåæåæèéåäãèåçäçäæääééååèåïèääèåçäæ
+æææäçã
+
+æèçæåèçååãçæåæåéåæçåæèæåçïäåäæææçéèééä
+æçåèãåäåäçåææéåçäèäééïäèæèääæèäååèåçæä
+ççååãèèäïååæLinuxåèèèçåææèäççåææçåääåå/äå
+çæïåääæçéçåçèäïåæèååääåäååæåææåäåäæçååï
+èåçåæãDMESGçæåãåææèãæèååãåèååãéåçã
+
+éåäååæèãåææåçåæèãååæèãåæåççéæäèåååæéææ
+æèïèåæææåäçæåãääèæèäææçææãäåéåäæåèçïèæ
+åCPUãååååèæäéèèæèïæèïæçæçåäïåäåçåäèèäéè
+èæèãèæèäåçéæççïääåéèåäæèææåæçã
+
+äæééåçèæïåèèçåæèääæåéååääãåäåéèæèïççåç
+èèæèäççååæåéèçïäéèäççèäæåçåæçææã
+
+åææåèäæèååääèåäïèäèååäååæåääâæäæåâæåLinux
+çæäçççççgitäïéäçæäååéåæèæãè :ref:`cn_explicit_in_reply_to`.
+
+æäèäåèåääééãåæäçæèåååéïèåèæäåèéèæåäçèäã
+èè :ref:`cn_split_changes`
+
+æäæéææääèçåæäèçåçåæïèåæåæçäèçåèæåççãäè
+åèèæèäïçåïççåçãäèææåçççæäååçææçèäçææåç
+URLæææèäæèåååæåèääãäåæèïèäïçåïååæèåèæçççã
+èåçæäåååæäåéæååãääèåèåèçèæææåèäçææçæã
+
+æèäååäèæäçååïäåâmake xyzzy do frotzâèäæâ[èäèä]make
+xyzzy do frotzâæâ[æ]changed xyzzy to do frotzâïåååäååääçåæå
+åçèääæã
+
+åæäèçåäåäääèåçbugæçïèæçååURLåçèbugæçãåæèäæ
+èéäåèèèïèçåéäåèåæçURLïäçåæ ``Message-ID`` ç
+https://lkml.kernel.org/ éååïäçäéæääèæã
+
+äæïåææåéèæçæåäïåéèäçèéåçèãéäæäéäåèåææ
+bugçURLäåïèèæçéèæäèäççåèèèçã
+
+åæææèåçääçåçæäïäèååçæäç SHA-1 IDãèèåææäçäè
+æèïäääåéèäèåæåäääçãäå::
+
+ Commit e21d2170f36602ae2708 ("video: remove unnecessary
+ platform_set_drvdata()") removed the unnecessary
+ platform_set_drvdata(), but left the variable "dev" unused,
+ delete it.
+
+æèåèçäèåäçå12ä SHA-1 ID. åæååååå*èå*åèïääèççID
+åçåççåèæååãèäïåäçåäääæçåäåçIDåçåçïèçæå
+åèäååæåã
+
+åæäèçåäåäçåæääçéèïäåïäç ``git bisct`` ïèäçåæå
+12äåçSHA-1 ID ç"Fixes:"æèååèæèãääçåäèåæèæåäåäï
+èãæèäååæèæâ75åæèâèåçéåãäå::
-2)æèäçæåã
-æèäçæåååçææçèã
+ Fixes: 54a4f0239f2e ("KVM: MMU: make kvm_mmu_zap_page() return the number of pages it actually freed")
-èååäååååäãæçççæèåèæåäéèäèåïâææäæéåç
-åâïâäæäæéåçåçbugâïæèâèäèäååäæåçççäæïè
-äçãâ
+äå ``git config`` èçåäæåè ``git log``, ``git show`` æäçæçæå::
-åæäçæèåååéïèèçääèéèæåäçèääïèçç3åèï
-ççã
+ [core]
+ abbrev = 12
+ [pretty]
+ fixes = Fixes: %h (\"%s\")
-3)æåäçæå
+.. _cn_split_changes:
-åæåæåïéèçäçæååääèäæäéã
+3) æåäçæå
+---------------
+
+åæäéèææåéæääåççèäã
äåïåæäçæåéåææbugäæåæèäåïéäæèäæåæååääæ
èæåçèäæääãåæäçæååååAPIçäæïåääæäéåçåæé
@@ -96,64 +181,94 @@ http://savannah.nongnu.org/projects/quilt
åææääèääèååääèäæåæåçæåïéæééãçåçåäçè
äæèéæåâèäèääèæèäâååäã
+ååæçææååääçåèäæïèçåææçäåæåçåäçæäèääå
+éèæåæååèèãäç ``git bisect`` æèèééçååèåèäåääæ
+åååäçèäçåïåæäåäéååéèïääääæèäã
+
åæääèåèäæçææåçæäïéäææåçåéå15äïçåçååæ
-åæåã
+åéæã
+
+4) ææäçææéæ
+-------------------
+
+æææçèäæååååææååçïèçäæåå
+:ref:`Documentation/process/coding-style.rst <codingstyle>`
+äæåãåæäèæåïåäæèåçäçæéïåääåèäçèäèæçïçè
+åèææèéèã
+
+ääéèçäåæååäçäääæäçåååääæäæââåèçæåäïæäå
+èåçåäççåääèäääæçåçäçãèææåæèäçåäçåæçææ
+çèäãèååæåäåæåéååïååèååæååèèäçæèçååã
+
+åæääåïäçèäæåææçåææèäïscripts/check patch.plïãäèï
+èææïæåææçååèèèäääæåïèäæäääçåæçæäåãåææ
+çäççèææåïäæèèèäïéäæåäèäçåã
+
+ææèæåääçåï
-4)éæ e-mail çæää
+ - ERRORïååèåéçäæ
+ - WARNINGïéèäçåæçäé
+ - CHECKïéèæèçäæ
-çäé MAINTAINERS æäåæäçïççäæçæåæåçåæåççææææ
-åççæèãåææïçääåe-mailã
+æåèèååææçèääååçææèèèäã
-åææææåçæèïæèçæèææåéïåäçèäåéååæååèäé
-äåè linux-kernel@xxxxxxxxxxxxxxxãåéåçåæååèéèèèäéäå
-èïåäèääçæåã
+5) éæèäæää
+-----------------
-ææäèåéèè15äèäå vger éäåèïïï
+æåèææåääèääååçåçåçççæäåïäèåääçæçäçïæç
+çæäåæäåæäçäèååèåïääèèäçæäåæèãèæ
+scripts/get_Maintainer.plåèäæéäéåæçãåæææäåæååäçåçç
+ççæäåïéäAndrew Mortonïakpm@xxxxxxxxxxxxxxxxxxxxïåååæåççæ
+äåã
+
+æéåèåèéæèåääéäåèæææèäéçãlinux-kernel@xxxxxxxxxxxxxxx
+ääæåääèååæçåèïäæèäåèäçäçåçåèäèåååäåçæçã
+åMAINTAINERSæääææåçççåçåèïæçèäåèäåééååæåçåæã
+äèïèäèåéååéäåæåçåèã
+
+èåäåæçåçåèæçåvger.kernel.orgäïæåäå
+http://vger.kernel.org/vger-lists.html äæååäçåèãäèïäæäåæçå
+çåèæçååäåæã
+
+äèäæåéèè15äèäåvgeréäåèïïïï
Linus Torvalds æååæåèåèå Linux åæçæçèåèãäç e-mail
ååæ <torvalds@xxxxxxxxxxxxxxxxxxxx> ãäæåç e-mail ååïæääè
çèïæååçäå e-mailã
-éääæbugïâæèæèâçäææèæçäçåéèååèèçèäåäçæ
-åéæèCCçLinusãéäéèèèæèææåææçååçèäïäèååéå
-linux-kerneléäåèãåæåèäèèèååäåäïææäçLinusã
+åæææäåååçååææçèäïèåèèäåéå security@xxxxxxxxxxãåä
+äéçbugïåäèèçææåäåèåéååçæååèäïåèçæåäïæçäå
+åèäåéåääåååèã
-5)éæCC( e-mail æé)åè
+äåååååæääééèçèäçååèæåçåççæäåïææææèæçäè::
-ééäæççäèæåïååCC linux-kernel@xxxxxxxxxxxxxxxã
+ Cc: stable@xxxxxxxxxxxxxxx
-éä Linus äåïåäåæååèäéèææåäçæåïèæääæèèèä
-çæååæääçåæååèãlinux-kernel æ Linux åæååèäéäåè
-ãååçéäåèäçåçåççæäæåïæå USBïframebuffer èåïè
-ææäççïSCSI åççïççãæç MAINTAINERS æäæèååäçæåæ
-åçéäåèã
+èåèäççååïææïäæçåéäæääïãéäèäæääåïæèåèéè
+:ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>`
-Majordomo lists of VGER.KERNEL.ORG at:
- <http://vger.kernel.org/vger-lists.html>
+äæïèææïääåçççæäååæååääèåççèïååäèäåèèæå
+çåçæäãååæçççæäåïäåæçååäååäååèääæååäéèæ
+çèã
-åææåååäçæçéååæäéçæåïèç MAN-PAGES ççæèïåå
-MAINTAINERS æäéçïåéääæåéïman-pagesïèäïæèèåéçääæ
-åïèäääææéåèåæåéã
+åæææåååçæååææåïèåæåéçæäåïåçæäåæääæåïåé
+æåéèäïæèååéææéçïäääääæèåæåéãèååçæçéAPI
+ææååå linux-api@xxxxxxxxxxxxxxxã
-åäåçåæçæåïçæèææäåååïäèçèåäæääçäççæå
-ïäçåçæèæèåCCåèäã
+åäåçèäïääèäCCåæéççèäçéäåè(Trivial Patch Monkey)
+trivial@xxxxxxxxxxïééäéæéçççèäãäéèæçèääèçäâçççâ
+èäï
-åäåçèäïääèäCCå Adrian Bunk çççæéççèäçéäåè
-(Trivial Patch Monkey)trivial@xxxxxxxxxxïééäéæéçççèäãäéèæ
-çèääèçäâçççâèäï
-
- ææçæåäæã
- äæäååå grep(1) çæåã
- èåäæäæ(éççæåæççèåæäåçã)
- çèéèäæïäçéèççæåçïåæçèæééãï
- èèæäæïåèççäæäéèãï
- çéäçäèååçåæ/åçäç(äå check_regionã)
- èçæååææäæã
- çåçæçäçææäåçæçäçïåäåäççæçåçäçäïæçæ
- äæèïåèåæçççï
- ääæäçäè/çæèåèæäçæåïäå patch monkey åéäæåäï
-
-EMAIL: trivial@xxxxxxxxxx
+ - ææçæåäæã
+ - äæäååå grep(1) çæåã
+ - èåäæäæ(éççæåæççèåæäåçã)
+ - çèéèäæïäçéèççæåçïåæçèæééãï
+ - èèæäæïåèççäæäéèãï
+ - çéäçäèååçåæ/åçäç(äå check_regionã)
+ - èçæååææäæã
+ - çåçæçäçææäåçæçäçïåäåäççæçåçäçäïæçæ
+ - äæèïåèåæçççï
+ - ääæäçäè/çæèåèæäçæåïäå patch monkey åéäæåäï
(èæïåäâççèäâçääèæïåäåæçèäéåååæèçåïæääåä
èäåääèæã"trivial"èäèæåèçæææâçççïäéèçãâäæåèé
@@ -164,100 +279,92 @@ EMAIL: trivial@xxxxxxxxxx
trivial@xxxxxxxxxxéäåèçççæéåèæçèäïäæäèæääääåïæ
éäæäçéæã)
-6)ææ MIME ççïææéæïææåçïææéäïåæçææã
+6) ææ MIME ççïææéæïææåçïææéäïåæçææ
+-----------------------------------------------------------
Linus ååäçåæååèéèéèåèèäæäçæåãåäåæååèæè
ïåäâåçâäçæååéèïäçäèç e-mail ååïääååäåäç
äççäääçæåèèã
åäèäååïææçæäçèäéæ e-mail äâååâçã
-èåïåæääçåå-çèäçèäïååäççèåçèåæèåèçåäç
-èäã
+
+.. warning::
+ åæääçåå-çèäçèäïååäççèåçèåæèåèçåäçèä
äèåèäää MIME çççéäïäçæååçãååæèç e-mail èää
æääæåéå MIME çççéäåäçææåéçïèääååäææåäç
äçäåèèãååïMIME çççéääè Linus åèäçæéæåçïèå
éäääçæåèæåçåèæã
-èåïääéäèäïæå Mozilla äåäçäæäåäæååéï
----- éäå ----
-Content-Type: text/plain; charset=us-ascii; format=flowed
----- éäå ----
-ééåä âformat=flowedâ äèææççæäéäèäåéääçåèçææ
-æçæäååääçäçææãèæïäåéçæåçèææééçèäåèç
-åäã
-
-èäæèäééïåéèåäç mozilla ç defaults/pref/mailnews.js æä
-éç
-pref("mailnews.send_plaintext_flowed", false); // RFC 2646=======
-äææ
-pref("mailnews.display.disable_format_flowed_support", true);
-ååääã
+äåïåæäçééåååäèäïéäæäåèäèæääçmimeéæåéèä
-7) e-mail çåå
+èåé :ref:`Documentation/process/e-mail-clients.rst <email_clients>`
+äèåæåéççåéäåæçääåäåååååéäèçåçæçã
-ç Linus åéèäçæåïæèæçç6åèèçåã
+7) e-mail çåå
+----------------
åçæååéäåèäåéïåæäçæèääåéãåæäçèäïåäåç
-çæåäïèèä40kBïéääæååèäæåääèéè internet èéçæ
-ååäïçåçæåäçèäç URL æäã
+çæåäïèèä300kBïéääæååèäæåääèéè internet èéçæ
+ååäïçåçæåäçèäç URL æäãäæèææïåææçèäèèä
+300kbïéäååäèåéèèçåã
-8) æåäçåæçæ
+8ïååèåæè
+---------------
-åæéååèäçæèäïæåèäååçåæççæïæåéèçã
+äçèäåäèåäååèåèåèäæèææçèèãæåéåèäèèäå
+ååïèèäèåççääååæåæåçåéèçæèãääåèäçææç
+æèæééåäèåäåææéæåææåçæåïäääääèåèæååäè
+æååççäæã
-åæèääèååçåææçæçåæäæäïLinus æääæååçã
+äåèåèåçääååääæåïåæèääçæéãäçåææääçää
+èæçèçïåæäåææäååæèãåäåèçæåäïäèçèåååå
+èåääæåçééã
-9) äèæéïççæäã
+9ïäèæææäèç
+-------------------
-åäæääæåäåïèååçåãåæ Linus åæäçæååäåæåïéä
-åååäääåæååçæäåçã
+æäææåïèèåçåãåéèæåççäïåèææçåèéæçäèçåã
-çèïåæäçæåææåçåäääçæçåæäïåèæèåååãååé
-äååïäæéèïéææäææåçæåïæäèåçåäã
+æåäæïèäæåææèèçæåäæååççäïäååèçæçåæåéåã
+æåèåäåååçæéåæåèèïåææææåèèïèçäæååèäåé
+åæççäçãåéææäæèçåéèäåèåçåäå-åèåååçåäçç
+çåæéåèæéã
-Linusäçåääèèåâäåâäçèäæåèçäæãåççäèæçäæå
-ååãåæäæææåäçèäïäèæçäääååï
-* äçèääèåææçæçåæäååçæäã
-* äçèäå linux-kernel éäåèäææååååçèèã
-* éæééïåçç2åèï
-* éäæåééïéèæèï
-* äçæåæææééã
-* äæåäæåç e-mailïèäçåæäääåäã
-* äèääéã
+10ïäéäåå PATCH
+--------------------
-æçéçæåïå linux-kernel éäåèäèæèèã
+çäålinusålinuxåæççåéäæéåéïéåäåäéèåéåä[PATCH]
+åç. èäLinusååäåæååäåæåæåèääåäçåéäèèåååã
-10) åæéäåä PATCH çåæ
-
-Linus å linux-kernel éäåèç e-mail æééåéïääéåççåææ
-éèä [PATCH] ååãèæåäè Linus ååäåæååäååää e-mail
-çèèäåèæçåèäåèåæã
-
-11ïääçåäçå
+11ïççäçäå-ååèååèè
+-------------------------------
ääåååèåäääçèèïååæåéäéèåååççæèçèäïæä
åèååéååçèääåää âsign-offâ çèçã
"sign-off" æåèäçæéçæåççåçäèæåïèèäçåäåæèåä
-äææåååääåææäççèääéãèååçåïåæäèèèåääæ
-ï
+äææåååääåææäççèääéãèååçåïåæäèèèåääæ:
+
ååèææèä 1.1
^^^^^^^^^^^^^^^^^^
+
åäæéççèçïæèèåääæï
ïaïèäèçæååæèéåççæååïæææåäæääæå
- çåææäçèåèæäåïæè
+ çåææäçèåèæäåïæè
ïbïèäèçåääåçåäïæææçïèääåçåäåæåçåæ
- æäçèåèäæïèäïææèåèïææææääæåçèçï
- æèæååèæéåçæåéïèäèçéäçåääåææäçèåè
- ïééæèåèçååçèåèïïæåæääæåçïæè
+ æäçèåèäæïèäïææèåèïææææääæåçèçï
+ æèæååèæéåçæåéïèäèçéäçåääåææäçèåè
+ ïééæèåèçååçèåèïïæåæääæåçïæè
ïcïèäèççèèïaïïïbïæèïcïçäçææäçæïè
- äæææäæåã
+ äæææäæåã
ïdïæçèååæèäéçåèçæååçïèççèåïåææ
- äèæäçääèåïåæ sign-off ïèæäçæåäåäåèäéç
- æèåææäççèåèåæåååèã
- éäååèæäèï
+ äèæäçääèåïåæ sign-off ïèæäçæåäåäåèäéç
+ æèåææäççèåèåæåååèã
+
+éäååèæäè::
+
Signed-off-by: Random J Developer <random@xxxxxxxxxxxxxxxxxxxxx>
äçäççåïææïäèäçååæèååãï
@@ -265,24 +372,141 @@ Linus å linux-kernel éäåèç e-mail æééåéïääéåç
æäåæååäæçãçåèääèäèåçïäæäåäèæåïææèåå
åéçèçïæèåææååä sign-off çääçæçèã
+åæææåççæåæçæäåïææéèçåäææåçèäïääåååäï
+åäæåæäèäçäçäååçåãåæääæéåèåïcïïäåèèææäè
+éæååïäèååæåæèæéåçåãèåïbïåèæèæäçïäæææää
+æäèçäçåèäèåæçéèæéåäçèçãèèåæééïåèåæåää
+ççåèåæçèäéæåäèïæçææçæèãèçèåäæååæçïäää
+åæèååäæçéäå/æååïåéçææåæèæïïèèäèäææåæåæ
+åäåéçææèæèäãäå::
+
+ Signed-off-by: Random J Developer <random@xxxxxxxxxxxxxxxxxxxxx>
+ [lucky@xxxxxxxxxxxxxxxxxxxxxx: struct foo moved from foo.c to foo.h]
+ Signed-off-by: Lucky K Maintainer <lucky@xxxxxxxxxxxxxxxxxxxxxx>
+
+åææçæääçåçåæææïåæåæåäèèèèèãèèææãååäåå
+äææäèäåæèïéäèçåæååæçãèææïåääæåäéäèææäè
+çIDïFrom åïïåäåæåçåæææåäçæèã
+
+åååïback-portersïççåèæïåæäææçééïäéèäåïæåääèä
+çèææçääæäçåèäæççåèïäääèèãäåïäéææäå3.xçå
+çæäçåçåå::
+
+ Date: Tue Oct 7 07:26:38 2014 -0400
+
+ libata: Un-break ATA blacklist
+
+ commit 1c40279960bcd7d52dbdf1d466b20d24b99176c8 upstream.
+
+èæï èéæääæçåæäçääååèä::
+
+ Date: Tue May 13 22:12:27 2008 +0200
+
+ wireless, airo: waitbusy() won't delay
+
+ [backport of 2.6 commit b7acbdfbd1f277c1eb23f344f899cfa4cd0bf36a]
+
+12ïäæäçAcked-by:ïCC:ïåCo-Developed by:
+----------------------------------------------
+
+Singed-off-by: æèèççåèåääèäçååïæèä/ååèäçäéèåäã
+
+åæäääææçæåäèäçååæåçïäåæèçåèåääåèäçæåï
+éäääåäèæåèäçåææåäæåää Acked-by:
+
+Acked-byïéåçåååäçççæèäçïåèçæèæææèçäææèåèäæã
+
+Acked-by: äåçåäéææåãèæääèåïçèäèååæäèäïåèçæåã
+åæïèäååææäæååAckerçâYepïlooks good to meâèæä Acked-Byïïä
+èææïéåæåèæääæççAckïã
+
+Acked-byïääåèçåæäèäççèãäåïåæääèäåååäåççïåä
+æääïæèääåçççæèïéäèéåèçåçèååçæèäççéåãèé
+åèäçåæãåæçéïååèéäåèææäçååèèã
+
+åææäææäåèäèèèèïäæææäæçèèïæåäéæåèääæå ``Cc:``
+èæåäääæçïååäåææèåååçäæåæäçæåäæåïäååèèæ
+èääæåèääæéçãèèäååäæååççåæã
+
+Co-developed-by: åæèääæçåääååäååååäèäèååçãååää
+åääèääåäæïèåæçãææïæääéèåèääæää Signed-off-by:
+
+13ïäçæåäïãæèäïãåæäïãåèäïãäåäï
+--------------------------------------------------------
+
+Reported-by: çéäåçéèåæåéèçäèèïååææåääååæåæåå
+æäãèææïåæbugæäçææåæåçïéäåäçReported-byæèäåïè
+åèææéã
+
+Tested-by: æèèçèäåçæåçäïåæäçåäïæåæèãèäæçéç
+çæäååçæèäääæèïäåæçèäæäääçåäæèäåçææïåç
+äæèäåçäèã
+
+Reviewed-byïçåïææåæäçåæïèæèèäåèåæåèèäæåæåçï
+
+
+åæäçççåæ
+^^^^^^^^^^^^^^^^
+
+éèæäæç Reviewed-byïæåæï
+
+ (a) æåçåèäèäèèääæææåæïäèäåæåéåèååå
+ äçåæäã
+
+ (b) äèäçåçääééãéèæéééååéçæäèãæåæäèå
+ æçèèçååæåææã
+
+ (c) èçèäæäåèäæèäääèïäæçäïææïï1ïååæ
+ èèäæäåçäæïï2ïææååäèäæåçåçééã
+
+ (d) èçæåçåæäèäåèäåæååçïäæääïééåææç
+ èæïäåäääèæäèåååääçåæåäåçåèåççç
+ ææåèèã
+
+Reviewed-by æäçèçåæïåèäæååæçéåäæïææääéççäéææ
+ééãääæåèçåéèïåæåäçäïéåääääèäæäää Review-by
+æçãææççäååéèæäèèïåéççæèååäèçåäåæçåéçåã
+Reviewed-by: åçåçäèäéåååæèååææçåéèæäæïéåäåå
+èäèååæçåèæã
+
+Suggested-by: èçèäçæææçæåçäæåçïåçäåæææååäæåç
+äãèææïæçèåïäåæåææçïçåæåæèæææåååèåäååã
+èåæèïåææäåååèèæäçåæèïääåæåæåææååéèïåæ
+ååæäã
+
+Fixes: æçèäåäåçæäääåäääééãååäååæåçåéèçææï
+èæåäææéèäåãèäæèèååçååæåéçååèææäåççååæ
+çæãèææçèääåçéèçééææãèåé :ref:`cn_describe_changes`
+æèæçææääèæåèçäæã
+
+.. _cn_the_canonical_patch_format:
+
12ïæåèäæå
+----------------
+
+æèæèåäæååèäæèãèææïåææçèäååå ``Git`` åååäïå
+åääç ``git format-patch`` èèæççèäæåèçãäæïèäååææåå
+åèçææïåæèååéèäéçèæã
+
+æåçèäïæéèæ::
-æåçèäïæéèæï
Subject: [PATCH 001/123] åçç:äåèæè
æåèäçääåååäéåï
- - ää "from" èæåèääèã
+ - ää "from" èæåèääèãåèçèïäååéäèçåçääæäèææéèïã
+
+ - èéçææïèä75ååèïèåèåååæäåææåææèèäèäã
- ääçè
- - èæçääïèäèææåäèæèåæèèèäçæäæåèåéã
+ - äéæèçâSigned-off-byâ èïäååçåæææåäã
- - ääç"---"ææçæèè
+ - ååå ``---`` çæèçã
- - äåéæåæåèåéçéåçæèã
+ - ääåääéåæååææåçæéã
- - èäæèïdiff èåï
+ - åéèäï ``diff`` èåïã
æéèçæåïäååæéèæåæåæåéåçåæ - åå e-mail åæçé
åäææ - åäåååæçéååçïæäææåæååæåææåæäæçã
@@ -296,21 +520,35 @@ e-mail æéäçâäåèæèâæèçæè e-mail äçèäã
èä e-mail çâäåèæèâäæäèèäçåååäæèãåäèåå git
çæåèåéãçåâäåèæèâäèçåååèçèèéïçææäèäè
äãçæååæéè google ææç"äåèæè"ææåéäèèèäèäçæ
-çã
+çãåääåäääæåäçèå ``gitk`` æ ``git log --oneline`` äç
+çååæçæåäèäæïääååçååã
+
+åäèäååïæèåéäèè70-75äåçïåäåéæèèäçææäåä
+ääéèèäãæèçæåèæèæåææææïäåååçæèåèèæåã
+
+æèçåçåäçææåæèæïâSubject: [PATCH <tag>...] <æè>âãæè
+äèèäæèçäéåïèææèåèåäåçèäãåæèäçåäçæåå
+éåæäååèåïåâv1ïv2ïv3âïæârfcâïäæçèåèæïéäéçæè
+åèåæçææèçãåæääèäçåäæåäèäïéäåäèäåäèæ
+çåï1/4ã2/4ã3/4ã4/4ãèåäçäååäåäèèäåççéåïåäää
+åçæçæåçäèäçåäçææèäã
ääæéçäå::
Subject: [patch 2/5] ext2: improve scalability of bitmap searching
Subject: [PATCHv2 001/207] x86: fix eflags tracking
-"from" èæääéçæäéäèïåæåäæåï
+"From" èæääéçæäéäèïåæåäæåï
From: Original Author <author@xxxxxxxxxxx>
-"from" èææåæäæåæåéïèäèçèääèãåæææ "from" èïé
+"From" èææåæäæåæåéïèäèçèääèãåæææ "From" èïé
äéäåéç "From: " èäèçæååæåæåäçäèã
èæçäéåäèæäåæäçæäçæåæåéïåæåéäæåçäèåå
-èäèäçåçèèçèçæèåçèèæèïæææäçã
+èäèäçåçèèçèçæèåçèèæèïæææäçãåæèäçååä
+éèçïåææåææãOOPSææçïççïåäæçæäæåäåæéçèäçä
+ååæçãåæääèääåäääçèåèïéäåèäéèååææçèåèï
+åèèåèæçèäçäèåæåååèäãäæèäæïæèçæåèæèæã
"---" æèèåäèäåçååèæååéææåæåäæççæïæäåçå
çã
@@ -324,65 +562,63 @@ e-mail æéäçâäåèæèâæèçæè e-mail äçèäã
ååéçåèèæäèçåéåçèäæåçæåçèã
--------------------------------
-çäè æçïåèåèç
--------------------------------
+.. _cn_explicit_in_reply_to:
-æèåååååæäååæçäçæåçéåç"èå"ãäææèæäå...äæ
-äåéççæåçççèæåãäåäææèååLinusçèçæçååéèã
+15) æçååéäå(In-Reply-To)
+-------------------------------
-1) è Document/process/coding-style.rst
+æåæåååèäççæéå(In-Reply_To:) ææååçïäåïäç ``git send-email`` ï
+åèäääåççåèèåèèæïäåïåbugäåçåéæåçåéäåbugæåã
+äæïåäåèäçåïæåéååååæäçéæåèçåçæçæãèæï
+èäçåäçæåääæäçåéäåæçäææçççåçååãåæéææçï
+åääç https://lkml.kernel.org/ éåååïäåïååéçåéäææäï
+éæåèäçåçææçæã
-Nuff èèïåæäçäçåèäåçååïéäåæåèäèæçïæææåç
-åæïæææåçèäã
+16) åégit pullèæ
+--------------------
-2) #ifdef æäéç
-ææä ifdef çäçéäéèåçæãåèæåãääæäïåäç ifdef æ
-ååæäéïææäååä "static inline" åæïæèåïåäçéçèää
-èãèçèåæéä"çæä"äåæã
+åæææäçåèäïéäèçæäåéègit pullæäååäçææååççåå
+ååèæææäçãäæïèææïäååäåééèåèäæäéäåèäèåè
+äéèæéçääåãåæïèååçççæäåäæææåèæïçåææèæç
+æçååäåçèæãåææçéïæåäååééäääçpull èæääèäçå
+æåååçääééïèçæäååäéæäçåäääã
-ääçåçäåïäåçäç::
+pull èæçäéèäåèæ[Git Pull]ãèææèåèåäèäååååååçå
+æåèçåæïååèçèæå::
- dev = alloc_etherdev (sizeof(struct funky_private));
- if (!dev)
- return -ENODEV;
- #ifdef CONFIG_NET_FUNKINESS
- init_funky_net(dev);
- #endif
+ Please pull from
-æçåçäå:
+ git://jdelvare.pck.nerim.net/jdelvare-2.6 i2c-for-linus
-(åæäé)::
+ to get these changes:
- #ifndef CONFIG_NET_FUNKINESS
- static inline void init_funky_net (struct net_device *d) {}
- #endif
-(äçæäé)::
+pull èæèåèååäææäææïèæèæäåååääïääèäæèç ``Git shortlog``
+äåääæçèäçåæäææç ``diffstat`` ãåçïåææèääææéåäè
+çæçåæææè ``git`` äç ``git request-pull`` åääæåæèäåäã
- dev = alloc_etherdev (sizeof(struct funky_private));
- if (!dev)
- return -ENODEV;
- init_funky_net(dev);
+ääçæäåïåæLinusïåæçåæèåçåæäçèæïèååäääåäç
+èæäåãçåæïåææçåæççæåäïLinus äääå Github èæçåå
+æçççæèæã
-3) 'static inline' æåå
+ååæççåççäææçæää GNRPG åéïåçääæåäæååæååäåå
+åèèçåãèäæåæååäåæèåèååéïäææåæçèåãååäèæ
+æååäççæçåéçååäåçåææã
-Static inline åæçæåæèïæåååçéæãStatic inline åææää
-çåååïææéåéåïæææåéåïå gcc äåéååäæåã
+äææåGit äååäääæåææäæçèäçåïåç ``git tag -s`` ååä
+äçåæèãèåååääææèïæèèçåäçæåäææäïåååçæçç
+éååççåãæèåäåchangelogæåçæææååæèäïèæääæèæèæ
+æäææççæäçã
-ååå static inline åæäææäçæå[å fast paths éæååçççç
-æä]ïæèäåèç static inline åæçæå[äååçäåé]ã
-åèç 'static inline' èäæ 'static __inline__', 'extern inline' å
-'extern __inline__' ã
+åæçæäååèääæåçæäæææåäççåååïèäèåèååçåçæè
+æåæéåååæã
-4) äèèåèè
+çææèææïèäçåçåçæèääçæãèæçåäåäåç::
-äèèåéèæççææäæïèääæäèæçäèææçï"èäæååèç
-çåïèäææçå"ã
+ git request-pull master git://my.public.tree/linux.git my-signed-tag
-----------------
-çäè åèæç
-----------------
+åèæç
+--------
Andrew Morton, "The perfect patch" (tpp).
<http://www.ozlabs.org/~akpm/stuff/tpp.txt>
@@ -391,16 +627,28 @@ Jeff Garzik, "Linux kernel patch submission format".
<http://linux.yyz.us/patch-format.html>
Greg Kroah-Hartman, "How to piss off a kernel subsystem maintainer".
- <http://www.kroah.com/log/2005/03/31/>
- <http://www.kroah.com/log/2005/07/08/>
- <http://www.kroah.com/log/2005/10/19/>
- <http://www.kroah.com/log/2006/01/11/>
+ <http://www.kroah.com/log/linux/maintainer.html>
+
+ <http://www.kroah.com/log/linux/maintainer-02.html>
+
+ <http://www.kroah.com/log/linux/maintainer-03.html>
+
+ <http://www.kroah.com/log/linux/maintainer-04.html>
+
+ <http://www.kroah.com/log/linux/maintainer-05.html>
+
+ <http://www.kroah.com/log/linux/maintainer-06.html>
NO!!!! No more huge patch bombs to linux-kernel@xxxxxxxxxxxxxxx people!
<https://lkml.org/lkml/2005/7/11/336>
Kernel Documentation/process/coding-style.rst:
- <http://sosdg.org/~coywolf/lxr/source/Documentation/process/coding-style.rst>
+ :ref:`Documentation/process/coding-style.rst <codingstyle>`
Linus Torvalds's mail on the canonical patch format:
<http://lkml.org/lkml/2005/4/7/183>
+
+Andi Kleen, "On submitting kernel patches"
+ Some strategies to get difficult or controversial changes in.
+
+ http://halobates.de/on-submitting-patches.pdf
--
2.19.1.856.g8858448bb