version 1.1.1.1, 1996/09/21 05:39:45 |
version 1.1.1.2, 2003/04/13 18:21:22 |
|
|
.TH LESSKEY 1 |
.TH LESSKEY 1 "Version 381: 17 Jan 2003" |
.SH NAME |
.SH NAME |
lesskey \- specify key bindings for less |
lesskey \- specify key bindings for less |
.SH SYNOPSIS |
.SH SYNOPSIS |
.B "lesskey [-o output] [input]" |
.B "lesskey [-o output] [--] [input]" |
.br |
.br |
|
.B "lesskey [--output=output] [--] [input]" |
|
.br |
.B "lesskey -V" |
.B "lesskey -V" |
|
.br |
|
.B "lesskey --version" |
.SH DESCRIPTION |
.SH DESCRIPTION |
.I Lesskey |
.I Lesskey |
is used to specify a set of key bindings to be used by |
is used to specify a set of key bindings to be used by |
.I less. |
.I less. |
The input file is a text file which describes the key bindings, |
The input file is a text file which describes the key bindings, |
If the input file is "-", standard input is read. |
If the input file is "-", standard input is read. |
If no input file is specified, $HOME/.lesskey 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 |
The output file is a binary file which is used by |
.I less. |
.I less. |
If no output file is specified, $HOME/.less is written. |
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, |
If the output file already exists, |
.I lesskey |
.I lesskey |
will overwrite it. |
will overwrite it. |
.PP |
.PP |
The input file consists of lines of the form: |
The -V or --version option causes |
|
.I lesskey |
|
to print its version number and immediately exit. |
|
If -V or --version is present, other options and arguments are ignored. |
|
.PP |
|
The input file consists of one or more |
|
.I sections. |
|
Each section starts with a line that identifies the type of section. |
|
Possible sections are: |
|
.IP #command |
|
Defines new command keys. |
|
.IP #line-edit |
|
Defines new line-editing keys. |
|
.IP #env |
|
Defines environment variables. |
|
.PP |
|
Blank lines and lines which start with a pound sign (#) are ignored, |
|
except for the special section header lines. |
|
|
|
.SH "COMMAND SECTION" |
|
The command section begins with the line |
.sp |
.sp |
|
#command |
|
.sp |
|
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: |
|
.sp |
\fIstring\fP <whitespace> \fIaction\fP [extra-string] <newline> |
\fIstring\fP <whitespace> \fIaction\fP [extra-string] <newline> |
.sp |
.sp |
Whitespace is any sequence of one or more spaces and/or tabs. |
Whitespace is any sequence of one or more spaces and/or tabs. |
|
|
prefixed by a caret to indicate a control key. |
prefixed by a caret to indicate a control key. |
A backslash followed by one to three octal digits may be used to |
A backslash followed by one to three octal digits may be used to |
specify a character by its octal value. |
specify a character by its octal value. |
A backslash followed by b, e, n, r or t specifies |
A backslash followed by certain characters specifies input |
BACKSPACE, ESCAPE, NEWLINE, RETURN or TAB, respectively. |
characters as follows: |
|
.IP \eb |
|
BACKSPACE |
|
.IP \ee |
|
ESCAPE |
|
.IP \en |
|
NEWLINE |
|
.IP \er |
|
RETURN |
|
.IP \et |
|
TAB |
|
.IP \eku |
|
UP ARROW |
|
.IP \ekd |
|
DOWN ARROW |
|
.IP \ekr |
|
RIGHT ARROW |
|
.IP \ekl |
|
LEFT ARROW |
|
.IP \ekU |
|
PAGE UP |
|
.IP \ekD |
|
PAGE DOWN |
|
.IP \ekh |
|
HOME |
|
.IP \eke |
|
END |
|
.IP \ekx |
|
DELETE |
|
.PP |
A backslash followed by any other character indicates that character is |
A backslash followed by any other character indicates that character is |
to be taken literally. |
to be taken literally. |
Characters which must be preceded by backslash include |
Characters which must be preceded by backslash include |
caret, space, tab and the backslash itself. |
caret, space, tab and the backslash itself. |
Blank lines and lines which start with a pound sign (#) are ignored. |
|
.PP |
.PP |
An action may be followed by an "extra" string. |
An action may be followed by an "extra" string. |
When such a command is entered while running |
When such a command is entered while running |
|
|
This feature can be used in certain cases to extend |
This feature can be used in certain cases to extend |
the functionality of a command. |
the functionality of a command. |
For example, see the "{" and ":t" commands in the example below. |
For example, see the "{" and ":t" commands in the example below. |
.PP |
The extra string has a special meaning for the "quit" action: |
The -V flag causes |
when |
.I lesskey |
.I less |
to print its version number and immediately exit. |
quits, first character of the extra string is used as its exit status. |
Other flags and arguments are ignored. |
|
|
|
.SH EXAMPLE |
.SH EXAMPLE |
The following input file describes the set of |
The following input file describes the set of |
default command keys used by less: |
default command keys used by less: |
.sp |
.sp |
.nf |
.nf |
|
#command |
\er forw-line |
\er forw-line |
\en forw-line |
\en forw-line |
e forw-line |
e forw-line |
j forw-line |
j forw-line |
|
\ekd forw-line |
^E forw-line |
^E forw-line |
^N forw-line |
^N forw-line |
k back-line |
k back-line |
|
|
^D forw-scroll |
^D forw-scroll |
u back-scroll |
u back-scroll |
^U back-scroll |
^U back-scroll |
\e40 forw-screen |
\e40 forw-screen |
f forw-screen |
f forw-screen |
^F forw-screen |
^F forw-screen |
^V forw-screen |
^V forw-screen |
|
\ekD forw-screen |
b back-screen |
b back-screen |
^B back-screen |
^B back-screen |
\eev back-screen |
\eev back-screen |
|
\ekU back-screen |
z forw-window |
z forw-window |
w back-window |
w back-window |
|
\ee\e40 forw-screen-force |
F forw-forever |
F forw-forever |
R repaint-flush |
R repaint-flush |
r repaint |
r repaint |
^R repaint |
^R repaint |
^L repaint |
^L repaint |
|
\eeu undo-hilite |
g goto-line |
g goto-line |
|
\ekh goto-line |
< goto-line |
< goto-line |
\ee< goto-line |
\ee< goto-line |
p percent |
p percent |
% percent |
% percent |
|
\ee[ left-scroll |
|
\ee] right-scroll |
|
\ee( left-scroll |
|
\ee) right-scroll |
{ forw-bracket {} |
{ forw-bracket {} |
} back-bracket {} |
} back-bracket {} |
( forw-bracket () |
( forw-bracket () |
|
|
G goto-end |
G goto-end |
\ee> goto-end |
\ee> goto-end |
> goto-end |
> goto-end |
|
\eke goto-end |
= status |
= status |
^G status |
^G status |
:f status |
:f status |
|
|
\een repeat-search-all |
\een repeat-search-all |
N reverse-search |
N reverse-search |
\eeN reverse-search-all |
\eeN reverse-search-all |
\eu undo-hilite |
|
m set-mark |
m set-mark |
' goto-mark |
' goto-mark |
^X^X goto-mark |
^X^X goto-mark |
|
|
^X^V examine |
^X^V examine |
:n next-file |
:n next-file |
:p prev-file |
:p prev-file |
|
t next-tag |
|
T prev-tag |
:x index-file |
:x index-file |
|
:d remove-file |
- toggle-option |
- toggle-option |
:t toggle-option t |
:t toggle-option t |
s toggle-option o |
s toggle-option o |
|
|
H help |
H help |
h help |
h help |
V version |
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 |
:q quit |
:Q quit |
:Q quit |
ZZ quit |
ZZ quit |
|
|
.sp |
.sp |
This will cause all default commands to be ignored. |
This will cause all default commands to be ignored. |
The #stop line should be the last line in that section of the file. |
The #stop line should be the last line in that section of the file. |
(Another section, introduced by #line-edit, may follow the #stop line.) |
|
.PP |
.PP |
Be aware that #stop can be dangerous. |
Be aware that #stop can be dangerous. |
Since all default commands are disabled, |
Since all default commands are disabled, |
|
|
to enable all necessary actions. |
to enable all necessary actions. |
For example, failure to provide a "quit" command can lead to frustration. |
For example, failure to provide a "quit" command can lead to frustration. |
|
|
.SH "LINE EDITING" |
.SH "LINE EDITING SECTION" |
New key bindings may be specified for the line editing commands, |
The line-editing section begins with the line: |
in a manner similar to the way key bindings for |
|
ordinary commands are specified. |
|
This control line marks the beginning of a section of line-editing commands: |
|
.sp |
.sp |
#line-edit |
#line-edit |
.sp |
.sp |
Following this line is a list of keys and actions, |
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. |
one per line as in the example below. |
|
|
.SH EXAMPLE |
.SH EXAMPLE |
|
|
\et forw-complete |
\et forw-complete |
\e17 back-complete |
\e17 back-complete |
\ee\et back-complete |
\ee\et back-complete |
\e14 expand |
^L expand |
^V literal |
^V literal |
^A literal |
^A literal |
\eel right |
\eel right |
|
\ekr right |
\eeh left |
\eeh left |
|
\ekl left |
\eeb word-left |
\eeb word-left |
|
\ee\ekl word-left |
\eew word-right |
\eew word-right |
|
\ee\ekr word-right |
\eei insert |
\eei insert |
\eex delete |
\eex delete |
|
\ekx delete |
|
\eeX word-delete |
|
\eekx word-delete |
\ee\eb word-backspace |
\ee\eb word-backspace |
\ee0 home |
\ee0 home |
|
\ekh home |
\ee$ end |
\ee$ end |
|
\eke end |
\eek up |
\eek up |
|
\eku up |
\eej down |
\eej down |
.fi |
.fi |
.sp |
.sp |
|
|
|
.SH "LESS ENVIRONMENT VARIABLES" |
|
The environment variable section begins with the line |
|
.sp |
|
#env |
|
.sp |
|
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. |
|
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 |
|
configuration information stored in one file. |
|
|
|
.SH EXAMPLE |
|
The following input file sets the -i option whenever |
|
.I less |
|
is run, and specifies the character set to be "latin1": |
|
.sp |
|
.nf |
|
#env |
|
LESS = -i |
|
LESSCHARSET = latin1 |
|
.fi |
|
.sp |
|
|
.SH "SEE ALSO" |
.SH "SEE ALSO" |
less(1) |
less(1) |
|
|
|
.SH WARNINGS |
|
It is not possible to specify special keys, such as uparrow, |
|
in a keyboard-independent manner. |
|
The only way to specify such keys is to specify the escape sequence |
|
which a particular keyboard sends when such a key is pressed. |
|
.PP |
|
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 \e340 in a lesskey file. |
|
|
.SH COPYRIGHT |
.SH COPYRIGHT |
Copyright (c) 1984,1985,1989,1994,1995 Mark Nudelman |
Copyright (C) 2000 Mark Nudelman |
|
.PP |
|
lesskey is part of the GNU project and is free software; |
|
you can redistribute it and/or modify it |
|
under the terms of the GNU General Public License as published by |
|
the Free Software Foundation; |
|
either version 2, or (at your option) any later version. |
|
.PP |
|
lesskey 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. |
|
.PP |
|
You should have received a copy of the GNU General Public License |
|
along with lesskey; see the file COPYING. |
|
If not, write to the Free Software Foundation, 59 Temple Place, |
|
Suite 330, Boston, MA 02111-1307, USA. |
|
|
|
.SH AUTHOR |
|
.PP |
|
Mark Nudelman <markn@greenwoodsoftware.com> |
|
.br |
|
Send bug reports or comments to the above address or to bug-less@gnu.org. |
|
|