Jonathan Corbet <corbet@xxxxxxx> 于2021年5月14日周五 上午12:20写道: > > Yanteng Si <siyanteng@xxxxxxxxxxx> 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. OK! I will remove them and then direct the reader to the original document. But the patch 1/3 has too many kernel-doc directives, In order to give the reader a good reading experience, I decided to remove it.~>_<~ Thanks, Yanteng > > Thanks, > > jon