2024-01-18-installkernel-merge: further clarifications

- explicitly mention rEFInd
- put instructions for UKI under its own header
- update for new layout=compat so instructions here are again on the same page
with the instructions in the next news item about the introduction of
USE=systemd-boot.

https://forums.gentoo.org/viewtopic-t-1167432-highlight-installkernel.html

Signed-off-by: Andrew Ammerlaan <andrewammerlaan@gentoo.org>

1 files changed, 43 insertions, 10 deletions

diff --git a/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt b/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt
index 96ff934..5af1ad1 100644
--- a/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt
+++ b/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt
@@ -1,7 +1,7 @@
 Title: Merging of installkernel-gentoo and installkernel-systemd
 Author: Andrew Ammerlaan <andrewammerlaan@gentoo.org>
 Posted: 2024-01-18
-Revision: 6
+Revision: 7
 News-Item-Format: 2.0
 Display-If-Installed: sys-kernel/installkernel
 Display-If-Installed: sys-kernel/installkernel-gentoo
@@ -77,6 +77,31 @@ emerge --noreplace sys-kernel/installkernel
 emerge --depclean sys-kernel/installkernel-systemd
 
 
+User Action Required (rEFInd users)
+====================
+
+Previously sys-kernel/installkernel-gentoo provided kernel installation
+automation for users of rEFInd. The new sys-kernel/installkernel provides the
+same functionality, which now works with both the traditional installkernel and
+systemd's kernel-install.
+
+Users of rEFInd should:
+- ensure that the "systemd-boot" and "grub" USE flags are NOT enabled when
+upgrading to >=sys-kernel/installkernel-20.
+
+Additionally, users of rEFInd may want to
+- enable the "refind" USE flag to
+install an icon file alongside the installed kernel image which rEFInd will
+pick up at runtime.
+
+Users of rEFInd 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 further user action is required to upgrade to the new package.
+
+
 User Action Required (users of other bootloaders and custom scripts)
 ====================
 
@@ -85,16 +110,24 @@ 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
+Users of bootloaders other than GRUB, systemd-boot or refind may want to retain
+the traditional /boot layout. They may do so by:
+- ensuring that the "systemd-boot", "grub" and "refind" USE flags are disabled.
+
+
+Optional: Unified Kernel Images (all users)
+====================
+
+Users who wish to use Unified Kernel Images[2] (e.g. for EFI stub booting) may
+do so by
+- enabling the "ukify" and "uki" USE flags.
+Which will automatically install a bootable EFI executable to the EFI system
+partition.
+
+The UEFI firmware, as well as, Systemd-boot, GRUB and rEFInd are capable of
+loading Unified Kernel Images. For more details see the wiki page on Unified
+Kernel Images[2]
 
-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