From 40e65c511502fe47932e230290537e7391ab8a83 Mon Sep 17 00:00:00 2001 From: nicm Date: Mon, 27 Jul 2020 08:03:10 +0000 Subject: Add a -d option to display-message to set delay, from theonekeyg at gmail dot com in GitHub issue 2322. --- tmux.1 | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 77cb3c56..cd20c056 100644 --- a/tmux.1 +++ b/tmux.1 @@ -5378,6 +5378,7 @@ The following keys are also available: .It Xo Ic display-message .Op Fl aIpv .Op Fl c Ar target-client +.Op Fl d Ar delay .Op Fl t Ar target-pane .Op Ar message .Xc @@ -5387,7 +5388,14 @@ If .Fl p is given, the output is printed to stdout, otherwise it is displayed in the .Ar target-client -status line. +status line for up to +.Ar delay +milliseconds. +If +.Ar delay +is not given, the +.Ic message-time +option is used; a delay of zero waits for a key press. The format of .Ar message is described in the -- cgit From d0957529edcdd3f616d0361972dd819b8b4c29d0 Mon Sep 17 00:00:00 2001 From: nicm Date: Thu, 20 Aug 2020 16:57:40 +0000 Subject: Add n: modifier to get length of a format, also automatically expand variable name arguments again if they contain a #{. --- tmux.1 | 3 +++ 1 file changed, 3 insertions(+) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index cd20c056..46fe1fa2 100644 --- a/tmux.1 +++ b/tmux.1 @@ -4574,6 +4574,9 @@ pads the string to a given width, for example .Ql #{p10:pane_title} will result in a width of at least 10 characters. A positive width pads on the left, a negative on the right. +.Ql n +expands to the length of the variable, for example +.Ql #{n:window_name} . .Pp Prefixing a time variable with .Ql t:\& -- cgit From 2ab289980afd7d47a92dfb17d488c127d335b429 Mon Sep 17 00:00:00 2001 From: nicm Date: Thu, 27 Aug 2020 06:55:54 +0000 Subject: Add pane_last format, GitHub issue 2353. --- tmux.1 | 1 + 1 file changed, 1 insertion(+) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 46fe1fa2..21fcdedd 100644 --- a/tmux.1 +++ b/tmux.1 @@ -4773,6 +4773,7 @@ The following variables are available, where appropriate: .It Li "pane_in_mode" Ta "" Ta "1 if pane is in a mode" .It Li "pane_index" Ta "#P" Ta "Index of pane" .It Li "pane_input_off" Ta "" Ta "1 if input to pane is disabled" +.It Li "pane_last" Ta "" Ta "1 if last pane" .It Li "pane_left" Ta "" Ta "Left of pane" .It Li "pane_marked" Ta "" Ta "1 if this is the marked pane" .It Li "pane_marked_set" Ta "" Ta "1 if a marked pane is set" -- cgit From 60860aced8d424ef6c1d527b63842a0ea0f452ad Mon Sep 17 00:00:00 2001 From: nicm Date: Tue, 1 Sep 2020 09:19:01 +0000 Subject: Add -F to set-environment and source-file; GitHub issue 2359. --- tmux.1 | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 21fcdedd..c11df7ce 100644 --- a/tmux.1 +++ b/tmux.1 @@ -1407,7 +1407,7 @@ and .Fl T show debugging information about jobs and terminals. .It Xo Ic source-file -.Op Fl nqv +.Op Fl Fnqv .Ar path .Ar ... .Xc @@ -1418,6 +1418,11 @@ Execute commands from one or more files specified by .Xr glob 7 patterns). If +.Fl F +is present, then +.Ar path +is expanded as a format. +If .Fl q is given, no error will be returned if .Ar path @@ -5102,7 +5107,7 @@ section). Commands to alter and view the environment are: .Bl -tag -width Ds .It Xo Ic set-environment -.Op Fl hgru +.Op Fl Fhgru .Op Fl t Ar target-session .Ar name Op Ar value .Xc @@ -5113,6 +5118,11 @@ If is used, the change is made in the global environment; otherwise, it is applied to the session environment for .Ar target-session . +If +.Fl F +is present, then +.Ar value +is expanded as a format. The .Fl u flag unsets a variable. -- cgit From 37b1600d9cf7076498760372dcc20f021e4c181a Mon Sep 17 00:00:00 2001 From: nicm Date: Wed, 2 Sep 2020 13:46:35 +0000 Subject: Add a -w flag to set- and load-buffer to send to clipboard using OSC 52. GitHub issue 2363. --- tmux.1 | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index c11df7ce..08b329f4 100644 --- a/tmux.1 +++ b/tmux.1 @@ -5651,12 +5651,21 @@ See the .Sx FORMATS section. .It Xo Ic load-buffer +.Op Fl w .Op Fl b Ar buffer-name +.Op Fl t Ar target-client .Ar path .Xc .D1 (alias: Ic loadb ) Load the contents of the specified paste buffer from .Ar path . +If +.Fl w +is given, the buffer is also sent to the clipboard for +.Ar target-client +using the +.Xr xterm 1 +escape sequence, if possible. .It Xo Ic paste-buffer .Op Fl dpr .Op Fl b Ar buffer-name @@ -5693,14 +5702,22 @@ The .Fl a option appends to rather than overwriting the file. .It Xo Ic set-buffer -.Op Fl a +.Op Fl aw .Op Fl b Ar buffer-name +.Op Fl t Ar target-client .Op Fl n Ar new-buffer-name .Ar data .Xc .D1 (alias: Ic setb ) Set the contents of the specified buffer to .Ar data . +If +.Fl w +is given, the buffer is also sent to the clipboard for +.Ar target-client +using the +.Xr xterm 1 +escape sequence, if possible. The .Fl a option appends to rather than overwriting the buffer. -- cgit From 3206869ea5cbcf0caa9e62ec11edb170aae2cf27 Mon Sep 17 00:00:00 2001 From: nicm Date: Wed, 16 Sep 2020 19:12:59 +0000 Subject: Add -q flag to unbind-key to hide errors, GitHub issue 2381. --- tmux.1 | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 08b329f4..b5cbafe8 100644 --- a/tmux.1 +++ b/tmux.1 @@ -3039,7 +3039,7 @@ Send the prefix key, or with .Fl 2 the secondary prefix key, to a window as if it was pressed. .It Xo Ic unbind-key -.Op Fl an +.Op Fl anq .Op Fl T Ar key-table .Ar key .Xc @@ -3054,6 +3054,9 @@ are the same as for If .Fl a is present, all key bindings are removed. +The +.Fl q +option prevents errors being returned. .El .Sh OPTIONS The appearance and behaviour of -- cgit From d6680b94742896c3c3afc31fc9e53c741ef6677b Mon Sep 17 00:00:00 2001 From: nicm Date: Tue, 22 Sep 2020 15:45:20 +0000 Subject: Move a sentence to the right command. --- tmux.1 | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index b5cbafe8..0eeb2367 100644 --- a/tmux.1 +++ b/tmux.1 @@ -3167,6 +3167,9 @@ flag unsets an option, so a session inherits the option from the global options (or with .Fl g , restores a global option to the default). +.Ar value +depends on the option and may be a number, a string, or a flag (on, off, or +omitted to toggle). .Pp The .Fl o @@ -3238,9 +3241,6 @@ includes hooks (omitted by default). .Fl A includes options inherited from a parent set of options, such options are marked with an asterisk. -.Ar value -depends on the option and may be a number, a string, or a flag (on, off, or -omitted to toggle). .El .Pp Available server options are: -- cgit From 9ec68db74fda97cc23bcc1e6310a75e4839fcf10 Mon Sep 17 00:00:00 2001 From: Nicholas Marriott Date: Wed, 30 Sep 2020 14:17:27 +0100 Subject: Correct break-pane default format, from Gregory Pakosz. --- tmux.1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 9b8f4420..56c7db7f 100644 --- a/tmux.1 +++ b/tmux.1 @@ -1858,7 +1858,7 @@ The .Fl P option prints information about the new window after it has been created. By default, it uses the format -.Ql #{session_name}:#{window_index} +.Ql #{session_name}:#{window_index}.#{pane_index} but a different format may be specified with .Fl F . .It Xo Ic capture-pane -- cgit From c8f3736b07a0ae4c73bd6517ab8c8596d74c1c67 Mon Sep 17 00:00:00 2001 From: nicm Date: Mon, 5 Oct 2020 09:53:01 +0000 Subject: Use the setal capability as well as (tmux's) Setulc. --- tmux.1 | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 0eeb2367..c2fecd9d 100644 --- a/tmux.1 +++ b/tmux.1 @@ -5897,8 +5897,8 @@ Set a styled underscore. The single parameter is one of: 0 for no underscore, 1 for normal underscore, 2 for double underscore, 3 for curly underscore, 4 for dotted underscore and 5 for dashed underscore. -.It Em \&Setulc -Set the underscore colour. +.It Em \&Setulc , \&ol +Set the underscore colour or reset to the default. The argument is (red * 65536) + (green * 256) + blue where each is between 0 and 255. .It Em \&Ss , Se -- cgit From 8d9ea1b97ca1f70191808df03f9fbe9f93912773 Mon Sep 17 00:00:00 2001 From: nicm Date: Mon, 5 Oct 2020 11:04:40 +0000 Subject: Trim "s from process names; also fix a default format in man page. --- tmux.1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index c2fecd9d..a39237d5 100644 --- a/tmux.1 +++ b/tmux.1 @@ -1858,7 +1858,7 @@ The .Fl P option prints information about the new window after it has been created. By default, it uses the format -.Ql #{session_name}:#{window_index} +.Ql #{session_name}:#{window_index}.#{pane_index} but a different format may be specified with .Fl F . .It Xo Ic capture-pane -- cgit From 4dc76e084b9c9d3d4b04c7e29bbe425c77ee5ae8 Mon Sep 17 00:00:00 2001 From: tim Date: Fri, 9 Oct 2020 19:12:36 +0000 Subject: Escape ! in Ql OK jmc@ nicm@, agreement from schwarze@ --- tmux.1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index a39237d5..7900ecce 100644 --- a/tmux.1 +++ b/tmux.1 @@ -1003,7 +1003,7 @@ wait for an empty line input before exiting in control mode .El .Pp A leading -.Ql ! +.Ql \&! turns a flag off if the client is already attached. .Fl r is an alias for -- cgit From 649e5970e98b0073763f42a25dcab02aadea688f Mon Sep 17 00:00:00 2001 From: nicm Date: Fri, 30 Oct 2020 08:55:56 +0000 Subject: Add a -O flag to display-menu to change the mouse behaviour and not close the menu when the mouse is released, from teo_paul1 at yahoo dot com. --- tmux.1 | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 7900ecce..955ce16e 100644 --- a/tmux.1 +++ b/tmux.1 @@ -5331,6 +5331,7 @@ option. This command works only from inside .Nm . .It Xo Ic display-menu +.Op Fl O .Op Fl c Ar target-client .Op Fl t Ar target-pane .Op Fl T Ar title @@ -5382,8 +5383,14 @@ Both may be a row or column number, or one of the following special values: Each menu consists of items followed by a key shortcut shown in brackets. If the menu is too large to fit on the terminal, it is not displayed. Pressing the key shortcut chooses the corresponding item. -If the mouse is enabled and the menu is opened from a mouse key binding, releasing -the mouse button with an item selected will choose that item. +If the mouse is enabled and the menu is opened from a mouse key binding, +releasing the mouse button with an item selected chooses that item and +releasing the mouse button without an item selected closes the menu. +.Fl O +changes this behaviour so that the menu does not close when the mouse button is +released without an item selected the menu is not closed and a mouse button +must be clicked to choose an item. +.Pp The following keys are also available: .Bl -column "Key" "Function" -offset indent .It Sy "Key" Ta Sy "Function" -- cgit From ac5045a00f1fee2ca94aef063e6a5a3d2efce3f1 Mon Sep 17 00:00:00 2001 From: nicm Date: Mon, 2 Nov 2020 08:21:30 +0000 Subject: Add numeric comparisons for formats, from teo_paul1 at yahoo dot com in GitHub issue 2442. --- tmux.1 | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 955ce16e..3d58b32f 100644 --- a/tmux.1 +++ b/tmux.1 @@ -4544,7 +4544,7 @@ multiplication .Ql * , division .Ql / , -and modulus +modulus .Ql m or .Ql % @@ -4553,7 +4553,15 @@ or must be escaped as .Ql %% in formats which are also expanded by -.Xr strftime 3 ) . +.Xr strftime 3 ) +and numeric comparison operators +.Ql == , +.Ql != , +.Ql < , +.Ql <= , +.Ql > +and +.Ql >= . For example, .Ql #{e|*|f|4:5.5,3} multiplies 5.5 by 3 for a result with four decimal places and -- cgit