From 70126f4f51011a66c09cab5b1ce8dc8859765779 Mon Sep 17 00:00:00 2001 From: Michael Opdenacker Date: Tue, 13 Dec 2022 09:57:04 +0100 Subject: manuals: prepare 4.2 migration notes (From yocto-docs rev: 9276628507233aef554450c807d8456a0eb00225) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie --- .../0001-manuals-prepare-4.2-migration-notes.patch | 134 +++++++++++++++++++++ documentation/migration-guides/index.rst | 1 + documentation/migration-guides/migration-4.2.rst | 48 ++++++++ documentation/migration-guides/release-4.2.rst | 9 ++ .../migration-guides/release-notes-4.2.rst | 28 +++++ 5 files changed, 220 insertions(+) create mode 100644 documentation/0001-manuals-prepare-4.2-migration-notes.patch 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 diff --git a/documentation/0001-manuals-prepare-4.2-migration-notes.patch b/documentation/0001-manuals-prepare-4.2-migration-notes.patch new file mode 100644 index 0000000000..9c8f9d74b5 --- /dev/null +++ b/documentation/0001-manuals-prepare-4.2-migration-notes.patch @@ -0,0 +1,134 @@ +From 42a8aad2c8b52b1cfbc6c580c689d3c9a7056485 Mon Sep 17 00:00:00 2001 +From: Michael Opdenacker +Date: Tue, 13 Dec 2022 09:57:04 +0100 +Subject: [PATCH] manuals: prepare 4.2 migration notes + +Signed-off-by: Michael Opdenacker +--- + 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 + +diff --git a/documentation/migration-guides/index.rst b/documentation/migration-guides/index.rst +index ce0ca8c659..6f7bcbef29 100644 +--- a/documentation/migration-guides/index.rst ++++ b/documentation/migration-guides/index.rst +@@ -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 +diff --git a/documentation/migration-guides/migration-4.2.rst b/documentation/migration-guides/migration-4.2.rst +new file mode 100644 +index 0000000000..944ad31a4c +--- /dev/null ++++ b/documentation/migration-guides/migration-4.2.rst +@@ -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: ++ +diff --git a/documentation/migration-guides/release-4.2.rst b/documentation/migration-guides/release-4.2.rst +new file mode 100644 +index 0000000000..ae52d939c8 +--- /dev/null ++++ b/documentation/migration-guides/release-4.2.rst +@@ -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 +diff --git a/documentation/migration-guides/release-notes-4.2.rst b/documentation/migration-guides/release-notes-4.2.rst +new file mode 100644 +index 0000000000..f3d69d98cc +--- /dev/null ++++ b/documentation/migration-guides/release-notes-4.2.rst +@@ -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: ++ +-- +2.37.2 + diff --git a/documentation/migration-guides/index.rst b/documentation/migration-guides/index.rst index ce0ca8c659..6f7bcbef29 100644 --- a/documentation/migration-guides/index.rst +++ b/documentation/migration-guides/index.rst @@ -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 diff --git a/documentation/migration-guides/migration-4.2.rst b/documentation/migration-guides/migration-4.2.rst new file mode 100644 index 0000000000..944ad31a4c --- /dev/null +++ b/documentation/migration-guides/migration-4.2.rst @@ -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: + diff --git a/documentation/migration-guides/release-4.2.rst b/documentation/migration-guides/release-4.2.rst new file mode 100644 index 0000000000..ae52d939c8 --- /dev/null +++ b/documentation/migration-guides/release-4.2.rst @@ -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 diff --git a/documentation/migration-guides/release-notes-4.2.rst b/documentation/migration-guides/release-notes-4.2.rst new file mode 100644 index 0000000000..690a228f7b --- /dev/null +++ b/documentation/migration-guides/release-notes-4.2.rst @@ -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 is the minimum Python version required on the build host. + For host distributions 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: + -- cgit v1.2.3-54-g00ecf