Thread (14 messages) 14 messages, 4 authors, 2021-05-17

Re: [PATCH v6 1/3] docs/zh_CN: add core-api kernel-api.rst translation

From: yanteng si <hidden>
Date: 2021-05-17 08:18:48

Alex Shi [off-list ref] 于2021年5月17日周一 上午11:21写道:


On 2021/5/17 上午9:55, yanteng si wrote:
quoted
Alex Shi [off-list ref] 于2021年5月16日周日 上午11:30写道:
quoted


On 2021/5/15 下午4:10, Yanteng Si wrote:
quoted
+安全框架
+========
+
+check the functions in security/security.c in kernel source code.
+   :internal:
+
+check the functions in security/inode.c in kernel source code.
+   :export:
+
+审计接口
+========
+
+check the functions in kernel/audit.c in kernel source code.
+   :export:
+
+check the functions in kernel/auditsc.c in kernel source code.
+   :internal:
+
+check the functions in kernel/auditfilter.c in kernel source code.
+   :internal:
+
Too verbose w/o much useful info, Is the following better?

  APIs in kernel code: kernel/audit.c, kernel/auitsc.c and kernel/auditfilter.c

  该 APIs 在以下内核代码中 kernel/audit.c, kernel/auitsc.c and kernel/auditfilter.c
It looks great, but in some cases, sentences that are too long have
some difficulty with a new line, and they are not neat after the new
line.
For example::

这些函数在以下内核代码中 include/asm-generic/bitops/instrumented-atomic.h,
include/asm-generic/bitops/instrumented-non-atomic.h and
include/asm-generic/bitops/instrumented-lock.h
...

how about::

该API在以下内核代码中:

kernel/audit.c
kernel/auitsc.c
kernel/auditfilter.c

该API在以下内核代码中:

include/asm-generic/bitops/instrumented-atomic.h
include/asm-generic/bitops/instrumented-non-atomic.h
include/asm-generic/bitops/instrumented-lock.h
Right split them into multiple lines looks better.
OK!

Thanks,
 Yanteng
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help