version 1.391, 2014/04/17 15:48:02 |
version 1.392, 2014/05/13 07:34:35 |
|
|
.Ql 10w |
.Ql 10w |
in vi. |
in vi. |
.Pp |
.Pp |
When copying the selection, the repeat count indicates the buffer index to |
|
replace, if used. |
|
.Pp |
|
Mode key bindings are defined in a set of named tables: |
Mode key bindings are defined in a set of named tables: |
.Em vi-edit |
.Em vi-edit |
and |
and |
|
|
.Fl F . |
.Fl F . |
.It Xo Ic capture-pane |
.It Xo Ic capture-pane |
.Op Fl aepPq |
.Op Fl aepPq |
.Op Fl b Ar buffer-index |
.Op Fl b Ar buffer-name |
.Op Fl E Ar end-line |
.Op Fl E Ar end-line |
.Op Fl S Ar start-line |
.Op Fl S Ar start-line |
.Op Fl t Ar target-pane |
.Op Fl t Ar target-pane |
|
|
.El |
.El |
.Sh BUFFERS |
.Sh BUFFERS |
.Nm |
.Nm |
maintains a stack of |
maintains a set of named |
.Em paste buffers . |
.Em paste buffers . |
Up to the value of the |
Each buffer may be either explicitly or automatically named. |
|
Explicitly named buffers are named when created with the |
|
.Ic set-buffer |
|
or |
|
.Ic load-buffer |
|
commands, or by renaming an automatically named buffer with |
|
.Ic set-buffer |
|
.Fl n . |
|
Automatically named buffers are given a name such as |
|
.Ql buffer0001 , |
|
.Ql buffer0002 |
|
and so on. |
|
When the |
.Ic buffer-limit |
.Ic buffer-limit |
option are kept; when a new buffer is added, the buffer at the bottom of the |
option is reached, the oldest automatically named buffer is deleted. |
stack is removed. |
Explicitly named are not subject to |
|
.Ic buffer-limit |
|
and may be deleted with |
|
.Ic delete-buffer |
|
command. |
|
.Pp |
Buffers may be added using |
Buffers may be added using |
.Ic copy-mode |
.Ic copy-mode |
or the |
or the |
.Ic set-buffer |
.Ic set-buffer |
command, and pasted into a window using the |
and |
|
.Ic load-buffer |
|
commands, and pasted into a window using the |
.Ic paste-buffer |
.Ic paste-buffer |
command. |
command. |
|
If a buffer command is used and no buffer is specified, the most |
|
recently added automatically named buffer is assumed. |
.Pp |
.Pp |
A configurable history buffer is also maintained for each window. |
A configurable history buffer is also maintained for each window. |
By default, up to 2000 lines are kept; this can be altered with the |
By default, up to 2000 lines are kept; this can be altered with the |
|
|
interactively from a list. |
interactively from a list. |
After a buffer is selected, |
After a buffer is selected, |
.Ql %% |
.Ql %% |
is replaced by the buffer index in |
is replaced by the buffer name in |
.Ar template |
.Ar template |
and the result executed as a command. |
and the result executed as a command. |
If |
If |
|
|
.It Ic clear-history Op Fl t Ar target-pane |
.It Ic clear-history Op Fl t Ar target-pane |
.D1 (alias: Ic clearhist ) |
.D1 (alias: Ic clearhist ) |
Remove and free the history for the specified pane. |
Remove and free the history for the specified pane. |
.It Ic delete-buffer Op Fl b Ar buffer-index |
.It Ic delete-buffer Op Fl b Ar buffer-name |
.D1 (alias: Ic deleteb ) |
.D1 (alias: Ic deleteb ) |
Delete the buffer at |
Delete the buffer named |
.Ar buffer-index , |
.Ar buffer-name , |
or the top buffer if not specified. |
or the most recently added automatically named buffer if not specified. |
.It Xo Ic list-buffers |
.It Xo Ic list-buffers |
.Op Fl F Ar format |
.Op Fl F Ar format |
.Xc |
.Xc |
|
|
.Sx FORMATS |
.Sx FORMATS |
section. |
section. |
.It Xo Ic load-buffer |
.It Xo Ic load-buffer |
.Op Fl b Ar buffer-index |
.Op Fl b Ar buffer-name |
.Ar path |
.Ar path |
.Xc |
.Xc |
.D1 (alias: Ic loadb ) |
.D1 (alias: Ic loadb ) |
|
|
.Ar path . |
.Ar path . |
.It Xo Ic paste-buffer |
.It Xo Ic paste-buffer |
.Op Fl dpr |
.Op Fl dpr |
.Op Fl b Ar buffer-index |
.Op Fl b Ar buffer-name |
.Op Fl s Ar separator |
.Op Fl s Ar separator |
.Op Fl t Ar target-pane |
.Op Fl t Ar target-pane |
.Xc |
.Xc |
|
|
If not specified, paste into the current one. |
If not specified, paste into the current one. |
With |
With |
.Fl d , |
.Fl d , |
also delete the paste buffer from the stack. |
also delete the paste buffer. |
When output, any linefeed (LF) characters in the paste buffer are replaced with |
When output, any linefeed (LF) characters in the paste buffer are replaced with |
a separator, by default carriage return (CR). |
a separator, by default carriage return (CR). |
A custom separator may be specified using the |
A custom separator may be specified using the |
|
|
buffer if the application has requested bracketed paste mode. |
buffer if the application has requested bracketed paste mode. |
.It Xo Ic save-buffer |
.It Xo Ic save-buffer |
.Op Fl a |
.Op Fl a |
.Op Fl b Ar buffer-index |
.Op Fl b Ar buffer-name |
.Ar path |
.Ar path |
.Xc |
.Xc |
.D1 (alias: Ic saveb ) |
.D1 (alias: Ic saveb ) |
|
|
option appends to rather than overwriting the file. |
option appends to rather than overwriting the file. |
.It Xo Ic set-buffer |
.It Xo Ic set-buffer |
.Op Fl a |
.Op Fl a |
.Op Fl b Ar buffer-index |
.Op Fl b Ar buffer-name |
|
.Op Fl n Ar new-buffer-name |
.Ar data |
.Ar data |
.Xc |
.Xc |
.D1 (alias: Ic setb ) |
.D1 (alias: Ic setb ) |
|
|
The |
The |
.Fl a |
.Fl a |
option appends to rather than overwriting the buffer. |
option appends to rather than overwriting the buffer. |
|
The |
|
.Fl n |
|
option renames the buffer to |
|
.Ar new-buffer-name . |
.It Xo Ic show-buffer |
.It Xo Ic show-buffer |
.Op Fl b Ar buffer-index |
.Op Fl b Ar buffer-name |
.Xc |
.Xc |
.D1 (alias: Ic showb ) |
.D1 (alias: Ic showb ) |
Display the contents of the specified buffer. |
Display the contents of the specified buffer. |