manuals: prepare 4.2 migration notes

(From yocto-docs rev: 9276628507233aef554450c807d8456a0eb00225)

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

5 files changed, 220 insertions, 0 deletions

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 <michael.opdenacker@bootlin.com>
+Date: Tue, 13 Dec 2022 09:57:04 +0100
+Subject: [PATCH] manuals: prepare 4.2 migration notes
+
+Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
+---
+ 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:
+