|
91 | 91 |
|
92 | 92 | <varlistentry id='pager'> |
93 | 93 | <term><varname>$SYSTEMD_PAGER</varname></term> |
| 94 | + <term><varname>$PAGER</varname></term> |
94 | 95 |
|
95 | | - <listitem><para>Pager to use when <option>--no-pager</option> is not given; overrides |
96 | | - <varname>$PAGER</varname>. If neither <varname>$SYSTEMD_PAGER</varname> nor <varname>$PAGER</varname> are set, a |
97 | | - set of well-known pager implementations are tried in turn, including |
98 | | - <citerefentry project='man-pages'><refentrytitle>less</refentrytitle><manvolnum>1</manvolnum></citerefentry> and |
99 | | - <citerefentry project='man-pages'><refentrytitle>more</refentrytitle><manvolnum>1</manvolnum></citerefentry>, until one is found. If |
100 | | - no pager implementation is discovered no pager is invoked. Setting this environment variable to an empty string |
101 | | - or the value <literal>cat</literal> is equivalent to passing <option>--no-pager</option>.</para> |
| 96 | + <listitem><para>Pager to use when <option>--no-pager</option> is not given. |
| 97 | + <varname>$SYSTEMD_PAGER</varname> is used if set; otherwise <varname>$PAGER</varname> is used. |
| 98 | + If neither <varname>$SYSTEMD_PAGER</varname> nor <varname>$PAGER</varname> are set, a set of well-known |
| 99 | + pager implementations is tried in turn, including |
| 100 | + <citerefentry project='man-pages'><refentrytitle>less</refentrytitle><manvolnum>1</manvolnum></citerefentry> |
| 101 | + and |
| 102 | + <citerefentry project='man-pages'><refentrytitle>more</refentrytitle><manvolnum>1</manvolnum></citerefentry>, |
| 103 | + until one is found. If no pager implementation is discovered, no pager is invoked. Setting those |
| 104 | + environment variables to an empty string or the value <literal>cat</literal> is equivalent to passing |
| 105 | + <option>--no-pager</option>.</para> |
102 | 106 |
|
103 | 107 | <para>Note: if <varname>$SYSTEMD_PAGERSECURE</varname> is not set, <varname>$SYSTEMD_PAGER</varname> |
104 | | - (as well as <varname>$PAGER</varname>) will be silently ignored.</para></listitem> |
| 108 | + and <varname>$PAGER</varname> can only be used to disable the pager (with <literal>cat</literal> or |
| 109 | + <literal></literal>), and are otherwise ignored.</para></listitem> |
105 | 110 | </varlistentry> |
106 | 111 |
|
107 | 112 | <varlistentry id='less'> |
|
196 | 201 | implement "secure mode" will not be used at all.</para> |
197 | 202 |
|
198 | 203 | <para>Note that if the <varname>$SYSTEMD_PAGER</varname> or <varname>$PAGER</varname> variables are to |
199 | | - be honoured, <varname>$SYSTEMD_PAGERSECURE</varname> must be set too.</para> |
200 | | - </listitem> |
| 204 | + be honoured, other than to disable the pager, <varname>$SYSTEMD_PAGERSECURE</varname> must be set |
| 205 | + too.</para></listitem> |
201 | 206 | </varlistentry> |
202 | 207 |
|
203 | 208 | <varlistentry id='colors'> |
|
0 commit comments