From 64c276c23bd729c03c2a3ff00c6f9e6ac4c644c6 Mon Sep 17 00:00:00 2001 From: nicm Date: Thu, 10 Jun 2021 07:24:10 +0000 Subject: Add an "always" value to the extended-keys option to always forward these keys to applications inside tmux. --- tmux.1 | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index f5689bfa..146c998f 100644 --- a/tmux.1 +++ b/tmux.1 @@ -3418,11 +3418,24 @@ sessions. .Xc If enabled, the server will exit when there are no attached clients. .It Xo Ic extended-keys -.Op Ic on | off +.Op Ic on | off | always .Xc -When enabled, extended keys are requested from the terminal and if supported -are recognised by -.Nm . +When +.Ic on +or +.Ic always , +the escape sequence to enable extended keys is sent to the terminal, if +.Nm +knows that it is supported. +.Nm +always recognises extended keys itself. +If this option is +.Ic on , +.Nm +will only forward extended keys to applications when they request them; if +.Ic always , +.Nm +will always forward the keys. .It Xo Ic focus-events .Op Ic on | off .Xc @@ -3501,8 +3514,8 @@ capabilities to be set instead, is intended for classes of functionality supported in a standard way but not reported by .Xr terminfo 5 . -Care must be taken only to configure this with features the terminal actually -support. +Care must be taken to configure this only with features the terminal actually +supports. .Pp This is an array option where each entry is a colon-separated string made up of a terminal type pattern (matched using -- cgit From 0c5cbbbf5cd09598ff2f3d6d1ae99fa353ec5b40 Mon Sep 17 00:00:00 2001 From: nicm Date: Thu, 10 Jun 2021 07:28:45 +0000 Subject: Three changes to fix problems with xterm in VT340 mode, reported by Thomas Sattler. 1) Do not include the DECSLRM or DECFRA features for xterm; they will be added instead if secondary DA responds as VT420 (this happens already). 2) Set or reset the individual flags after terminal-overrides is applied, so the user can properly disable them. 3) Add a capability for DECFRA ("Rect"). --- tmux.1 | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 146c998f..d2ad593f 100644 --- a/tmux.1 +++ b/tmux.1 @@ -6049,6 +6049,10 @@ Disable and enable focus reporting. These are set automatically if the .Em XT capability is present. +.It Em \&Rect +Tell +.Nm +that the terminal supports rectangle operations. .It Em \&Smol Enable the overline attribute. .It Em \&Smulx -- cgit From 84e22168a52f8fe0fa0ef0431d1752273f53e8bd Mon Sep 17 00:00:00 2001 From: nicm Date: Thu, 10 Jun 2021 07:33:41 +0000 Subject: Change resize timers and flags into one timer and a queue which is simpler and fixes problems with vim when resized multiple times. GitHub issue 2677. --- tmux.1 | 2 ++ 1 file changed, 2 insertions(+) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index d2ad593f..47cf4f2c 100644 --- a/tmux.1 +++ b/tmux.1 @@ -2953,6 +2953,8 @@ Ctrl keys may be prefixed with .Ql C- or .Ql ^ , +Shift keys with +.Ql S- and Alt (meta) with .Ql M- . In addition, the following special key names are accepted: -- cgit From 866117636e47c9a5d961df2ac40456b7c910a932 Mon Sep 17 00:00:00 2001 From: nicm Date: Thu, 10 Jun 2021 07:50:03 +0000 Subject: Add different command historys for different types of prompts ("command", "search" etc). From Anindya Mukherjee. --- tmux.1 | 47 +++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 41 insertions(+), 6 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 47cf4f2c..50b3b6b7 100644 --- a/tmux.1 +++ b/tmux.1 @@ -3453,7 +3453,9 @@ will write command prompt history on exit and load it from on start. .It Ic message-limit Ar number Set the number of error or information messages to save in the message log for each client. -The default is 100. +.It Ic prompt-history-limit Ar number +Set the number of history items to save in the history file for each type of +command prompt. .It Xo Ic set-clipboard .Op Ic on | external | off .Xc @@ -5376,11 +5378,25 @@ session option. .Pp Commands related to the status line are as follows: .Bl -tag -width Ds +.It Xo Ic clear-prompt-history +.Op Fl T Ar prompt-type +.Xc +.D1 (alias: Ic clrphist) +Clear status prompt history for prompt type +.Ar prompt-type . +If +.Fl T +is omitted, then clear history for all types. +See +.Ic command-prompt +for possible values for +.Ar prompt-type . .It Xo Ic command-prompt -.Op Fl 1ikNTW +.Op Fl 1ikN .Op Fl I Ar inputs .Op Fl p Ar prompts .Op Fl t Ar target-client +.Op Fl T Ar prompt-type .Op Ar template .Xc Open the command prompt in a client. @@ -5436,14 +5452,20 @@ makes the prompt only accept numeric key presses. .Fl i executes the command every time the prompt input changes instead of when the user exits the command prompt. +.Pp .Fl T tells .Nm -that the prompt is for a target which affects what completions are offered when +the prompt type. +This affects what completions are offered when .Em Tab -is pressed; -.Fl W -is similar but indicates the prompt is for a window. +is pressed. +Available types are: +.Ql command , +.Ql search , +.Ql target +and +.Ql window-target . .Pp The following keys have a special meaning in the command prompt, depending on the value of the @@ -5665,6 +5687,19 @@ If omitted, half of the terminal size is used. The .Fl C flag closes any popup on the client. +.It Xo Ic show-prompt-history +.Op Fl T Ar prompt-type +.Xc +.D1 (alias: Ic showphist) +Display status prompt history for prompt type +.Ar prompt-type . +If +.Fl T +is omitted, then show history for all types. +See +.Ic command-prompt +for possible values for +.Ar prompt-type . .El .Sh BUFFERS .Nm -- cgit From 1bbdd2aba27057363134fa8c20c10e56ce095dea Mon Sep 17 00:00:00 2001 From: nicm Date: Thu, 10 Jun 2021 07:52:56 +0000 Subject: Add -F for command-prompt and use it to fix "Rename" on the window menu, GitHub issue 2699. --- tmux.1 | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 50b3b6b7..d44dd591 100644 --- a/tmux.1 +++ b/tmux.1 @@ -5392,7 +5392,7 @@ See for possible values for .Ar prompt-type . .It Xo Ic command-prompt -.Op Fl 1ikN +.Op Fl 1FikN .Op Fl I Ar inputs .Op Fl p Ar prompts .Op Fl t Ar target-client @@ -5407,6 +5407,11 @@ to execute commands interactively. If .Ar template is specified, it is used as the command. +With +.Fl F , +.Ar template +is expanded as a format. +.Pp If present, .Fl I is a comma-separated list of the initial text for each prompt. -- cgit From 77b1290698e3bc3ea8edeadb96fd483af26efdfe Mon Sep 17 00:00:00 2001 From: nicm Date: Thu, 10 Jun 2021 07:56:47 +0000 Subject: More accurate vi(1) word navigation in copy mode and on the status line. This changes the meaning of the word-separators option - setting it to the empty string is equivalent to the previous behavior. From Will Noble in GitHub issue 2693. --- tmux.1 | 16 ++++++---------- 1 file changed, 6 insertions(+), 10 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index d44dd591..2a77ba21 100644 --- a/tmux.1 +++ b/tmux.1 @@ -1782,19 +1782,18 @@ commands) or when the cursor reaches the bottom (for scrolling commands). .Ql -no-clear variants do not clear the selection. .Pp -The next and previous word keys use space and the -.Ql - , -.Ql _ -and -.Ql @ -characters as word delimiters by default, but this can be adjusted by -setting the +The next and previous word keys skip over whitespace and treat consecutive +runs of either word separators or other letters as words. +Word separators can be customized with the .Em word-separators session option. Next word moves to the start of the next word, next word end to the end of the next word and previous word to the start of the previous word. The three next and previous space keys work similarly but use a space alone as the word separator. +Setting +.Em word-separators +to the empty string makes next/previous word equivalent to next/previous space. .Pp The jump commands enable quick movement within a line. For instance, typing @@ -3974,9 +3973,6 @@ If set to both, a bell and a message are produced. Sets the session's conception of what characters are considered word separators, for the purposes of the next and previous word commands in copy mode. -The default is -.Ql \ -_@ . -.El .Pp Available window options are: .Pp -- cgit From 1e879ef458a21ea4dd266761757537fbbf567eee Mon Sep 17 00:00:00 2001 From: nicm Date: Thu, 10 Jun 2021 07:59:08 +0000 Subject: Feature for the mouse since FreeBSD termcap does not have kmous. --- tmux.1 | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index 2a77ba21..d6a7e35f 100644 --- a/tmux.1 +++ b/tmux.1 @@ -3540,6 +3540,10 @@ Supports extended keys. Supports focus reporting. .It margins Supports DECSLRM margins. +.It mouse +Supports +.Xr xterm 1 +mouse sequences. .It overline Supports the overline SGR attribute. .It rectfill -- cgit From 0d0683c28aa467d30c50ac7cc99b95ae829f61a5 Mon Sep 17 00:00:00 2001 From: jmc Date: Thu, 10 Jun 2021 13:12:31 +0000 Subject: fix some formatting errors; --- tmux.1 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index d6a7e35f..c06b6456 100644 --- a/tmux.1 +++ b/tmux.1 @@ -4331,6 +4331,7 @@ see the .Sx STYLES section. .El +.El .Sh HOOKS .Nm allows commands to run on various triggers, called @@ -5381,7 +5382,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 (alias: Ic clrphist ) Clear status prompt history for prompt type .Ar prompt-type . If @@ -5695,7 +5696,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 (alias: Ic showphist ) Display status prompt history for prompt type .Ar prompt-type . If -- cgit From 1d4296f17fde47186e2d09752a912559af034e37 Mon Sep 17 00:00:00 2001 From: nicm Date: Fri, 18 Jun 2021 07:46:54 +0000 Subject: Mention %1 under choose-tree also. --- tmux.1 | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'tmux.1') diff --git a/tmux.1 b/tmux.1 index c06b6456..dd25edfc 100644 --- a/tmux.1 +++ b/tmux.1 @@ -2102,9 +2102,11 @@ The following keys may be used in tree mode: .It Li "q" Ta "Exit mode" .El .Pp -After a session, window or pane is chosen, +After a session, window or pane is chosen, the first instance of .Ql %% -is replaced by the target in +and all instances of +.Ql %1 +are replaced by the target in .Ar template and the result executed as a command. If -- cgit