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

[Xingyou Chen]

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