src/usr.bin/tmux/tmux.1 - diff

Return to tmux.1 CVS log

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

Diff for /src/usr.bin/tmux/tmux.1 between version 1.420 and 1.421

version 1.420, 2015/04/19 22:10:30

version 1.421, 2015/04/20 15:34:56

Line 838

.Op Fl lnpr

.Op Fl c Ar target-client

.Op Fl t Ar target-session

.Op Fl T Ar key-table

.Xc

.D1 (alias: Ic switchc )

Switch the current session for client

Line 855

Line 856

toggles whether a client is read-only (see the

.Ic attach-session

command).

.Pp

.Fl T

sets the client's key table; the next key from the client will be interpreted from

.Ar key-table .

This may be used to configure multiple prefix keys, or to bind commands to

sequences of keys.

For example, to make typing

.Ql abc

run the

.Ic list-keys

command:

.Bd -literal -offset indent

bind-key -Ttable2 c list-keys

bind-key -Ttable1 b switch-client -Ttable2

bind-key -Troot a switch-client -Ttable1

.Ed

.El

.Sh WINDOWS AND PANES

Line 1931

Line 1948

.It Xo Ic bind-key

.Op Fl cnr

.Op Fl t Ar mode-table

.Op Fl T Ar key-table

.Ar key Ar command Op Ar arguments

.Xc

.D1 (alias: Ic bind )

Line 1938

Line 1956

.Ar key

.Ar command .

By default (without

Keys are bound in a key table.

.Fl t )

By default (without -T), the key is bound in

the primary key bindings are modified (those normally activated with the prefix

the

key); in this case, if

.Em prefix

.Fl n

key table.

is specified, it is not necessary to use the prefix key,

This table is used for keys pressed after the prefix key (for example,

.Ar command

by default

.Ql c

is bound to

.Ar key

.Ic new-window

alone.

in the

.Em prefix

table, so

.Ql C-b c

creates a new window).

The

.Em root

table is used for keys pressed without the prefix key: binding

.Ql c

.Ic new-window

in the

.Em root

table (not recommended) means a plain

.Ql c

will create a new window.

.Fl n

is an alias

for

.Fl T Ar root .

Keys may also be bound in custom key tables and the

.Ic switch-client

.Fl T

command used to switch to them from a key binding.

The

.Fl r

flag indicates this key may repeat, see the

.Ic repeat-time

Line 1962

Line 2004

.Ar mode-table :

the binding for command mode with

.Fl c

or for normal mode without.

or for normal mode without. See the

.Sx WINDOWS AND PANES

section and the

.Ic list-keys

command for information on mode key bindings.

.Pp

To view the default bindings and possible commands, see the

.Ic list-keys

command.

.It Ic list-keys Op Fl t Ar key-table

.It Xo Ic list-keys

.Op Fl t Ar mode-table

.Op Fl T Ar key-table

.Xc

.D1 (alias: Ic lsk )

List all key bindings.

Without

.Fl t

.Fl T

the primary key bindings - those executed when preceded by the prefix key -

all key tables are printed.

are printed.

With

.Fl T

only

.Ar key-table .

.Pp

With

.Fl t ,

the key bindings in

.Ar key-table

.Ar mode-table

are listed; this may be one of:

.Em vi-edit ,

.Em emacs-edit ,

Line 2022

Line 2075

.It Xo Ic unbind-key

.Op Fl acn

.Op Fl t Ar mode-table

.Op Fl T Ar key-table

.Ar key

.Xc

.D1 (alias: Ic unbind )

Unbind the command bound to

.Ar key .

Without

.Fl c ,

.Fl n ,

.Fl T

and

.Fl t

the primary key bindings are modified; in this case, if

are the same as for

.Fl n

.Ic bind-key .

is specified, the command bound to

.Ar key

without a prefix (if any) is removed.

.Fl a

is present, all key bindings are removed.

.Pp

.Fl t

is present,

.Ar key

.Ar mode-table

is unbound: the binding for command mode with

.Fl c

or for normal mode without.

.El

.Sh OPTIONS

The appearance and behaviour of