Re: [docs] [bitbake-devel] [PATCH] doc: bitbake-user-manual: fix syntax in example and improve description

["Richard Purdie" <richard.purdie@linuxfoundation.org>]

On Fri, 2021-07-23 at 10:35 +0200, Michael Opdenacker wrote:
> Hi Richard,
> 
> On 7/23/21 12:14 AM, Richard Purdie wrote:
> > I should probably highlight there is a new command, "bitbake-getvar":
> > 
> > http://git.yoctoproject.org/cgit.cgi/poky/commit/?id=7bbeddeee1992d8c8fb71ba2dd49b03d0ae1ce86
> > 
> > We probably want to document that.
> 
> 
> Sure, this sounds like a very good idea indeed. I'll take care of that.

Thanks.

> > Whilst I'm thinking about it, the override discussions on the architecture list
> > are going to have implications for documentation too.
> > 
> > http://git.yoctoproject.org/cgit.cgi/poky/commit/?id=75fad23fc06c008a03414a1fc288a8614c6af9ca
> 
> 
> Of course! I was wondering when we are supposed to start updating the
> documentation. Probably right now, indeed, right?

I think we need to get final approval on what we're converting on the
openembedded-architecture list, then we can start.

> > An example of my scripted conversion run against the manuals is included
> > in this commit:
> > 
> > http://git.yoctoproject.org/cgit.cgi/poky-contrib/diff/documentation/ref-manual/variables.rst?h=rpurdie/overrides-convert&id=9ac22a64a4c0ac4640552e90674e6459f0fece9a
> 
> Where can I find the script (or commands) that you used to modify the
> documentation?

It was done with a script in the same tree:

http://git.yoctoproject.org/cgit.cgi/poky-contrib/commit/?h=rpurdie/overrides-convert&id=f7c5c3bbb9bc5d4c4c8f798d64a020a4504542df

Not pretty or efficient but does roughly what we need. I'm still working on it
with some build tests on master-next to see how close this is to working.

The main issue is the script doesn't spot some manual/docs specific example 
overrides.

Cheers,

Richard