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 majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
