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

From: Rob Landley
Date: Wed Aug 07 2013 - 03:32:42 EST

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...)

To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at
Please read the FAQ at