diff options
| author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2019-07-21 12:32:17 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2019-07-22 06:58:07 +0200 |
| commit | 03909b1e23833a4c08818a16f26e60e19517f06c (patch) | |
| tree | 611f29733e0eda2368f11fd2343a1917a9a5fb9a | |
| parent | a505166845f9806ac87389821474b6aa16cd0d9d (diff) | |
| download | systemd-03909b1e23833a4c08818a16f26e60e19517f06c.tar.gz | |
man: describe $LESS options more fully
https://bugzilla.redhat.com/show_bug.cgi?id=1655316
| -rw-r--r-- | man/less-variables.xml | 35 |
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'> |