Add a choose-buffer command for easier use of the paste buffer stack.

1 files changed, 19 insertions, 0 deletions

diff --git a/tmux.1 b/tmux.1
index 30725f6e..f53e65f3 100644
--- a/tmux.1
+++ b/tmux.1
@@ -248,6 +248,8 @@ Select windows 0 to 9.
 Enter the
 .Nm
 command prompt.
+.It =
+Choose which buffer to paste interactively from a list.
 .It \&?
 List all key bindings.
 .It D
@@ -2447,6 +2449,23 @@ command above).
 .Pp
 The buffer commands are as follows:
 .Bl -tag -width Ds
+.It Xo
+.Ic choose-buffer
+.Op Fl t Ar target-window
+.Op Ar template
+.Xc
+Put a window into buffer choice mode, where a buffer may be chosen
+interactively from a list.
+After a buffer is selected,
+.Ql %%
+is replaced by the buffer index in
+.Ar template
+and the result executed as a command.
+If
+.Ar template
+is not given, "paste-buffer -b '%%'" is used.
+This command works only from inside
+.Nm .
 .It Ic clear-history Op Fl t Ar target-pane
 .D1 (alias: Ic clearhist )
 Remove and free the history for the specified pane.