From b207ad6344d565cfa844aa047223e13a4b5120dc Mon Sep 17 00:00:00 2001
From: Emil Velikov <emil.velikov@collabora.com>
Date: Mon, 2 Oct 2023 17:31:36 +0100
Subject: [PATCH] man: document LoaderConfigConsoleMode

The variable was introduced with systemd v250 although it went
completely undocumented, even though sd-boot will honour and print it
separately (from the loader.conf one) in the boot help screen.

Document it in the systemd-boot and hint about it in loader.conf manual
pages.

Signed-off-by: Emil Velikov <emil.velikov@collabora.com>
---
 man/loader.conf.xml  | 9 ++++++---
 man/systemd-boot.xml | 9 +++++++++
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/man/loader.conf.xml b/man/loader.conf.xml
index 9592f48247..c7794cd195 100644
--- a/man/loader.conf.xml
+++ b/man/loader.conf.xml
@@ -142,9 +142,12 @@
       <varlistentry>
         <term>console-mode</term>
 
-        <listitem><para>This option configures the resolution of the console. Takes a
-        number or one of the special values listed below. The following values may be
-        used:</para>
+        <listitem><para>This option configures the resolution of the console. This may be changed in
+        the boot menu itself and will be stored as an EFI variable in that case, overriding this
+        option.</para>
+
+        <para>Takes a number or one of the special values listed below. The following
+        values may be used:</para>
 
         <variablelist>
           <varlistentry>
diff --git a/man/systemd-boot.xml b/man/systemd-boot.xml
index def2d06cf1..67208806f9 100644
--- a/man/systemd-boot.xml
+++ b/man/systemd-boot.xml
@@ -416,6 +416,15 @@
         <xi:include href="version-info.xml" xpointer="v240"/></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><varname>LoaderConfigConsoleMode</varname></term>
+        <listitem><para>The numerical menu console mode. Read by the boot loader. <varname>LoaderConfigConsoleMode</varname>
+        is maintained persistently. <varname>LoaderConfigConsoleMode</varname> may be manipulated with the
+        <keycap>r</keycap>/<keycap>R</keycap> keys, see above.</para>
+
+        <xi:include href="version-info.xml" xpointer="v250"/></listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><varname>LoaderDevicePartUUID</varname></term>
 
-- 
2.25.1