Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-04 Thread Chen Gang
On 09/04/2013 05:38 PM, Chen Gang wrote: > On 09/04/2013 05:27 PM, Geert Uytterhoeven wrote: >> On Wed, Sep 4, 2013 at 11:13 AM, Chen Gang wrote: > Hmm... why we need "uapi/linux/" ? (I can not find some related > documents, so I have to 'guess'). The "uapi" subdirectories are t

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-04 Thread Chen Gang
On 09/04/2013 05:27 PM, Geert Uytterhoeven wrote: > On Wed, Sep 4, 2013 at 11:13 AM, Chen Gang wrote: Hmm... why we need "uapi/linux/" ? (I can not find some related documents, so I have to 'guess'). >>> >>> The "uapi" subdirectories are there to distinguish userspace headers from >>> k

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-04 Thread Geert Uytterhoeven
On Wed, Sep 4, 2013 at 11:13 AM, Chen Gang wrote: >>> Hmm... why we need "uapi/linux/" ? (I can not find some related >>> documents, so I have to 'guess'). >> >> The "uapi" subdirectories are there to distinguish userspace headers from >> kernelspace headers, and allow both to live in the kernel

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-04 Thread Chen Gang
On 09/04/2013 05:02 PM, Geert Uytterhoeven wrote: > On Wed, Sep 4, 2013 at 10:09 AM, Chen Gang wrote: >> On 09/04/2013 03:02 PM, Geert Uytterhoeven wrote: >>> On Wed, Sep 4, 2013 at 3:08 AM, Chen Gang wrote: On 09/04/2013 12:41 AM, Geert Uytterhoeven wrote: > On Tue, Aug 6, 2013 at 3:46

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-04 Thread Geert Uytterhoeven
On Wed, Sep 4, 2013 at 10:09 AM, Chen Gang wrote: > On 09/04/2013 03:02 PM, Geert Uytterhoeven wrote: >> On Wed, Sep 4, 2013 at 3:08 AM, Chen Gang wrote: >>> On 09/04/2013 12:41 AM, Geert Uytterhoeven wrote: On Tue, Aug 6, 2013 at 3:46 AM, Chen Gang wrote: > --- a/include/uapi/Kbuild >>

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-04 Thread Chen Gang
On 09/04/2013 03:02 PM, Geert Uytterhoeven wrote: > On Wed, Sep 4, 2013 at 3:08 AM, Chen Gang wrote: >> On 09/04/2013 12:41 AM, Geert Uytterhoeven wrote: >>> On Tue, Aug 6, 2013 at 3:46 AM, Chen Gang wrote: --- a/include/uapi/Kbuild +++ b/include/uapi/Kbuild @@ -1,7 +1,6 @@ #

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-04 Thread Geert Uytterhoeven
On Wed, Sep 4, 2013 at 3:08 AM, Chen Gang wrote: > On 09/04/2013 12:41 AM, Geert Uytterhoeven wrote: >> On Tue, Aug 6, 2013 at 3:46 AM, Chen Gang wrote: >>> --- a/include/uapi/Kbuild >>> +++ b/include/uapi/Kbuild >>> @@ -1,7 +1,6 @@ >>> # UAPI Header export list >>> -# Top-level Makefile calls i

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-03 Thread Chen Gang
On 09/04/2013 12:41 AM, Geert Uytterhoeven wrote: > On Tue, Aug 6, 2013 at 3:46 AM, Chen Gang wrote: >> --- a/include/uapi/Kbuild >> +++ b/include/uapi/Kbuild >> @@ -1,7 +1,6 @@ >> # UAPI Header export list >> -# Top-level Makefile calls into asm-$(ARCH) >> -# List only non-arch directories below

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-03 Thread Geert Uytterhoeven
On Tue, Aug 6, 2013 at 3:46 AM, Chen Gang wrote: > --- a/include/uapi/Kbuild > +++ b/include/uapi/Kbuild > @@ -1,7 +1,6 @@ > # UAPI Header export list > -# Top-level Makefile calls into asm-$(ARCH) > -# List only non-arch directories below > - > +# Except "linux/", UAPI means Universal API. Sorr

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-09-02 Thread Chen Gang
Hello Maintainers: Maybe... I still miss some important mail addresses? or this patch is not suitable for applying? Hmm... but I still want to try the last time: "please help check this patch, when you have time". And next, I should not send additional tracing mail again, that will be really spa

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-08-23 Thread Chen Gang
Hello Maintainers: Is this patch suitable for applying ? Does it belong to 'trivial' (or 'Documentation', or others) ? And sorry for my original missing some important mail addresses when I sent the original patch (I got them by "./scripts/get_maintainers", and not give more considerations for

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-08-21 Thread Chen Gang
Hello all: According to the reply of yours, it seems we need more 'work' for the API related documents. If really it is, I need change my 'work' way for it. Currently, my 'work' way is "finding and solving issues", which may be efficient for 'grow up' sub-systems (e.g. "kernel/" sub-system). Bu

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-08-07 Thread Chen Gang
Hello Rob: Maybe I misunderstand what you said (if so, I am sorry for it). At least for me, what you said is valuable to get additional discussion, but it seems better to start a new thread for it and also cc to linux-doc mail list. If so better include me in cc list, thanks. ;-) If you think

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-08-07 Thread Chen Gang
On 08/07/2013 03:32 PM, Rob Landley wrote: > On 08/06/2013 12:31:43 PM, Joe Perches wrote: >> On Tue, 2013-08-06 at 09:46 +0800, Chen Gang wrote: >> > "include/uapi/" is the whole Linux kernel API, it is important enough >> > to get more global explanations by comments. >> >> It'd probably be usefu

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-08-07 Thread Rob Landley
On 08/06/2013 12:31:43 PM, Joe Perches wrote: On Tue, 2013-08-06 at 09:46 +0800, Chen Gang wrote: > "include/uapi/" is the whole Linux kernel API, it is important enough > to get more global explanations by comments. It'd probably be useful to have more descriptions of uapi in the Documentati

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-08-06 Thread Chen Gang
On 08/07/2013 01:31 AM, Joe Perches wrote: > On Tue, 2013-08-06 at 09:46 +0800, Chen Gang wrote: >> "include/uapi/" is the whole Linux kernel API, it is important enough >> to get more global explanations by comments. > > It'd probably be useful to have more descriptions > of uapi in the Documenta

Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-08-06 Thread Joe Perches
On Tue, 2013-08-06 at 09:46 +0800, Chen Gang wrote: > "include/uapi/" is the whole Linux kernel API, it is important enough > to get more global explanations by comments. It'd probably be useful to have more descriptions of uapi in the Documentation directory too. -- To unsubscribe from this lis

[PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

2013-08-05 Thread Chen Gang
"include/uapi/" is the whole Linux kernel API, it is important enough to get more global explanations by comments. In "include/uapi/Kbuild", "Makefile..." and "non-arch..." comments are meaningless for current 'Kbuild', so delete them. And add more explanations for "include/uapi/" in "include/uap