summaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2019-07-21 12:32:17 +0200
committerLennart Poettering <lennart@poettering.net>2019-07-22 06:58:07 +0200
commit03909b1e23833a4c08818a16f26e60e19517f06c (patch)
tree611f29733e0eda2368f11fd2343a1917a9a5fb9a /man
parentMerge pull request #13096 from keszybz/unit-loading (diff)
downloadsystemd-03909b1e23833a4c08818a16f26e60e19517f06c.tar.xz
systemd-03909b1e23833a4c08818a16f26e60e19517f06c.zip
man: describe $LESS options more fully
https://bugzilla.redhat.com/show_bug.cgi?id=1655316
Diffstat (limited to 'man')
-rw-r--r--man/less-variables.xml35
1 files changed, 30 insertions, 5 deletions
diff --git a/man/less-variables.xml b/man/less-variables.xml
index c80534b960..38cb18be2e 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'>