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.915 and 1.916

version 1.915, 2023/02/06 09:20:30

version 1.916, 2023/02/07 10:21:01

Line 466

.Ic confirm-before ,

parse their argument to create a new command which is inserted immediately

after themselves.

This means that arguments can be parsed twice or more - once when the parent command (such as

This means that arguments can be parsed twice or more - once when the parent

command (such as

.Ic if-shell )

is parsed and again when it parses and executes its command.

Commands like

Line 884

Line 885

.Ql {mouse}

(alternative form

.Ql = )

to specify the session, window or pane where the most recent mouse event occurred

to specify the session, window or pane where the most recent mouse event

(see the

occurred (see the

.Sx MOUSE SUPPORT

section)

Line 1461

Line 1462

.Xr xterm 1

escape sequence.

Ar target-pane

.Ar target-pane

is given, the clipboard is sent (in encoded form), otherwise it is stored in a

new paste buffer.

.Pp

Line 1574

Line 1575

.Pp

Note that as by default the

.Nm

server will exit with no sessions, this is only useful if a session is created in

server will exit with no sessions, this is only useful if a session is created

.Pa ~/.tmux.conf ,

.Ic exit-empty

is turned off, or another command is run as part of the same command sequence.

Line 1929

Line 1931

.Ed

.El

.Pp

A number of preset arrangements of panes are available, these are called layouts.

A number of preset arrangements of panes are available, these are called

layouts.

These may be selected with the

.Ic select-layout

command or cycled with

Line 4595

Line 4598

.Pp

Hooks are stored as array options, members of the array are executed in

order when the hook is triggered.

Like options different hooks may be global or belong to a session, window or pane.

Like options different hooks may be global or belong to a session, window or

pane.

Hooks may be configured with the

.Ic set-hook

Line 4778

Line 4782

.Ar target-pane

in commands bound to mouse key bindings.

It resolves to the window or pane over which the mouse event took place

(for example, the window in the status line over which button 1 was released for a

(for example, the window in the status line over which button 1 was released

for a

.Ql MouseUp1Status

binding, or the pane over which the wheel was scrolled for a

.Ql WheelDownPane

Line 4918

Line 4923

For example:

.Ql #{C/r:^Start}

.Pp

Numeric operators may be performed by prefixing two comma-separated alternatives with an

Numeric operators may be performed by prefixing two comma-separated alternatives

with an

.Ql e

and an operator.

An optional

.Ql f

flag may be given after the operator to use floating point numbers, otherwise integers are used.

flag may be given after the operator to use floating point numbers, otherwise

This may be followed by a number giving the number of decimal places to use for the result.

integers are used.

This may be followed by a number giving the number of decimal places to use for

the result.

The available operators are:

addition

.Ql + ,

Line 5054

Line 5062

.Xr strftime 3

specifiers.

.Ql S:\& ,

.Ql W:\&

.Ql W:\& ,

.Ql P:\&

will loop over each session, window or pane and insert the format once

.Ql L:\&

will loop over each session, window, pane or client and insert the format once

for each.

For windows and panes, two comma-separated formats may be given:

the second is used for the current window or active pane.

Line 5084

Line 5093

with

.Ql bar

throughout.

The first argument may be an extended regular expression and a final argument may be

The first argument may be an extended regular expression and a final argument

may be

.Ql i

to ignore case, for example

.Ql s/a(.)/\e1x/i:\&

Line 5095

Line 5105

A different delimiter character may also be used, to avoid collisions with

literal slashes in the pattern.

For example,

.Ql s|foo/|bar/|:

.Ql s|foo/|bar/|:\&

will substitute

.Ql foo/

with

Line 5111

Line 5121

.Nm

does not wait for

.Ql #()

commands to finish; instead, the previous result from running the same command is used,

commands to finish; instead, the previous result from running the same command

or a placeholder if the command has not been run before.

is used, or a placeholder if the command has not been run before.

If the command hasn't exited, the most recent line of output will be used, but the status

If the command hasn't exited, the most recent line of output will be used, but

line will not be updated more than once a second.

the status line will not be updated more than once a second.

Commands are executed using

.Pa /bin/sh

and with the

Line 5415

Line 5425

.Ic list=on

marks the start of the list;

.Ic list=focus

is the part of the list that should be kept in focus if the entire list won't fit

is the part of the list that should be kept in focus if the entire list won't

in the available space (typically the current window);

fit in the available space (typically the current window);

.Ic list=left-marker

and

.Ic list=right-marker

Line 6566

Line 6576

.Em %end

.Em %error

have three arguments: an integer time (as seconds from epoch), command number and

have three arguments: an integer time (as seconds from epoch), command number

flags (currently not used).

and flags (currently not used).

For example:

.Bd -literal -offset indent

%begin 1363006971 2 1

Line 6617

Line 6627

.Ar pause-after

flag is set.

.Ar age

is the time in milliseconds for which tmux had buffered the output before it was sent.

is the time in milliseconds for which tmux had buffered the output before it

was sent.

Any subsequent arguments up until a single

.Ql \&:

are for future use and should be ignored.

.It Ic %layout-change Ar window-id Ar window-layout Ar window-visible-layout Ar window-flags

.It Xo Ic %layout-change

.Ar window-id

.Ar window-layout

.Ar window-visible-layout

.Ar window-flags

.Xc

The layout of a window with ID

.Ar window-id

changed.