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

[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 Documentation directory too.

I'd rather have comments in the headers that get exported to userspace  
and then have other forms of documentation generated from that by some  
process similar to "make htmldocs". Otherwise you've got two places to  
keep in sync.

(Really the guy you've got to keep in the loop about this is Michael  
Kerrisk. The section 2 man pages are the current best reference on UAPI  
stuff...)

Rob--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/