linux-kernel - Re: [PATCH] docs/zh_CN: core-api: Update translation of workqueue.rst to 6.9-rc1

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] [day] [month] [year] [list]

Message-ID: <d6d188a3-5604-4848-8b45-a7aff2535611@rockwork.org>
Date: Wed, 3 Apr 2024 06:58:13 +0800
From: Xingyou Chen <rockrush@...kwork.org>
To: Yanteng Si <siyanteng@...ngson.cn>, alexs@...nel.org, corbet@....net
Cc: zhoubinbin@...ngson.cn, tj@...nel.org, wangjinchao@...sion.com,
 linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] docs/zh_CN: core-api: Update translation of workqueue.rst
 to 6.9-rc1

On 4/2/24 19:47, Yanteng Si wrote:
> Hi xingyou,
> 
> 在 2024/4/1 01:21, Xingyou Chen 写道:
>> Significant changes have been made to workqueue, and there are staging
>> works transferring from tasklet, while the current translation doesn't
>> include description around WQ_BH, an update seems to be helpful.
>>
>> Synchronize translation from upstream commit 3bc1e711c26b
>> ("workqueue: Don't implicitly make UNBOUND workqueues w/ 
>> @max_active==1 ordered")
> It seems that you cannot pass the build test. You need to find a way to 
> silence these warnings
There are some "Title underline too short" warnings, I'll send an 
updated one.
> 
> 
> /home/siyanteng/doc/linux/Documentation/core-api/workqueue:776: 
> ./include/linux/workqueue.h:493: WARNING: Inline literal start-string 
> without end-string
It's "%WQ_*" in workqueue.h, and didn't found note on this labeling rule 
after quick search, I'll do an in depth reading around reStructuredText 
and Sphinx. We may simply remove "%" here, or protect asterisk as "%WQ_\*".
> 
> ...
> 
> 
> You need to follow the steps below:
> 
> $ ./scripts/sphinx-pre-install
> 
>       install them.
> 
> $ make cleandocs
> 
> $ make htmldocs
> 
>      silence warnings
> 
> 
> 
> Thanks,
> 
> Yanteng
>