Re: [PATCH v3] docs/zh_CN: add core-api workqueue.rst translation

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

 



Alex Shi <seakeel@xxxxxxxxx> 于2021年5月14日周五 下午6:40写道:
>
>
>
> On 2021/5/14 下午5:47, yanteng si wrote:
> > Alex Shi <seakeel@xxxxxxxxx> 于2021年5月14日周五 下午5:30写道:
> >>
> >>
> >>
> >> On 2021/5/14 下午5:09, yanteng si wrote:
> >>> Alex Shi <seakeel@xxxxxxxxx> 于2021年5月14日周五 下午12:53写道:
> >>>>
> >>>>
> >>>>
> >>>> On 2021/5/14 上午12:18, Jonathan Corbet wrote:
> >>>>>>> This patch translates Documentation/core-api/workqueue.rst into Chinese.
> >>>>>>>
> >>>>>>>
> >>>>>>> Signed-off-by: Yanteng Si <siyanteng@xxxxxxxxxxx>
> >>>>>>> Reviewed-by: Alex Shi <alexs@xxxxxxxxxx>
> >>>>>> I fixed that typo too - it appears to originate from Alex...:)
> >>>>
> >>>> Sorry for the typo.
> >>>>
> >>>>> Actually, I've dropped this back out; it creates vast numbers of
> >>>>> warnings:
> >>>>>
> >>>>>> Documentation/core-api/workqueue:398: ./include/linux/workqueue.h:3: WARNING: Duplicate C declaration, also
> >>>>>> defined at translations/zh_CN/core-api/workqueue:3.
> >>>>> This will be the result of the ".. kernel-doc::" directives at the end,
> >>>>> which create new definitions (within sphinx) for all the symbols pulled
> >>>>> in.
> >>>>>
> >>>>> In the long term, we may want to try to find some sort of fix for this.
> >>>>> But we're really just recreating a bunch of (English-language)
> >>>>> documentation that's already rendered once; I'm not sure it makes any
> >>>>> real sense to do that.  So I would suggest that, for now, when you are
> >>>>> translating documents with kernel-doc directives, you should leave those
> >>>>> directives out.  Stick in a note directing readers to the original if
> >>>>> they want to see that material...
> >>>>>
> >>>>> Make sense?
> >>>>
> >>>> Yes, it is a reasonable solution for now.
> >>> OK, I will.
> >>> I will remove them and then direct the reader to the original
> >>> document. just like:
> >>>
> >>> .. note:: 抱歉,由于原始文档在此处交叉引用了代码中的注释,而现在并不是翻译这些注释的好时机(将会带来很多编译警告),所以请暂时浏览英文文档,链接在本文档顶部。
> >>
> >> Jon said just remove kernel-doc, not all line? If so, don't need above explanation.
> > just like:
> >
> >  +列表管理函数
> >  +============
> >  +
> > -+.. kernel-doc:: include/linux/list.h
> > + include/linux/list.h
>
> I prefer sth like in this line, does this look fine?
>
>   + check the functions in include/linux/list.h in kernel source code.
Yes, it's fine!

Thanks,
Yanteng
>
> >  +   :internal:
> >  +
> >  +基本的C库函数
> >  +=============
> >> _< ?
> >
> > 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