On Mon, Jun 04, 2012 at 07:08:43PM +0200, Linus Walleij wrote:

> I read some drivers/base/regmap code and I think I understand this stuff
> now, but seriously, it's quite hard to see the forest with all these trees,
> and regmap is actually one of the finest new things in recent kernels,
> so can could we create
> Documentation/driver-model/regmap.txt?

Of course, someone can!

> I think this document is needed... I would write it myself if I felt I
> understood the regmap overall concepts well enough, but I'm
> certain to get something wrong.

Well, there's one sure fire way to make sure you've got a good
understanding :)

More seriously I'm not sure I could readily tell what's non-obvious and
worth writing a document about.  Personally I always just read the
commit logs for Linux stuff, they're some of the best documentation I've
ever seen for software.