Skip to contentSkip to conversation

doc/zh_CN: add admin-guide index

PATCH Applied Alex Shi 2 participants 4 messages Jul 13, 2020 – Jul 23, 2020

Subsystems (2)
lore
Share & tools
lore

Alex Shi

author
#0 lore raw

PATCH v2 1/3 doc/zh_CN: add admin-guide index

Translate the admin-guide index.rst file into Chinese. and link it into Chinese top index file.

---
 .../translations/zh_CN/admin-guide/index.rst  | 112 ++++++++++++++++++
 Documentation/translations/zh_CN/index.rst    |   1 +
 2 files changed, 113 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/admin-guide/index.rst
Documentation/translations/zh_CN/admin-guide/index.rst new file +112 -0
new file mode 100644
index 000000000000..0cb3f79f77cf
@@ -0,0 +1,112 @@
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/admin-guide/index.rst`
+:Translator: Alex Shi <[email protected]>
+
+
+Linux 内核用户和管理员指南
+==========================
+
+下面是一组随时间添加到内核中的面向用户的文档的集合。到目前为止,还没有一个
+整体的顺序或组织 - 这些材料不是一个单一的,连贯的文件!幸运的话,情况会随着
+时间的推移而迅速改善。
+
+这个初始部分包含总体信息,包括描述内核的README, 关于内核参数的文档等。
+
+
+   README
+   kernel-parameters
+   devices
+   sysctl/index
+
+本节介绍CPU漏洞及其缓解措施。
+
+   hw-vuln/index
+
+下面的一组文档,针对的是试图跟踪问题和bug的用户。
+
+
+   reporting-bugs
+   security-bugs
+   bug-hunting
+   bug-bisect
+   tainted-kernels
+   ramoops
+   dynamic-debug-howto
+   init
+   kdump/index
+   perf/index
+
+这是应用程序开发人员感兴趣的章节的开始。可以在这里找到涵盖内核ABI各个
+方面的文档。
+
+   sysfs-rules
+
+本手册的其余部分包括各种指南,介绍如何根据您的喜好配置内核的特定行为。
+
+   acpi/index
+   aoe/index
+   auxdisplay/index
+   bcache
+   binderfs
+   binfmt-misc
+   blockdev/index
+   bootconfig
+   braille-console
+   btmrvl
+   cgroup-v1/index
+   cgroup-v2
+   cifs/index
+   clearing-warn-once
+   cpu-load
+   cputopology
+   dell_rbu
+   device-mapper/index
+   edid
+   efi-stub
+   ext4
+   nfs/index
+   gpio/index
+   highuid
+   hw_random
+   initrd
+   iostats
+   java
+   jfs
+   kernel-per-CPU-kthreads
+   laptops/index
+   lcd-panel-cgram
+   ldm
+   lockup-watchdogs
+   LSM/index
+   md
+   media/index
+   mm/index
+   module-signing
+   mono
+   namespaces/index
+   numastat
+   parport
+   perf-security
+   pm/index
+   pnp
+   rapidio
+   ras
+   rtc
+   serial-console
+   svga
+   sysrq
+   thunderbolt
+   ufs
+   unicode
+   vga-softcursor
+   video-output
+   wimax/index
+   xfs
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Documentation/translations/zh_CN/index.rst +1 -0
index 76850a5dd982..301e50a64dc6 100644
@@ -13,6 +13,7 @@
 .. toctree::
    :maxdepth: 2
 
+   admin-guide/index
    process/index
    filesystems/index
 
Signature · 1 line
2.18.4
author
#1 lore raw

PATCH v2 2/3 doc/zh_CN: add clearing-warn-once Chinese version

and link it into admin-guide.

---
 .../zh_CN/admin-guide/clearing-warn-once.rst      |  9 +++++++++
 .../translations/zh_CN/admin-guide/index.rst      | 15 ++++++++++++++-
 2 files changed, 23 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/admin-guide/clearing-warn-once.rst
Documentation/translations/zh_CN/admin-guide/clearing-warn-once.rst new file +9 -0
new file mode 100644
index 000000000000..659264d5f994
@@ -0,0 +1,9 @@
+清除 WARN_ONCE
+--------------
+
+WARN_ONCE / WARN_ON_ONCE / printk_once 仅仅打印一次消息.
+
+echo 1 > /sys/kernel/debug/clear_warn_once
+
+可以清除这种状态并且再次允许打印一次告警信息,这对于运行测试集后重现问题
+很有用。
Documentation/translations/zh_CN/admin-guide/index.rst +14 -1
index 0cb3f79f77cf..76637ff880c5 100644
@@ -13,6 +13,7 @@ Linux 内核用户和管理员指南
 
 这个初始部分包含总体信息,包括描述内核的README, 关于内核参数的文档等。
 
+Todolist:
 
    README
    kernel-parameters
@@ -21,10 +22,13 @@ Linux 内核用户和管理员指南
 
 本节介绍CPU漏洞及其缓解措施。
 
+Todolist:
+
    hw-vuln/index
 
 下面的一组文档,针对的是试图跟踪问题和bug的用户。
 
+Todolist:
 
    reporting-bugs
    security-bugs
@@ -40,10 +44,20 @@ Linux 内核用户和管理员指南
 这是应用程序开发人员感兴趣的章节的开始。可以在这里找到涵盖内核ABI各个
 方面的文档。
 
+Todolist:
+
    sysfs-rules
 
 本手册的其余部分包括各种指南,介绍如何根据您的喜好配置内核的特定行为。
 
+
+.. toctree::
+   :maxdepth: 1
+
+   clearing-warn-once
+
+Todolist:
+
    acpi/index
    aoe/index
    auxdisplay/index
@@ -57,7 +71,6 @@ Linux 内核用户和管理员指南
    cgroup-v1/index
    cgroup-v2
    cifs/index
-   clearing-warn-once
    cpu-load
    cputopology
    dell_rbu
Signature · 1 line
2.18.4
author
#2 lore raw

PATCH v2 3/3 doc/zh_CN: add Chinese translation prefer section

In reply to Alex Shi

The add words is:

Tranlation plan:
Welcome for any part of kernel doc Chinese translation, expecially for admin-guide part.

---
 Documentation/translations/zh_CN/index.rst | 3 +++
 1 file changed, 3 insertions(+)
Documentation/translations/zh_CN/index.rst +3 -0
index 301e50a64dc6..85643e46e308 100644
@@ -10,6 +10,9 @@
 人员做出贡献。 与任何大型社区一样,知道如何完成任务将使得更改合并的过程变得更
 加容易。
 
+翻译计划:
+内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。
+
 .. toctree::
    :maxdepth: 2
 
Signature · 1 line
2.18.4
maintainer Applied
#3 lore raw
In reply to Alex Shi
Quoted 8 lines · On Mon, 13 Jul 2020 19:58:05 +0800 Alex Shi <[email protected]> wrote:

Translate the admin-guide index.rst file into Chinese. and link it into Chinese top index file.

Quoted 5 lines
---
 .../translations/zh_CN/admin-guide/index.rst  | 112 ++++++++++++++++++
 Documentation/translations/zh_CN/index.rst    |   1 +
 2 files changed, 113 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/admin-guide/index.rst

I've applied the set, thanks.

jon