summaryrefslogtreecommitdiff
path: root/poky/documentation
diff options
context:
space:
mode:
Diffstat (limited to 'poky/documentation')
-rw-r--r--poky/documentation/dev-manual/init-manager.rst49
-rw-r--r--poky/documentation/migration-guides/release-notes-4.2.rst48
-rw-r--r--poky/documentation/poky.yaml.in12
-rw-r--r--poky/documentation/ref-manual/system-requirements.rst2
-rw-r--r--poky/documentation/ref-manual/variables.rst5
-rwxr-xr-xpoky/documentation/set_versions.py6
6 files changed, 70 insertions, 52 deletions
diff --git a/poky/documentation/dev-manual/init-manager.rst b/poky/documentation/dev-manual/init-manager.rst
index fd8747b9b0..b96e011ebf 100644
--- a/poky/documentation/dev-manual/init-manager.rst
+++ b/poky/documentation/dev-manual/init-manager.rst
@@ -111,3 +111,52 @@ configuration file::
Doing so will prevent ``rsyslog`` / ``busybox-syslog`` from being pulled in by
default, leaving only ``systemd-journald``.
+Summary
+-------
+
+The Yocto Project supports three different initialization managers, offering
+increasing levels of complexity and functionality:
+
+.. list-table::
+ :widths: 40 20 20 20
+ :header-rows: 1
+
+ * -
+ - BusyBox init
+ - SysVinit
+ - systemd
+ * - Size
+ - Small
+ - Small
+ - Big [#footnote-systemd-size]_
+ * - Complexity
+ - Small
+ - Medium
+ - High
+ * - Support for boot profiles
+ - No
+ - Yes ("runlevels")
+ - Yes ("targets")
+ * - Services defined as
+ - Shell scripts
+ - Shell scripts
+ - Description files
+ * - Starting services in parallel
+ - No
+ - No
+ - Yes
+ * - Setting service resource limits
+ - No
+ - No
+ - Yes
+ * - Support service isolation
+ - No
+ - No
+ - Yes
+ * - Integrated logging
+ - No
+ - No
+ - Yes
+
+.. [#footnote-systemd-size] Using systemd increases the ``core-image-minimal``
+ image size by 160\% for ``qemux86-64`` on Mickledore (4.2), compared to SysVinit.
diff --git a/poky/documentation/migration-guides/release-notes-4.2.rst b/poky/documentation/migration-guides/release-notes-4.2.rst
index 30a4afeebb..473ea984c3 100644
--- a/poky/documentation/migration-guides/release-notes-4.2.rst
+++ b/poky/documentation/migration-guides/release-notes-4.2.rst
@@ -8,37 +8,34 @@ New Features / Enhancements in 4.2
- Linux kernel 6.1, glibc 2.37 and ~350 other recipe upgrades
-- Python 3.8 is the minimum Python version required on the build host.
+- Python 3.8+ and GCC 8.0+ are now the minimum required versions on the build host.
For host distributions that do not provide it, this is included as part of the
:term:`buildtools` tarball.
- BitBake in this release now supports a new ``addpylib`` directive to enable
- Python libraries within layers.
+ Python libraries within layers. For more information,
+ see :ref:`bitbake-user-manual/bitbake-user-manual-metadata:extending python library code`.
This directive should be added to your layer configuration
as in the below example from ``meta/conf/layer.conf``::
addpylib ${LAYERDIR}/lib oe
-- BitBake has seen multiple internal changes that may impact
+- BitBake has seen multiple internal changes that may improve
memory and disk usage as well as parsing time, in particular:
- BitBake's Cooker server is now multithreaded.
+ - Ctrl+C can now be used to interrupt some long-running operations
+ that previously ignored it.
+
- BitBake's cache has been extended to include more hash
debugging data, but has also been optimized to :yocto_git:`compress
cache data <https://git.yoctoproject.org/poky/commit/?h=mickledore&id=7d010055e2af3294e17db862f42664ca689a9356>`.
- - BitBake's Cooker server :yocto_git:`can now be pinged
- </poky/commit/?h=mickledore&id=26f255da09>`
- from the UI.
-
-- Architecture-specific enhancements:
-
- - This release adds initial support for the
- :wikipedia:`LoongArch <Loongson#LoongArch>`
- (``loongarch64``) architecture, though there is no testing for it yet.
-
+ - BitBake's UI will now ping the server regularly to ensure
+ it is still alive.
+
- New variables:
- :term:`VOLATILE_TMP_DIR` allows to specify
@@ -71,27 +68,6 @@ New Features / Enhancements in 4.2
- Use built-in Rust targets for ``-native`` builds to save several
minutes building the Rust toolchain
-- Python 3.8+ and GCC 8.0+ are now the minimum required versions on the build host
-
-- BitBake in this release now supports a new ``addpylib`` directive to enable
- Python libraries within layers. For more information,
- see :ref:`bitbake-user-manual/bitbake-user-manual-metadata:extending python library code`.
-
-- BitBake has seen multiple internal changes that may improve
- memory and disk usage as well as parsing time, in particular:
-
- - BitBake's Cooker server is now multithreaded.
-
- - Ctrl+C can now be used to interrupt some long-running operations
- that previously ignored it.
-
- - BitBake's cache has been extended to include more hash
- debugging data, but has also been optimized to :yocto_git:`compress
- cache data <https://git.yoctoproject.org/poky/commit/?h=mickledore&id=7d010055e2af3294e17db862f42664ca689a9356>`.
-
- - BitBake's UI will now ping the server regularly to ensure
- it is still alive.
-
- Architecture-specific enhancements:
- This release adds initial support for the
@@ -227,7 +203,6 @@ New Features / Enhancements in 4.2
- ``base-passwd``
- ``cronie``
- ``cups``
- - ``cups``
- ``curl``
- ``file``
- ``gstreamer1.0-plugins-good``
@@ -310,9 +285,6 @@ New Features / Enhancements in 4.2
- Many packages were updated to add large file support.
- - New :term:`VOLATILE_TMP_DIR` variable allows to specify whether ``/tmp``
- should be on persistent storage or in RAM.
-
- ``vulkan-loader``: allow headless targets to build the loader
- ``dhcpcd``: fix to work with systemd
- ``u-boot``: add /boot to :term:`SYSROOT_DIRS` to allow boot files to be used by other recipes
diff --git a/poky/documentation/poky.yaml.in b/poky/documentation/poky.yaml.in
index 1c072c1d05..b2b6a6330f 100644
--- a/poky/documentation/poky.yaml.in
+++ b/poky/documentation/poky.yaml.in
@@ -1,10 +1,10 @@
-DISTRO : "4.1"
-DISTRO_NAME_NO_CAP : "langdale"
-DISTRO_NAME : "Langdale"
-DISTRO_NAME_NO_CAP_MINUS_ONE : "kirkstone"
+DISTRO : "4.2"
+DISTRO_NAME_NO_CAP : "mickledore"
+DISTRO_NAME : "Mickledore"
+DISTRO_NAME_NO_CAP_MINUS_ONE : "langdale"
DISTRO_NAME_NO_CAP_LTS : "kirkstone"
-YOCTO_DOC_VERSION : "4.1"
-DISTRO_REL_TAG : "yocto-4.1"
+YOCTO_DOC_VERSION : "4.2"
+DISTRO_REL_TAG : "yocto-4.2"
DOCCONF_VERSION : "dev"
BITBAKE_SERIES : ""
YOCTO_DL_URL : "https://downloads.yoctoproject.org"
diff --git a/poky/documentation/ref-manual/system-requirements.rst b/poky/documentation/ref-manual/system-requirements.rst
index fd4a8afb5d..91ed6d8d6d 100644
--- a/poky/documentation/ref-manual/system-requirements.rst
+++ b/poky/documentation/ref-manual/system-requirements.rst
@@ -182,7 +182,7 @@ AlmaLinux Packages
Here are the packages needed to build an image on a headless system
with a supported AlmaLinux distribution::
- $ sudo dnf install &ALMALINUX8_HOST_PACKAGES_ESSENTIAL;
+ $ sudo dnf install &ALMALINUX_HOST_PACKAGES_ESSENTIAL;
.. note::
diff --git a/poky/documentation/ref-manual/variables.rst b/poky/documentation/ref-manual/variables.rst
index 4dc67a1324..574af2c2f9 100644
--- a/poky/documentation/ref-manual/variables.rst
+++ b/poky/documentation/ref-manual/variables.rst
@@ -3962,7 +3962,6 @@ system and gives an overview of their function and contents.
- ``sysvinit``
- ``systemd``
- ``mdev-busybox``
- - ``none``
With ``sysvinit``, the init manager is set to
:wikipedia:`SysVinit <Init#SysV-style>`, the traditional UNIX init
@@ -3977,10 +3976,6 @@ system and gives an overview of their function and contents.
and lightest solution, and probably the best choice for low-end systems
with a rather slow CPU and a limited amount of RAM.
- With ``none``, the init manager is also set to ``sysvinit``. This is the
- default setting in OpenEmbedded-Core. This option also selects the
- :wikipedia:`udev <Udev>` device manager.
-
More concretely, this is used to include
``conf/distro/include/init-manager-${INIT_MANAGER}.inc`` into the global
configuration. You can have a look at the
diff --git a/poky/documentation/set_versions.py b/poky/documentation/set_versions.py
index efaebe43b5..354dabe618 100755
--- a/poky/documentation/set_versions.py
+++ b/poky/documentation/set_versions.py
@@ -26,8 +26,8 @@ ourversion = None
if len(sys.argv) == 2:
ourversion = sys.argv[1]
-activereleases = ["langdale", "kirkstone", "dunfell"]
-devbranch = "mickledore"
+activereleases = ["mickledore", "kirkstone", "dunfell"]
+devbranch = "nanbield"
ltsseries = ["kirkstone", "dunfell"]
# used by run-docs-builds to get the default page
@@ -36,6 +36,7 @@ if ourversion == "getlatest":
sys.exit(0)
release_series = collections.OrderedDict()
+release_series["nanbield"] = "4.3"
release_series["mickledore"] = "4.2"
release_series["langdale"] = "4.1"
release_series["kirkstone"] = "4.0"
@@ -66,6 +67,7 @@ release_series["laverne"] = "0.9"
bitbake_mapping = {
+ "nanbield" : "2.6",
"mickledore" : "2.4",
"langdale" : "2.2",
"kirkstone" : "2.0",