Skip to content

Commit

Permalink
Version 14.0
Browse files Browse the repository at this point in the history 
NF: The YankRing window supports 1-9 to choose to paste those items for quicker access to the top 9 items.
NF: The YankRing now maps the @ key to run macros.  Not all actions performed during the macro are recorded by the YankRing as a number of items had to be unmapped to support the replay of actions which can prompt the user for input (i.e. t and f) (Asis Hallab).
BF: When flipping between applications the system clipboard was not added to the YankRing in all cases.
BF: The YankRing could report E121: Undefined variable: g:yankring_manual_clipboard_check (Thilo Six).
BF: The YankRing could report: E132: Function call depth is higher than 'maxfuncdepth'.  When executing a YRClear or YRPop or when flipping between applications (Marcin Szamotulski).
BF: Strange behaviour when opening the YankRing with :e [YankRing] instead of :YRShow (Marcin Szamotulski).
  • Loading branch information
@dfishburn @vim-scripts
dfishburn authored and vim-scripts committed May 20, 2012
1 parent e42cac0 commit 8ebc225
Show file tree
Hide file tree
Showing 3 changed files with 379 additions and 318 deletions.
2 changes: 1 addition & 1 deletion README
View file
Expand Up @@ -6,7 +6,7 @@ Vim does not provide any mechanism to reference previous yanked, deleted or chan

The YankRing plugin allows the user to configure the number of yanked, deleted and changed text. A split window can be used to choose which element(s) from the yankring you wish to paste. Alternately after text has been pasted (using p), it can be replaced with a previous value from the yankring with a single key stroke.

The captured text is stored in a file (location configurable) and is instantly available (also configurable) to any other instance of Vim also running on the same machine.
The captured text is stored in a file (location configurable) and is instantly available (also configurable) to any other instance of Vim also running on the same machine. This can especially be useful on *nix machines when you are sshed in running Vim in multiple terminals.

Storing the capture text in a file allows the text to be shared easily between multiple instances of Vim running in X, Windows, SSH or Screen.

Expand Down
99 changes: 61 additions & 38 deletions doc/yankring.txt
View file
@@ -1,7 +1,7 @@
*yankring.txt* For Vim version 7.0.

Author: David Fishburn February 5, 2011
Version: 13.0
Author: David Fishburn April 1, 2011
Version: 14.0

For instructions on installing this file, type
:help add-local-help |add-local-help| inside Vim.
Expand All @@ -21,23 +21,23 @@ Homepage: http://vim.sourceforge.net/script.php?script_id=1234
3.4 Customizing Menus..................: |yankring-custom-menus|
4. Using the YankRing Window..............: |yankring-window|
5. Commands...............................: |yankring-commands|
5.1 YRToggle..........................: |YRToggle|
5.2 YRClear...........................: |YRClear|
5.3 YRShow............................: |YRShow|
5.5 YRGetElem.........................: |YRGetElem|
5.6 YRGetMultiple.....................: |YRGetMultiple|
5.7 YRPush............................: |YRPush|
5.8 YRPop.............................: |YRPop|
5.9 YRYankCount.......................: |YRYankCount|
5.10 YRYankRange.......................: |YRYankRange|
5.11 YRDeleteRange.....................: |YRDeleteRange|
5.12 YRPaste...........................: |YRPaste|
5.13 YRReplace.........................: |YRReplace|
5.14 YRMapsCreate......................: |YRMapsCreate|
5.15 YRMapsDelete......................: |YRMapsDelete|
5.16 YRSearch..........................: |YRSearch|
5.17 YRCheckClipboard..................: |YRCheckClipboard|
5.18 YRRunAfterMaps....................: |YRRunAfterMaps|
5.1 YRToggle..........................: |:YRToggle|
5.2 YRClear...........................: |:YRClear|
5.3 YRShow............................: |:YRShow|
5.5 YRGetElem.........................: |:YRGetElem|
5.6 YRGetMultiple.....................: |:YRGetMultiple|
5.7 YRPush............................: |:YRPush|
5.8 YRPop.............................: |:YRPop|
5.9 YRYankCount.......................: |:YRYankCount|
5.10 YRYankRange.......................: |:YRYankRange|
5.11 YRDeleteRange.....................: |:YRDeleteRange|
5.12 YRPaste...........................: |:YRPaste|
5.13 YRReplace.........................: |:YRReplace|
5.14 YRMapsCreate......................: |:YRMapsCreate|
5.15 YRMapsDelete......................: |:YRMapsDelete|
5.16 YRSearch..........................: |:YRSearch|
5.17 YRCheckClipboard..................: |:YRCheckClipboard|
5.18 YRRunAfterMaps....................: |:YRRunAfterMaps|
6. Tutorial...............................: |yankring-tutorial|
6.1 YRShow............................: |YRShow-example|
6.2 YRReplace.........................: |YRReplace-example|
Expand Down Expand Up @@ -540,7 +540,7 @@ convience you can map a key, <F11>, to this command: >
Status line~
The first line in the YankRing window is the status line. >
AutoClose=1;ClipboardMonitor=1;Cmds:p,P,d,r,s,a,c,u,q,<enter>,<space>;Help=?
AutoClose=1;ClipboardMonitor=1;Cmds:[g]p,[g]P,1-9,d,r,s,a,c,u,q,<enter>,<space>;Help=?
<
Help=?, pressing [?] will toggle the display of available commands the
yankring window supports. Pressing [?] again will remove the additional
Expand Down Expand Up @@ -572,10 +572,11 @@ in the YankRing window.
<CR> Just like "p".
<Enter> Just like "p".
<2-LeftMouse> Just like "p". Normal mode only.
1-9 Short cut to paste the n'th number from the YankRing.
d Removes the element from the yankring. In visual mode all
elements selected will be removed.
r Just like "p", but in visual mode if many lines are selected
it will paste these in reverse order.
it will paste these items in reverse order.
s Prompts you for a regex to search the YankRing and display
only matching items.
a Toggles the g:yankring_window_auto_close setting.
Expand All @@ -597,7 +598,7 @@ through maps against a buffer, instead of commands. This makes it much easier
to use.


5.1 YRToggle *YRToggle*
5.1 YRToggle :*YRToggle*
Allows you to enable and disable the YankRing quickly. This
command will remove the default maps and recreate them.

Expand All @@ -607,12 +608,12 @@ to use.
:YRToggle 0 " Disables it
<

5.2 YRClear *YRClear*
5.2 YRClear :*YRClear*
Clears all elements from the yankring.
See also |YRClear-example|.


5.3 YRShow *YRShow*
5.3 YRShow :*YRShow*
Similar to |:register|, will display all the entries in the yankring.
The element at the top will be the next element pasted from the
yankring.
Expand All @@ -629,7 +630,7 @@ to use.
5 one^@
<

5.5 YRGetElem *YRGetElem*
5.5 YRGetElem :*YRGetElem*
This command has two modes. If no parameters are provided, it
becomes interactive. It uses YRShow to display the list and
allows you to choose which element to paste. If a parameter
Expand All @@ -649,7 +650,7 @@ to use.
:YRGetElem 0 " Error, invalid choice is reported
5.6 YRGetMultiple *YRGetMultiple*
5.6 YRGetMultiple :*YRGetMultiple*
Will paste many elements from the YankRing in one command.
If the number specified is 1 or less, it is assumed you want
just the current element pasted. If the number specified is
Expand All @@ -668,7 +669,7 @@ to use.
:YRGetMultiple 0 " Will paste element 1
5.7 YRPush *YRPush*
5.7 YRPush :*YRPush*
Allows the user to "push" additional entries into the yankring.
If you yanked text via a key mapping which does not use the
YankRing (or there is text on the clipboard) you can use this
Expand All @@ -682,7 +683,7 @@ to use.
< See also |YRPush-example|.


5.8 YRPop *YRPop*
5.8 YRPop :*YRPop*
Allows you to pop any elements from the yankring. If no parameters
are provided, the 1st element is removed from the yankring. The
command optionally takes a second parameter to specify how many
Expand All @@ -697,7 +698,7 @@ to use.
< See also |YRPop-example|.


5.9 YRYankCount *YRYankCount*
5.9 YRYankCount :*YRYankCount*
This command has the most mappings created for it. If you are
in normal mode and you are not specifying a range, this command
will add the text to the yankring.
Expand Down Expand Up @@ -739,7 +740,7 @@ to use.
See also |yankring-tutorial|.


5.10 YRYankRange *YRYankRange*
5.10 YRYankRange :*YRYankRange*
This command by default is only called in visual mode. All
visual modes (|characterwise-visual|, |linewise-visual|,
|blockwise-visual|) are supported. Any visually selected text
Expand All @@ -761,12 +762,12 @@ to use.
< See also |YRYankRange-example|.


5.11 YRDeleteRange *YRDeleteRange*
5.11 YRDeleteRange :*YRDeleteRange*
This command is identical to YRYankRange, except the range is
also deleted.


5.12 YRPaste *YRPaste*
5.12 YRPaste :*YRPaste*
This command will paste elements from the yankring. By default it has
been mapped to p and P to match Vim's native key strokes. The text
pasted is exactly what was yanked, including newline characters and
Expand All @@ -783,7 +784,7 @@ to use.
See also |yankring-tutorial|.


5.13 YRReplace *YRReplace*
5.13 YRReplace :*YRReplace*
The purpose of the YankRing is to gain access to previously yanked
(or deleted) elements. This command will replace the previous
paste with a different entry from the yankring.
Expand Down Expand Up @@ -812,33 +813,33 @@ to use.
let g:yankring_replace_n_nkey = '<Char-174>'
endif

5.14 YRMapsCreate *YRMapsCreate*
5.14 YRMapsCreate :*YRMapsCreate*
This public function is responsible for creating the maps which
enable the yankring. This function is called by the YRToggle
command.


5.15 YRMapsDelete *YRMapsDelete*
5.15 YRMapsDelete :*YRMapsDelete*
This public function removes the YankRing maps and disables
the yankring. This function is called by the YRToggle command.


5.16 YRSearch *YRSearch*
5.16 YRSearch :*YRSearch*
This command is similar to |YRGetElem|. The command takes
one parameter which is a regular expression. Similar to
YRGetElem, it will display all items in the YankRing that match
the regular expression. It is also interactive, and will
prompt you to enter which match you wish pasted.
See also |YRSearch-example|.

5.17 YRCheckClipboard *YRCheckClipboard*
5.17 YRCheckClipboard :*YRCheckClipboard*
Normally the GUI Vims will automatically (via autocmds)
check for changes to the system clipboard and add any new
changes to the YankRing. Most console Vim's do not fire
the required autocmds. This command will perform the check
manually.

5.18 YRRunAfterMaps *YRRunAfterMaps*
5.18 YRRunAfterMaps :*YRRunAfterMaps*
See the following section |yankring-custom-maps|.


Expand Down Expand Up @@ -1055,6 +1056,10 @@ mapping: >
Using the YankRing window can be much faster if you do not want to cycle
through the YankRing using <C-P> and <C-N> to find the element.

As a short cut, when using the YankRing window, you can press the numbers
1-9 to paste that item directly and close the YankRing window. This can
be faster than navigating to the correct line number and pressing 'p'.

*multiple-items-example*
There are times when you need to move through a buffer capturing many
different lines (or snippets of code) and eventually want to switch
Expand Down Expand Up @@ -1215,6 +1220,24 @@ mapping: >
==============================================================================
7. History *yankring-history*

14.0: April 1, 2012
NF: The YankRing window supports 1-9 to choose to paste those
items for quicker access to the top 9 items.
NF: The YankRing now maps the @ key to run macros. Not all actions
performed during the macro are recorded by the YankRing
as a number of items had to be unmapped to support the replay
of actions which can prompt the user for input (i.e. t and f)
(Asis Hallab).
BF: When flipping between applications the system clipboard
was not added to the YankRing in all cases.
BF: The YankRing could report E121: Undefined variable:
g:yankring_manual_clipboard_check (Thilo Six).
BF: The YankRing could report: E132: Function call depth is higher
than 'maxfuncdepth'. When executing a YRClear or YRPop or
when flipping between applications (Marcin Szamotulski).
BF: Strange behaviour when opening the YankRing with
:e [YankRing] instead of :YRShow (Marcin Szamotulski).

13.0: February 5, 2012
NF: [p, ]p, [P, ]P are now supported within the YankRing
window (Alexandre Provencio).
Expand Down

0 comments on commit 8ebc225

Please sign in to comment.