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]

 



yanteng si <siyanteng01@xxxxxxxxx> 于2021年5月14日周五 下午5:24写道:

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




[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