summaryrefslogtreecommitdiff
path: root/usr.bin/tmux/tmux.1
diff options
context:
space:
mode:
authorNicholas Marriott <nicm@cvs.openbsd.org>2017-09-02 17:51:55 +0000
committerNicholas Marriott <nicm@cvs.openbsd.org>2017-09-02 17:51:55 +0000
commit7bb71fbbb0baba64a35869ecc8701cd388dd1d52 (patch)
tree9f6f66f906384e00f736d0d19fb63ad4cc0e101f /usr.bin/tmux/tmux.1
parent8f6057df9ae6f21acac4c0e3ee1f3b6263c92c75 (diff)
Add selectp -T to set pane title.
Diffstat (limited to 'usr.bin/tmux/tmux.1')
-rw-r--r--usr.bin/tmux/tmux.126
1 files changed, 16 insertions, 10 deletions
diff --git a/usr.bin/tmux/tmux.1 b/usr.bin/tmux/tmux.1
index 15d3c3eabbe..7aff17356f2 100644
--- a/usr.bin/tmux/tmux.1
+++ b/usr.bin/tmux/tmux.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: tmux.1,v 1.576 2017/08/23 09:39:11 nicm Exp $
+.\" $OpenBSD: tmux.1,v 1.577 2017/09/02 17:51:54 nicm Exp $
.\"
.\" Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com>
.\"
@@ -14,7 +14,7 @@
.\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
.\" OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: August 23 2017 $
+.Dd $Mdocdate: September 2 2017 $
.Dt TMUX 1
.Os
.Sh NAME
@@ -1923,6 +1923,7 @@ applies the last set layout if possible (undoes the most recent layout change).
.It Xo Ic select-pane
.Op Fl DdegLlMmRU
.Op Fl P Ar style
+.Op Fl T Ar title
.Op Fl t Ar target-pane
.Xc
.D1 (alias: Ic selectp )
@@ -1978,6 +1979,9 @@ select-pane -t:.1 -P 'bg=red'
.Pp
.Fl g
shows the current pane style.
+.Pp
+.Fl T
+sets the pane title.
.It Xo Ic select-window
.Op Fl lnpT
.Op Fl t Ar target-window
@@ -2874,7 +2878,7 @@ Set the position of the status line.
Display
.Ar string
to the right of the status line.
-By default, the current window title in double quotes, the date and the time
+By default, the current pane title in double quotes, the date and the time
are shown.
As with
.Ic status-left ,
@@ -3722,14 +3726,11 @@ and are displayed in the status line and various lists: the name is the
.Nm
identifier for a window or session.
Only panes have titles.
-A pane's title is typically set by the program running inside the pane and
-is not modified by
-.Nm .
-It is the same mechanism used to set for example the
+A pane's title is typically set by the program running inside the pane using
+an escape sequence (like it would set the
.Xr xterm 1
-window title in an
-.Xr X 7
-window manager.
+window title in
+.Xr X 7 Ns ).
Windows themselves do not have titles - a window's title is the title of its
active pane.
.Nm
@@ -3770,6 +3771,11 @@ A pane's title can be set via the OSC title setting sequence, for example:
.Bd -literal -offset indent
$ printf '\e033]2;My Title\e033\e\e'
.Ed
+.Pp
+It can also be modified with the
+.Ic select-pane
+.Fl T
+command.
.Sh ENVIRONMENT
When the server is started,
.Nm