From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Sun, 21 Jul 2019 10:32:17 +0000 (+0200)
Subject: man: describe $LESS options more fully
X-Git-Tag: v243-rc1~76
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=03909b1e23833a4c08818a16f26e60e19517f06c;p=thirdparty%2Fsystemd.git

man: describe $LESS options more fully

https://bugzilla.redhat.com/show_bug.cgi?id=1655316
---

diff --git a/man/less-variables.xml b/man/less-variables.xml
index c80534b9609..38cb18be2e8 100644
--- a/man/less-variables.xml
+++ b/man/less-variables.xml
@@ -25,11 +25,36 @@
       <listitem><para>Override the options passed to <command>less</command> (by default
       <literal>FRSXMK</literal>).</para>
 
-      <para>If the value of <varname>$SYSTEMD_LESS</varname> does not include <literal>K</literal>,
-      and the pager that is invoked is <command>less</command>,
-      <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> will be ignored by the
-      executable.  This allows <command>less</command> to handle
-      <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> itself.</para></listitem>
+      <para>Users might want to change two options in particular:</para>
+
+      <variablelist class='environment-variables'>
+        <varlistentry>
+          <term><option>K</option></term>
+
+          <para>This option instructs the pager to exit immediately when
+          <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> is pressed. To allow
+          <command>less</command> to handle <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>
+          itself to switch back to the pager command prompt, unset this option.</para>
+
+          <para>If the value of <varname>$SYSTEMD_LESS</varname> does not include <literal>K</literal>,
+          and the pager that is invoked is <command>less</command>,
+          <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> will be ignored by the
+          executable, and needs to be handled by the pager.</para>
+        </varlistentry>
+
+        <varlistentry>
+          <term><option>X</option></term>
+
+          <para>This option instructs the pager to not send termcap initialization and deinitialization
+          strings to the terminal. It is set by default to allow command output to remain visible in the
+          terminal even after the pager exits. Nevertheless, this prevents some pager functionality from
+          working, in particular paged output cannot be scrolled with the mouse.</para>
+        </varlistentry>
+      </variablelist>
+
+      <para>See
+      <citerefentry project='man-pages'><refentrytitle>less</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+      for more discussion.</para></listitem>
     </varlistentry>
 
     <varlistentry id='lesscharset'>