linux-kernel - Re: [PATCH 04/13] docs: zh_CN: remove references to rust documentation

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <727a1f6e-113b-3ba4-87ec-2ba568343089@loongson.cn>
Date:   Sat, 20 Aug 2022 10:20:05 +0800
From:   YanTeng Si <siyanteng@...ngson.cn>
To:     Mauro Carvalho Chehab <mchehab@...nel.org>,
        Linux Doc Mailing List <linux-doc@...r.kernel.org>,
        corbet@....net
Cc:     Alex Shi <alexs@...nel.org>, linux-kernel@...r.kernel.org
Subject: Re: [PATCH 04/13] docs: zh_CN: remove references to rust
 documentation


在 2022/8/18 21:38, Mauro Carvalho Chehab 写道:
> There is a note on this file that, using a robot to translate,
> says:
>
> 	"The kernel-doc cannot contain Rust code: please refer
> 	 to Documentation/rust/general-information.rst."
>
> Such note doesn't exist at the original file anymore, so, just remove
> it from the translation, in order to solve this warning:
>
> 	Warning: Documentation/translations/zh_CN/doc-guide/kernel-doc.rst references a file that doesn't exist: Documentation/rust/general-information.rst
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab@...nel.org>

Reviewed-by: Yanteng Si<siyanteng@...ngson.cn>

Thanks,
Yanteng

> ---
>
> See [PATCH 00/13] at: https://lore.kernel.org/all/cover.1660829433.git.mchehab@kernel.org/
>
>   Documentation/translations/zh_CN/doc-guide/kernel-doc.rst | 2 --
>   1 file changed, 2 deletions(-)
>
> diff --git a/Documentation/translations/zh_CN/doc-guide/kernel-doc.rst b/Documentation/translations/zh_CN/doc-guide/kernel-doc.rst
> index ccfb9b8329c2..9fd170faf951 100644
> --- a/Documentation/translations/zh_CN/doc-guide/kernel-doc.rst
> +++ b/Documentation/translations/zh_CN/doc-guide/kernel-doc.rst
> @@ -14,8 +14,6 @@ Linux内核源文件可以包含kernel-doc格式的结构化文档注释，用
>             实际有着明显的不同。内核源包含成千上万个kernel-doc注释。请坚持遵循
>             此处描述的风格。
>   
> -.. note:: kernel-doc无法包含Rust代码：请参考 Documentation/rust/general-information.rst 。
> -
>   从注释中提取kernel-doc结构，并从中生成适当的 `Sphinx C 域`_ 函数和带有锚点的
>   类型描述。这些注释将被过滤以生成特殊kernel-doc高亮和交叉引用。详见下文。
>