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

From: Xingyou Chen
Date: Tue Apr 02 2024 - 18:58:33 EST


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