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.869 and 1.870

version 1.869, 2021/11/03 13:37:17

version 1.870, 2021/11/04 13:15:13

Line 1034

.Op Fl f Ar flags

.Op Fl t Ar target-session

.Xc

.D1 (alias: Ic attach )

.D1 Pq alias: Ic attach

If run from outside

.Nm ,

create a new client in the current terminal and attach it to

Line 1121

.Op Fl s Ar target-session

.Op Fl t Ar target-client

.Xc

.D1 (alias: Ic detach )

.D1 Pq alias: Ic detach

Detach the current client if bound to a key, the client specified with

.Fl t ,

or all clients currently attached to the session specified by

Line 1143

to replace the client.

.Tg has

.It Ic has-session Op Fl t Ar target-session

.D1 (alias: Ic has )

.D1 Pq alias: Ic has

Report an error and exit with 1 if the specified session does not exist.

If it does exist, exit with 0.

.It Ic kill-server

Line 1168

.Op Fl F Ar format

.Op Fl t Ar target-session

.Xc

.D1 (alias: Ic lsc )

.D1 Pq alias: Ic lsc

List all clients attached to the server.

For the meaning of the

.Fl F

Line 1183

.Op Fl F Ar format

.Op Ar command

.Xc

.D1 (alias: Ic lscm )

.D1 Pq alias: Ic lscm

List the syntax of

.Ar command

or - if omitted - of all commands supported by

Line 1193

.Op Fl F Ar format

.Op Fl f Ar filter

.Xc

.D1 (alias: Ic ls )

.D1 Pq alias: Ic ls

List all sessions managed by the server.

.Fl F

specifies the format of each line and

Line 1205

section.

.Tg lockc

.It Ic lock-client Op Fl t Ar target-client

.D1 (alias: Ic lockc )

.D1 Pq alias: Ic lockc

Lock

.Ar target-client ,

see the

Line 1213

command.

.Tg locks

.It Ic lock-session Op Fl t Ar target-session

.D1 (alias: Ic locks )

.D1 Pq alias: Ic locks

Lock all clients attached to

.Ar target-session .

.Tg new

Line 1230

.Op Fl y Ar height

.Op Ar shell-command

.Xc

.D1 (alias: Ic new )

.D1 Pq alias: Ic new

Create a new session with name

.Ar session-name .

.Pp

Line 1346

.Op Fl t Ar target-client

.Op Ar adjustment

.Xc

.D1 (alias: Ic refresh )

.D1 Pq alias: Ic refresh

Refresh the current client if bound to a key, or a single client if one is given

with

.Fl t .

Line 1477

.Op Fl t Ar target-session

.Ar new-name

.Xc

.D1 (alias: Ic rename )

.D1 Pq alias: Ic rename

Rename the session to

.Ar new-name .

.Tg showmsgs

Line 1485

.Op Fl JT

.Op Fl t Ar target-client

.Xc

.D1 (alias: Ic showmsgs )

.D1 Pq alias: Ic showmsgs

Show server messages or information.

Messages are stored, up to a maximum of the limit set by the

.Ar message-limit

Line 1500

.Ar path

.Ar ...

.Xc

.D1 (alias: Ic source )

.D1 Pq alias: Ic source

Execute commands from one or more files specified by

.Ar path

(which may be

Line 1523

shows the parsed commands and line numbers if possible.

.Tg start

.It Ic start-server

.D1 (alias: Ic start )

.D1 Pq alias: Ic start

Start the

.Nm

server, if not already running, without creating any sessions.

Line 1542

.It Xo Ic suspend-client

.Op Fl t Ar target-client

.Xc

.D1 (alias: Ic suspendc )

.D1 Pq alias: Ic suspendc

Suspend a client by sending

.Dv SIGTSTP

(tty stop).

Line 1553

.Op Fl t Ar target-session

.Op Fl T Ar key-table

.Xc

.D1 (alias: Ic switchc )

.D1 Pq alias: Ic switchc

Switch the current session for client

.Ar target-client

Line 1945

.Op Fl s Ar src-pane

.Op Fl t Ar dst-window

.Xc

.D1 (alias: Ic breakp )

.D1 Pq alias: Ic breakp

Break

.Ar src-pane

off from its containing window to make it the only pane in

Line 1974

.Op Fl S Ar start-line

.Op Fl t Ar target-pane

.Xc

.D1 (alias: Ic capturep )

.D1 Pq alias: Ic capturep

Capture the contents of a pane.

.Fl p

Line 2226

.Op Fl t Ar target-client

.Op Ar template

.Xc

.D1 (alias: Ic displayp )

.D1 Pq alias: Ic displayp

Display a visible indicator of each pane shown by

.Ar target-client .

See the

Line 2266

.Op Fl t Ar target-pane

.Ar match-string

.Xc

.D1 (alias: Ic findw )

.D1 Pq alias: Ic findw

Search for a

.Xr fnmatch 3

pattern or, with

Line 2296

.Op Fl s Ar src-pane

.Op Fl t Ar dst-pane

.Xc

.D1 (alias: Ic joinp )

.D1 Pq alias: Ic joinp

.Ic split-window ,

but instead of splitting

Line 2324

.Op Fl a

.Op Fl t Ar target-pane

.Xc

.D1 (alias: Ic killp )

.D1 Pq alias: Ic killp

Destroy the given pane.

If no panes remain in the containing window, it is also destroyed.

The

Line 2336

.Op Fl a

.Op Fl t Ar target-window

.Xc

.D1 (alias: Ic killw )

.D1 Pq alias: Ic killw

Kill the current window or the window at

.Ar target-window ,

removing it from any sessions to which it is linked.

Line 2349

.Op Fl deZ

.Op Fl t Ar target-window

.Xc

.D1 (alias: Ic lastp )

.D1 Pq alias: Ic lastp

Select the last (previously selected) pane.

.Fl Z

keeps the window zoomed if it was zoomed.

Line 2359

disables input to the pane.

.Tg last

.It Ic last-window Op Fl t Ar target-session

.D1 (alias: Ic last )

.D1 Pq alias: Ic last

Select the last (previously selected) window.

If no

.Ar target-session

Line 2370

.Op Fl s Ar src-window

.Op Fl t Ar dst-window

.Xc

.D1 (alias: Ic linkw )

.D1 Pq alias: Ic linkw

Link the window at

.Ar src-window

to the specified

Line 2402

.Op Fl f Ar filter

.Op Fl t Ar target

.Xc

.D1 (alias: Ic lsp )

.D1 Pq alias: Ic lsp

.Fl a

is given,

Line 2431

.Op Fl f Ar filter

.Op Fl t Ar target-session

.Xc

.D1 (alias: Ic lsw )

.D1 Pq alias: Ic lsw

.Fl a

is given, list all windows on the server.

Line 2452

.Op Fl s Ar src-pane

.Op Fl t Ar dst-pane

.Xc

.D1 (alias: Ic movep )

.D1 Pq alias: Ic movep

Does the same as

.Ic join-pane .

.Tg movew

Line 2461

.Op Fl s Ar src-window

.Op Fl t Ar dst-window

.Xc

.D1 (alias: Ic movew )

.D1 Pq alias: Ic movew

This is similar to

.Ic link-window ,

except the window at

Line 2484

.Op Fl t Ar target-window

.Op Ar shell-command

.Xc

.D1 (alias: Ic neww )

.D1 Pq alias: Ic neww

Create a new window.

With

.Fl a

Line 2559

.Fl F .

.Tg nextl

.It Ic next-layout Op Fl t Ar target-window

.D1 (alias: Ic nextl )

.D1 Pq alias: Ic nextl

Move a window to the next layout and rearrange the panes to fit.

.Tg next

.It Xo Ic next-window

.Op Fl a

.Op Fl t Ar target-session

.Xc

.D1 (alias: Ic next )

.D1 Pq alias: Ic next

Move to the next window in the session.

.Fl a

Line 2577

.Op Fl t Ar target-pane

.Op Ar shell-command

.Xc

.D1 (alias: Ic pipep )

.D1 Pq alias: Ic pipep

Pipe output sent by the program in

.Ar target-pane

to a shell command or vice versa.

Line 2624

.It Xo Ic previous-layout

.Op Fl t Ar target-window

.Xc

.D1 (alias: Ic prevl )

.D1 Pq alias: Ic prevl

Move to the previous layout in the session.

.Tg prev

.It Xo Ic previous-window

.Op Fl a

.Op Fl t Ar target-session

.Xc

.D1 (alias: Ic prev )

.D1 Pq alias: Ic prev

Move to the previous window in the session.

With

.Fl a ,

Line 2641

.Op Fl t Ar target-window

.Ar new-name

.Xc

.D1 (alias: Ic renamew )

.D1 Pq alias: Ic renamew

Rename the current window, or the window at

.Ar target-window

if specified, to

Line 2654

.Op Fl y Ar height

.Op Ar adjustment

.Xc

.D1 (alias: Ic resizep )

.D1 Pq alias: Ic resizep

Resize a pane, up, down, left or right by

.Ar adjustment

with

Line 2699

.Op Fl y Ar height

.Op Ar adjustment

.Xc

.D1 (alias: Ic resizew )

.D1 Pq alias: Ic resizew

Resize a window, up, down, left or right by

.Ar adjustment

with

Line 2732

.Op Fl t Ar target-pane

.Op Ar shell-command

.Xc

.D1 (alias: Ic respawnp )

.D1 Pq alias: Ic respawnp

Reactivate a pane in which the command has exited (see the

.Ic remain-on-exit

window option).

Line 2758

.Op Fl t Ar target-window

.Op Ar shell-command

.Xc

.D1 (alias: Ic respawnw )

.D1 Pq alias: Ic respawnw

Reactivate a window in which the command has exited (see the

.Ic remain-on-exit

window option).

Line 2781

.Op Fl DUZ

.Op Fl t Ar target-window

.Xc

.D1 (alias: Ic rotatew )

.D1 Pq alias: Ic rotatew

Rotate the positions of the panes within a window, either upward (numerically

lower) with

.Fl U

Line 2794

.Op Fl t Ar target-pane

.Op Ar layout-name

.Xc

.D1 (alias: Ic selectl )

.D1 Pq alias: Ic selectl

Choose a specific layout for a window.

.Ar layout-name

Line 2817

.Op Fl T Ar title

.Op Fl t Ar target-pane

.Xc

.D1 (alias: Ic selectp )

.D1 Pq alias: Ic selectp

Make pane

.Ar target-pane

the active pane in its window.

Line 2861

.Op Fl lnpT

.Op Fl t Ar target-window

.Xc

.D1 (alias: Ic selectw )

.D1 Pq alias: Ic selectw

Select the window at

.Ar target-window .

.Fl l ,

Line 2889

.Op Ar shell-command

.Op Fl F Ar format

.Xc

.D1 (alias: Ic splitw )

.D1 Pq alias: Ic splitw

Create a new pane by splitting

.Ar target-pane :

.Fl h

Line 2946

.Op Fl s Ar src-pane

.Op Fl t Ar dst-pane

.Xc

.D1 (alias: Ic swapp )

.D1 Pq alias: Ic swapp

Swap two panes.

.Fl U

Line 2975

.Op Fl s Ar src-window

.Op Fl t Ar dst-window

.Xc

.D1 (alias: Ic swapw )

.D1 Pq alias: Ic swapw

This is similar to

.Ic link-window ,

except the source and destination windows are swapped.

Line 2996

.Op Fl k

.Op Fl t Ar target-window

.Xc

.D1 (alias: Ic unlinkw )

.D1 Pq alias: Ic unlinkw

Unlink

.Ar target-window .

Unless

Line 3069

.Op Fl T Ar key-table

.Ar key command Op Ar arguments

.Xc

.D1 (alias: Ic bind )

.D1 Pq alias: Ic bind

Bind key

.Ar key

Line 3127

.Op Fl P Ar prefix-string Fl T Ar key-table

.Op Ar key

.Xc

.D1 (alias: Ic lsk )

.D1 Pq alias: Ic lsk

List key bindings.

There are two forms: the default lists keys as

.Ic bind-key

Line 3164

.Op Fl t Ar target-pane

.Ar key Ar ...

.Xc

.D1 (alias: Ic send )

.D1 Pq alias: Ic send

Send a key or keys to a window.

Each argument

.Ar key

Line 3215

.Op Fl T Ar key-table

.Ar key

.Xc

.D1 (alias: Ic unbind )

.D1 Pq alias: Ic unbind

Unbind the command bound to

.Ar key .

.Fl n

Line 3311

.Op Fl t Ar target-pane

.Ar option Ar value

.Xc

.D1 (alias: Ic set )

.D1 Pq alias: Ic set

Set a pane option with

.Fl p ,

a window option with

Line 3386

.Op Fl t Ar target-pane

.Op Ar option

.Xc

.D1 (alias: Ic show )

.D1 Pq alias: Ic show

Show the pane options (or a single option if

.Ar option

is provided) with

Line 5425

.Op Fl t Ar target-session

.Ar name Op Ar value

.Xc

.D1 (alias: Ic setenv )

.D1 Pq alias: Ic setenv

Set or unset an environment variable.

.Fl g

Line 5451

.Op Fl t Ar target-session

.Op Ar variable

.Xc

.D1 (alias: Ic showenv )

.D1 Pq alias: Ic showenv

Display the environment for

.Ar target-session

or the global environment with

Line 5534

.It Xo Ic clear-prompt-history

.Op Fl T Ar prompt-type

.Xc

.D1 (alias: Ic clrphist )

.D1 Pq alias: Ic clrphist

Clear status prompt history for prompt type

.Ar prompt-type .

Line 5660

.Op Fl t Ar target-client

.Ar command

.Xc

.D1 (alias: Ic confirm )

.D1 Pq alias: Ic confirm

Ask for confirmation before executing

.Ar command .

Line 5689

.Ar command

.Ar ...

.Xc

.D1 (alias: Ic menu )

.D1 Pq alias: Ic menu

Display a menu on

.Ar target-client .

.Ar target-pane

Line 5776

.Op Fl t Ar target-pane

.Op Ar message

.Xc

.D1 (alias: Ic display )

.D1 Pq alias: Ic display

Display a message.

.Fl p

Line 5827

.Op Fl y Ar position

.Op Ar shell-command

.Xc

.D1 (alias: Ic popup )

.D1 Pq alias: Ic popup

Display a popup running

.Ar shell-command

Line 5900

.It Xo Ic show-prompt-history

.Op Fl T Ar prompt-type

.Xc

.D1 (alias: Ic showphist )

.D1 Pq alias: Ic showphist

Display status prompt history for prompt type

.Ar prompt-type .

Line 6028

This command works only if at least one client is attached.

.Tg clearhist

.It Ic clear-history Op Fl t Ar target-pane

.D1 (alias: Ic clearhist )

.D1 Pq alias: Ic clearhist

Remove and free the history for the specified pane.

.Tg deleteb

.It Ic delete-buffer Op Fl b Ar buffer-name

.D1 (alias: Ic deleteb )

.D1 Pq alias: Ic deleteb

Delete the buffer named

.Ar buffer-name ,

or the most recently added automatically named buffer if not specified.

Line 6041

.Op Fl F Ar format

.Op Fl f Ar filter

.Xc

.D1 (alias: Ic lsb )

.D1 Pq alias: Ic lsb

List the global buffers.

.Fl F

specifies the format of each line and

Line 6058

.Ar path

.Xc

.Tg loadb

.D1 (alias: Ic loadb )

.D1 Pq alias: Ic loadb

Load the contents of the specified paste buffer from

.Ar path .

Line 6075

.Op Fl s Ar separator

.Op Fl t Ar target-pane

.Xc

.D1 (alias: Ic pasteb )

.D1 Pq alias: Ic pasteb

Insert the contents of a paste buffer into the specified pane.

If not specified, paste into the current one.

With

Line 6099

.Op Fl b Ar buffer-name

.Ar path

.Xc

.D1 (alias: Ic saveb )

.D1 Pq alias: Ic saveb

Save the contents of the specified paste buffer to

.Ar path .

The

Line 6113

.Op Fl n Ar new-buffer-name

.Ar data

.Xc

.D1 (alias: Ic setb )

.D1 Pq alias: Ic setb

Set the contents of the specified buffer to

.Ar data .

Line 6134

.It Xo Ic show-buffer

.Op Fl b Ar buffer-name

.Xc

.D1 (alias: Ic showb )

.D1 Pq alias: Ic showb

Display the contents of the specified buffer.

.El

.Sh MISCELLANEOUS

Line 6149

.Ar shell-command command

.Op Ar command

.Xc

.D1 (alias: Ic if )

.D1 Pq alias: Ic if

Execute the first

.Ar command

Line 6176

are expanded).

.Tg lock

.It Ic lock-server

.D1 (alias: Ic lock )

.D1 Pq alias: Ic lock

Lock each client individually by running the command specified by the

.Ic lock-command

option.

Line 6187

.Op Fl t Ar target-pane

.Op Ar shell-command

.Xc

.D1 (alias: Ic run )

.D1 Pq alias: Ic run

Execute

.Ar shell-command

or (with

Line 6219

.Op Fl L | S | U

.Ar channel

.Xc

.D1 (alias: Ic wait )

.D1 Pq alias: Ic wait

When used without options, prevents the client from exiting until woken using

.Ic wait-for

.Fl S