From 759efe1b3327a7244c03ecc7b90e0e3c49712d06 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 11 Oct 2021 10:55:30 +0000
Subject: Add -e flag to set environment for popup, from Alexis Hildebrandt in
 GitHub issue 2924.

---
 tmux.1 | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 027db664..14556ba3 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5753,6 +5753,7 @@ forwards any input read from stdin to the empty pane given by
 .Op Fl BCE
 .Op Fl c Ar target-client
 .Op Fl d Ar start-directory
+.Op Fl e Ar environment
 .Op Fl h Ar height
 .Op Fl t Ar target-pane
 .Op Fl w Ar width
@@ -5793,6 +5794,12 @@ If omitted, half of the terminal size is used.
 .Fl B
 does not surround the popup by a border.
 .Pp
+.Fl e
+takes the form
+.Ql VARIABLE=value
+and sets an environment variable for the popup; it may be specified multiple
+times.
+.Pp
 The
 .Fl C
 flag closes any popup on the client.
-- 
cgit 


From 837ca176d1874273f3de615c75b506e1b1787a1b Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Wed, 13 Oct 2021 09:28:36 +0000
Subject: Add popup-style and popup-border-style options, from Alexis
 Hildebrandt in GitHub issue 2927.

---
 tmux.1 | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 14556ba3..f222e907 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4258,6 +4258,24 @@ see the
 section.
 Attributes are ignored.
 .Pp
+.It Ic popup-style Ar style
+Set the popup style.
+For how to specify
+.Ar style ,
+see the
+.Sx STYLES
+section.
+Attributes are ignored.
+.Pp
+.It Ic popup-border-style Ar style
+Set the popup border style.
+For how to specify
+.Ar style ,
+see the
+.Sx STYLES
+section.
+Attributes are ignored.
+.Pp
 .It Ic window-status-activity-style Ar style
 Set status line style for windows with an activity alert.
 For how to specify
-- 
cgit 


From add20637f256c0118d3c687d5d1446612d14389a Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Thu, 14 Oct 2021 13:19:01 +0000
Subject: Add popup-border-lines option to set popup line style, from Alexis
 Hildebrandt, GitHub issue 2930.

---
 tmux.1 | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index f222e907..cb930c9c 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4276,6 +4276,50 @@ see the
 section.
 Attributes are ignored.
 .Pp
+.It Ic popup-style Ar style
+Set the popup style.
+For how to specify
+.Ar style ,
+see the
+.Sx STYLES
+section.
+Attributes are ignored.
+.Pp
+.It Ic popup-border-style Ar style
+Set the popup border style.
+For how to specify
+.Ar style ,
+see the
+.Sx STYLES
+section.
+Attributes are ignored.
+.Pp
+.It Ic popup-border-lines Ar type
+Set the type of characters used for drawing popup borders.
+.Ar type
+may be one of:
+.Bl -tag -width Ds
+.It single
+single lines using ACS or UTF-8 characters (default)
+.It rounded
+variation of single with rounded corners using UTF-8 characters
+.It double
+double lines using UTF-8 characters
+.It heavy
+heavy lines using UTF-8 characters
+.It simple
+simple ASCII characters
+.It padded
+simple ASCII space character
+.It none
+no border
+.El
+.Pp
+.Ql double
+and
+.Ql heavy
+will fall back to standard ACS line drawing when UTF-8 is not supported.
+.Pp
 .It Ic window-status-activity-style Ar style
 Set status line style for windows with an activity alert.
 For how to specify
@@ -5769,6 +5813,7 @@ forwards any input read from stdin to the empty pane given by
 .Tg popup
 .It Xo Ic display-popup
 .Op Fl BCE
+.Op Fl b Ar border-lines
 .Op Fl c Ar target-client
 .Op Fl d Ar start-directory
 .Op Fl e Ar environment
@@ -5809,9 +5854,22 @@ and
 give the width and height - both may be a percentage (followed by
 .Ql % ) .
 If omitted, half of the terminal size is used.
+.Pp
 .Fl B
 does not surround the popup by a border.
 .Pp
+.Fl b
+sets the type of border line for the popup.
+When
+.Fl B
+is specified the
+.Fl b
+option is ignored.
+See
+.Ic popup-border-lines
+for possible values for
+.Ar border-lines .
+.Pp
 .Fl e
 takes the form
 .Ql VARIABLE=value
-- 
cgit 


From cc27a43c402b412509f4bd63ecf4c263ea65ec81 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 18 Oct 2021 09:09:46 +0000
Subject: Remove duplicate options, spotted by Ricky Cintron.

---
 tmux.1 | 18 ------------------
 1 file changed, 18 deletions(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index cb930c9c..ab92be2e 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4276,24 +4276,6 @@ see the
 section.
 Attributes are ignored.
 .Pp
-.It Ic popup-style Ar style
-Set the popup style.
-For how to specify
-.Ar style ,
-see the
-.Sx STYLES
-section.
-Attributes are ignored.
-.Pp
-.It Ic popup-border-style Ar style
-Set the popup border style.
-For how to specify
-.Ar style ,
-see the
-.Sx STYLES
-section.
-Attributes are ignored.
-.Pp
 .It Ic popup-border-lines Ar type
 Set the type of characters used for drawing popup borders.
 .Ar type
-- 
cgit 


From 8a9bfd0cddd783436e842495fc3039aa56571ed1 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Wed, 20 Oct 2021 09:50:40 +0000
Subject: Add -T to set a popup title, from Alexis Hildebrandt in GitHub issue
 2941.

---
 tmux.1 | 5 +++++
 1 file changed, 5 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index ab92be2e..bf615895 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5801,6 +5801,7 @@ forwards any input read from stdin to the empty pane given by
 .Op Fl e Ar environment
 .Op Fl h Ar height
 .Op Fl t Ar target-pane
+.Op Fl T Ar title
 .Op Fl w Ar width
 .Op Fl x Ar position
 .Op Fl y Ar position
@@ -5858,6 +5859,10 @@ takes the form
 and sets an environment variable for the popup; it may be specified multiple
 times.
 .Pp
+.Fl T
+is a format for the popup title (see
+.Sx FORMATS ) .
+.Pp
 The
 .Fl C
 flag closes any popup on the client.
-- 
cgit 


From ef46eb91a5e0b6e2b023544f45dbc98c8fe1377f Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 25 Oct 2021 09:38:36 +0000
Subject: Add -s and -S to display-popup to set popup and border style, from
 Alexis Hildebrandt in GitHub issue 2931.

---
 tmux.1 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index bf615895..9bedb20b 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5800,6 +5800,8 @@ forwards any input read from stdin to the empty pane given by
 .Op Fl d Ar start-directory
 .Op Fl e Ar environment
 .Op Fl h Ar height
+.Op Fl s Ar style
+.Op Fl S Ar border-style
 .Op Fl t Ar target-pane
 .Op Fl T Ar title
 .Op Fl w Ar width
@@ -5853,6 +5855,16 @@ See
 for possible values for
 .Ar border-lines .
 .Pp
+.Fl s
+sets the style for the popup and
+.Fl S
+sets the style for the popup border.
+For how to specify
+.Ar style ,
+see the
+.Sx STYLES
+section.
+.Pp
 .Fl e
 takes the form
 .Ql VARIABLE=value
-- 
cgit 


From eb82ad5216f1538e13f4ad7c2d36f28fedd88310 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 25 Oct 2021 20:32:42 +0000
Subject: Missing Pp, from Alexis Hildebrandt.

---
 tmux.1 | 1 +
 1 file changed, 1 insertion(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 9bedb20b..c270309f 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4214,6 +4214,7 @@ see the
 .Sx STYLES
 section.
 Attributes are ignored.
+.Pp
 .It Ic pane-base-index Ar index
 Like
 .Ic base-index ,
-- 
cgit 


From 197a116f5a2146309c4c6fecbd9d08d36f2be750 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 25 Oct 2021 21:21:16 +0000
Subject: Add a way to force a colour to RGB and a format to display it.

---
 tmux.1 | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index c270309f..35a87bd0 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4831,6 +4831,10 @@ replaces a numeric argument by its ASCII equivalent, so
 .Ql #{a:98}
 results in
 .Ql b .
+.Ql c
+replaces a
+.Nm
+colour by its six-digit hexadecimal RGB value.
 .Pp
 A limit may be placed on the length of the resultant string by prefixing it
 by an
-- 
cgit 


From 8d2286b76917debc4f6c3b0903ad2807ae254bb5 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 1 Nov 2021 09:34:49 +0000
Subject: Add a cursor-colour option, from Alexis Hildebrandt in GitHub issue
 2959.

---
 tmux.1 | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 35a87bd0..eb2340e3 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4416,6 +4416,9 @@ The alternate screen feature preserves the contents of the window when an
 interactive application starts and restores it on exit, so that any output
 visible before the application starts reappears unchanged after it exits.
 .Pp
+.It Ic cursor-colour Ar colour
+Set the colour of the cursor.
+.Pp
 .It Ic pane-colours[] Ar colour
 The default colour palette.
 Each entry in the array defines the colour
-- 
cgit 


From 57100376cc70739f53a1f8a4bacf192b8cdcd124 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Wed, 3 Nov 2021 13:37:17 +0000
Subject: Add a cursor-style option, from Alexis Hildebrandt in GitHub issue
 2960.

---
 tmux.1 | 10 ++++++++++
 1 file changed, 10 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index eb2340e3..4131719c 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4426,6 +4426,16 @@ Each entry in the array defines the colour
 uses when the colour with that index is requested.
 The index may be from zero to 255.
 .Pp
+.It Ic cursor-style Ar style
+Set the style of the cursor. Available styles are:
+.Ic default ,
+.Ic blinking-block ,
+.Ic block ,
+.Ic blinking-underline ,
+.Ic underline ,
+.Ic blinking-bar ,
+.Ic bar .
+.Pp
 .It Xo Ic remain-on-exit
 .Op Ic on | off | failed
 .Xc
-- 
cgit 


From 8f1cc0e9fa78a6200ba6bddf7c8958225d9fdd6d Mon Sep 17 00:00:00 2001
From: kn <kn>
Date: Thu, 4 Nov 2021 13:15:13 +0000
Subject: Fix mandoc HTML rendering for command aliases

Replace hand-rolled parentheses with the proper mdoc(7) macro,
otherwise the closing ")" ends up inside the command description.

Reported by Josh Rickmar, thanks!
---
 tmux.1 | 150 ++++++++++++++++++++++++++++++++---------------------------------
 1 file changed, 75 insertions(+), 75 deletions(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 4131719c..20723308 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1034,7 +1034,7 @@ The following commands are available to manage clients and sessions:
 .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
@@ -1121,7 +1121,7 @@ option will not be applied.
 .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
@@ -1143,7 +1143,7 @@ run
 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
@@ -1168,7 +1168,7 @@ session.
 .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
@@ -1183,7 +1183,7 @@ is specified, list only clients connected to that session.
 .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
@@ -1193,7 +1193,7 @@ or - if omitted - of all commands supported by
 .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
@@ -1205,7 +1205,7 @@ See the
 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
@@ -1213,7 +1213,7 @@ see the
 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
@@ -1230,7 +1230,7 @@ Lock all clients attached to
 .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
@@ -1346,7 +1346,7 @@ specified multiple times.
 .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 .
@@ -1477,7 +1477,7 @@ option.
 .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
@@ -1485,7 +1485,7 @@ Rename the session to
 .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
@@ -1500,7 +1500,7 @@ show debugging information about jobs and terminals.
 .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
@@ -1523,7 +1523,7 @@ the file is parsed but no commands are executed.
 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.
@@ -1542,7 +1542,7 @@ $ tmux start \\; show -g
 .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).
@@ -1553,7 +1553,7 @@ Suspend a client by sending
 .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
 to
@@ -1945,7 +1945,7 @@ Commands related to windows and panes are as follows:
 .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
@@ -1974,7 +1974,7 @@ but a different format may be specified with
 .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.
 If
 .Fl p
@@ -2226,7 +2226,7 @@ This command works only if at least one client is attached.
 .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
@@ -2266,7 +2266,7 @@ other commands are not blocked from running until the indicator is closed.
 .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
@@ -2296,7 +2296,7 @@ This command works only if at least one client is attached.
 .Op Fl s Ar src-pane
 .Op Fl t Ar dst-pane
 .Xc
-.D1 (alias: Ic joinp )
+.D1 Pq alias: Ic joinp
 Like
 .Ic split-window ,
 but instead of splitting
@@ -2324,7 +2324,7 @@ the marked pane is used rather than the current pane.
 .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
@@ -2336,7 +2336,7 @@ option kills all but the pane given with
 .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.
@@ -2349,7 +2349,7 @@ option kills all but the window given with
 .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.
@@ -2359,7 +2359,7 @@ enables or
 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
@@ -2370,7 +2370,7 @@ is specified, select the last window of the current session.
 .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
@@ -2402,7 +2402,7 @@ is given, the newly linked window is not selected.
 .Op Fl f Ar filter
 .Op Fl t Ar target
 .Xc
-.D1 (alias: Ic lsp )
+.D1 Pq alias: Ic lsp
 If
 .Fl a
 is given,
@@ -2431,7 +2431,7 @@ section.
 .Op Fl f Ar filter
 .Op Fl t Ar target-session
 .Xc
-.D1 (alias: Ic lsw )
+.D1 Pq alias: Ic lsw
 If
 .Fl a
 is given, list all windows on the server.
@@ -2452,7 +2452,7 @@ section.
 .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
@@ -2461,7 +2461,7 @@ Does the same as
 .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
@@ -2484,7 +2484,7 @@ option.
 .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
@@ -2559,14 +2559,14 @@ but a different format may be specified with
 .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.
 If
 .Fl a
@@ -2577,7 +2577,7 @@ is used, move to the next window with an alert.
 .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.
@@ -2624,14 +2624,14 @@ bind-key C-p pipe-pane -o 'cat >>~/output.#I-#P'
 .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 ,
@@ -2641,7 +2641,7 @@ move to the previous window with an alert.
 .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
@@ -2654,7 +2654,7 @@ if specified, to
 .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
@@ -2699,7 +2699,7 @@ history to replace them.
 .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
@@ -2732,7 +2732,7 @@ to manual in the window options.
 .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).
@@ -2758,7 +2758,7 @@ command.
 .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).
@@ -2781,7 +2781,7 @@ command.
 .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
@@ -2794,7 +2794,7 @@ keeps the window zoomed if it was zoomed.
 .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.
 If
 .Ar layout-name
@@ -2817,7 +2817,7 @@ spreads the current pane and any panes next to it out evenly.
 .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.
@@ -2861,7 +2861,7 @@ and
 .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 ,
@@ -2889,7 +2889,7 @@ the command behaves like
 .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
@@ -2946,7 +2946,7 @@ command.
 .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.
 If
 .Fl U
@@ -2975,7 +2975,7 @@ the marked pane is used rather than the current pane.
 .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.
@@ -2996,7 +2996,7 @@ the window containing the marked pane is used rather than the current window.
 .Op Fl k
 .Op Fl t Ar target-window
 .Xc
-.D1 (alias: Ic unlinkw )
+.D1 Pq alias: Ic unlinkw
 Unlink
 .Ar target-window .
 Unless
@@ -3069,7 +3069,7 @@ Commands related to key bindings are as follows:
 .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
 to
@@ -3127,7 +3127,7 @@ command.
 .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
@@ -3164,7 +3164,7 @@ lists the command for keys that do not have a note rather than skipping them.
 .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
@@ -3215,7 +3215,7 @@ the secondary prefix key, to a window as if it was pressed.
 .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
@@ -3311,7 +3311,7 @@ Commands which set options are as follows:
 .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
@@ -3386,7 +3386,7 @@ the result would be the default background and a blue foreground.
 .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
@@ -5425,7 +5425,7 @@ Commands to alter and view the environment are:
 .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.
 If
 .Fl g
@@ -5451,7 +5451,7 @@ marks the variable as hidden.
 .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
@@ -5534,7 +5534,7 @@ Commands related to the status line are as follows:
 .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 .
 If
@@ -5660,7 +5660,7 @@ until it is dismissed.
 .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 .
 If
@@ -5689,7 +5689,7 @@ until it is dismissed.
 .Ar command
 .Ar ...
 .Xc
-.D1 (alias: Ic menu )
+.D1 Pq alias: Ic menu
 Display a menu on
 .Ar target-client .
 .Ar target-pane
@@ -5776,7 +5776,7 @@ The following keys are also available:
 .Op Fl t Ar target-pane
 .Op Ar message
 .Xc
-.D1 (alias: Ic display )
+.D1 Pq alias: Ic display
 Display a message.
 If
 .Fl p
@@ -5827,7 +5827,7 @@ forwards any input read from stdin to the empty pane given by
 .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
 on
@@ -5900,7 +5900,7 @@ flag closes any popup on the client.
 .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 .
 If
@@ -6028,11 +6028,11 @@ starts without the preview.
 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.
@@ -6041,7 +6041,7 @@ or the most recently added automatically named buffer if not specified.
 .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
@@ -6058,7 +6058,7 @@ section.
 .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 .
 If
@@ -6075,7 +6075,7 @@ escape sequence, if possible.
 .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
@@ -6099,7 +6099,7 @@ buffer if the application has requested bracketed paste mode.
 .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
@@ -6113,7 +6113,7 @@ option appends to rather than overwriting the file.
 .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 .
 If
@@ -6134,7 +6134,7 @@ option renames the buffer to
 .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
@@ -6149,7 +6149,7 @@ Display a large clock.
 .Ar shell-command command
 .Op Ar command
 .Xc
-.D1 (alias: Ic if )
+.D1 Pq alias: Ic if
 Execute the first
 .Ar command
 if
@@ -6176,7 +6176,7 @@ is not executed but considered success if neither empty nor zero (after formats
 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.
@@ -6187,7 +6187,7 @@ option.
 .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
@@ -6219,7 +6219,7 @@ If the command fails, the exit status is also displayed.
 .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
-- 
cgit 


From 630c592ef8740a935ba6c12c957a359c94414219 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Thu, 11 Nov 2021 09:22:33 +0000
Subject: If trimming menu item text, show key if it would take up less than a
 quarter of the space; from Alexis Hildebrandt.

Also new sentence, new line in tmux.1, from jmc.
---
 tmux.1 | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 20723308..7d5c7357 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4427,7 +4427,8 @@ uses when the colour with that index is requested.
 The index may be from zero to 255.
 .Pp
 .It Ic cursor-style Ar style
-Set the style of the cursor. Available styles are:
+Set the style of the cursor.
+Available styles are:
 .Ic default ,
 .Ic blinking-block ,
 .Ic block ,
-- 
cgit 


From 1f9aad2bb40fe90bec38288b08e8b152f13e04ad Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Fri, 10 Dec 2021 12:45:32 +0000
Subject: Mention XParseColor(3) for the cursor colour escape sequence.

---
 tmux.1 | 5 +++++
 1 file changed, 5 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 7d5c7357..00750dd6 100644
--- a/tmux.1
+++ b/tmux.1
@@ -6292,6 +6292,11 @@ to change the cursor colour from inside
 .Bd -literal -offset indent
 $ printf '\e033]12;red\e033\e\e'
 .Ed
+.Pp
+The colour is an
+.Xr X 7
+colour, see
+.Xr XParseColor 3 .
 .It Em \&Cmg, \&Clmg, \&Dsmg , \&Enmg
 Set, clear, disable or enable DECSLRM margins.
 These are set automatically if the terminal reports it is
-- 
cgit 


From 9c1633a8659c4045b8303eb99d5f89b4f0dcb784 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Fri, 10 Dec 2021 12:51:11 +0000
Subject: Missed unlinked control notifications, GitHub issue 2996.

---
 tmux.1 | 8 ++++++++
 1 file changed, 8 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 00750dd6..708f5c75 100644
--- a/tmux.1
+++ b/tmux.1
@@ -6512,6 +6512,14 @@ are for future use and should be ignored.
 The window with ID
 .Ar window-id
 was created but is not linked to the current session.
+.It Ic %unlinked-window-close Ar window-id
+The window with ID
+.Ar window-id ,
+which is not linked to the current session, was closed.
+.It Ic %unlinked-window-renamed Ar window-id
+The window with ID
+.Ar window-id ,
+which is not linked to the current session, was renamed.
 .It Ic %window-add Ar window-id
 The window with ID
 .Ar window-id
-- 
cgit 


From e5e4df7a2241298b7ea3ba77b5fe1fdef6df0e08 Mon Sep 17 00:00:00 2001
From: Nicholas Marriott <nicholas.marriott@gmail.com>
Date: Thu, 6 Jan 2022 08:23:42 +0000
Subject: Mention alternate config files, from Daniel Augusto in GitHub issue
 3023.

---
 tmux.1 | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 50a356a5..78a7d10b 100644
--- a/tmux.1
+++ b/tmux.1
@@ -140,7 +140,10 @@ By default,
 loads the system configuration file from
 .Pa @SYSCONFDIR@/tmux.conf ,
 if present, then looks for a user configuration file at
-.Pa ~/.tmux.conf .
+.Pa ~/.tmux.conf,
+.Pa $XDG_CONFIG_HOME/tmux/tmux.conf
+or
+.Pa ~/.config/tmux/tmux.conf .
 .Pp
 The configuration file is a set of
 .Nm
@@ -6627,6 +6630,8 @@ options.
 .Sh FILES
 .Bl -tag -width "@SYSCONFDIR@/tmux.confXXX" -compact
 .It Pa ~/.tmux.conf
+.It Pa $XDG_CONFIG_HOME/tmux/tmux.conf
+.It Pa ~/.config/tmux/tmux.conf
 Default
 .Nm
 configuration file.
-- 
cgit 


From 7a4ba6d4a5458f4e2450024d72f0e16905dd5c64 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 1 Feb 2022 12:05:42 +0000
Subject: Mention that if-shell and #() use /bin/sh.

---
 tmux.1 | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 708f5c75..5310b97f 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4989,7 +4989,9 @@ commands to finish; instead, the previous result from running the same command i
 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
 line will not be updated more than once a second.
-Commands are executed with the
+Commands are executed using
+.Pa /bin/sh
+and with the
 .Nm
 global environment set (see the
 .Sx GLOBAL AND SESSION ENVIRONMENT
@@ -6155,6 +6157,8 @@ Execute the first
 .Ar command
 if
 .Ar shell-command
+(run with
+.Pa /bin/sh )
 returns success or the second
 .Ar command
 otherwise.
@@ -6191,6 +6195,8 @@ option.
 .D1 Pq alias: Ic run
 Execute
 .Ar shell-command
+using
+.Pa /bin/sh
 or (with
 .Fl C )
 a
-- 
cgit 


From 7e34645fcbe93984461343d67373a29e552fec20 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 1 Feb 2022 14:46:41 +0000
Subject: Add option to show arrows for active pane indicator, GitHub issue
 3022 from Marcel Partap.

---
 tmux.1 | 6 ++++++
 1 file changed, 6 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 5310b97f..7a8b9f24 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4223,6 +4223,12 @@ but set the starting index for pane numbers.
 .It Ic pane-border-format Ar format
 Set the text shown in pane border status lines.
 .Pp
+.It Xo Ic pane-border-indicators
+.Op Ic off | colour | arrows | both
+.Xc
+Indicate active pane by colouring only half of the border in windows with
+exactly two panes, by displaying arrow markers, by drawing both or neither.
+.Pp
 .It Ic pane-border-lines Ar type
 Set the type of characters used for drawing pane borders.
 .Ar type
-- 
cgit 


From 5080acc12714862ef7a66286d7c3bce538c6d74f Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Thu, 3 Feb 2022 07:26:43 +0000
Subject: Add a key in copy mode to toggle position indicator.

---
 tmux.1 | 1 +
 1 file changed, 1 insertion(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 7a8b9f24..255f10a9 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1773,6 +1773,7 @@ The following commands are supported in copy mode:
 .It Li "set-mark" Ta "X" Ta "X"
 .It Li "start-of-line" Ta "0" Ta "C-a"
 .It Li "stop-selection" Ta "" Ta ""
+.It Li "toggle-position" Ta "P" Ta "P"
 .It Li "top-line" Ta "H" Ta "M-R"
 .El
 .Pp
-- 
cgit 


From 5076beb009f761999a3b218a1a8d7cbfbc80ee03 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 15 Feb 2022 13:11:29 +0000
Subject: Add an option (default off) to control the passthrough escape
 sequence. Like set-clipboard and allow-rename it is safer to forbid this by
 default.

---
 tmux.1 | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 255f10a9..c9c9f221 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4403,6 +4403,13 @@ The default is on.
 Available pane options are:
 .Pp
 .Bl -tag -width Ds -compact
+.It Xo Ic allow-passthrough
+.Op Ic on | off
+.Xc
+Allow programs in the pane to bypass
+.Nm
+using a terminal escape sequence (\eePtmux;...\ee\e\e).
+.Pp
 .It Xo Ic allow-rename
 .Op Ic on | off
 .Xc
-- 
cgit 


From fa71e9a07911715da596d618fe045943337c596b Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 22 Feb 2022 11:10:41 +0000
Subject: Add next_session_id format with the next session ID, GitHub issue
 3078.

---
 tmux.1 | 6 ++++++
 1 file changed, 6 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index c9c9f221..22eb6b1f 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4589,6 +4589,11 @@ Run when a session is renamed.
 Run when a window is linked into a session.
 .It window-renamed
 Run when a window is renamed.
+.It window-resized
+Run when a window is resized.
+This may be after the
+.Ar client-resized
+hook is run.
 .It window-unlinked
 Run when a window is unlinked from a session.
 .El
@@ -5093,6 +5098,7 @@ The following variables are available, where appropriate:
 .It Li "mouse_word" Ta "" Ta "Word under mouse, if any"
 .It Li "mouse_x" Ta "" Ta "Mouse X position, if any"
 .It Li "mouse_y" Ta "" Ta "Mouse Y position, if any"
+.It Li "next_session_id" Ta "" Ta "Unique session ID for next new session"
 .It Li "origin_flag" Ta "" Ta "Pane origin flag"
 .It Li "pane_active" Ta "" Ta "1 if active pane"
 .It Li "pane_at_bottom" Ta "" Ta "1 if pane is at the bottom of window"
-- 
cgit 


From ad9b8059836d424f70a8579d28e28e0186cdbaa6 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 8 Mar 2022 12:01:19 +0000
Subject: Add argument to refresh-client -l to forward clipboard to a pane.
 GitHub issue 3068.

---
 tmux.1 | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 22eb6b1f..215d825c 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1338,11 +1338,12 @@ and sets an environment variable for the newly created session; it may be
 specified multiple times.
 .Tg refresh
 .It Xo Ic refresh-client
-.Op Fl cDlLRSU
+.Op Fl cDLRSU
 .Op Fl A Ar pane:state
 .Op Fl B Ar name:what:format
 .Op Fl C Ar size
 .Op Fl f Ar flags
+.Op Fl l Op Ar target-pane
 .Op Fl t Ar target-client
 .Op Ar adjustment
 .Xc
@@ -1456,7 +1457,11 @@ sets a comma-separated list of client flags, see
 .Fl l
 requests the clipboard from the client using the
 .Xr xterm 1
-escape sequence and stores it in a new paste buffer.
+escape sequence.
+If
+Ar target-pane
+is given, the clipboard is sent (in encoded form), otherwise it is stored in a
+new paste buffer.
 .Pp
 .Fl L ,
 .Fl R ,
@@ -5054,6 +5059,8 @@ The following variables are available, where appropriate:
 .It Li "client_termname" Ta "" Ta "Terminal name of client"
 .It Li "client_termtype" Ta "" Ta "Terminal type of client, if available"
 .It Li "client_tty" Ta "" Ta "Pseudo terminal of client"
+.It Li "client_uid" Ta "" Ta "UID of client process"
+.It Li "client_user" Ta "" Ta "User of client process"
 .It Li "client_utf8" Ta "" Ta "1 if client supports UTF-8"
 .It Li "client_width" Ta "" Ta "Width of client"
 .It Li "client_written" Ta "" Ta "Bytes written to client"
@@ -5171,6 +5178,8 @@ The following variables are available, where appropriate:
 .It Li "session_windows" Ta "" Ta "Number of windows in session"
 .It Li "socket_path" Ta "" Ta "Server socket path"
 .It Li "start_time" Ta "" Ta "Server start time"
+.It Li "uid" Ta "" Ta "Server UID"
+.It Li "user" Ta "" Ta "Server user"
 .It Li "version" Ta "" Ta "Server version"
 .It Li "window_active" Ta "" Ta "1 if window active"
 .It Li "window_active_clients" Ta "" Ta "Number of clients viewing this window"
@@ -5185,7 +5194,6 @@ The following variables are available, where appropriate:
 .It Li "window_cell_width" Ta "" Ta "Width of each cell in pixels"
 .It Li "window_end_flag" Ta "" Ta "1 if window has the highest index"
 .It Li "window_flags" Ta "#F" Ta "Window flags with # escaped as ##"
-.It Li "window_raw_flags" Ta "" Ta "Window flags with nothing escaped"
 .It Li "window_format" Ta "" Ta "1 if format is for a window"
 .It Li "window_height" Ta "" Ta "Height of window"
 .It Li "window_id" Ta "" Ta "Unique window ID"
@@ -5200,6 +5208,7 @@ The following variables are available, where appropriate:
 .It Li "window_offset_x" Ta "" Ta "X offset into window if larger than client"
 .It Li "window_offset_y" Ta "" Ta "Y offset into window if larger than client"
 .It Li "window_panes" Ta "" Ta "Number of panes in window"
+.It Li "window_raw_flags" Ta "" Ta "Window flags with nothing escaped"
 .It Li "window_silence_flag" Ta "" Ta "1 if window has silence alert"
 .It Li "window_stack_index" Ta "" Ta "Index in session most recent stack"
 .It Li "window_start_flag" Ta "" Ta "1 if window has the lowest index"
-- 
cgit 


From a3d920930bf77cafa5260e25584dd3ba1d26f9cb Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 8 Mar 2022 18:31:46 +0000
Subject: Add remain-on-exit-format to set text shown when pane is dead.

---
 tmux.1 | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 215d825c..d204e454 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4468,6 +4468,11 @@ The pane may be reactivated with the
 .Ic respawn-pane
 command.
 .Pp
+.It Ic remain-on-exit-format Ar string
+Set the text shown at the bottom of exited panes when
+.Ic remain-on-exit
+is enabled.
+.Pp
 .It Xo Ic synchronize-panes
 .Op Ic on | off
 .Xc
@@ -5117,7 +5122,9 @@ The following variables are available, where appropriate:
 .It Li "pane_current_command" Ta "" Ta "Current command if available"
 .It Li "pane_current_path" Ta "" Ta "Current path if available"
 .It Li "pane_dead" Ta "" Ta "1 if pane is dead"
+.It Li "pane_dead_signal" Ta "" Ta "Exit signal of process in dead pane"
 .It Li "pane_dead_status" Ta "" Ta "Exit status of process in dead pane"
+.It Li "pane_dead_time" Ta "" Ta "Exit time of process in dead pane"
 .It Li "pane_fg" Ta "" Ta "Pane foreground colour"
 .It Li "pane_format" Ta "" Ta "1 if format is for a pane"
 .It Li "pane_height" Ta "" Ta "Height of pane"
-- 
cgit 


From e6e737ac0bf9a5be729b5c71f3a582355432d041 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Wed, 16 Mar 2022 17:00:17 +0000
Subject: Add an option to set the character used for unused areas of the
 terminal, GitHub issue 3110.

---
 tmux.1 | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index d204e454..6c9ff820 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4114,6 +4114,9 @@ Set clock colour.
 .Xc
 Set clock hour format.
 .Pp
+.It Ic fill-character Ar character
+Set the character used to fill areas of the terminal unused by a window.
+.Pp
 .It Ic main-pane-height Ar height
 .It Ic main-pane-width Ar width
 Set the width or height of the main (left or top) pane in the
-- 
cgit 


From 10d689e7354f789f951016f7f4d57a0c2d14e124 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Thu, 17 Mar 2022 11:35:37 +0000
Subject: Add an option (scroll-on-clear) to control if tmux scrolls into
 history on clear, from Robert Lange in GitHub issue 3121.

---
 tmux.1 | 6 ++++++
 1 file changed, 6 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 6c9ff820..bc5c1a55 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4476,6 +4476,12 @@ Set the text shown at the bottom of exited panes when
 .Ic remain-on-exit
 is enabled.
 .Pp
+.It Xo Ic scroll-on-clear
+.Op Ic on | off
+.Xc
+When the entire screen is cleared and this option is on, scroll the contents of
+the screen into history before clearing it.
+.Pp
 .It Xo Ic synchronize-panes
 .Op Ic on | off
 .Xc
-- 
cgit 


From 792d13af49f2550a9a8d11b0099528628957a1a0 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Thu, 24 Mar 2022 09:05:57 +0000
Subject: Add a capability for OSC 7 and use it similarly to how the title is
 set (and controlled by the same set-titles option). GitHub issue 3127.

---
 tmux.1 | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index bc5c1a55..5c8a3bd9 100644
--- a/tmux.1
+++ b/tmux.1
@@ -3624,6 +3624,8 @@ Supports DECSLRM margins.
 Supports
 .Xr xterm 1
 mouse sequences.
+.It osc7
+Supports the OSC 7 working directory extension.
 .It overline
 Supports the overline SGR attribute.
 .It rectfill
@@ -6391,6 +6393,11 @@ $ printf '\e033[4 q'
 If
 .Em Se
 is not set, \&Ss with argument 0 will be used to reset the cursor style instead.
+.It Em \&Swd
+Set the opening sequence for the working directory notification.
+The sequence is terminated using the standard
+.Em fsl
+capability.
 .It Em \&Sync
 Start (parameter is 1) or end (parameter is 2) a synchronized update.
 .It Em \&Tc
-- 
cgit 


From 2d9f4ca9a1368f47ddd6e121c9b1a7822884a31a Mon Sep 17 00:00:00 2001
From: naddy <naddy>
Date: Thu, 31 Mar 2022 17:27:27 +0000
Subject: man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@
---
 tmux.1 | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 5c8a3bd9..9342004f 100644
--- a/tmux.1
+++ b/tmux.1
@@ -43,7 +43,7 @@ then later reattached.
 .Pp
 When
 .Nm
-is started it creates a new
+is started, it creates a new
 .Em session
 with a single
 .Em window
@@ -5915,7 +5915,7 @@ does not surround the popup by a border.
 sets the type of border line for the popup.
 When
 .Fl B
-is specified the
+is specified, the
 .Fl b
 option is ignored.
 See
@@ -6636,7 +6636,7 @@ are replaced with underscores
 For input,
 .Nm
 always runs with a UTF-8 locale.
-If en_US.UTF-8 is provided by the operating system it is used and
+If en_US.UTF-8 is provided by the operating system, it is used and
 .Ev LC_CTYPE
 is ignored for input.
 Otherwise,
-- 
cgit 


From d6306b634e4a044e3380ed984dc7f5e5d67e69ac Mon Sep 17 00:00:00 2001
From: Nicholas Marriott <nicholas.marriott@gmail.com>
Date: Wed, 6 Apr 2022 14:28:50 +0100
Subject: Add an ACL list for users connecting to the tmux socket. Users may be
 forbidden from attaching, forced to attach read-only, or allowed to attach
 read-write. A new command, server-access, configures the list. tmux gets the
 user using getpeereid(3) of the client socket. Users must still configure
 file system permissions manually.

---
 tmux.1 | 40 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index ae6b6fb8..d21e1e42 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1488,6 +1488,44 @@ option.
 .D1 Pq alias: Ic rename
 Rename the session to
 .Ar new-name .
+.It Xo Ic server-access
+.Op Fl adlrw
+.Op Ar user
+.Xc
+Change the access or read/write permission of
+.Ar user .
+The user running the
+.Nm
+server (its owner) and the root user cannot be changed and are always
+permitted access.
+.Pp
+.Fl a
+and
+.Fl d
+are used to give or revoke access for the specified user.
+If the user is already attached, the
+.Fl d
+flag causes their clients to be detached.
+.Pp
+.Fl r
+and
+.Fl w
+change the permissions for
+.Ar user :
+.Fl r
+makes their clients read-only and
+.Fl w
+writable.
+.Fl l
+lists current access permissions.
+.Pp
+By default, the access list is empty and
+.Nm
+creates sockets with file system permissions preventing access by any user
+other than the owner (and root).
+These permissions must be changed manually.
+Great care should be taken not to allow access to untrusted users even
+read-only.
 .Tg showmsgs
 .It Xo Ic show-messages
 .Op Fl JT
@@ -5072,7 +5110,7 @@ The following variables are available, where appropriate:
 .It Li "client_name" Ta "" Ta "Name of client"
 .It Li "client_pid" Ta "" Ta "PID of client process"
 .It Li "client_prefix" Ta "" Ta "1 if prefix key has been pressed"
-.It Li "client_readonly" Ta "" Ta "1 if client is readonly"
+.It Li "client_readonly" Ta "" Ta "1 if client is read-only"
 .It Li "client_session" Ta "" Ta "Name of the client's session"
 .It Li "client_termfeatures" Ta "" Ta "Terminal features of client, if any"
 .It Li "client_termname" Ta "" Ta "Terminal name of client"
-- 
cgit 


From d4423dca19d6d5cbaa97336a744ec760841c3816 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Thu, 14 Apr 2022 06:59:29 +0000
Subject: Fix clearphist alias, from Jacqueline Jolicoeur via jmc@.

---
 tmux.1 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 9342004f..f6b498e9 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5580,11 +5580,11 @@ session option.
 .Pp
 Commands related to the status line are as follows:
 .Bl -tag -width Ds
-.Tg clrphist
+.Tg clearphist
 .It Xo Ic clear-prompt-history
 .Op Fl T Ar prompt-type
 .Xc
-.D1 Pq alias: Ic clrphist
+.D1 Pq alias: Ic clearphist
 Clear status prompt history for prompt type
 .Ar prompt-type .
 If
-- 
cgit 


From 1b28b2b51d264544a7c9490087561c9192459ba5 Mon Sep 17 00:00:00 2001
From: Nicholas Marriott <nicholas.marriott@gmail.com>
Date: Fri, 20 May 2022 08:49:05 +0100
Subject: Add pane_start_path to match start_command.

---
 tmux.1 | 1 +
 1 file changed, 1 insertion(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index e1115fe2..61834a94 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5195,6 +5195,7 @@ The following variables are available, where appropriate:
 .It Li "pane_right" Ta "" Ta "Right of pane"
 .It Li "pane_search_string" Ta "" Ta "Last search string in copy mode"
 .It Li "pane_start_command" Ta "" Ta "Command pane started with"
+.It Li "pane_start_path" Ta "" Ta "Path pane started with"
 .It Li "pane_synchronized" Ta "" Ta "1 if pane is synchronized"
 .It Li "pane_tabs" Ta "" Ta "Pane tab positions"
 .It Li "pane_title" Ta "#T" Ta "Title of pane (can be set by application)"
-- 
cgit 


From bf33e807b60c34792d60a9304cec782323da8826 Mon Sep 17 00:00:00 2001
From: Nicholas Marriott <nicholas.marriott@gmail.com>
Date: Mon, 30 May 2022 08:43:06 +0100
Subject: Fix property name, from Sergei Dyshel.

---
 tmux.1 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 61834a94..d89ee840 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5880,7 +5880,7 @@ milliseconds.
 If
 .Ar delay
 is not given, the
-.Ic message-time
+.Ic display-time
 option is used; a delay of zero waits for a key press.
 .Ql N
 ignores key presses and closes only after the delay expires.
-- 
cgit 


From cd692b5a68be0eb95252380db97fbbec587d6350 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 30 May 2022 12:48:57 +0000
Subject: Add an ACL list for users connecting to the tmux socket. Users may be
 forbidden from attaching, forced to attach read-only, or allowed to attach
 read-write. A new command, server-access, configures the list. tmux gets the
 user using getpeereid(3) of the client socket. Users must still configure
 file system permissions manually. From Dallas Lyons and others.

---
 tmux.1 | 40 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index f6b498e9..3f7ed889 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1485,6 +1485,44 @@ option.
 .D1 Pq alias: Ic rename
 Rename the session to
 .Ar new-name .
+.It Xo Ic server-access
+.Op Fl adlrw
+.Op Ar user
+.Xc
+Change the access or read/write permission of
+.Ar user .
+The user running the
+.Nm
+server (its owner) and the root user cannot be changed and are always
+permitted access.
+.Pp
+.Fl a
+and
+.Fl d
+are used to give or revoke access for the specified user.
+If the user is already attached, the
+.Fl d
+flag causes their clients to be detached.
+.Pp
+.Fl r
+and
+.Fl w
+change the permissions for
+.Ar user :
+.Fl r
+makes their clients read-only and
+.Fl w
+writable.
+.Fl l
+lists current access permissions.
+.Pp
+By default, the access list is empty and
+.Nm
+creates sockets with file system permissions preventing access by any user
+other than the owner (and root).
+These permissions must be changed manually.
+Great care should be taken not to allow access to untrusted users even
+read-only.
 .Tg showmsgs
 .It Xo Ic show-messages
 .Op Fl JT
@@ -5069,7 +5107,7 @@ The following variables are available, where appropriate:
 .It Li "client_name" Ta "" Ta "Name of client"
 .It Li "client_pid" Ta "" Ta "PID of client process"
 .It Li "client_prefix" Ta "" Ta "1 if prefix key has been pressed"
-.It Li "client_readonly" Ta "" Ta "1 if client is readonly"
+.It Li "client_readonly" Ta "" Ta "1 if client is read-only"
 .It Li "client_session" Ta "" Ta "Name of the client's session"
 .It Li "client_termfeatures" Ta "" Ta "Terminal features of client, if any"
 .It Li "client_termname" Ta "" Ta "Terminal name of client"
-- 
cgit 


From 384f0ee269a49b8a139f8090264420df3a93ff78 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 30 May 2022 13:06:10 +0000
Subject: Fix property name from Sergei Dyshel, and a typo from imcusg at gmail
 dot com.

---
 tmux.1 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 3f7ed889..da13b1e9 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5876,7 +5876,7 @@ milliseconds.
 If
 .Ar delay
 is not given, the
-.Ic message-time
+.Ic display-time
 option is used; a delay of zero waits for a key press.
 .Ql N
 ignores key presses and closes only after the delay expires.
-- 
cgit 


From 2f2bb82f5f9c7ba995e8c21a217926efbbb4c5e5 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 30 May 2022 13:07:06 +0000
Subject: Add pane_start_path to match start_command.

---
 tmux.1 | 1 +
 1 file changed, 1 insertion(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index da13b1e9..c58597c6 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5192,6 +5192,7 @@ The following variables are available, where appropriate:
 .It Li "pane_right" Ta "" Ta "Right of pane"
 .It Li "pane_search_string" Ta "" Ta "Last search string in copy mode"
 .It Li "pane_start_command" Ta "" Ta "Command pane started with"
+.It Li "pane_start_path" Ta "" Ta "Path pane started with"
 .It Li "pane_synchronized" Ta "" Ta "1 if pane is synchronized"
 .It Li "pane_tabs" Ta "" Ta "Pane tab positions"
 .It Li "pane_title" Ta "#T" Ta "Title of pane (can be set by application)"
-- 
cgit 


From 616bde08ac74d4be0ae06087aa3103df54833f86 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 14 Jun 2022 07:29:00 +0000
Subject: kf* terminfo capabilities are poorly defined and rxvt uses them in a
 different way from xterm, so add a feature flag for rxvt to make tmux ignore
 the capabilities and instead rely on its builtin definitions.

---
 tmux.1 | 6 ++++++
 1 file changed, 6 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index c58597c6..f06a42a4 100644
--- a/tmux.1
+++ b/tmux.1
@@ -3656,6 +3656,12 @@ Allows setting the cursor style.
 Supports extended keys.
 .It focus
 Supports focus reporting.
+.It ignorefkeys
+Ignore function keys from
+.Xr terminfo 5
+and use the
+.Nm
+internal set only.
 .It margins
 Supports DECSLRM margins.
 .It mouse
-- 
cgit 


From a888ce9963053c790c6ee9bf64cc53d95f0f9c09 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 20 Jun 2022 07:59:37 +0000
Subject: Do not display configuration file errors in a pane when in control
 mode, instead report them with a %config-error notification. GitHub issue
 3193.

---
 tmux.1 | 2 ++
 1 file changed, 2 insertions(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index f06a42a4..44b96eb7 100644
--- a/tmux.1
+++ b/tmux.1
@@ -6529,6 +6529,8 @@ The client is now attached to the session with ID
 .Ar session-id ,
 which is named
 .Ar name .
+.It Ic %config-error Ar error
+An error has happened in a configuration file.
 .It Ic %continue Ar pane-id
 The pane has been continued after being paused (if the
 .Ar pause-after
-- 
cgit 


From cdacc12ce305ad2f3e65e2a01328a988e3200b51 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Thu, 30 Jun 2022 09:55:53 +0000
Subject: Add support for OSC 8 hyperlinks (a VTE extension now supported by
 other terminals such as iTerm2). Originally written by me then extended and
 completed by first Will Noble and later Jeff Chiang. GitHub issues 911, 2621,
 2890, 3240.

---
 tmux.1 | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 44b96eb7..c7ff6cea 100644
--- a/tmux.1
+++ b/tmux.1
@@ -3656,6 +3656,8 @@ Allows setting the cursor style.
 Supports extended keys.
 .It focus
 Supports focus reporting.
+.It hyperlinks
+Supports OSC 8 hyperlinks.
 .It ignorefkeys
 Ignore function keys from
 .Xr terminfo 5
@@ -6122,9 +6124,14 @@ a format for each shortcut key; both are evaluated once for each line.
 starts without the preview.
 This command works only if at least one client is attached.
 .Tg clearhist
-.It Ic clear-history Op Fl t Ar target-pane
+.It Xo Ic clear-history
+.Op Fl H
+.Op Fl t Ar target-pane
+.Xc
 .D1 Pq alias: Ic clearhist
 Remove and free the history for the specified pane.
+.Fl H
+also removes all hyperlinks.
 .Tg deleteb
 .It Ic delete-buffer Op Fl b Ar buffer-name
 .D1 Pq alias: Ic deleteb
@@ -6412,6 +6419,8 @@ Disable and enable focus reporting.
 These are set automatically if the
 .Em XT
 capability is present.
+.It Em \&Hls
+Set or clear a hyperlink annotation.
 .It Em \&Rect
 Tell
 .Nm
-- 
cgit 


From d0d2c39decd1c342f2ffdb360e5d6b509b9bb34e Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Wed, 6 Jul 2022 07:36:36 +0000
Subject: Support hyperlinks with capture-pane -e and add a mouse_hyperlink
 format, GitHub issue 3247 from Jeff Chiang.

---
 tmux.1 | 1 +
 1 file changed, 1 insertion(+)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index c7ff6cea..ee6740ac 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5160,6 +5160,7 @@ The following variables are available, where appropriate:
 .It Li "mouse_all_flag" Ta "" Ta "Pane mouse all flag"
 .It Li "mouse_any_flag" Ta "" Ta "Pane mouse any flag"
 .It Li "mouse_button_flag" Ta "" Ta "Pane mouse button flag"
+.It Li "mouse_hyperlink" Ta "" Ta "Hyperlink under mouse, if any"
 .It Li "mouse_line" Ta "" Ta "Line under mouse, if any"
 .It Li "mouse_sgr_flag" Ta "" Ta "Pane mouse SGR flag"
 .It Li "mouse_standard_flag" Ta "" Ta "Pane mouse standard flag"
-- 
cgit 


From dd602eaa61e82188313b9187021accab260f89c0 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Wed, 6 Jul 2022 07:51:37 +0000
Subject: Mention whether time is creation/activity for sort orders.

---
 tmux.1 | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index ee6740ac..1fc2d061 100644
--- a/tmux.1
+++ b/tmux.1
@@ -2112,9 +2112,11 @@ is not given, "detach-client -t '%%'" is used.
 specifies the initial sort field: one of
 .Ql name ,
 .Ql size ,
-.Ql creation ,
+.Ql creation
+(time),
 or
-.Ql activity .
+.Ql activity
+(time).
 .Fl r
 reverses the sort order.
 .Fl f
@@ -2196,7 +2198,8 @@ specifies the initial sort field: one of
 .Ql index ,
 .Ql name ,
 or
-.Ql time .
+.Ql time
+(activity).
 .Fl r
 reverses the sort order.
 .Fl f
@@ -6107,7 +6110,8 @@ is not given, "paste-buffer -b '%%'" is used.
 .Pp
 .Fl O
 specifies the initial sort field: one of
-.Ql time ,
+.Ql time
+(creation),
 .Ql name
 or
 .Ql size .
-- 
cgit