Received: by 2002:ac0:aed5:0:0:0:0:0 with SMTP id t21csp3053009imb; Mon, 4 Mar 2019 23:01:02 -0800 (PST) X-Google-Smtp-Source: APXvYqwOQ2rodM42dCnpPPEnrmY1hRAehyYp5IbLBXnraI2ZWIZgwXdd0dV36lwrUOROidzhuGiY X-Received: by 2002:a63:d442:: with SMTP id i2mr137672pgj.246.1551769262120; Mon, 04 Mar 2019 23:01:02 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1551769262; cv=none; d=google.com; s=arc-20160816; b=riETZ6ZWd08XTLwPb64XiuONwXZCK3RUBzqLzaVC2EINfiAJqaKdUCQkBwJ1t3bn6t 5uzgs9QbpsS6mb0WfBZnBCQKVfWQefeXX+ZGzwmPlWxyB9tfXFEDyj4d4eoVYhoxlaxG avfbEO/iKtjVKYKQizcAQXCOlgiRD0Uxav/xn5Ob8tJoARghfjqiKxg1XO1iQA83N6K5 DYf9EE7xu9+gcB5mj3DKZC4LpZvM2ItGMzbATzvA4v9eRlsxkxSm1s9mQz+Yy/NmJa0F b29ogoHHqmMLj2CCFIGCtsbY5onDlcqrAl+MNdHg/A8MXp/OYrJX3m1xtTKn4HhWH4qK LdcQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=nje5jUC/X1uRHGAfA0zuN/nQIrgoAwMJwQa2vmCjxfs=; b=dbkYd+fZ4zfwXWfxL0+SF26FNwP8tbraF7epfQyX4fulgIZUi/2AZHXAIIJg1vkq2w C0fcA6BY+whBoV0SdD2bVuSCxWDtlPJugb/DSna/u9ZxcCoeUC3fGK3UHObocmpOETH6 ceif0atMg+QQF2G1UGzxTI3dn/ec2gGEqJfz0xVgfg2EGBIkxYF1AuXVcu3ZhUwMMKSx eCxSmS6I291y4IXUIlt1SQchGUZ7oSk9rYyRn/1YqoETPbOBYcDjgC3ts5vhJzJr6Mt5 kLvYn4dW3nxc33TtkrxQw2PwfkK8+d17ityISa4u8tCmIWWyBwfgYE/q0B/g7k/OVIXn t10Q== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id 72si669223ple.250.2019.03.04.23.00.47; Mon, 04 Mar 2019 23:01:02 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727331AbfCEG7D (ORCPT + 99 others); Tue, 5 Mar 2019 01:59:03 -0500 Received: from out30-131.freemail.mail.aliyun.com ([115.124.30.131]:60702 "EHLO out30-131.freemail.mail.aliyun.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727255AbfCEG7A (ORCPT ); Tue, 5 Mar 2019 01:59:00 -0500 X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R841e4;CH=green;DM=||false|;FP=0|-1|-1|-1|0|-1|-1|-1;HT=e01f04389;MF=alex.shi@linux.alibaba.com;NM=1;PH=DS;RN=11;SR=0;TI=SMTPD_---0TM.nNt4_1551769127; Received: from localhost(mailfrom:alex.shi@linux.alibaba.com fp:SMTPD_---0TM.nNt4_1551769127) by smtp.aliyun-inc.com(127.0.0.1); Tue, 05 Mar 2019 14:58:48 +0800 From: Alex Shi To: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, harryxiyou@gmail.com, corbet@lwn.net, leoyang.li@nxp.com Cc: colyli@suse.de, fengguang.wu@intel.com, shawn.guo@linaro.org, lizefan@huawei.com, Alex Shi , TripleX Chung Subject: [PATCH v2 26/27] docs/zh_CN: fix rst format issue in submitting-patch Date: Tue, 5 Mar 2019 14:58:14 +0800 Message-Id: <20190305065815.157964-28-alex.shi@linux.alibaba.com> X-Mailer: git-send-email 2.19.1.856.g8858448bb In-Reply-To: <20190305065815.157964-1-alex.shi@linux.alibaba.com> References: <20190305065815.157964-1-alex.shi@linux.alibaba.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Tame 'make htmldocs' to avoid indent and code section error complains. Signed-off-by: Alex Shi Cc: Harry Wei Cc: Jonathan Corbet Cc: Li Yang Cc: TripleX Chung --- .../zh_CN/process/submitting-patches.rst | 24 +++++++++++-------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/Documentation/translations/zh_CN/process/submitting-patches.rst b/Documentation/translations/zh_CN/process/submitting-patches.rst index 47cdca62cfa2..54fe00d0afc1 100644 --- a/Documentation/translations/zh_CN/process/submitting-patches.rst +++ b/Documentation/translations/zh_CN/process/submitting-patches.rst @@ -39,7 +39,7 @@ Documentation/process/submitting-drivers.rst 。 参数生成。而且,请使用 '-p' 参数,那样会显示每个改动所在的C函数,使得 产生的补丁容易读得多。补丁应该基于内核源代码树的根目录,而不是里边的任 何子目录。 -为一个单独的文件创建补丁,一般来说这样做就够了: +为一个单独的文件创建补丁,一般来说这样做就够了:: SRCTREE= linux-2.6 MYFILE= drivers/net/mydriver.c @@ -51,7 +51,7 @@ Documentation/process/submitting-drivers.rst 。 diff -up $SRCTREE/$MYFILE{.orig,} > /tmp/patch 为多个文件创建补丁,你可以解开一个没有修改过的内核源代码树,然后和你自 -己的代码树之间做 diff 。例如: +己的代码树之间做 diff 。例如:: MYSRC= /devel/linux-2.6 @@ -141,6 +141,7 @@ MAINTAINERS 文件里的)发送一个手册页(man-pages)补丁,或者 对于小的补丁,你也许会CC到 Adrian Bunk 管理的搜集琐碎补丁的邮件列表 (Trivial Patch Monkey)trivial@kernel.org,那里专门收集琐碎的补丁。下面这样 的补丁会被看作“琐碎的”补丁: + 文档的拼写修正。 修正会影响到 grep(1) 的拼写。 警告信息修正(频繁的打印无用的警告是不好的。) @@ -239,10 +240,12 @@ Linus 和 linux-kernel 邮件列表的 e-mail 流量都很高,一个通常的 建议在发送出去的补丁上加一个 “sign-off” 的过程。 "sign-off" 是在补丁的注释的最后的简单的一行文字,认证你编写了它或者其他 -人有权力将它作为开放源代码的补丁传递。规则很简单:如果你能认证如下信息 -: - 开发者来源证书 1.1 - 对于本项目的贡献,我认证如下信息: +人有权力将它作为开放源代码的补丁传递。规则很简单:如果你能认证如下信息: + +开发者来源证书 1.1 +^^^^^^^^^^^^^^^^^^ +对于本项目的贡献,我认证如下信息: + (a)这些贡献是完全或者部分的由我创建,我有权利以文件中指出 的开放源代码许可证提交它;或者 (b)这些贡献基于以前的工作,据我所知,这些以前的工作受恰当的开放 @@ -338,7 +341,7 @@ Nuff 说过,如果你的代码和这个偏离太多,那么它有可能会被 在头文件里,有条件地定义 "static inline" 函数,或者宏,在代码里用这些东 西。让编译器把那些"空操作"优化掉。 -一个简单的例子,不好的代码: +一个简单的例子,不好的代码:: dev = alloc_etherdev (sizeof(struct funky_private)); if (!dev) @@ -349,12 +352,14 @@ Nuff 说过,如果你的代码和这个偏离太多,那么它有可能会被 清理后的例子: -(头文件里) +(头文件里):: + #ifndef CONFIG_NET_FUNKINESS static inline void init_funky_net (struct net_device *d) {} #endif -(代码文件里) +(代码文件里):: + dev = alloc_etherdev (sizeof(struct funky_private)); if (!dev) return -ENODEV; @@ -399,4 +404,3 @@ Kernel Documentation/process/coding-style.rst: Linus Torvalds's mail on the canonical patch format: --- -- 2.19.1.856.g8858448bb