Documentation/zh_CN/SubmitChecklist

   1 Chinese translated version of Documentation/SubmitChecklist
   2
   3 If you have any comment or update to the content, please contact the
   4 original document maintainer directly.  However, if you have a problem
   5 communicating in English you can also ask the Chinese maintainer for
   6 help.  Contact the Chinese maintainer if this translation is outdated
   7 or if there is a problem with the translation.
   8
   9 Chinese maintainer: Harry Wei <harryxiyou@gmail.com>
  10 ---------------------------------------------------------------------
  11 Documentation/SubmitChecklist µÄÖÐÎÄ·Òë
  12
  13 Èç¹ûÏëÆÀÂÛ»ò¸üÐÂ±¾ÎÄµÄÄÚÈÝ£¬ÇëÖ±½ÓÁªÏµÔÎÄµµµÄÎ¬»¤Õß¡£Èç¹ûÄãÊ¹ÓÃÓ¢ÎÄ
  14 ½»Á÷ÓÐÀ§ÄÑµÄ»°£¬Ò²¿ÉÒÔÏòÖÐÎÄ°æÎ¬»¤ÕßÇóÖú¡£Èç¹û±¾·Òë¸üÐÂ²»¼°Ê±»òÕß·
  15 Òë´æÔÚÎÊÌâ£¬ÇëÁªÏµÖÐÎÄ°æÎ¬»¤Õß¡£
  16
  17 ÖÐÎÄ°æÎ¬»¤Õß£º ¼ÖÍþÍþ Harry Wei <harryxiyou@gmail.com>
  18 ÖÐÎÄ°æ·ÒëÕß£º ¼ÖÍþÍþ Harry Wei <harryxiyou@gmail.com>
  19 ÖÐÎÄ°æÐ£ÒëÕß£º ¼ÖÍþÍþ Harry Wei <harryxiyou@gmail.com>
  20
  21
  22 ÒÔÏÂÎªÕýÎÄ
  23 ---------------------------------------------------------------------
  24 LinuxÄÚºËÌá½»Çåµ¥
  25 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  26
  27 ÕâÀïÓÐÒ»Ð©ÄÚºË¿ª·¢ÕßÓ¦¸Ã×öµÄ»ù±¾ÊÂÇé£¬Èç¹ûËûÃÇÏë¿´µ½×Ô¼ºµÄÄÚºË²¹¶¡Ìá½»
  28 ±»½ÓÊÜµÄ¸ü¿ì¡£
  29
  30 ÕâÐ©¶¼ÊÇ³¬³öDocumentation/SubmittingPatchesÎÄµµÀïËùÌá¹©µÄÒÔ¼°ÆäËû
  31 ¹ØÓÚÌá½»LinuxÄÚºË²¹¶¡µÄËµÃ÷¡£
  32
  33 1£ºÈç¹ûÄãÊ¹ÓÃÁËÒ»¸ö¹¦ÄÜÄÇÃ´¾Í#include¶¨Òå/ÉùÃ÷ÄÇ¸ö¹¦ÄÜµÄÄÇ¸öÎÄ¼þ¡£
  34    ²»ÒªÒÀ¿¿ÆäËû¼ä½ÓÒýÈë¶¨Òå/ÉùÃ÷ÄÇ¸ö¹¦ÄÜµÄÍ·ÎÄ¼þ¡£
  35
  36 2£º¹¹½¨¼ò½àÊÊÓÃ»òÕß¸ü¸ÄCONFIGÑ¡Ïî =y£¬=m£¬»òÕß=n¡£
  37    ²»ÒªÓÐ±àÒë¾¯¸æ/´íÎó£¬ ²»ÒªÓÐÁ´½Ó¾¯¸æ/´íÎó¡£
  38
  39 2b£ºÍ¨¹ý allnoconfig, allmodconfig
  40
  41 2c£ºµ±Ê¹ÓÃ 0=builddir ³É¹¦µØ¹¹½¨
  42
  43 3£ºÍ¨¹ýÊ¹ÓÃ±¾µØ½»²æ±àÒë¹¤¾ß»òÕßÆäËûÒ»Ð©¹¹½¨²úËù£¬ÔÚ¶àCPU¿ò¼ÜÉÏ¹¹½¨¡£
  44
  45 4£ºppc64 ÊÇÒ»¸öºÜºÃµÄ¼ì²é½»²æ±àÒëµÄ¿ò¼Ü£¬ÒòÎªËüÍùÍù°Ñ¡®unsigned long¡¯
  46    µ±64Î»ÖµÀ´Ê¹ÓÃ¡£
  47
  48 5£º°´ÕÕDocumentation/CodingStyleÎÄ¼þÀïµÄÏêÏ¸ÃèÊö£¬¼ì²éÄã²¹¶¡µÄÕûÌå·ç¸ñ¡£
  49    Ê¹ÓÃ²¹¶¡·ç¸ñ¼ì²éËöËéµÄÎ¥¹æ(scripts/checkpatch.pl)£¬ÉóºËÔ±ÓÅÏÈÌá½»¡£
  50    ÄãÓ¦¸Ãµ÷ÕûÒÅÁôÔÚÄã²¹¶¡ÖÐµÄËùÓÐÎ¥¹æ¡£
  51
  52 6£ºÈÎºÎ¸üÐÂ»òÕß¸Ä¶¯CONFIGÑ¡Ïî¶¼²»ÄÜ´òÂÒÅäÖÃ²Ëµ¥¡£
  53
  54 7£ºËùÓÐµÄKconfigÑ¡Ïî¸üÐÂ¶¼ÒªÓÐËµÃ÷ÎÄ×Ö¡£
  55
  56 8£ºÒÑ¾ÈÏÕæµØ×Ü½áÁËÏà¹ØµÄKconfig×éºÏ¡£ÕâÊÇºÜÄÑÍ¨¹ý²âÊÔ×öºÃµÄ--ÄÔÁ¦ÔÚÕâÀïÏÂ½µ¡£
  57
  58 9£º¼ì²é¾ßÓÐ¼ò½àÐÔ¡£
  59
  60 10£ºÊ¹ÓÃ'make checkstack'ºÍ'make namespacecheck'¼ì²é£¬È»ºóÐÞ¸ÄËùÕÒµ½µÄÎÊÌâ¡£
  61     ×¢Òâ£º¶ÑÕ»¼ì²é²»»áÃ÷È·µØ³öÏÖÎÊÌâ£¬µ«ÊÇÈÎºÎµÄÒ»¸öº¯ÊýÔÚ¶ÑÕ»ÉÏÊ¹ÓÃ¶àÓÚ512×Ö½Ú
  62     ¶¼Òª×¼±¸ÐÞ¸Ä¡£
  63
  64 11£º°üº¬kernel-docµ½È«¾ÖÄÚºËAPIsÎÄ¼þ¡££¨²»ÒªÇó¾²Ì¬µÄº¯Êý£¬µ«ÊÇ°üº¬Ò²ÎÞËùÎ½¡££©
  65     Ê¹ÓÃ'make htmldocs'»òÕß'make mandocs'À´¼ì²ékernel-doc£¬È»ºóÐÞ¸ÄÈÎºÎ
  66     ·¢ÏÖµÄÎÊÌâ¡£
  67
  68 12£ºÒÑ¾Í¨¹ýCONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT,
  69     CONFIG_DEBUG_SLAB, CONFIG_DEBUG_PAGEALLOC, CONFIG_DEBUG_MUTEXES,
  70     CONFIG_DEBUG_SPINLOCK, CONFIG_DEBUG_ATOMIC_SLEEP²âÊÔ£¬²¢ÇÒÍ¬Ê±¶¼
  71     Ê¹ÄÜ¡£
  72
  73 13£ºÒÑ¾¶¼¹¹½¨²¢ÇÒÊ¹ÓÃ»òÕß²»Ê¹ÓÃ CONFIG_SMP ºÍ CONFIG_PREEMPT²âÊÔÖ´ÐÐÊ±¼ä¡£
  74
  75 14£ºÈç¹û²¹¶¡Ó°ÏìIO/Disk£¬µÈµÈ£ºÒÑ¾Í¨¹ýÊ¹ÓÃ»òÕß²»Ê¹ÓÃ CONFIG_LBDAF ²âÊÔ¡£
  76
  77 15£ºËùÓÐµÄcodepathsÒÑ¾ÐÐÊ¹ËùÓÐlockdepÆôÓÃ¹¦ÄÜ¡£
  78
  79 16£ºËùÓÐµÄ/proc¼ÇÂ¼¸üÐÂ¶¼Òª×÷³ÉÎÄ¼þ·ÅÔÚDocumentation/Ä¿Â¼ÏÂ¡£
  80
  81 17£ºËùÓÐµÄÄÚºËÆô¶¯²ÎÊý¸üÐÂ¶¼±»¼ÇÂ¼µ½Documentation/kernel-parameters.txtÎÄ¼þÖÐ¡£
  82
  83 18£ºËùÓÐµÄÄ£¿é²ÎÊý¸üÐÂ¶¼ÓÃMODULE_PARM_DESC()¼ÇÂ¼¡£
  84
  85 19£ºËùÓÐµÄÓÃ»§¿Õ¼ä½Ó¿Ú¸üÐÂ¶¼±»¼ÇÂ¼µ½Documentation/ABI/¡£²é¿´Documentation/ABI/README
  86     ¿ÉÒÔ»ñµÃ¸ü¶àµÄÐÅÏ¢¡£¸Ä±äÓÃ»§¿Õ¼ä½Ó¿ÚµÄ²¹¶¡Ó¦¸Ã±»ÓÊ¼þ³ËÍ¸ølinux-api@vger.kernel.org¡£
  87
  88 20£º¼ì²éËüÊÇ²»ÊÇ¶¼Í¨¹ý`make headers_check'¡£
  89
  90 21£ºÒÑ¾Í¨¹ýÖÁÉÙÒýÈëslabºÍpage-allocationÊ§°Ü¼ì²é¡£²é¿´Documentation/fault-injection/¡£
  91
  92 22£ºÐÂ¼ÓÈëµÄÔ´ÂëÒÑ¾Í¨¹ý`gcc -W'£¨Ê¹ÓÃ"make EXTRA_CFLAGS=-W"£©±àÒë¡£ÕâÑù½«²úÉúºÜ¶à·³ÄÕ£¬
  93     µ«ÊÇ¶ÔÓÚÑ°ÕÒÂ©¶´ºÜÓÐÒæ´¦£¬ÀýÈç:"warning: comparison between signed and unsigned"¡£
  94
  95 23£ºµ±Ëü±»ºÏ²¢µ½-mm²¹¶¡¼¯ºóÔÙ²âÊÔ£¬ÓÃÀ´È·¶¨ËüÊÇ·ñ»¹ºÍ²¹¶¡¶ÓÁÐÖÐµÄÆäËû²¹¶¡Ò»Æð¹¤×÷ÒÔ¼°ÔÚVM£¬VFS
  96     ºÍÆäËû×ÓÏµÍ³ÖÐ¸÷¸ö±ä»¯¡£
  97
  98 24£ºËùÓÐµÄÄÚ´æÆÁÕÏ{e.g., barrier(), rmb(), wmb()}ÐèÒªÔÚÔ´´úÂëÖÐµÄÒ»¸ö×¢ÊÍÀ´½âÊÍËûÃÇ¶¼ÊÇ¸ÉÊ²Ã´µÄ
  99     ÒÔ¼°ÔÒò¡£
 100
 101 25£ºÈç¹ûÓÐÈÎºÎÊäÈëÊä³ö¿ØÖÆµÄ²¹¶¡±»Ìí¼Ó£¬Ò²Òª¸üÐÂDocumentation/ioctl/ioctl-number.txt¡£
 102
 103 26£ºÈç¹ûÄãµÄ¸ü¸Ä´úÂëÒÀ¿¿»òÕßÊ¹ÓÃÈÎºÎµÄÄÚºËAPIs»òÕßÓëÏÂÃæµÄkconfig·ûºÅÓÐ¹ØÏµµÄ¹¦ÄÜ£¬Äã¾ÍÒª
 104     Ê¹ÓÃÏà¹ØµÄkconfig·ûºÅ¹Ø±Õ£¬ and/or =m£¨Èç¹ûÑ¡ÏîÌá¹©£©[ÔÚÍ¬Ò»Ê±¼ä²»ÊÇËùÓÃµÄ¶¼ÆôÓÃ£¬½ö½ö¸÷¸ö»òÕß×ÔÓÉ
 105     ×éºÏËûÃÇ]£º
 106
 107     CONFIG_SMP, CONFIG_SYSFS, CONFIG_PROC_FS, CONFIG_INPUT, CONFIG_PCI,
 108     CONFIG_BLOCK, CONFIG_PM, CONFIG_HOTPLUG, CONFIG_MAGIC_SYSRQ,
 109     CONFIG_NET, CONFIG_INET=n (ºóÒ»¸öÊ¹ÓÃ CONFIG_NET=y)