[oe] Variable reference (was: Documentation update about machine conf files)

[Holger Hans Peter Freyther]

On Friday 21 August 2009 08:11:50 Steffen Sledz wrote:
> [start new thread because of the more common subject]
>
> >> I would be really happy about an index of all variables usable in the
> >> recipes together with a desciption or a reference to it. I would
> >> prefer such an index in the wiki, but manual or documentation.conf
> >> would be fine too.
> >
> > Something like that you mean?
> >
> > http://pokylinux.org/doc/poky-handbook.html#ref-variables-glossary
>
> Yes.
>
> Would be nice if it is not a glossary only but contains additional info
> (e.g. exact usage, restrictions, dependencies, examples). This may be
> realized by references to an own (wiki) page for each variable which needs
> more than a one liner.
>
> What's the community opinion? Should we start such an index in the wiki?

Long time ago, I created conf/documentation.conf. For every variable back then 
we have used VAR[doc] = "Documentation" to describe the semantic of this 
variable. A utility like bitdoc spit out a HTML page...

I would like to see this updated.

z.