From: Emil Velikov <emil.velikov@collabora.com>
Date: Mon, 2 Oct 2023 16:31:36 +0000 (+0100)
Subject: man: document LoaderConfigConsoleMode
X-Git-Tag: v255-rc1~316^2~1
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=b207ad6344d565cfa844aa047223e13a4b5120dc;p=thirdparty%2Fsystemd.git

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>
---

diff --git a/man/loader.conf.xml b/man/loader.conf.xml
index 9592f482474..c7794cd195f 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 def2d06cf16..67208806f97 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>