docs/zh_CN: fix indent issue in stable-api-nonsense file

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>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Alex Shi 2019-03-13 21:49:56 +08:00 committed by Jonathan Corbet
parent f448a54e0e
commit 115dbd5ca5
1 changed files with 19 additions and 14 deletions

View File

@ -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为更多不同的设备提供现成的驱动而且能在更多不
同体系结构的处理器上支持这些设备。这个经过考验的开发模式,必然是错不了