[U-Boot] Quick guide to Kconfig

[Ian Campbell]

On Mon, 2014-08-04 at 17:35 +0200, Hans de Goede wrote:
> Hi,
> 
> On 08/04/2014 04:27 PM, Tom Rini wrote:
> > On Fri, Aug 01, 2014 at 01:37:54PM +0900, Masahiro Yamada wrote:
> > 
> > [snip]
> >> We had multiple entries in boards.cfg per board
> >> (with some differences in the options field)
> >> and I generated the correspoing defconfig files.
> >>
> >> But I guess it would be painful to maintain lots of defconfigs.
> >>
> >> I expect board maintainers will consolidate defconfigs like you are
> >> trying to do, and eventually, we will have one defconfig per board in
> >> the future.
> > 
> > So I was thinking about this a bit this morning since I have lots of
> > defconfigs I want to merge together as well (see am335x_evm*).  I
> > suspect the answer is board maintainers will want a README in their
> > directory.  But today we're inconsistent in a few places.  First, it's
> > most often board/.../README but we have a few README.somethings (I'm
> > guilty there too.  And despite 702e601 we have some board-level (I'd
> > consider at least) details in docs/ still.
> > 
> > Would board/sunxi/README work for the sunxi cases?  Or is that going to
> > get too unwieldy?
> 
> board/sunxi/README will work fine for sunxi documentation as far as I
> can see right now.

A bunch of the sort of thing I imaging would be there probably ought
instead to go into Kconfig help sections for the symbols which they are
documenting.

Ian.