On Tue, 01 Jun 2010 21:39:10 +0100 Jonathan Cameron <kernel@xxxxxxxxxxxxxxxxxxxxx> wrote: > > > > It would be most useful if the changelog were to fully describe the > > proposed kernel<->userspace interface. That's the most important part > > of the driver, because it's the only part we can never change. > > > > There is a desultory effort to maintain sysfs API descriptions under > > Documentation/ABI/. I'd have thought that it would be appropriate to > > document this driver's ABI in there. > Agreed, but we get back to the debate of what we should standardise on. I'd suggest standardising on one of the existing drivers. That way we have two compliant drivers and only need to change (n-2) others. If we pick some new standard then we need to change (n) drivers. And we can't change the drivers, really. They'd all end up needing to provide two interfaces: one for the shiny-new-standard and one legacy. > The main point of ALS before it died was exactly putting this standardization > in place (admittedly the interface was slightly different from what we > are proposing in IIO, but that was before Greg pointed out that sharing > with hwmon would be a good idea!) > > I have to admit I'm a little loath to spend too much time on this given > the amount of time wasted previously (ALS). Well, it's not a waste. This is very important! We appear to be making a big mess which we can never fix up. -- To unsubscribe from this list: send the line "unsubscribe linux-omap" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html