Re: [PATCH v5 0/3] docs/zh_CN add three core api docs

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux