Re: [PATCH] Document flexible arrays

From: David Rientjes
Date: Wed Sep 09 2009 - 15:26:25 EST


On Wed, 9 Sep 2009, Jonathan Corbet wrote:

> > Hmm, there are a number of changes in -mm that conflict with the
> > description given in this document (element poisoning, DEFINE_FLEX_ARRAY,
> > array shrinking, etc). Perhaps this could be based on the -mm behavior
> > and get pushed through Andrew so that it's consistent when merged for
> > 2.6.32?
>
> I've seen those patches going by. The problem is that documenting
> existing, in-mainline APIs is challenging enough; trying to document
> maybe-next-release versions is a recipe for frustration. So I'd really
> rather start with a document that describes the current state of the
> art; I promise I'll update it when the other changes go in.
>

If you're going to push it yourself, I guess that's fine. But if it's
going through -mm, I don't think it would be helpful for the documentation
to be inconsistent with the library in that kernel. I'll probably be
forced to update it myself when the changes are merged by Linus.
--
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/