Sync OpenBSD patchset 726:

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

tmux.1

@@ -1,4 +1,4 @@
-.\" $Id: tmux.1,v 1.259 2010-06-22 23:29:05 tcunha Exp $
+.\" $Id: tmux.1,v 1.260 2010-06-22 23:35:20 tcunha Exp $
 .\"
 .\" Copyright (c) 2007 Nicholas Marriott <nicm@users.sourceforge.net>
 .\"
@@ -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.