migration-guides: Add start of 3.4 guide with override migration notes
A message that is not in the archive (sent off-list or not yet received): [email protected]
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
@@ -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
PATCH v2 1/1 migration-guides: Add start of 3.4 guide with override migration notes
In reply to a message not in the archiveFrom: 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
@@ -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
Hi Michael,
Quoted 4 lines · Michael Opdenacker
From: Richard Purdie <[email protected]>
Signed-off-by Richard Purdie <[email protected]>Reviewed-by Quentin Schulz <[email protected]>
Please don't add my Reviewed-by if I haven't given it :)
Quoted 59 lines
Reviewed-by Michael Opdenacker <[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.rstdocumentation/migration-guides/index.rst +1
-0@@ -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.1documentation/migration-guides/migration-3.4.rst new file +34
-0@@ -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
Hi Quentin,
Quoted 8 lines · Quentin Schulz
Hi Michael,
Quoted 4 lines · Michael Opdenacker
From: Richard Purdie <[email protected]>
Signed-off-by Richard Purdie <[email protected]>Reviewed-by Quentin Schulz <[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]
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]
Quoted 5 lines · Michael Opdenacker
From: Richard Purdie <[email protected]>
Signed-off-by Richard Purdie <[email protected]>Reviewed-by Quentin Schulz <[email protected]>Reviewed-by Michael Opdenacker <[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