linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Alex Shi <alex.shi@linux.alibaba.com>
To: corbet@lwn.net, harryxiyou@gmail.com, linux-doc@vger.kernel.org,
	linux-kernel@vger.kernel.org
Cc: Alex Shi <alex.shi@linux.alibaba.com>,
	Li Yang <leoyang.li@nxp.com>, TripleX Chung <xxx.phy@gmail.com>
Subject: [PATCH v5 26/31] docs/zh_CN: fix indent issue in stable-api-nonsense file
Date: Wed, 13 Mar 2019 21:49:56 +0800	[thread overview]
Message-ID: <20190313135001.260905-27-alex.shi@linux.alibaba.com> (raw)
In-Reply-To: <20190313135001.260905-1-alex.shi@linux.alibaba.com>

Tame the 'make htmldocs' to avoid 'ERROR: Unexpected indentation'
etc errors.

Signed-off-by: Alex Shi <alex.shi@linux.alibaba.com>
Cc: Harry Wei <harryxiyou@gmail.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Li Yang <leoyang.li@nxp.com>
Cc: TripleX Chung <xxx.phy@gmail.com>
Signed-off-by: Weiwei Jia <harryxiyou@gmail.com>
---
 .../zh_CN/process/stable-api-nonsense.rst     | 33 +++++++++++--------
 1 file changed, 19 insertions(+), 14 deletions(-)

diff --git a/Documentation/translations/zh_CN/process/stable-api-nonsense.rst b/Documentation/translations/zh_CN/process/stable-api-nonsense.rst
index 42d974e6dc35..beb94200b35e 100644
--- a/Documentation/translations/zh_CN/process/stable-api-nonsense.rst
+++ b/Documentation/translations/zh_CN/process/stable-api-nonsense.rst
@@ -54,18 +54,22 @@ Linux能成为强壮,稳定,成熟的操作系统,这也是你最开始选
 --------------
 假如我们有一个稳定的内核源代码接口,那么自然而然的,我们就拥有了稳定的
 二进制接口,是这样的吗?错。让我们看看关于Linux内核的几点事实:
+
     - 取决于所用的C编译器的版本,不同的内核数据结构里的结构体的对齐方
-式会有差别,代码中不同函数的表现形式也不一样(函数是不是被inline编译取
-决于编译器行为)。不同的函数的表现形式并不重要,但是数据结构内部的对齐
-方式很关键。
+      式会有差别,代码中不同函数的表现形式也不一样(函数是不是被inline
+      编译取决于编译器行为)。不同的函数的表现形式并不重要,但是数据
+      结构内部的对齐方式很关键。
+
     - 取决于内核的配置选项,不同的选项会让内核的很多东西发生改变:
+
       - 同一个结构体可能包含不同的成员变量
       - 有的函数可能根本不会被实现(比如编译的时候没有选择SMP支持
-,一些锁函数就会被定义成空函数)。
+        一些锁函数就会被定义成空函数)。
       - 内核使用的内存会以不同的方式对齐,这取决于不同的内核配置选
-项。
+        项。
+
     - Linux可以在很多的不同体系结构的处理器上运行。在某个体系结构上编
-译好的二进制驱动程序,不可能在另外一个体系结构上正确的运行。
+      译好的二进制驱动程序,不可能在另外一个体系结构上正确的运行。
 
 对于一个特定的内核,满足这些条件并不难,使用同一个C编译器和同样的内核配
 置选项来编译驱动程序模块就可以了。这对于给一个特定Linux发布的特定版本提
@@ -85,7 +89,7 @@ Linux能成为强壮,稳定,成熟的操作系统,这也是你最开始选
 
 如果有人不将他的内核驱动程序,放入公版内核的源代码树,而又想让驱动程序
 一直保持在最新的内核中可用,那么这个话题将会变得没完没了。
- 内核开发是持续而且快节奏的,从来都不会慢下来。内核开发人员在当前接口中
+内核开发是持续而且快节奏的,从来都不会慢下来。内核开发人员在当前接口中
 找到bug,或者找到更好的实现方式。一旦发现这些,他们就很快会去修改当前的
 接口。修改接口意味着,函数名可能会改变,结构体可能被扩充或者删减,函数
 的参数也可能发生改变。一旦接口被修改,内核中使用这些接口的地方需要同时
@@ -93,21 +97,22 @@ Linux能成为强壮,稳定,成熟的操作系统,这也是你最开始选
 
 举一个例子,内核的USB驱动程序接口在USB子系统的整个生命周期中,至少经历
 了三次重写。这些重写解决以下问题:
+
     - 把数据流从同步模式改成非同步模式,这个改动减少了一些驱动程序的
-复杂度,提高了所有USB驱动程序的吞吐率,这样几乎所有的USB设备都能以最大
-速率工作了。
+      复杂度,提高了所有USB驱动程序的吞吐率,这样几乎所有的USB设备都
+      能以最大速率工作了。
     - 修改了USB核心代码中为USB驱动分配数据包内存的方式,所有的驱动都
-需要提供更多的参数给USB核心,以修正了很多已经被记录在案的死锁。
+      需要提供更多的参数给USB核心,以修正了很多已经被记录在案的死锁。
 
 这和一些封闭源代码的操作系统形成鲜明的对比,在那些操作系统上,不得不额
 外的维护旧的USB接口。这导致了一个可能性,新的开发者依然会不小心使用旧的
 接口,以不恰当的方式编写代码,进而影响到操作系统的稳定性。
- 在上面的例子中,所有的开发者都同意这些重要的改动,在这样的情况下修改代
+在上面的例子中,所有的开发者都同意这些重要的改动,在这样的情况下修改代
 价很低。如果Linux保持一个稳定的内核源代码接口,那么就得创建一个新的接口
 ;旧的,有问题的接口必须一直维护,给Linux USB开发者带来额外的工作。既然
 所有的Linux USB驱动的作者都是利用自己的时间工作,那么要求他们去做毫无意
 义的免费额外工作,是不可能的。
- 安全问题对Linux来说十分重要。一个安全问题被发现,就会在短时间内得到修
+安全问题对Linux来说十分重要。一个安全问题被发现,就会在短时间内得到修
 正。在很多情况下,这将导致Linux内核中的一些接口被重写,以从根本上避免安
 全问题。一旦接口被重写,所有使用这些接口的驱动程序,必须同时得到修正,
 以确定安全问题已经得到修复并且不可能在未来还有同样的安全问题。如果内核
@@ -132,14 +137,14 @@ Linux能成为强壮,稳定,成熟的操作系统,这也是你最开始选
 做什么事情。
 
 把驱动放到内核源代码树里会有很多的好处:
+
     - 驱动的质量会提升,而维护成本(对原始作者来说)会下降。
     - 其他人会给驱动添加新特性。
     - 其他人会找到驱动中的bug并修复。
     - 其他人会在驱动中找到性能优化的机会。
     - 当外部的接口的改变需要修改驱动程序的时候,其他人会修改驱动程序
-。
     - 不需要联系任何发行商,这个驱动会自动的随着所有的Linux发布一起发
-布。
+      布。
 
 和别的操作系统相比,Linux为更多不同的设备提供现成的驱动,而且能在更多不
 同体系结构的处理器上支持这些设备。这个经过考验的开发模式,必然是错不了
-- 
2.19.1.856.g8858448bb


  parent reply	other threads:[~2019-03-13 13:51 UTC|newest]

Thread overview: 33+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-03-13 13:49 [PATCH v5 00/31] Clean up and reorg Chinese kernel docs Alex Shi
2019-03-13 13:49 ` [PATCH v5 01/31] docs/zh_CN: add disclaimer file Alex Shi
2019-03-13 13:49 ` [PATCH v5 02/31] docs/zh_CN: move process related docs into process dir Alex Shi
2019-03-13 13:49 ` [PATCH v5 03/31] docs/zh_CN: change Chinese index to know " Alex Shi
2019-03-13 13:49 ` [PATCH v5 04/31] docs/zh_CN: add index file into " Alex Shi
2019-03-13 13:49 ` [PATCH v5 05/31] docs/zh_CN: rename HOWTO into process directory Alex Shi
2019-03-13 13:49 ` [PATCH v5 06/31] docs/zh_CN: howto format changes Alex Shi
2019-03-13 13:49 ` [PATCH v5 07/31] docs/zh_CN: rename SubmittingPatches for html links Alex Shi
2019-03-13 13:49 ` [PATCH v5 08/31] docs/zh_CN: format the submitting-patches doc to rst Alex Shi
2019-03-13 13:49 ` [PATCH v5 09/31] docs/zh_CN: rename stable_kernel_rules doc Alex Shi
2019-03-13 13:49 ` [PATCH v5 10/31] docs/zh_CN: rst format change for stable-kernel-rules Alex Shi
2019-03-13 13:49 ` [PATCH v5 11/31] docs/zh_CN: rename email-clients.txt as email-clients.rst Alex Shi
2019-03-13 13:49 ` [PATCH v5 12/31] docs/zh_CN: do rst format for email-clients.rst Alex Shi
2019-03-13 13:49 ` [PATCH v5 13/31] docs/zh_CN: rename volatile-consider-harmful doc Alex Shi
2019-03-13 13:49 ` [PATCH v5 14/31] docs/zh_CN: volatile doc format changes Alex Shi
2019-03-13 13:49 ` [PATCH v5 15/31] docs/zh_CN: rename SubmittingDrivers Alex Shi
2019-03-13 13:49 ` [PATCH v5 16/31] docs/zh_CN: format submitting drivers as rst Alex Shi
2019-03-13 13:49 ` [PATCH v5 17/31] docs/zh_CN: rename magic-numbers as rst doc Alex Shi
2019-03-13 13:49 ` [PATCH v5 18/31] docs/zh_CN: format the magic-number doc as rst Alex Shi
2019-03-13 13:49 ` [PATCH v5 19/31] docs/zh_CN: rename stable_api_nonsense.txt as stable-api-nonsense.rst Alex Shi
2019-03-13 13:49 ` [PATCH v5 20/31] docs/zh_CN: format stable-api-nonsense Alex Shi
2019-03-13 13:49 ` [PATCH v5 21/31] docs/zh_CN: update Li Yang's email address Alex Shi
2019-03-13 13:49 ` [PATCH v5 22/31] mailmap: " Alex Shi
2019-03-13 13:49 ` [PATCH v5 23/31] docs/zh_CN: update Zhang Wei's " Alex Shi
2019-03-13 13:49 ` [PATCH v5 24/31] mailmap: update email address for Triplex Alex Shi
2019-03-13 13:49 ` [PATCH v5 25/31] docs/zh_CN: update TripleX chung's email address Alex Shi
2019-03-13 13:49 ` Alex Shi [this message]
2019-03-13 13:49 ` [PATCH v5 27/31] docs/zh_CN: fix indent issue in submitting-drivers Alex Shi
2019-03-13 13:49 ` [PATCH v5 28/31] docs/zh_CN: remove zh-kernel.org in MAINTAINERS Alex Shi
2019-03-13 13:49 ` [PATCH v5 29/31] mailmap: update my obsolete email address Alex Shi
2019-03-13 13:50 ` [PATCH v5 30/31] docs/zh_CN: fix rst format issue in submitting-patch Alex Shi
2019-03-13 13:50 ` [PATCH v5 31/31] docs/zh_CN: fix rst format errors in howto.rst Alex Shi
2019-03-18 17:31 ` [PATCH v5 00/31] Clean up and reorg Chinese kernel docs Jonathan Corbet

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20190313135001.260905-27-alex.shi@linux.alibaba.com \
    --to=alex.shi@linux.alibaba.com \
    --cc=corbet@lwn.net \
    --cc=harryxiyou@gmail.com \
    --cc=leoyang.li@nxp.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=xxx.phy@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).