Thread (142 messages) 142 messages, 28 authors, 2013-08-14

DT bindings as ABI [was: Do we have people interested in device tree janitoring / cleanup?]

From: Russell King - ARM Linux <hidden>
Date: 2013-07-25 23:20:48
Also in: lkml

On Thu, Jul 25, 2013 at 03:31:35PM -0400, Jason Cooper wrote:
On Thu, Jul 25, 2013 at 02:11:31PM -0500, Rob Herring wrote:
quoted
On Thu, Jul 25, 2013 at 11:09 AM, Olof Johansson [off-list ref] wrote:
quoted
quoted
One problem that needs to be solved is obviously how a binding
graduates from tentative to locked. This work isn't going to be very
interesting to most people, I suspect. Think standards committee type
work.
I think a time based stabilization period would be better than a
separate directory to apply bindings too. Or time plus periodic review
perhaps.
The only problem with a time-based versus separate directory is how do
users who've downloaded the tree determine which bindings are stable?
If they pull a tarball, or receive an SDK, there is most likely no git
history attached.

I think the idea of a 'tentative' directory (or 'locked') is churnish,
but necessary.  If I DL'd a tarball and had to type 'tentative' to get
to the binding doc I wanted, that would be a pretty clear clue to be
delicate about how I trust/use/plan with that binding.
It's actually extremely simple.  If the bindings are in development,
they must not appear in a -final released kernel.  Anything that appears
in a -final kernel becomes part of the ABI at that point.

That obviously does not mean you remove them in the last -rc and put
them back during the merge window!

That's how we handle every other ABI thing in the kernel tree, why should
DT files be any different?  (I've added Linus and Grant to this discussion.)

As I've already stated, it is intended to eventually remove the DT files
from the kernel tree and have them as a separately maintained project,
which means they will be independent of the kernel version.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help