gentoo auto-resync : 29:01:2024 - 12:57:49

1 files changed, 35 insertions, 9 deletions

diff --git a/metadata/news/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt b/metadata/news/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt
index aaf78844c550..f36618032ae1 100644
--- a/metadata/news/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt
+++ b/metadata/news/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt
@@ -1,15 +1,18 @@
 Title: Merging of installkernel-gentoo and installkernel-systemd
 Author: Andrew Ammerlaan <andrewammerlaan@gentoo.org>
 Posted: 2024-01-18
-Revision: 2
+Revision: 5
 News-Item-Format: 2.0
 Display-If-Installed: sys-kernel/installkernel
 Display-If-Installed: sys-kernel/installkernel-gentoo
 Display-If-Installed: sys-kernel/installkernel-systemd
 Display-If-Installed: sys-kernel/installkernel-systemd-boot
 
-The functionalities of sys-kernel/installkernel-gentoo and
-sys-kernel/installkernel-systemd have been merged into sys-kernel/installkernel.
+/sbin/installkernel is a script called by the kernels 'make install' as well
+as by the distribution kernels post install phase. It was previously provided
+by sys-kernel/installkernel-gentoo or sys-kernel/installkernel-systemd. The
+functionalities of these two packages have now been merged into
+sys-kernel/installkernel.
 
 sys-kernel/installkernel now provides the systemd USE flag to switch between
 the traditional installkernel (formerly sys-kernel/installkernel-gentoo) and
@@ -30,13 +33,19 @@ User Action Required (GRUB users)
 Previously sys-kernel/installkernel-gentoo provided kernel installation
 automation for users of GRUB via USE=grub. The new sys-kernel/installkernel
 provides the same functionality, which now works with both the traditional
-installkernel and systemd's kernel-install. In principle no user action is
-required unless users wish to explicitly choose either the traditional
+installkernel and systemd's kernel-install.
+
+Users of GRUB should therefore:
+- check that the "grub" USE flag is enabled
+to ensure that systemd's kernel-install uses the correct layout that
+grub-mkconfig understands.
+
+Users of GRUB may wish to explicitly choose either the traditional
 installkernel or systemd's kernel-install, in which case they may do so
 via USE=-/+systemd.
 
 sys-kernel/installkernel is renamed from sys-kernel/installkernel-gentoo,
-therefore no user action is required to upgrade.
+therefore no user action is required to upgrade to the new package.
 
 
 User Action Required (systemd-boot users)
@@ -44,14 +53,21 @@ User Action Required (systemd-boot users)
 
 Previously sys-kernel/installkernel-systemd provided kernel installation
 automation for users of systemd-boot. sys-kernel/installkernel provides
-the same functionality but only via systemd's kernel-install. Users
-of systemd-boot should therefore ensure that the "systemd" USE flag is enabled
+the same functionality but only via systemd's kernel-install.
+
+Users of systemd-boot should therefore:
+- ensure that the "systemd" USE flag is enabled
 when upgrading to >=sys-kernel/installkernel-14.
 
 Users who are using the distribution kernels (i.e. gentoo-kernel(-bin)) should
 enable the "dracut" USE flag on installkernel as well to pull in and enable
 the dracut initramfs generator. This is enforced by portage.
 
+Note that the automagic behaviour of the dracut kernel-install plugin is
+removed in sys-kernel/installkernel. Users who rely on the dracut plugin
+automatically generating an initramfs when installing the kernel must
+enable the "dracut" USE flag to retain this behaviour.
+
 The upgrade path is enforced by sys-kernel/installkernel-systemd-4, which is
 just a wrapper pulling in >=sys-kernel/installkernel-14 with the "systemd" flag
 enabled. sys-kernel/installkernel-systemd may be removed after installing
@@ -69,6 +85,16 @@ plugins should either ensure that the same kernel installation method will be
 used after upgrading to >=sys-kernel/installkernel-14 (via USE=+/-systemd) or
 migrate these custom plugins (details are on the wiki [1]).
 
+Users of bootloaders other than GRUB or systemd-boot may want to retain the
+traditional /boot layout. They may do so by either:
+- disabling the "systemd" USE flag, or
+- when the "systemd" USE flag is enabled, enabling the "grub" USE flag as well.
+- when the "systemd" USE flag is enabled, setting "layout=grub" in
+/etc/kernel/install.conf
 
-[1] https://wiki.gentoo.org/wiki/Installkernel
+Users who wish to use EFI stub booting may be interested in building an
+Unified Kernel Image[2] by enabling the "ukify" and "uki" USE flags. This will
+automatically install a bootable EFI executable to the EFI system partition.
 
+[1] https://wiki.gentoo.org/wiki/Installkernel
+[2] https://wiki.gentoo.org/wiki/Unified_kernel_image