Commit 115dbd5c authored by Alex Shi's avatar Alex Shi Committed by Jonathan Corbet
Browse files

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: default avatarAlex 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: default avatarWeiwei Jia <harryxiyou@gmail.com>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent f448a54e
Loading
Loading
Loading
Loading
+19 −14
Original line number Diff line number Diff line
@@ -54,16 +54,20 @@ Linux能成为强壮,稳定,成熟的操作系统,这也是你最开始选
--------------
假如我们有一个稳定的内核源代码接口,那么自然而然的,我们就拥有了稳定的
二进制接口,是这样的吗?错。让我们看看关于Linux内核的几点事实:

    - 取决于所用的C编译器的版本,不同的内核数据结构里的结构体的对齐方
式会有差别,代码中不同函数的表现形式也不一样(函数是不是被inline编译取
决于编译器行为)。不同的函数的表现形式并不重要,但是数据结构内部的对齐
方式很关键。
      式会有差别,代码中不同函数的表现形式也不一样(函数是不是被inline
      编译取决于编译器行为)。不同的函数的表现形式并不重要,但是数据
      结构内部的对齐方式很关键。

    - 取决于内核的配置选项,不同的选项会让内核的很多东西发生改变:

      - 同一个结构体可能包含不同的成员变量
      - 有的函数可能根本不会被实现(比如编译的时候没有选择SMP支持
一些锁函数就会被定义成空函数)。
        一些锁函数就会被定义成空函数)。
      - 内核使用的内存会以不同的方式对齐,这取决于不同的内核配置选
        项。

    - Linux可以在很多的不同体系结构的处理器上运行。在某个体系结构上编
      译好的二进制驱动程序,不可能在另外一个体系结构上正确的运行。

@@ -93,9 +97,10 @@ Linux能成为强壮,稳定,成熟的操作系统,这也是你最开始选

举一个例子,内核的USB驱动程序接口在USB子系统的整个生命周期中,至少经历
了三次重写。这些重写解决以下问题:

    - 把数据流从同步模式改成非同步模式,这个改动减少了一些驱动程序的
复杂度,提高了所有USB驱动程序的吞吐率,这样几乎所有的USB设备都能以最大
速率工作了。
      复杂度,提高了所有USB驱动程序的吞吐率,这样几乎所有的USB设备都
      能以最大速率工作了。
    - 修改了USB核心代码中为USB驱动分配数据包内存的方式,所有的驱动都
      需要提供更多的参数给USB核心,以修正了很多已经被记录在案的死锁。

@@ -132,12 +137,12 @@ Linux能成为强壮,稳定,成熟的操作系统,这也是你最开始选
做什么事情。

把驱动放到内核源代码树里会有很多的好处:

    - 驱动的质量会提升,而维护成本(对原始作者来说)会下降。
    - 其他人会给驱动添加新特性。
    - 其他人会找到驱动中的bug并修复。
    - 其他人会在驱动中找到性能优化的机会。
    - 当外部的接口的改变需要修改驱动程序的时候,其他人会修改驱动程序

    - 不需要联系任何发行商,这个驱动会自动的随着所有的Linux发布一起发
      布。