Skip to contentSkip to conversation

manuals: prepare 4.2 migration notes

PATCH In review [email protected] 2 participants 3 messages Dec 16, 2022

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 manuals: prepare 4.2 migration notes

From: Michael Opdenacker <[email protected]>

---
 documentation/migration-guides/index.rst      |  1 +
 .../migration-guides/migration-4.2.rst        | 48 +++++++++++++++++++
 .../migration-guides/release-4.2.rst          |  9 ++++
 .../migration-guides/release-notes-4.2.rst    | 28 +++++++++++
 4 files changed, 86 insertions(+)
 create mode 100644 documentation/migration-guides/migration-4.2.rst
 create mode 100644 documentation/migration-guides/release-4.2.rst
 create mode 100644 documentation/migration-guides/release-notes-4.2.rst
documentation/migration-guides/index.rst +1 -0
index ce0ca8c659..6f7bcbef29 100644
@@ -12,6 +12,7 @@ to move to one release of the Yocto Project from the previous one.
 .. toctree::
 
    migration-general
+   release-4.2
    release-4.1
    release-4.0
    release-3.4
documentation/migration-guides/migration-4.2.rst new file +48 -0

48 lines not on this page · raw message

documentation/migration-guides/release-4.2.rst new file +9 -0
new file mode 100644
index 0000000000..ae52d939c8
@@ -0,0 +1,9 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+Release 4.2 (mickledore)
+========================
+
+.. toctree::
+
+   migration-4.2
+   release-notes-4.2
documentation/migration-guides/release-notes-4.2.rst new file +28 -0
new file mode 100644
index 0000000000..f3d69d98cc
@@ -0,0 +1,28 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+Release notes for 4.2 (mickledore)
+---------------------------------
+
+New Features / Enhancements in 4.2
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- Python 3.8 s the minimum Python version required on the build host.
+  For host distros that do not provide it, this is included as part of the
+  :term:`buildtools` tarball.
+
+- This release now supports a new ``addpylib`` directive to enable
+  Python libraries within layers.
+
+  This directive should be added to your layer configuration,
+  as in the below example from ``meta/conf/layer.conf``::
+
+     addpylib ${LAYERDIR}/lib oe
+
+-  Architecture-specific enhancements:
+
+-  Kernel-related enhancements:
+
+-  QEMU/runqemu enhancements:
+
+-  Image-related enhancements:
+
Signature · 1 line
2.37.2
#1 lore raw

Hi Michael,

Quoted 100 lines · Michael Opdenacker via lists.yoctoproject.org

From: Michael Opdenacker <[email protected]>

---
  documentation/migration-guides/index.rst      |  1 +
  .../migration-guides/migration-4.2.rst        | 48 +++++++++++++++++++
  .../migration-guides/release-4.2.rst          |  9 ++++
  .../migration-guides/release-notes-4.2.rst    | 28 +++++++++++
  4 files changed, 86 insertions(+)

create mode 100644 documentation/migration-guides/migration-4.2.rst create mode 100644 documentation/migration-guides/release-4.2.rst create mode 100644 documentation/migration-guides/release-notes-4.2.rst

documentation/migration-guides/index.rst +1 -0
index ce0ca8c659..6f7bcbef29 100644
@@ -12,6 +12,7 @@ to move to one release of the Yocto Project from the previous one.
  .. toctree::
 
     migration-general
+   release-4.2
     release-4.1
     release-4.0
     release-3.4
documentation/migration-guides/migration-4.2.rst new file +48 -0
new file mode 100644
index 0000000000..944ad31a4c
@@ -0,0 +1,48 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+Release 4.2 (mickledore)
+========================
+
+Migration notes for 4.2 (mickledore)
+------------------------------------
+
+This section provides migration information for moving to the Yocto
+Project 4.2 Release (codename "mickledore") from the prior release.
+
+.. _migration-4.2-python-3.8:
+
+Python 3.8 is now the minimum required Python version version
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~------------
+
+BitBake and OpenEmbedded-Core are now relying on Python 3.8,
+making it a requirement to use a distribution providing at least this
+version, or to use :term:`buildtools`.
+
+.. _migration-4.2-qa-checks:
+
+QA check changes
+~~~~~~~~~~~~~~~~
+
+.. _migration-4.2-misc-changes:
+
+Miscellaneous changes
+~~~~~~~~~~~~~~~~~~~~~
+
+- The ``OEBasic`` signature handler (see :term:`BB_SIGNATURE_HANDLER`) has been
+  removed.
+
+.. _migration-4.2-removed-variables:
+
+Removed variables
+~~~~~~~~~~~~~~~~~
+
+The following variables have been removed:
+- ``SERIAL_CONSOLE``, deprecated since version 2.6, replaced by :term:``SERIAL_CONSOLES``.
+
+.. _migration-4.2-removed-recipes:
+
+Removed recipes
+~~~~~~~~~~~~~~~
+
+The following recipes have been removed in this release:
+
documentation/migration-guides/release-4.2.rst new file +9 -0
new file mode 100644
index 0000000000..ae52d939c8
@@ -0,0 +1,9 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+Release 4.2 (mickledore)
+========================
+
+.. toctree::
+
+   migration-4.2
+   release-notes-4.2
documentation/migration-guides/release-notes-4.2.rst new file +0 -0
new file mode 100644
index 0000000000..f3d69d98cc

documentation/migration-guides/release-notes-4.2.rst line 9

Quoted 9 lines
documentation/migration-guides/release-notes-4.2.rst new file +9 -0
@@ -0,0 +1,28 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+Release notes for 4.2 (mickledore)
+---------------------------------
+
+New Features / Enhancements in 4.2
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- Python 3.8 s the minimum Python version required on the build host.

s/s/is/

documentation/migration-guides/release-notes-4.2.rst line 10

Quoted 1 line
documentation/migration-guides/release-notes-4.2.rst new file +1 -0
+  For host distros that do not provide it, this is included as part of the

s/distros/distributions/

documentation/migration-guides/release-notes-4.2.rst line 15

Quoted 5 lines
documentation/migration-guides/release-notes-4.2.rst new file +5 -0
+  :term:`buildtools` tarball.
+
+- This release now supports a new ``addpylib`` directive to enable
+  Python libraries within layers.
+

I think it's worth saying a few more words here if we don't already have some explanations elsewhere in the docs.

When should I use this?

IIRC, it's when you want to use some function in some configuration file (where one cannot define functions?) or put things in common in recipes without using a class to define this new function. Is there another usecase I haven't thought about?

Anyways, this can be improved over time :)

Cheers,
Quentin

#2 lore raw

Hi Quentin,

Thanks for the review!

Am 16.12.22 um 11:27 schrieb Quentin Schulz via lists.yoctoproject.org:

Quoted 15 lines

documentation/migration-guides/release-notes-4.2.rst line 9

Quoted 12 lines

+++ b/documentation/migration-guides/release-notes-4.2.rst

documentation/migration-guides/release-notes-4.2.rst new file +9 -0
@@ -0,0 +1,28 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+Release notes for 4.2 (mickledore)
+---------------------------------
+
+New Features / Enhancements in 4.2
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+- Python 3.8 s the minimum Python version required on the build host.

s/s/is/

Quoted 4 lines
Quoted 2 lines
(quoted diff) +1 -0
+  For host distros that do not provide it, this is included as part 

of the

s/distros/distributions/

Fixed.

Quoted 9 lines

documentation/migration-guides/release-notes-4.2.rst line 15

Quoted 6 lines

+  :term:buildtools tarball.

documentation/migration-guides/release-notes-4.2.rst new file +4 -0
+
+- This release now supports a new ``addpylib`` directive to enable
+  Python libraries within layers.
+

I think it's worth saying a few more words here if we don't already have some explanations elsewhere in the docs.

Quoted 5 lines

When should I use this?

IIRC, it's when you want to use some function in some configuration file (where one cannot define functions?) or put things in common in recipes without using a class to define this new function. Is there another usecase I haven't thought about?

Anyways, this can be improved over time :)

Sure, this was just a placeholder and I hope people would provide more details. Indeed, this should also be added to the documentation.

Thanks again,

Cheers
Michael.

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