src/usr.bin/less/lesskey.1 - diff

Return to lesskey.1 CVS log

Up to [local] / src / usr.bin / less

Diff for /src/usr.bin/less/lesskey.1 between version 1.16 and 1.17

version 1.16, 2019/06/02 06:53:11

version 1.17, 2021/12/07 13:26:49

Line 118

.Pp

If the command section is the first section in the file,

this line may be omitted.

.Pp

The command section consists of lines of the form:

.Bd -filled -offset indent

.Ar string

.Ar keys

.Aq whitespace

.Ar action

.Bq extra-string

.Op Ar extra

.Aq newline

.Ed

.Pp

Whitespace is any sequence of one or more spaces and/or tabs.

The three fields are separated by whitespace

consisting of one or more spaces and/or tabs.

.Pp

The

.Ar string

.Ar keys

is the command key(s) which invoke the action.

string consists of at least one and at most 15 keys.

The

By typing it in

.Ar string

.Xr less 1 ,

may be a single command key, or a sequence of up to 15 keys.

the

The

.Ar action

is the name of the less action, from the list below.

is invoked.

The characters in the

The list of default key bindings given below

.Ar string

also serves as a list of supported actions.

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:

.Pp

Each of the

.Ar keys

can be specified in these forms:

.Bl -bullet -offset indent

.It

a literal character

.It

a character prefixed by a caret to indicate a control key

.It

a backslash followed by one to three octal digits

to specify a key by its octal value

.It

a backslash followed by certain characters

to specify input characters as follows:

.Pp

.Bl -tag -width Ds -offset indent -compact

.It \eb

BACKSPACE

Line 175

Line 185

.It \ekx

DELETE

.El

.Pp

.It

A backslash followed by any other character indicates that character is

a backslash followed by any other character

to be taken literally.

to indicate that character is to be taken literally.

Characters which must be preceded by backslash include

caret, space, tab and the backslash itself.

caret, space, tab, and the backslash itself.

.El

.Pp

An action may be followed by an

.Qq extra

.Ar extra

string.

When such a command is entered while running less,

It is parsed, just as if it were typed into

the action is performed, and then the extra

.Xr less 1 ,

string is parsed, just as if it were typed in to less.

after performing the

.Ar action .

This feature can be used in certain cases to extend

the functionality of a command.

For example, see the

.Sq {

and

.Sq :t

commands in the example below.

keys in the list of default bindings below.

The extra string has a special meaning for the

.Pp

The

.Ar extra

string has a special meaning for the

.Qq quit

action:

when less quits,

when

first character of the extra string is used as its exit status.

.Xr less 1

quits,

first character of the

.Ar extra

string is used as its exit status.

.Pp

The following input file describes the set of

default command keys used by less:

default command keys used by

.Xr less 1 :

.Bd -literal -offset indent

#command

\er forw-line

Line 294

Line 314

_ display-option

| pipe

v visual

! shell

+ firstcmd

H help

h help