aboutsummaryrefslogtreecommitdiff
path: root/tmux.1
diff options
context:
space:
mode:
authorThomas Adam <thomas@xteddy.org>2020-04-13 10:30:00 +0100
committerThomas Adam <thomas@xteddy.org>2020-04-13 10:30:00 +0100
commitb117c3b81217a11946ac784cfbe2ef1f3725b207 (patch)
tree196cc4a27cb75def4466d418cb91dd3fcfdfbf5b /tmux.1
parent52e3d960e7ebe2006509d48c427ffd8f25a0cf52 (diff)
parentc20eb0c0ae3347c768894a6355adfd7ebae6f2f3 (diff)
downloadrtmux-b117c3b81217a11946ac784cfbe2ef1f3725b207.tar.gz
rtmux-b117c3b81217a11946ac784cfbe2ef1f3725b207.tar.bz2
rtmux-b117c3b81217a11946ac784cfbe2ef1f3725b207.zip
Merge branch 'obsd-master'
Diffstat (limited to 'tmux.1')
-rw-r--r--tmux.182
1 files changed, 53 insertions, 29 deletions
diff --git a/tmux.1 b/tmux.1
index dba05536..169b4d2a 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1055,12 +1055,18 @@ List the syntax of
.Ar command
or - if omitted - of all commands supported by
.Nm .
-.It Ic list-sessions Op Fl F Ar format
+.It Xo Ic list-sessions
+.Op Fl F Ar format
+.Op Fl f Ar filter
+.Xc
.D1 (alias: Ic ls )
List all sessions managed by the server.
-For the meaning of the
.Fl F
-flag, see the
+specifies the format of each line and
+.Fl f
+a filter.
+Only sessions for which the filter is true are shown.
+See the
.Sx FORMATS
section.
.It Ic lock-client Op Fl t Ar target-client
@@ -1608,6 +1614,7 @@ command is:
.Bl -tag -width Ds
.It Xo Ic copy-mode
.Op Fl eHMqu
+.Op Fl s Ar src-pane
.Op Fl t Ar target-pane
.Xc
Enter copy mode.
@@ -1621,6 +1628,11 @@ begins a mouse drag (only valid if bound to a mouse key binding, see
hides the position indicator in the top right.
.Fl q
cancels copy mode and any other modes.
+.Fl s
+copies from
+.Ar src-pane
+instead of
+.Ar target-pane .
.Pp
.Fl e
specifies that scrolling to the bottom of the history (to the visible screen)
@@ -2056,6 +2068,7 @@ is given, the newly linked window is not selected.
.It Xo Ic list-panes
.Op Fl as
.Op Fl F Ar format
+.Op Fl f Ar filter
.Op Fl t Ar target
.Xc
.D1 (alias: Ic lsp )
@@ -2072,14 +2085,18 @@ is a session (or the current session).
If neither is given,
.Ar target
is a window (or the current window).
-For the meaning of the
.Fl F
-flag, see the
+specifies the format of each line and
+.Fl f
+a filter.
+Only panes for which the filter is true are shown.
+See the
.Sx FORMATS
section.
.It Xo Ic list-windows
.Op Fl a
.Op Fl F Ar format
+.Op Fl f Ar filter
.Op Fl t Ar target-session
.Xc
.D1 (alias: Ic lsw )
@@ -2088,9 +2105,12 @@ If
is given, list all windows on the server.
Otherwise, list windows in the current session or in
.Ar target-session .
-For the meaning of the
.Fl F
-flag, see the
+specifies the format of each line and
+.Fl f
+a filter.
+Only windows for which the filter is true are shown.
+See the
.Sx FORMATS
section.
.It Xo Ic move-pane
@@ -3312,6 +3332,9 @@ with
.Fl np .
.It Ic message-command-style Ar style
Set status line message command style.
+This is used for the command prompt with
+.Xr vi 1
+keys when in command mode.
For how to specify
.Ar style ,
see the
@@ -3319,6 +3342,7 @@ see the
section.
.It Ic message-style Ar style
Set status line message style.
+This is used for messages and for the command prompt.
For how to specify
.Ar style ,
see the
@@ -3873,6 +3897,7 @@ hook and there are a number of hooks not associated with commands.
.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.
Hooks may be configured with the
.Ic set-hook
or
@@ -3965,8 +3990,8 @@ Run when a window is unlinked from a session.
Hooks are managed with these commands:
.Bl -tag -width Ds
.It Xo Ic set-hook
-.Op Fl agRu
-.Op Fl t Ar target-session
+.Op Fl agpRuw
+.Op Fl t Ar target-pane
.Ar hook-name
.Ar command
.Xc
@@ -3978,18 +4003,8 @@ unsets) hook
.Ar hook-name
to
.Ar command .
-If
-.Fl g
-is given,
-.Em hook-name
-is added to the global list of hooks, otherwise it is added to the session
-hooks (for
-.Ar target-session
-with
-.Fl t ) .
-.Fl a
-appends to a hook.
-Like options, session hooks inherit from the global ones.
+The flags are the same as for
+.Ic set-option .
.Pp
With
.Fl R ,
@@ -3997,12 +4012,12 @@ run
.Ar hook-name
immediately.
.It Xo Ic show-hooks
-.Op Fl g
-.Op Fl t Ar target-session
+.Op Fl gpw
+.Op Fl t Ar target-pane
.Xc
-Shows the global list of hooks with
-.Fl g ,
-otherwise the session hooks.
+Shows hooks.
+The flags are the same as for
+.Ic show-options .
.El
.Sh MOUSE SUPPORT
If the
@@ -5251,12 +5266,16 @@ Delete the buffer named
or the most recently added automatically named buffer if not specified.
.It Xo Ic list-buffers
.Op Fl F Ar format
+.Op Fl f Ar filter
.Xc
.D1 (alias: Ic lsb )
List the global buffers.
-For the meaning of the
.Fl F
-flag, see the
+specifies the format of each line and
+.Fl f
+a filter.
+Only buffers for which the filter is true are shown.
+See the
.Sx FORMATS
section.
.It Xo Ic load-buffer
@@ -5442,7 +5461,7 @@ The server crashed or otherwise exited without telling the client the reason.
understands some unofficial extensions to
.Xr terminfo 5 :
.Bl -tag -width Ds
-.It Em Cs , Cr
+.It Em \&Cs , Cr
Set the cursor colour.
The first takes a single string argument and is used to set the colour;
the second takes no arguments and restores the default cursor colour.
@@ -5506,6 +5525,11 @@ capabilities to the
.Nm
.Xr terminfo 5
entry).
+.Pp
+This is equivalent to the
+.Em RGB
+.Xr terminfo 5
+capability.
.It Em \&Ms
Store the current buffer in the host terminal's selection (clipboard).
See the