mirror of
				https://github.com/tmux/tmux.git
				synced 2025-11-04 09:26:05 +00:00 
			
		
		
		
	Add a choose-client command and extend choose-{session,window} to accept a
template. After a choice is made, %% (or %1) in the template is replaced by the name of the session, window or client suitable for -t and the result executed as a command. So, for example, "choose-window "killw -t '%%'"" will kill the selected window. The defaults if no template is given are (as now) select-window for choose-window, switch-client for choose-session, and detach-client for choose-client (now bound to D).
This commit is contained in:
		
							
								
								
									
										55
									
								
								tmux.1
									
									
									
									
									
								
							
							
						
						
									
										55
									
								
								tmux.1
									
									
									
									
									
								
							@@ -622,14 +622,57 @@ off from its containing window to make it the only pane in a new window.
 | 
			
		||||
If
 | 
			
		||||
.Fl d
 | 
			
		||||
is given, the new window does not become the current window.
 | 
			
		||||
.It Ic choose-session Op Fl t Ar target-window
 | 
			
		||||
Put a window into session choice mode, where the session for the current
 | 
			
		||||
client may be selected interactively from a list.
 | 
			
		||||
.It Xo
 | 
			
		||||
.Ic choose-client
 | 
			
		||||
.Op Fl t Ar target-window
 | 
			
		||||
.Op Ar template
 | 
			
		||||
.Xc
 | 
			
		||||
Put a window into client choice mode, allowing a client to be selected
 | 
			
		||||
interactively from a list.
 | 
			
		||||
After a client is chosen,
 | 
			
		||||
.Ql %%
 | 
			
		||||
is replaced by the client
 | 
			
		||||
.Xr pty 4
 | 
			
		||||
path in
 | 
			
		||||
.Ar template
 | 
			
		||||
and the result executed as a command.
 | 
			
		||||
If
 | 
			
		||||
.Ar template
 | 
			
		||||
is not given, "detach-client -t '%%'" is used.
 | 
			
		||||
This command works only from inside
 | 
			
		||||
.Nm .
 | 
			
		||||
.It Ic choose-window Op Fl t Ar target-window
 | 
			
		||||
Put a window into window choice mode, where the window for the session
 | 
			
		||||
attached to the current client may be selected interactively from a list.
 | 
			
		||||
.It Xo
 | 
			
		||||
.Ic choose-session
 | 
			
		||||
.Op Fl t Ar target-window
 | 
			
		||||
.Op Ar template
 | 
			
		||||
.Xc
 | 
			
		||||
Put a window into session choice mode, where a session may be selected
 | 
			
		||||
interactively from a list.
 | 
			
		||||
When one is chosen,
 | 
			
		||||
.Ql %%
 | 
			
		||||
is replaced by the session name in
 | 
			
		||||
.Ar template
 | 
			
		||||
and the result executed as a command.
 | 
			
		||||
If
 | 
			
		||||
.Ar template
 | 
			
		||||
is not given, "switch-client -t '%%'" is used.
 | 
			
		||||
This command works only from inside
 | 
			
		||||
.Nm .
 | 
			
		||||
.It Xo
 | 
			
		||||
.Ic choose-window
 | 
			
		||||
.Op Fl t Ar target-window
 | 
			
		||||
.Op Ar template
 | 
			
		||||
.Xc
 | 
			
		||||
Put a window into window choice mode, where a window may be chosen
 | 
			
		||||
interactively from a list.
 | 
			
		||||
After a window is selected,
 | 
			
		||||
.Ql %%
 | 
			
		||||
is replaced by the session name and window index in
 | 
			
		||||
.Ar template
 | 
			
		||||
and the result executed as a command.
 | 
			
		||||
If
 | 
			
		||||
.Ar template
 | 
			
		||||
is not given, "select-window -t '%%'" is used.
 | 
			
		||||
This command works only from inside
 | 
			
		||||
.Nm .
 | 
			
		||||
.It Ic down-pane Op Fl t Ar target-pane
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user