Re: [PATCH v5 0/3] docs/zh_CN add three core api docs
From: Jonathan Corbet <corbet@lwn.net>
Date: 2021-05-13 16:21:03
From: Jonathan Corbet <corbet@lwn.net>
Date: 2021-05-13 16:21:03
Yanteng Si [off-list ref] writes:
* As Matthew and Xiangcheng suggested: call kernel-doc to generate related docs (0001 and 0002).Thanks! I tested it on other computers (at least three) with no problem, But on my computers it prints 1000+ warnings, I tried to find the cause in the past few days but no clue. So, the two patches may print as follows:(maybe your computer won't print anything) linux-next/Documentation/translations/zh_CN/core-api/kernel-api.rst:235: WARNING: Duplicate C declaration, also defined at core-api/kernel-api:235. Declaration is '.. c:None:: struct list_head *prev'.
This is the same problem I just talked about in my other message. I really think we need to just leave the kernel-doc directives out of translations; we certainly don't want to add all those warnings. Thanks, jon