Skip to contentSkip to conversation

migration-guides: Add start of 3.4 guide with override migration notes

PATCH Superseded Michael Opdenacker 2 participants 6 messages Jul 30, 2021 3 messages not in the archive

v2 of 3 Superseded Latest is v3 →

lore
Share & tools
lore

A message that is not in the archive (sent off-list or not yet received): [email protected]

#1 lore raw

PATCH v2 1/1 migration-guides: Add start of 3.4 guide with override migration notes

From: Richard Purdie <[email protected]>

---
 documentation/migration-guides/index.rst      |  1 +
 .../migration-guides/migration-3.4.rst        | 72 +++++++++++++++++++
 2 files changed, 73 insertions(+)
 create mode 100644 documentation/migration-guides/migration-3.4.rst
documentation/migration-guides/index.rst +1 -0
index 6304e6318c..287b553195 100644
@@ -12,6 +12,7 @@ to move to one release of the Yocto Project from the previous one.
 .. toctree::
 
    migration-general
+   migration-3.4
    migration-3.3
    migration-3.2
    migration-3.1
documentation/migration-guides/migration-3.4.rst new file +72 -0

72 lines not on this page · raw message

Signature · 1 line
2.25.1
#2 lore raw

PATCH v2 1/1 migration-guides: Add start of 3.4 guide with override migration notes

In reply to a message not in the archive

From: Richard Purdie <[email protected]>

---
 documentation/migration-guides/index.rst      |  1 +
 .../migration-guides/migration-3.4.rst        | 74 +++++++++++++++++++
 2 files changed, 75 insertions(+)
 create mode 100644 documentation/migration-guides/migration-3.4.rst
documentation/migration-guides/index.rst +1 -0
index 6304e6318c..287b553195 100644
@@ -12,6 +12,7 @@ to move to one release of the Yocto Project from the previous one.
 .. toctree::
 
    migration-general
+   migration-3.4
    migration-3.3
    migration-3.2
    migration-3.1
documentation/migration-guides/migration-3.4.rst new file +74 -0

74 lines not on this page · raw message

Signature · 1 line
2.25.1
Reviewed-by on v2 1/1
#3 lore raw

Hi Michael,

Quoted 4 lines · Michael Opdenacker

From: Richard Purdie <[email protected]>

Please don't add my Reviewed-by if I haven't given it :)

Quoted 59 lines
---
 documentation/migration-guides/index.rst      |  1 +
 .../migration-guides/migration-3.4.rst        | 74 +++++++++++++++++++
 2 files changed, 75 insertions(+)
 create mode 100644 documentation/migration-guides/migration-3.4.rst
documentation/migration-guides/index.rst +1 -0
index 6304e6318c..287b553195 100644
@@ -12,6 +12,7 @@ to move to one release of the Yocto Project from the previous one.
 .. toctree::
 
    migration-general
+   migration-3.4
    migration-3.3
    migration-3.2
    migration-3.1
documentation/migration-guides/migration-3.4.rst new file +34 -0
new file mode 100644
index 0000000000..4aa5271724
@@ -0,0 +1,74 @@
+Release 3.4 (honister)
+======================
+
+This section provides migration information for moving to the Yocto
+Project 3.4 Release (codename "honister") from the prior release.
+
+Override syntax changes
+-----------------------
+
+This release requires changes to the metadata to indicate where overrides are
+being used in variable key names. This is done with the ``:`` character replacing
+the use of ``_`` previously. This means that an entry like::
+
+   SRC_URI_qemux86 = "file://somefile"
+
+becomes::
+
+   SRC_URI:qemux86 = "file://somefile"
+
+since ``qemux86`` is an override. This applies to any use of override syntax so::
+
+   SRC_URI_append = " file://somefile"
+   SRC_URI_append_qemux86 = " file://somefile2"
+   SRC_URI_remove_qemux86-64 = " file://somefile3"
+   SRC_URI_prepend_qemuarm = "file://somefile4 "
+   FILES_${PN}-ptest = "${bindir}/xyz"
+   IMAGE_CMD_tar = "tar"
+   BASE_LIB_tune-cortexa76 = "lib"
+   SRCREV_pn-bash = "abc"
+   BB_TASK_NICE_LEVEL_task-testimage = '0'
+
+becomes::
+
+   SRC_URI:append = " file://somefile"

documentation/migration-guides/migration-3.4.rst line 44

Quoted 10 lines
documentation/migration-guides/migration-3.4.rst new file +10 -0
+   SRC_URI:append:qemux86 = " file://somefile2"
+   SRC_URI:remove:qemux86-64 = " file://somefile3"
+   SRC_URI:prepend:qemuarm = "file://somefile4 "
+   FILES:${PN}-ptest = "${bindir}/xyz"
+   IMAGE_CMD:tar = "tar"
+   BASE_LIB:tune-cortexa76 = "lib"
+   SRCREV:pn-bash = "abc"
+   BB_TASK_NICE_LEVEL:task-testimage = '0'
+
+This also applies to variable queries to the datastore, for example using getVar

getVar to be tick quoted?

Maybe we can link to:
https://docs.yoctoproject.org/bitbake/bitbake-user-manual/bitbake-user-manual-metadata.html?functions-for-accessing-datastore-variables
for the various queries to the datastore?

Thanks!

documentation/migration-guides/migration-3.4.rst line 46

Quoted 2 lines
documentation/migration-guides/migration-3.4.rst new file +2 -0
+and similar so ``d.getVar("RDEPENDS_${PN}")`` becomes ``d.getVar("RDEPENDS:${PN}")``.
+

Just something that popped up in my mind but we should be careful when updating the docs to use : instead of _ since I seem to recall that we have some ``RDEPENDS_*`` or similar that we could actually replace by :term:RDEPENDS now :)

I've yet to read the udpated documentation (if there's something available somewhere already?) and check a bit what's handled by the script done by Richard :)

Cheers,
Quentin

#4 lore raw

Hi Quentin,

Quoted 8 lines · Quentin Schulz

Hi Michael,

Quoted 4 lines · Michael Opdenacker

From: Richard Purdie <[email protected]>

Please don't add my Reviewed-by if I haven't given it :)

Oops, my apologies!

Quoted 5 lines

getVar to be tick quoted?

Maybe we can link to:
https://docs.yoctoproject.org/bitbake/bitbake-user-manual/bitbake-user-manual-metadata.html?functions-for-accessing-datastore-variables
for the various queries to the datastore?

Both done! I'm posting a V3 now.
Thanks,
Michael.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

A message that is not in the archive (sent off-list or not yet received): [email protected]

#6 lore raw

Forget about this one, this is still the V1 version.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

A message that is not in the archive (sent off-list or not yet received): [email protected]

#8 lore raw
Quoted 5 lines · Michael Opdenacker

From: Richard Purdie <[email protected]>

For further review, you can also check the generated HTML code on
https://docs.yoctoproject.org/next/migration-guides/migration-3.4.html
Michael.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com