Start of 4.3 migration guide docs

Start of 4.3 migration guide docs

[Richard Purdie]

As mentioned on the weekly tech call, we need to get better about
documenting changes for the migration guide and release notes as we go
along. Whilst we're not far into 4.3, I realise I made or merged
changes already which will need notes. Since we don't have a guide yet,
let me note them here on the basis Michael will inject them into a new
doc.


* The '-crosssdk' suffix and any MLPREFIX were removed from virtual/XXX
provider/dependencies where a PREFIX was used as well as we don't need
both and it made automated dependency rewriting unnecessarily complex.
In general this only affects internal toolchain dependencies so isn't
end user visible.

* runtime testing of ptest now fails if no test results are returned by
any given ptest.

* the bitbake cooker log now contains notes when the caches are
invalidated which is useful for memory resident bitbake debugging.

* glide was dropped as "go mod" has become the standard


Cheers,

Richard

Re: [docs] Start of 4.3 migration guide docs

[Michael Opdenacker]

Hi Richard,

On 03.05.23 at 16:55, Richard Purdie wrote:
> As mentioned on the weekly tech call, we need to get better about
> documenting changes for the migration guide and release notes as we go
> along. Whilst we're not far into 4.3, I realise I made or merged
> changes already which will need notes. Since we don't have a guide yet,
> let me note them here on the basis Michael will inject them into a new
> doc.
>
>
> * The '-crosssdk' suffix and any MLPREFIX were removed from virtual/XXX
> provider/dependencies where a PREFIX was used as well as we don't need
> both and it made automated dependency rewriting unnecessarily complex.
> In general this only affects internal toolchain dependencies so isn't
> end user visible.
>
> * runtime testing of ptest now fails if no test results are returned by
> any given ptest.
>
> * the bitbake cooker log now contains notes when the caches are
> invalidated which is useful for memory resident bitbake debugging.
>
> * glide was dropped as "go mod" has become the standard


That's a great start, thanks!

I was waiting for the release to made before creating the new pages, to 
make it easier to merge last minute changes into the "mickledore" branch.

Thanks again
Cheers
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] Start of 4.3 migration guide docs

[Richard Purdie]

On Wed, 2023-05-03 at 17:30 +0200, Michael Opdenacker wrote:
> Hi Richard,
> 
> On 03.05.23 at 16:55, Richard Purdie wrote:
> > As mentioned on the weekly tech call, we need to get better about
> > documenting changes for the migration guide and release notes as we go
> > along. Whilst we're not far into 4.3, I realise I made or merged
> > changes already which will need notes. Since we don't have a guide yet,
> > let me note them here on the basis Michael will inject them into a new
> > doc.
> > 
> > 
> > * The '-crosssdk' suffix and any MLPREFIX were removed from virtual/XXX
> > provider/dependencies where a PREFIX was used as well as we don't need
> > both and it made automated dependency rewriting unnecessarily complex.
> > In general this only affects internal toolchain dependencies so isn't
> > end user visible.
> > 
> > * runtime testing of ptest now fails if no test results are returned by
> > any given ptest.
> > 
> > * the bitbake cooker log now contains notes when the caches are
> > invalidated which is useful for memory resident bitbake debugging.
> > 
> > * glide was dropped as "go mod" has become the standard
> 
> 
> That's a great start, thanks!
> 
> I was waiting for the release to made before creating the new pages, to 
> make it easier to merge last minute changes into the "mickledore" branch.

At this point I think we can diverge things.

Cheers,

Richard

[PATCH] migration-guides: start of 4.3 migration and release notes

[michael.opdenacker]

From: Michael Opdenacker <michael.opdenacker@bootlin.com>

From notes from Richard Purdie

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
CC: richard.purdie@linuxfoundation.org
---
 documentation/migration-guides/index.rst      |  1 +
 .../migration-guides/migration-4.3.rst        | 73 +++++++++++++++++++
 .../migration-guides/release-4.3.rst          |  9 +++
 .../migration-guides/release-notes-4.3.rst    | 55 ++++++++++++++
 4 files changed, 138 insertions(+)
 create mode 100644 documentation/migration-guides/migration-4.3.rst
 create mode 100644 documentation/migration-guides/release-4.3.rst
 create mode 100644 documentation/migration-guides/release-notes-4.3.rst

diff --git a/documentation/migration-guides/index.rst b/documentation/migration-guides/index.rst
index 6f7bcbef29..a3bddb3f1e 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.3
    release-4.2
    release-4.1
    release-4.0
diff --git a/documentation/migration-guides/migration-4.3.rst b/documentation/migration-guides/migration-4.3.rst
new file mode 100644
index 0000000000..914012ce69
--- /dev/null
+++ b/documentation/migration-guides/migration-4.3.rst
@@ -0,0 +1,73 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+Release 4.3 (nanbield)
+========================
+
+Migration notes for 4.3 (nanbield)
+------------------------------------
+
+This section provides migration information for moving to the Yocto
+Project 4.3 Release (codename "nanbield") from the prior release.
+
+.. _migration-4.3-supported-distributions:
+
+Supported distributions
+~~~~~~~~~~~~~~~~~~~~~~~
+
+This release supports running BitBake on new GNU/Linux distributions:
+
+On the other hand, some earlier distributions are no longer supported:
+
+See :ref:`all supported distributions <system-requirements-supported-distros>`.
+
+.. _migration-4.3-go-changes:
+
+Go language changes
+~~~~~~~~~~~~~~~~~~~
+
+-  Support for the Glide package manager has been removed, as ``go mod``
+   has become the standard.
+  
+.. _migration-4.3-recipe-changes:
+
+Recipe changes
+~~~~~~~~~~~~~~
+
+-  Runtime testing of ptest now fails if no test results are returned by
+   any given ptest.
+
+.. _migration-4.3-removed-variables:
+
+Removed variables
+~~~~~~~~~~~~~~~~~
+
+The following variables have been removed:
+
+.. _migration-4.3-removed-recipes:
+
+Removed recipes
+~~~~~~~~~~~~~~~
+
+The following recipes have been removed in this release:
+
+-  ``glide``, as explained in :ref:`migration-4.3-go-changes`.
+
+.. _migration-4.3-removed-classes:
+
+Removed classes
+~~~~~~~~~~~~~~~
+
+The following classes have been removed in this release:
+
+
+.. _migration-4.3-misc-changes:
+
+Miscellaneous changes
+~~~~~~~~~~~~~~~~~~~~~
+
+-  The ``-crosssdk`` suffix and any :term:`MLPREFIX` were removed from
+   ``virtual/XXX`` provider/dependencies where a ``PREFIX`` was used as well,
+   as we don't need both and it made automated dependency rewriting
+   unnecessarily complex. In general this only affects internal toolchain
+   dependencies so isn't end user visible.
+
diff --git a/documentation/migration-guides/release-4.3.rst b/documentation/migration-guides/release-4.3.rst
new file mode 100644
index 0000000000..92516ae8f5
--- /dev/null
+++ b/documentation/migration-guides/release-4.3.rst
@@ -0,0 +1,9 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+Release 4.3 (nanbield)
+========================
+
+.. toctree::
+
+   migration-4.3
+   release-notes-4.3
diff --git a/documentation/migration-guides/release-notes-4.3.rst b/documentation/migration-guides/release-notes-4.3.rst
new file mode 100644
index 0000000000..16320d3db2
--- /dev/null
+++ b/documentation/migration-guides/release-notes-4.3.rst
@@ -0,0 +1,55 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+Release notes for 4.3 (nandbield)
+----------------------------------
+
+New Features / Enhancements in 4.3
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+-  Linux kernel 6.x, glibc 2.xx and ~xxx other recipe upgrades
+
+-  New variables:
+
+-  Architecture-specific enhancements:
+
+-  Kernel-related enhancements:
+
+-  New core recipes:
+
+-  QEMU/runqemu enhancements:
+
+-  Image-related enhancements:
+
+-  wic Image Creator enhancements:
+
+-  SDK-related improvements:
+
+-  Testing:
+
+-  Utility script changes:
+
+-  BitBake improvements:
+
+   -  The BitBake Cooker log now contains notes when the caches are
+      invalidated which is useful for memory resident bitbake debugging.
+
+-  Packaging changes:
+
+-  Miscellaneous changes:
+
+Known Issues in 4.3
+~~~~~~~~~~~~~~~~~~~
+
+Recipe License changes in 4.3
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following corrections have been made to the :term:`LICENSE` values set by recipes:
+
+Security Fixes in 4.3
+~~~~~~~~~~~~~~~~~~~~~
+
+Recipe Upgrades in 4.3
+~~~~~~~~~~~~~~~~~~~~~~
+
+Contributors to 4.3
+~~~~~~~~~~~~~~~~~~~
-- 
2.34.1