version 1.51, 2009/07/30 13:31:22 |
version 1.52, 2009/07/30 13:45:56 |
|
|
argument with one of |
argument with one of |
.Ar target-client , |
.Ar target-client , |
.Ar target-session |
.Ar target-session |
|
.Ar target-window , |
or |
or |
.Ar target-window . |
.Ar target-pane . |
These specify the client, session or window which a command should affect. |
These specify the client, session, window or pane which a command should affect. |
.Ar target-client |
.Ar target-client |
is the name of the |
is the name of the |
.Xr pty 4 |
.Xr pty 4 |
|
|
first attempts to parse it as window; if that fails, an attempt is made to |
first attempts to parse it as window; if that fails, an attempt is made to |
match a session. |
match a session. |
.Pp |
.Pp |
|
.Ar target-pane |
|
takes a similar form to |
|
.Ar target-window |
|
but with the optional addition of a period followed by a pane index, for |
|
example: mysession:mywindow.1. |
|
If the pane index is omitted, the currently active pane in the specified |
|
window is used. |
|
If neither a colon nor period appears, |
|
.Nm |
|
first attempts to use the argument as a pane index; if that fails, it is looked |
|
up as for |
|
.Ar target-window . |
|
.Pp |
Multiple commands may be specified together as part of a |
Multiple commands may be specified together as part of a |
.Em command sequence . |
.Em command sequence . |
Each command should be separated by spaces and a semicolon; |
Each command should be separated by spaces and a semicolon; |
|
|
command. |
command. |
.It Xo Ic break-pane |
.It Xo Ic break-pane |
.Op Fl d |
.Op Fl d |
.Op Fl p Ar pane-index |
.Op Fl t Ar target-pane |
.Op Fl t Ar target-window |
|
.Xc |
.Xc |
.D1 (alias: Ic breakp ) |
.D1 (alias: Ic breakp ) |
Break the current pane off from its containing window to make it the only pane |
Break |
in a new window. |
.Ar target-pane |
|
off from its containing window to make it the only pane in a new window. |
If |
If |
.Fl d |
.Fl d |
is given, the new window does not become the current window. |
is given, the new window does not become the current window. |
|
|
This command works only from inside |
This command works only from inside |
.Nm . |
.Nm . |
.It Xo Ic clear-history |
.It Xo Ic clear-history |
.Op Fl p Ar pane-index |
.Op Fl t Ar target-pane |
.Op Fl t Ar target-window |
|
.Xc |
.Xc |
.D1 (alias: Ic clearhist ) |
.D1 (alias: Ic clearhist ) |
Remove and free the history for the specified pane. |
Remove and free the history for the specified pane. |
|
|
option below) |
option below) |
in the status line. |
in the status line. |
.It Xo Ic down-pane |
.It Xo Ic down-pane |
.Op Fl p Ar pane-index |
.Op Fl t Ar target-pane |
.Op Fl t Ar target-window |
|
.Xc |
.Xc |
.D1 (alias: Ic downp ) |
.D1 (alias: Ic downp ) |
Move down a pane. |
Move down a pane. |
|
|
.Ar shell-command |
.Ar shell-command |
returns success. |
returns success. |
.It Xo Ic kill-pane |
.It Xo Ic kill-pane |
.Op Fl p Ar pane-index |
.Op Fl t Ar target-pane |
.Op Fl t Ar target-window |
|
.Xc |
.Xc |
.D1 (alias: Ic killp ) |
.D1 (alias: Ic killp ) |
Destroy the given pane. |
Destroy the given pane. |
|
|
.Ar new-name . |
.Ar new-name . |
.It Xo Ic resize-pane |
.It Xo Ic resize-pane |
.Op Fl DLRU |
.Op Fl DLRU |
.Op Fl p Ar pane-index |
.Op Fl t Ar target-pane |
.Op Fl t Ar target-window |
|
.Op Ar adjustment |
.Op Ar adjustment |
.Xc |
.Xc |
.D1 (alias: Ic resizep ) |
.D1 (alias: Ic resizep ) |
|
|
.Ar layout-name |
.Ar layout-name |
is not given, the last layout used (if any) is reapplied. |
is not given, the last layout used (if any) is reapplied. |
.It Xo Ic select-pane |
.It Xo Ic select-pane |
.Op Fl p Ar pane-index |
.Op Fl t Ar target-pane |
.Op Fl t Ar target-window |
|
.Xc |
.Xc |
.D1 (alias: Ic selectp ) |
.D1 (alias: Ic selectp ) |
Make pane |
Make pane |
.Ar pane-index |
.Ar target-pane |
the active pane in window |
the active pane in window |
.Ar target-window . |
.Ar target-window . |
.It Xo Ic select-prompt |
.It Xo Ic select-prompt |
|
|
.Fl r |
.Fl r |
flag to |
flag to |
.Ic bind-key . |
.Ic bind-key . |
Repeat is enabled for the default keys of the |
Repeat is enabled for the default keys bound to the |
.Ic resize-pane-up |
.Ic resize-pane |
and |
command. |
.Ic resize-pane-down |
|
commands. |
|
.It Xo Ic set-remain-on-exit |
.It Xo Ic set-remain-on-exit |
.Op Ic on | Ic off |
.Op Ic on | Ic off |
.Xc |
.Xc |
|
|
(tty stop). |
(tty stop). |
.It Xo Ic swap-pane |
.It Xo Ic swap-pane |
.Op Fl dDU |
.Op Fl dDU |
.Op Fl p Ar src-index |
.Op Fl s Ar src-pane |
.Op Fl t Ar target-window |
.Op Fl t Ar dst-pane |
.Op Fl q Ar dst-index |
|
.Xc |
.Xc |
.D1 (alias: Ic swapp ) |
.D1 (alias: Ic swapp ) |
Swap two panes within a window. |
Swap two panes. |
If |
If |
.Fl U |
.Fl U |
is used, the pane is swapped with the pane above (before it numerically); |
is used and no source pane is specified with |
|
.Fl s , |
|
.Ar dst-pane is swapped with the previous pane (before it numerically); |
.Fl D |
.Fl D |
swaps with the pane below (the next numerically); or |
swaps with the next pane (after it numerically). |
.Ar dst-index |
|
may be give to swap with a specific pane. |
|
.It Xo Ic swap-window |
.It Xo Ic swap-window |
.Op Fl d |
.Op Fl d |
.Op Fl s Ar src-window |
.Op Fl s Ar src-window |
|
|
is specified and the window is linked to only one session, it is unlinked and |
is specified and the window is linked to only one session, it is unlinked and |
destroyed. |
destroyed. |
.It Xo Ic up-pane |
.It Xo Ic up-pane |
.Op Fl p Ar pane-index |
.Op Fl t Ar target-pane |
.Op Fl t Ar target-window |
|
.Xc |
.Xc |
.D1 (alias: Ic upp ) |
.D1 (alias: Ic upp ) |
Move up a pane. |
Move up a pane. |