1- *yankring.txt* For Vim version 6.2 and 7.0.
1+ *yankring.txt* For Vim version 7.0.
22
3- Author: David Fishburn October 19, 2005
4- Version: 2.2
3+ Author: David Fishburn September 7, 2007
4+ Version: 3.0
55
66For instructions on installing this file, type
77 :help add-local-help | add-local-help | inside Vim.
@@ -33,6 +33,7 @@ For instructions on installing this file, type
3333 5.14 YRMapsCreate......................: | YRMapsCreate |
3434 5.15 YRMapsDelete......................: | YRMapsDelete |
3535 5.16 YRSearch..........................: | YRSearch |
36+ 5.17 YRRunAfterMaps....................: | yankring-custom-maps |
3637 6. Tutorial...............................: | yankring-tutorial |
3738 6.1 YRShow............................: | YRShow-example |
3839 6.2 YRReplace.........................: | YRReplace-example |
@@ -53,13 +54,16 @@ deletes. These previous deletes can be referenced using [register]p, so
5354"1p will paste the last delete, "2p the 2nd last delete. For more
5455information see | quote_number | .
5556
56- Vim does not provide any mechanism to reference previous yanked text.
57+ Vim does not provide any mechanism to reference previously yanked text.
5758In Emacs this feature is called the "kill ring".
5859
5960The yankring plugin allows the user to configure the number of yanked
6061and deleted text. After text has been pasted, it can be replaced with
6162a previous value from the yankring.
6263
64+ As of version 3.0, the yankring's content will persist (by default)
65+ between starting and stopping Vim.
66+
6367The plugin can be toggled on and off, and supports:
6468 Ranges
6569 Registers
@@ -101,6 +105,12 @@ your |.vimrc|.
101105 separate line. Since each yank could be very large, the display of
102106 the element is limited to the above default. >
103107 let g:yankring_max_display = 70
108+ yankring_persist
109+ < Default: 1
110+ If you have enabled the storing of global variables in the | viminfo |
111+ file, the yankring will be default persist the contents of the ring
112+ between starting and stopping Vim. To disable this feature: >
113+ let g:yankring_persist = 0
104114 yankring_dot_repeat_yank
105115< Default: Based on the Vim cpoption setting
106116 By default Vim will not repeat (using '.') yanking of text. This can
@@ -307,6 +317,7 @@ This line remaps Y (which the user presses) to the YRYankCount command. The
307317YRYankCount tells Vim to execute y$ instead.
308318
309319
320+ ==============================================================================
3103214. Using the YankRing Window: *yankring-window*
311322
312323This is a new feature as of the 2.0 release. The yankring uses a
@@ -360,6 +371,7 @@ in the yankring window.
360371
361372
362373
374+ ==============================================================================
3633755. Commands: *yankring-commands*
364376
365377The predefined mappings call some specific commands with special parameters.
@@ -949,6 +961,23 @@ mapping: >
949961==============================================================================
9509627. History *yankring-history*
951963
964+ 3.0: September 7, 2007:
965+ NF: Converted the yankring to use the new Vim7's List object which
966+ means it is no longer compatible with Vim6.
967+ NF: By default the yankring will now maintain the yankring's items
968+ persistently by default. It does this via the | viminfo | file.
969+ This means the contents are the yankring rely on the internal
970+ variables of only 1 Vim instance.
971+ BF: YRToggle was not unmapping 'gp' and 'gP'.
972+ BF: YRSearch prompted the user for a regex even if one was provided
973+ on the command line.
974+ BF: If g:yankring_manage_numbered_reg is enabled, the "." operator
975+ did not correctly repeat the previous action (Pedro DeRose).
976+
977+ 2.2: November 1, 2005:
978+ NF: Added 'x' to the list of yankring_n_keys. This is very useful
979+ in visual mode since it can delete a lot of characters.
980+
952981 2.2: October 19, 2005:
953982 BF: If you pressed '?' to toggle the display of the help in the
954983 yankring window, the window would close. This also applied to
0 commit comments