From 36d904011a0620284ad3a51639a090024f2575fb Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 2 Aug 2022 08:57:01 +0000
Subject: -u is no longer equivalent to -TUTF-8 so don't say it is.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 1fc2d061..a1298fe0 100644
--- a/tmux.1
+++ b/tmux.1
@@ -214,8 +214,6 @@ that is set does not contain
 .Qq UTF-8
 or
 .Qq UTF8 .
-This is equivalent to
-.Fl T Ar UTF-8 .
 .It Fl T Ar features
 Set terminal features for the client.
 This is a comma-separated list of features.
-- 
cgit 


From 42ba6c1b229c92256274e848e9c5ff1d59d9081b Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 2 Aug 2022 11:09:26 +0000
Subject: Add a third state "all" to allow-passthrough to work even in
 invisible panes, from Sergei Grechanik in GitHub issue 3274.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index a1298fe0..fa7fcbfb 100644
--- a/tmux.1
+++ b/tmux.1
@@ -4461,11 +4461,17 @@ Available pane options are:
 .Pp
 .Bl -tag -width Ds -compact
 .It Xo Ic allow-passthrough
-.Op Ic on | off
+.Op Ic on | off | all
 .Xc
 Allow programs in the pane to bypass
 .Nm
 using a terminal escape sequence (\eePtmux;...\ee\e\e).
+If set to
+.Ic on ,
+passthrough sequences will be allowed only if the pane is visible.
+If set to
+.Ic all ,
+they will be allowed even if the pane is invisible.
 .Pp
 .It Xo Ic allow-rename
 .Op Ic on | off
-- 
cgit 


From 03149bf7f62e2c92d0e60087c52604d2dd51794f Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 15 Aug 2022 08:54:03 +0000
Subject: Add a Nobr terminfo capability to tell tmux the terminal does not use
 bright colours for bold (makes a difference to how tmux applies palette
 differences). From Damien Tardy-Panis in GitHub issue 3301.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index fa7fcbfb..b6283373 100644
--- a/tmux.1
+++ b/tmux.1
@@ -6430,6 +6430,10 @@ These are set automatically if the
 capability is present.
 .It Em \&Hls
 Set or clear a hyperlink annotation.
+.It Em \&Nobr
+Tell
+.Nm
+that the terminal does not use bright colors for bold display.
 .It Em \&Rect
 Tell
 .Nm
-- 
cgit 


From 7c2dcd72380dc2d9e119e99cb423a67ae17b6bd2 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 15 Aug 2022 09:10:34 +0000
Subject: Notify when a paste buffer is deleted, GitHub issue 3302 from George
 Nachman.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index b6283373..3a378c49 100644
--- a/tmux.1
+++ b/tmux.1
@@ -6596,6 +6596,10 @@ escapes non-printable characters and backslash as octal \\xxx.
 The pane with ID
 .Ar pane-id
 has changed mode.
+.It Ic %paste-buffer-changed Ar name
+Paste buffer
+.Ar name
+has been changed.
 .It Ic %pause Ar pane-id
 The pane has been paused (if the
 .Ar pause-after
-- 
cgit 


From 416c27c9958e928b9ff845c1701acf5b10d0db8d Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Tue, 23 Aug 2022 08:14:19 +0000
Subject: Add scroll-middle copy mode command to make cursor line in the
 middle, from Varun Kumar E in GitHub issue 3307.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 3a378c49..bf72cc0c 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1808,6 +1808,7 @@ The following commands are supported in copy mode:
 .It Li "search-forward <for>" Ta "/" Ta ""
 .It Li "search-forward-incremental <for>" Ta "" Ta "C-s"
 .It Li "search-forward-text <for>" Ta "" Ta ""
+.It Li "scroll-middle" Ta "z" Ta ""
 .It Li "search-reverse" Ta "N" Ta "N"
 .It Li "select-line" Ta "V" Ta ""
 .It Li "select-word" Ta "" Ta ""
-- 
cgit 


From f03c3ca6c36cd52ae5ec4ae8cd4fa137cf79aaf3 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Fri, 9 Sep 2022 11:02:23 +0000
Subject: Add message-line option to control where message and prompt go, from
 Varun Kumar E in GitHub issue 3324.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index bf72cc0c..485b5d3a 100644
--- a/tmux.1
+++ b/tmux.1
@@ -3873,6 +3873,10 @@ For how to specify
 see the
 .Sx STYLES
 section.
+.It Xo Ic message-line
+.Op Ic 0 | 1 | 2 | 3 | 4
+.Xc
+Set line on which status line messages and the command prompt are shown.
 .It Ic message-style Ar style
 Set status line message style.
 This is used for messages and for the command prompt.
-- 
cgit 


From a10452be2d84d4ff1b9d4e636627b7a9c5a2c42a Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Wed, 28 Sep 2022 07:59:50 +0000
Subject: Add scroll-top and scroll-bottom commands to scroll so cursor is at
 top or bottom. From Anindya Mukherjee, GitHub issue 3334.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 485b5d3a..5e896902 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1808,7 +1808,9 @@ The following commands are supported in copy mode:
 .It Li "search-forward <for>" Ta "/" Ta ""
 .It Li "search-forward-incremental <for>" Ta "" Ta "C-s"
 .It Li "search-forward-text <for>" Ta "" Ta ""
+.It Li "scroll-bottom" Ta "" Ta ""
 .It Li "scroll-middle" Ta "z" Ta ""
+.It Li "scroll-top" Ta "" Ta ""
 .It Li "search-reverse" Ta "N" Ta "N"
 .It Li "select-line" Ta "V" Ta ""
 .It Li "select-word" Ta "" Ta ""
@@ -2011,7 +2013,7 @@ but a different format may be specified with
 .Fl F .
 .Tg capturep
 .It Xo Ic capture-pane
-.Op Fl aepPqCJN
+.Op Fl aAepPqCJN
 .Op Fl b Ar buffer-name
 .Op Fl E Ar end-line
 .Op Fl S Ar start-line
@@ -2036,10 +2038,15 @@ is given, the output includes escape sequences for text and background
 attributes.
 .Fl C
 also escapes non-printable characters as octal \exxx.
+.Fl T
+ignores trailing positions that do not contain a character.
 .Fl N
 preserves trailing spaces at each line's end and
 .Fl J
-preserves trailing spaces and joins any wrapped lines.
+preserves trailing spaces and joins any wrapped lines;
+.Fl J
+implies
+.Fl T .
 .Fl P
 captures only any output that the pane has received that is the beginning of an
 as-yet incomplete escape sequence.
-- 
cgit 


From 8edece2cdb7b4425526bae904506a246edbb6409 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Fri, 28 Oct 2022 13:00:02 +0000
Subject: Add paste-buffer-deleted notification and fix name of
 paste-buffer-changed.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 5e896902..dbfc85b1 100644
--- a/tmux.1
+++ b/tmux.1
@@ -6612,6 +6612,10 @@ has changed mode.
 Paste buffer
 .Ar name
 has been changed.
+.It Ic %paste-buffer-deleted Ar name
+Paste buffer
+.Ar name
+has been deleted.
 .It Ic %pause Ar pane-id
 The pane has been paused (if the
 .Ar pause-after
-- 
cgit 


From 3be369522b6de38ba08ee50a86a49a9a86af490b Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Thu, 3 Nov 2022 08:33:57 +0000
Subject: Add a -l flag to display-message to disable format expansion, from
 Aaron Jensen. GitHub issue 3372.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index dbfc85b1..36faf683 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5887,7 +5887,7 @@ The following keys are also available:
 .El
 .Tg display
 .It Xo Ic display-message
-.Op Fl aINpv
+.Op Fl aIlNpv
 .Op Fl c Ar target-client
 .Op Fl d Ar delay
 .Op Fl t Ar target-pane
@@ -5909,7 +5909,12 @@ is not given, the
 option is used; a delay of zero waits for a key press.
 .Ql N
 ignores key presses and closes only after the delay expires.
-The format of
+If
+.Fl l
+is given,
+.Ar message
+is printed unchanged.
+Otherwise, the format of
 .Ar message
 is described in the
 .Sx FORMATS
-- 
cgit 


From 48f41e4a411dc8dc77514e211293365ee8394792 Mon Sep 17 00:00:00 2001
From: jmc <jmc>
Date: Thu, 10 Nov 2022 22:58:39 +0000
Subject: - sort options; from josiah frentsos ok nicm

- add -N to SYNOPSIS

- sort usage()
---
 tmux.1 | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 36faf683..887608cb 100644
--- a/tmux.1
+++ b/tmux.1
@@ -23,7 +23,7 @@
 .Sh SYNOPSIS
 .Nm tmux
 .Bk -words
-.Op Fl 2CDluvV
+.Op Fl 2CDlNuVv
 .Op Fl c Ar shell-command
 .Op Fl f Ar file
 .Op Fl L Ar socket-name
@@ -203,6 +203,12 @@ If
 is specified, the default socket directory is not used and any
 .Fl L
 flag is ignored.
+.It Fl T Ar features
+Set terminal features for the client.
+This is a comma-separated list of features.
+See the
+.Ic terminal-features
+option.
 .It Fl u
 Write UTF-8 output to the terminal even if the first environment
 variable of
@@ -214,12 +220,10 @@ that is set does not contain
 .Qq UTF-8
 or
 .Qq UTF8 .
-.It Fl T Ar features
-Set terminal features for the client.
-This is a comma-separated list of features.
-See the
-.Ic terminal-features
-option.
+.It Fl V
+Report the
+.Nm
+version.
 .It Fl v
 Request verbose logging.
 Log messages will be saved into
@@ -244,10 +248,6 @@ signal may be sent to the
 server process to toggle logging between on (as if
 .Fl v
 was given) and off.
-.It Fl V
-Report the
-.Nm
-version.
 .It Ar command Op Ar flags
 This specifies one of a set of commands used to control
 .Nm ,
-- 
cgit 


From 079f48e8a6131b2ef46b370c0905252d29d9d815 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Fri, 11 Nov 2022 08:27:17 +0000
Subject: Document alternative delimiters for substitution, from Jim
 Wisniewski.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 887608cb..52a20266 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5080,6 +5080,15 @@ would change
 .Ql abABab
 into
 .Ql bxBxbx .
+A different delimiter character may also be used, to avoid collisions with
+literal slashes in the pattern.
+For example,
+.Ql s|foo/|bar/|:
+will substitute
+.Ql foo/
+with
+.Ql bar/
+throughout.
 .Pp
 In addition, the last line of a shell command's output may be inserted using
 .Ql #() .
-- 
cgit 


From fe475bd856ff1f98bf8a4cd9b6aedd5da81a7e3c Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Fri, 11 Nov 2022 08:37:55 +0000
Subject: Parse primary device attributes as well as secondary and add a SIXEL
 flag (not used yet), from Anindya Mukherjee.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 52a20266..4f314110 100644
--- a/tmux.1
+++ b/tmux.1
@@ -3687,6 +3687,8 @@ Supports the overline SGR attribute.
 Supports the DECFRA rectangle fill escape sequence.
 .It RGB
 Supports RGB colour with the SGR escape sequences.
+.It sixel
+Supports SIXEL graphics.
 .It strikethrough
 Supports the strikethrough SGR escape sequence.
 .It sync
@@ -6491,6 +6493,8 @@ Set the opening sequence for the working directory notification.
 The sequence is terminated using the standard
 .Em fsl
 capability.
+.It Em \&Sxl
+Indicates that the terminal supports SIXEL.
 .It Em \&Sync
 Start (parameter is 1) or end (parameter is 2) a synchronized update.
 .It Em \&Tc
-- 
cgit 


From 3b3f42053a5f11af5285392a5a072facbc16f4a9 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Fri, 16 Dec 2022 08:13:40 +0000
Subject: Add send-keys -K to handle keys directly as if typed (so look up in
 key table). GitHub issue 3361.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 4f314110..2a2e54bf 100644
--- a/tmux.1
+++ b/tmux.1
@@ -3212,13 +3212,14 @@ lists only the first matching key.
 lists the command for keys that do not have a note rather than skipping them.
 .Tg send
 .It Xo Ic send-keys
-.Op Fl FHlMRX
+.Op Fl FHKlMRX
+.Op Fl c Ar target-client
 .Op Fl N Ar repeat-count
 .Op Fl t Ar target-pane
 .Ar key Ar ...
 .Xc
 .D1 Pq alias: Ic send
-Send a key or keys to a window.
+Send a key or keys to a window or client.
 Each argument
 .Ar key
 is the name of the key (such as
@@ -3227,6 +3228,12 @@ or
 .Ql NPage )
 to send; if the string is not recognised as a key, it is sent as a series of
 characters.
+If
+.Fl K
+is given, keys are sent to
+.Ar target-client ,
+so they are looked up in the client's key table, rather than to
+.Ar target-pane .
 All arguments are sent sequentially from first to last.
 If no keys are given and the command is bound to a key, then that key is used.
 .Pp
-- 
cgit 


From b5ab4d2c13277e749c96920d4b1b09f2acc73390 Mon Sep 17 00:00:00 2001
From: kn <kn>
Date: Thu, 22 Dec 2022 19:53:23 +0000
Subject: Denote multiple arguments with 'arg ...' not 'args'

A few programs used the plural in their synopsis which doesn't read as
clear as the obvious triple-dot notation.

mdoc(7) .Ar defaults to "file ..." if no arguments are given and consistent
use of 'arg ...' matches that behaviour.

Cleanup a few markups of the same argument so the text keeps reading
naturally;  omit unhelpful parts like 'if optional arguments are given,
they are passed along' for tools like time(1) and timeout(1) that obviously
execute commands with whatever arguments where given -- just like doas(1)
which doesn't mention arguments in its DESCRIPTION in the first place.

For expr(1) the difference between 'expressions' and 'expression ...' is
crucial, as arguments must be passed as individual words.

Feedback millert jmc schwarze deraadt
OK jmc
---
 tmux.1 | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 2a2e54bf..c84d9e87 100644
--- a/tmux.1
+++ b/tmux.1
@@ -961,7 +961,7 @@ Will run
 directly without invoking the shell.
 .Pp
 .Ar command
-.Op Ar arguments
+.Op Ar argument ...
 refers to a
 .Nm
 command, either passed with the command and arguments separately, for example:
@@ -1538,8 +1538,7 @@ show debugging information about jobs and terminals.
 .Tg source
 .It Xo Ic source-file
 .Op Fl Fnqv
-.Ar path
-.Ar ...
+.Ar path ...
 .Xc
 .D1 Pq alias: Ic source
 Execute commands from one or more files specified by
@@ -3120,7 +3119,7 @@ Commands related to key bindings are as follows:
 .Op Fl nr
 .Op Fl N Ar note
 .Op Fl T Ar key-table
-.Ar key command Op Ar arguments
+.Ar key command Op Ar argument ...
 .Xc
 .D1 Pq alias: Ic bind
 Bind key
@@ -3216,7 +3215,7 @@ lists the command for keys that do not have a note rather than skipping them.
 .Op Fl c Ar target-client
 .Op Fl N Ar repeat-count
 .Op Fl t Ar target-pane
-.Ar key Ar ...
+.Ar key ...
 .Xc
 .D1 Pq alias: Ic send
 Send a key or keys to a window or client.
@@ -5821,8 +5820,7 @@ until it is dismissed.
 .Op Fl y Ar position
 .Ar name
 .Ar key
-.Ar command
-.Ar ...
+.Ar command Op Ar argument ...
 .Xc
 .D1 Pq alias: Ic menu
 Display a menu on
-- 
cgit 


From cb51942669cef089b46cd2b6cdbd62405000c0e7 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Sun, 8 Jan 2023 21:00:01 +0000
Subject: Quotes are now required in select-layout example.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index c84d9e87..6a0bfe52 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1971,7 +1971,7 @@ For example:
 $ tmux list-windows
 0: ksh [159x48]
     layout: bb62,159x48,0,0{79x48,0,0,79x48,80,0}
-$ tmux select-layout bb62,159x48,0,0{79x48,0,0,79x48,80,0}
+$ tmux select-layout 'bb62,159x48,0,0{79x48,0,0,79x48,80,0}'
 .Ed
 .Pp
 .Nm
-- 
cgit 


From 3aa458ea6398b0de37c3e146304bd2a4e17ea3c0 Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Fri, 20 Jan 2023 21:36:00 +0000
Subject: Add a flag to display-menu to select the manu item chosen first,
 GitHub issue 3442.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index 6a0bfe52..c75afd24 100644
--- a/tmux.1
+++ b/tmux.1
@@ -5815,6 +5815,7 @@ until it is dismissed.
 .Op Fl O
 .Op Fl c Ar target-client
 .Op Fl t Ar target-pane
+.Op Fl S Ar starting-choice
 .Op Fl T Ar title
 .Op Fl x Ar position
 .Op Fl y Ar position
@@ -5844,6 +5845,9 @@ command should be omitted.
 .Fl T
 is a format for the menu title (see
 .Sx FORMATS ) .
+.Fl S
+sets the menu item selected by default, if the menu is not bound to a mouse key
+binding.
 .Pp
 .Fl x
 and
-- 
cgit 


From e7e112fbd0263bb8661d0cf931d66c1b57e7fd3b Mon Sep 17 00:00:00 2001
From: nicm <nicm>
Date: Mon, 23 Jan 2023 09:33:51 +0000
Subject: Too many \s in example, GitHub issue 3445.

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

(limited to 'tmux.1')

diff --git a/tmux.1 b/tmux.1
index c75afd24..fdbc97cc 100644
--- a/tmux.1
+++ b/tmux.1
@@ -542,7 +542,7 @@ for example in these
 .Xr sh 1
 commands:
 .Bd -literal -offset indent
-$ tmux neww\e\e; splitw
+$ tmux neww\e; splitw
 .Ed
 .Pp
 Or:
-- 
cgit