yanteng si [off-list ref] 于2021年5月14日周五 下午5:24写道：

Jonathan Corbet [off-list ref] 于2021年5月14日周五 上午12:20写道：

quoted

Yanteng Si [off-list ref] writes:

quoted

* 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.~>_<~

I decided not to remove this patch(1/3) because it was needed to guide
the reader, and the new translation looks good.


Thanks,

Yanteng