Re: [bitbake-devel] [docs] [PATCH] bitbake: doc: bitbake-user-manual: Add more explanations to OVERRIDES

[Simon Eugster <simon.eu@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 2551 bytes --]

I submitted a patch for only the OVERRIDE part now. (The in-reply-to did
not seem to have an effect – sorry for that!)

I can submit that part as separate patch and I'm happy to re-phrase or
change it in other ways.

+.. note::
+
+   Before Honister (3.4), override style used ``_`` instead of ``:``, so
you will
+   still find a lot of documentation using “_append”, “_prepend”, and
+   “_remove”.

Simon

On Tue, Mar 1, 2022 at 2:33 PM Richard Purdie <
richard.purdie@linuxfoundation.org> wrote:

> On Tue, 2022-03-01 at 09:33 +0100, Michael Opdenacker via
> lists.openembedded.org
> wrote:
> > Hi Simon,
> >
> > On 2/28/22 10:31, Simon A. Eugster wrote:
> > >
> > > On Wed, Jan 5, 2022 at 5:02 PM Michael Opdenacker
> > > <michael.opdenacker@bootlin.com> wrote:
> > >
> > >     Hi Simon,
> > >
> > >     Thanks for your answers...
> > >
> > >     On 1/5/22 11:11 AM, Simon Eugster wrote:
> > >     > Hi Michael,
> > >     >
> > >     >     >
> > >     >     > +.. note::
> > >     >     > +
> > >     >     > +   Before Honister (3.4), override style used ``_``
> > >     instead of
> > >     >     ``:``, so you will
> > >     >     > +   still find a lot of documentation using “_append”,
> > >     >     “_prepend”, and
> > >     >     > +   “_remove”.
> > >     >     > +
> > >     >
> > >     >
> > >     >     I don't have anything about this text, but I wonder whether
> > >     we should
> > >     >     mention the old syntax in the current docs.
> > >     >     Thoughts anyone?
> > >     >
> > >     >
> > >     > I added this because I (as a new user) found it very confusing
> > >     to find
> > >     > all the _ style syntax in guides online and no mention of it in
> the
> > >     > docs. I would have expected such a note.
> > >
> > >
> > >     This makes sense, but so far we just mentioned the old syntax in
> the
> > >     migration guides. That's why I was asking for other opinions...
> > >
> > >
> > > Looks like there are no other opinions on that topic.
> > > In that case, do you want me to continue with the MR and apply your
> > > suggestions, or discard the MR?
> >
> >
> > Well, I'd rather drop the note about the overrides syntax change, but
> > I'm still interested in the rest of the patch.
>
> Since you asked for opinions, I think some mention of this in the overrides
> section of the bitbake manual would be a good idea since it was such a
> fundamental change?
>
> Cheers,
>
> Richard
>
>
>
>
>
>

[-- Attachment #2: Type: text/html, Size: 3730 bytes --]