492 lines
14 KiB
HTML
492 lines
14 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of LESSKEY</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>LESSKEY</H1>
|
|
Section: User Commands (1)<BR>Updated: Version 551: 11 Jun 2019<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
lesskey - specify key bindings for less
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>lesskey [-o output] [--] [input]</B>
|
|
|
|
<BR>
|
|
|
|
<B>lesskey [--output=output] [--] [input]</B>
|
|
|
|
<BR>
|
|
|
|
<B>lesskey -V</B>
|
|
|
|
<BR>
|
|
|
|
<B>lesskey --version</B>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<I>Lesskey</I>
|
|
|
|
is used to specify a set of key bindings to be used by
|
|
<I>less.</I>
|
|
|
|
The input file is a text file which describes the key bindings.
|
|
If the input file is "-", standard input is read.
|
|
If no input file is specified, a standard filename is used
|
|
as the name of the input file, which depends on the system being used:
|
|
On Unix systems, $HOME/.lesskey is used;
|
|
on MS-DOS systems, $HOME/_lesskey is used;
|
|
and on OS/2 systems $HOME/lesskey.ini is used,
|
|
or $INIT/lesskey.ini if $HOME is undefined.
|
|
The output file is a binary file which is used by
|
|
<I>less.</I>
|
|
|
|
If no output file is specified,
|
|
and the environment variable LESSKEY is set,
|
|
the value of LESSKEY is used as the name of the output file.
|
|
Otherwise, a standard filename is used as the name of the output file,
|
|
which depends on the system being used:
|
|
On Unix and OS-9 systems, $HOME/.less is used;
|
|
on MS-DOS systems, $HOME/_less is used;
|
|
and on OS/2 systems, $HOME/less.ini is used,
|
|
or $INIT/less.ini if $HOME is undefined.
|
|
If the output file already exists,
|
|
<I>lesskey</I>
|
|
|
|
will overwrite it.
|
|
<P>
|
|
|
|
The -V or --version option causes
|
|
<I>lesskey</I>
|
|
|
|
to print its version number and immediately exit.
|
|
If -V or --version is present, other options and arguments are ignored.
|
|
<P>
|
|
|
|
The input file consists of one or more
|
|
<I>sections.</I>
|
|
|
|
Each section starts with a line that identifies the type of section.
|
|
Possible sections are:
|
|
<DL COMPACT>
|
|
<DT id="1">#command<DD>
|
|
Defines new command keys.
|
|
<DT id="2">#line-edit<DD>
|
|
Defines new line-editing keys.
|
|
<DT id="3">#env<DD>
|
|
Defines environment variables.
|
|
</DL>
|
|
<P>
|
|
|
|
Blank lines and lines which start with a pound sign (#) are ignored,
|
|
except for the special section header lines.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>COMMAND SECTION</H2>
|
|
|
|
The command section begins with the line
|
|
<P>
|
|
#command
|
|
<P>
|
|
If the command section is the first section in the file,
|
|
this line may be omitted.
|
|
The command section consists of lines of the form:
|
|
<P>
|
|
<TT> </TT><I>string</I> <whitespace> <I>action</I> [extra-string] <newline><BR>
|
|
<P>
|
|
Whitespace is any sequence of one or more spaces and/or tabs.
|
|
The <I>string</I> is the command key(s) which invoke the action.
|
|
The <I>string</I> may be a single command key, or a sequence of up to 15 keys.
|
|
The <I>action</I> is the name of the less action, from the list below.
|
|
The characters in the <I>string</I> may appear literally, or be
|
|
prefixed by a caret to indicate a control key.
|
|
A backslash followed by one to three octal digits may be used to
|
|
specify a character by its octal value.
|
|
A backslash followed by certain characters specifies input
|
|
characters as follows:
|
|
<DL COMPACT>
|
|
<DT id="4">\b<DD>
|
|
BACKSPACE
|
|
<DT id="5">\e<DD>
|
|
ESCAPE
|
|
<DT id="6">\n<DD>
|
|
NEWLINE
|
|
<DT id="7">\r<DD>
|
|
RETURN
|
|
<DT id="8">\t<DD>
|
|
TAB
|
|
<DT id="9">\ku<DD>
|
|
UP ARROW
|
|
<DT id="10">\kd<DD>
|
|
DOWN ARROW
|
|
<DT id="11">\kr<DD>
|
|
RIGHT ARROW
|
|
<DT id="12">\kl<DD>
|
|
LEFT ARROW
|
|
<DT id="13">\kU<DD>
|
|
PAGE UP
|
|
<DT id="14">\kD<DD>
|
|
PAGE DOWN
|
|
<DT id="15">\kh<DD>
|
|
HOME
|
|
<DT id="16">\ke<DD>
|
|
END
|
|
<DT id="17">\kx<DD>
|
|
DELETE
|
|
</DL>
|
|
<P>
|
|
|
|
A backslash followed by any other character indicates that character is
|
|
to be taken literally.
|
|
Characters which must be preceded by backslash include
|
|
caret, space, tab and the backslash itself.
|
|
<P>
|
|
|
|
An action may be followed by an "extra" string.
|
|
When such a command is entered while running
|
|
<I>less,</I>
|
|
|
|
the action is performed, and then the extra
|
|
string is parsed, just as if it were typed in to
|
|
<I>less.</I>
|
|
|
|
This feature can be used in certain cases to extend
|
|
the functionality of a command.
|
|
For example, see the "{" and ":t" commands in the example below.
|
|
The extra string has a special meaning for the "quit" action:
|
|
when
|
|
<I>less</I>
|
|
|
|
quits, first character of the extra string is used as its exit status.
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXAMPLE</H2>
|
|
|
|
The following input file describes the set of
|
|
default command keys used by less:
|
|
<P>
|
|
<PRE>
|
|
#command
|
|
\r forw-line
|
|
\n forw-line
|
|
e forw-line
|
|
j forw-line
|
|
\kd forw-line
|
|
^E forw-line
|
|
^N forw-line
|
|
k back-line
|
|
y back-line
|
|
^Y back-line
|
|
^K back-line
|
|
^P back-line
|
|
J forw-line-force
|
|
K back-line-force
|
|
Y back-line-force
|
|
d forw-scroll
|
|
^D forw-scroll
|
|
u back-scroll
|
|
^U back-scroll
|
|
\40 forw-screen
|
|
f forw-screen
|
|
^F forw-screen
|
|
^V forw-screen
|
|
\kD forw-screen
|
|
b back-screen
|
|
^B back-screen
|
|
\ev back-screen
|
|
\kU back-screen
|
|
z forw-window
|
|
w back-window
|
|
\e\40 forw-screen-force
|
|
F forw-forever
|
|
\eF forw-until-hilite
|
|
R repaint-flush
|
|
r repaint
|
|
^R repaint
|
|
^L repaint
|
|
\eu undo-hilite
|
|
g goto-line
|
|
\kh goto-line
|
|
< goto-line
|
|
\e< goto-line
|
|
p percent
|
|
% percent
|
|
\e[ left-scroll
|
|
\e] right-scroll
|
|
\e( left-scroll
|
|
\e) right-scroll
|
|
\kl left-scroll
|
|
\kr right-scroll
|
|
\e{ no-scroll
|
|
\e} end-scroll
|
|
{ forw-bracket {}
|
|
} back-bracket {}
|
|
( forw-bracket ()
|
|
) back-bracket ()
|
|
[ forw-bracket []
|
|
] back-bracket []
|
|
\e^F forw-bracket
|
|
\e^B back-bracket
|
|
G goto-end
|
|
\e> goto-end
|
|
> goto-end
|
|
\ke goto-end
|
|
\eG goto-end-buffered
|
|
= status
|
|
^G status
|
|
:f status
|
|
/ forw-search
|
|
? back-search
|
|
\e/ forw-search *
|
|
\e? back-search *
|
|
n repeat-search
|
|
\en repeat-search-all
|
|
N reverse-search
|
|
\eN reverse-search-all
|
|
& filter
|
|
m set-mark
|
|
M set-mark-bottom
|
|
\em clear-mark
|
|
' goto-mark
|
|
^X^X goto-mark
|
|
E examine
|
|
:e examine
|
|
^X^V examine
|
|
:n next-file
|
|
:p prev-file
|
|
t next-tag
|
|
T prev-tag
|
|
:x index-file
|
|
:d remove-file
|
|
- toggle-option
|
|
:t toggle-option t
|
|
s toggle-option o
|
|
_ display-option
|
|
| pipe
|
|
v visual
|
|
! shell
|
|
+ firstcmd
|
|
H help
|
|
h help
|
|
V version
|
|
0 digit
|
|
1 digit
|
|
2 digit
|
|
3 digit
|
|
4 digit
|
|
5 digit
|
|
6 digit
|
|
7 digit
|
|
8 digit
|
|
9 digit
|
|
q quit
|
|
Q quit
|
|
:q quit
|
|
:Q quit
|
|
ZZ quit
|
|
</PRE>
|
|
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>PRECEDENCE</H2>
|
|
|
|
Commands specified by
|
|
<I>lesskey</I>
|
|
|
|
take precedence over the default commands.
|
|
A default command key may be disabled by including it in the
|
|
input file with the action "invalid".
|
|
Alternatively, a key may be defined
|
|
to do nothing by using the action "noaction".
|
|
"noaction" is similar to "invalid", but
|
|
<I>less</I>
|
|
|
|
will give an error beep for an "invalid" command,
|
|
but not for a "noaction" command.
|
|
In addition, ALL default commands may be disabled by
|
|
adding this control line to the input file:
|
|
<P>
|
|
#stop
|
|
<P>
|
|
This will cause all default commands to be ignored.
|
|
The #stop line should be the last line in that section of the file.
|
|
<P>
|
|
|
|
Be aware that #stop can be dangerous.
|
|
Since all default commands are disabled,
|
|
you must provide sufficient commands before the #stop line
|
|
to enable all necessary actions.
|
|
For example, failure to provide a "quit" command can lead to frustration.
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>LINE EDITING SECTION</H2>
|
|
|
|
The line-editing section begins with the line:
|
|
<P>
|
|
#line-edit
|
|
<P>
|
|
This section specifies new key bindings for the line editing commands,
|
|
in a manner similar to the way key bindings for
|
|
ordinary commands are specified in the #command section.
|
|
The line-editing section consists of a list of keys and actions,
|
|
one per line as in the example below.
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>EXAMPLE</H2>
|
|
|
|
The following input file describes the set of
|
|
default line-editing keys used by less:
|
|
<P>
|
|
<PRE>
|
|
#line-edit
|
|
\t forw-complete
|
|
\17 back-complete
|
|
\e\t back-complete
|
|
^L expand
|
|
^V literal
|
|
^A literal
|
|
\el right
|
|
\kr right
|
|
\eh left
|
|
\kl left
|
|
\eb word-left
|
|
\e\kl word-left
|
|
\ew word-right
|
|
\e\kr word-right
|
|
\ei insert
|
|
\ex delete
|
|
\kx delete
|
|
\eX word-delete
|
|
\ekx word-delete
|
|
\e\b word-backspace
|
|
\e0 home
|
|
\kh home
|
|
\e$ end
|
|
\ke end
|
|
\ek up
|
|
\ku up
|
|
\ej down
|
|
^G abort
|
|
</PRE>
|
|
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>LESS ENVIRONMENT VARIABLES</H2>
|
|
|
|
The environment variable section begins with the line
|
|
<P>
|
|
#env
|
|
<P>
|
|
Following this line is a list of environment variable assignments.
|
|
Each line consists of an environment variable name, an equals sign (=)
|
|
and the value to be assigned to the environment variable.
|
|
White space before and after the equals sign is ignored.
|
|
Variables assigned in this way are visible only to
|
|
<I>less.</I>
|
|
|
|
If a variable is specified in the system environment and also in a
|
|
lesskey file, the value in the lesskey file takes precedence.
|
|
Although the lesskey file can be used to override variables set in the
|
|
environment, the main purpose of assigning variables in the lesskey file
|
|
is simply to have all
|
|
<I>less</I>
|
|
|
|
configuration information stored in one file.
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>EXAMPLE</H2>
|
|
|
|
The following input file sets the -i option whenever
|
|
<I>less</I>
|
|
|
|
is run, and specifies the character set to be "latin1":
|
|
<P>
|
|
<PRE>
|
|
#env
|
|
LESS = -i
|
|
LESSCHARSET = latin1
|
|
</PRE>
|
|
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAL"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?1+less">less</A>(1)
|
|
<P>
|
|
<A NAME="lbAM"> </A>
|
|
<H2>WARNINGS</H2>
|
|
|
|
On MS-DOS and OS/2 systems, certain keys send a sequence of characters
|
|
which start with a NUL character (0).
|
|
This NUL character should be represented as \340 in a lesskey file.
|
|
<P>
|
|
<A NAME="lbAN"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright (C) 1984-2019 Mark Nudelman
|
|
<P>
|
|
|
|
less is part of the GNU project and is free software.
|
|
You can redistribute it and/or modify it
|
|
under the terms of either
|
|
(1) the GNU General Public License as published by
|
|
the Free Software Foundation; or (2) the Less License.
|
|
See the file README in the less distribution for more details
|
|
regarding redistribution.
|
|
You should have received a copy of the GNU General Public License
|
|
along with the source for less; see the file COPYING.
|
|
If not, write to the Free Software Foundation, 59 Temple Place,
|
|
Suite 330, Boston, MA 02111-1307, USA.
|
|
You should also have received a copy of the Less License;
|
|
see the file LICENSE.
|
|
<P>
|
|
|
|
less is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
or FITNESS FOR A PARTICULAR PURPOSE.
|
|
See the GNU General Public License for more details.
|
|
<P>
|
|
<A NAME="lbAO"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<P>
|
|
|
|
Mark Nudelman
|
|
<BR>
|
|
|
|
Send bug reports or comments to <<A HREF="mailto:bug-less@gnu.org">bug-less@gnu.org</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="18"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="19"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="20"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="21"><A HREF="#lbAE">COMMAND SECTION</A><DD>
|
|
<DT id="22"><A HREF="#lbAF">EXAMPLE</A><DD>
|
|
<DT id="23"><A HREF="#lbAG">PRECEDENCE</A><DD>
|
|
<DT id="24"><A HREF="#lbAH">LINE EDITING SECTION</A><DD>
|
|
<DT id="25"><A HREF="#lbAI">EXAMPLE</A><DD>
|
|
<DT id="26"><A HREF="#lbAJ">LESS ENVIRONMENT VARIABLES</A><DD>
|
|
<DT id="27"><A HREF="#lbAK">EXAMPLE</A><DD>
|
|
<DT id="28"><A HREF="#lbAL">SEE ALSO</A><DD>
|
|
<DT id="29"><A HREF="#lbAM">WARNINGS</A><DD>
|
|
<DT id="30"><A HREF="#lbAN">COPYRIGHT</A><DD>
|
|
<DT id="31"><A HREF="#lbAO">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:18 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|