From 35f58f8c36f9fe27c07ed4d35a4effcad504cdb3 Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Mon, 6 Nov 2023 12:03:03 +0100
Subject: [PATCH] man: document /usr/lib/modules/ paths as recommend copy
 source for kernel-install

---
 man/kernel-install.xml | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/man/kernel-install.xml b/man/kernel-install.xml
index 0223b561f1..ee8c0069df 100644
--- a/man/kernel-install.xml
+++ b/man/kernel-install.xml
@@ -674,6 +674,31 @@
           <xi:include href="version-info.xml" xpointer="v255"/>
         </listitem>
       </varlistentry>
+
+      <varlistentry>
+        <term><filename>/usr/lib/modules/<replaceable>KERNEL-VERSION/</replaceable></filename></term>
+
+        <listitem>
+          <para>Location for installed kernel modules and other kernel related resources. For each locally
+          installed kernel a directory named after the kernel version (<command>uname -r</command>) is
+          kept.</para>
+
+          <xi:include href="version-info.xml" xpointer="v255"/>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><filename>/usr/lib/modules/<replaceable>KERNEL-VERSION/vmlinuz</replaceable></filename></term>
+
+        <listitem>
+          <para>Location for installed kernel images. This is the recommended location for OS package
+          managers to install kernel images into (as applicable), from which <command>kernel-install
+          add</command> then copies it into the final boot partition.</para>
+
+          <xi:include href="version-info.xml" xpointer="v255"/>
+        </listitem>
+      </varlistentry>
+
     </variablelist>
 
     <para>For various cases listed above, if the <varname>$KERNEL_INSTALL_CONF_ROOT</varname> environment
-- 
2.25.1