1
1
*yankring.txt* For Vim version 7.0.
2
2
3
- Author: David Fishburn April 1, 2011
4
- Version: 14 .0
3
+ Author: David Fishburn Jnauary 2, 2013
4
+ Version: 15 .0
5
5
6
6
For instructions on installing this file, type
7
7
:help add-local-help | add-local-help | inside Vim.
@@ -196,12 +196,12 @@ your |.vimrc|.
196
196
setting this option to 0. >
197
197
let g:yankring_window_use_horiz = 0 " Use vertical split
198
198
yankring_window_height
199
- < Default: 1
199
+ < Default: 8
200
200
If using a horizontal split, this option controls how high to make
201
201
the window. >
202
202
let g:yankring_window_height = 8
203
203
yankring_window_width
204
- < Default: 1
204
+ < Default: 30
205
205
If using a vertical split, this option controls how wide to make the
206
206
window. >
207
207
let g:yankring_window_width = 30
@@ -282,7 +282,7 @@ your |.vimrc|.
282
282
GUI is not running, this option will be enabled by default.
283
283
To disable this feature you can put the following in your | vimrc | >
284
284
let g:yankring_manual_clipboard_check = 0
285
- yankring_paste_check_default_buffer
285
+ yankring_paste_check_default_register
286
286
< Default: 1
287
287
If the default register has changed without the YankRing registering
288
288
the change the YankRing will paste the top item from the history
@@ -291,7 +291,7 @@ your |.vimrc|.
291
291
intentionally change the default buffer which the YankRing has
292
292
no way to noticing. To disable this feature you can put the following
293
293
in your | vimrc | >
294
- let g:yankring_paste_check_default_buffer = 0
294
+ let g:yankring_paste_check_default_register = 0
295
295
yankring_default_menu_mode
296
296
< - Menus are useful for a number of reasons:
297
297
See a list of available commands.
@@ -535,7 +535,7 @@ specific maps that allow you to operate over the various elements from
535
535
within the yankring.
536
536
537
537
To display the YankRing buffer you can issue the :YRShow command. For
538
- convience you can map a key, <F11> , to this command: >
538
+ convenience you can map a key, <F11> , to this command: >
539
539
:nnoremap <silent> <F11> :YRShow<CR>
540
540
541
541
Status line~
@@ -572,7 +572,7 @@ in the YankRing window.
572
572
<CR> Just like "p".
573
573
<Enter> Just like "p".
574
574
<2-LeftMouse> Just like "p". Normal mode only.
575
- 1-9 Short cut to paste the n'th number from the YankRing.
575
+ 1-9 Shortcut to paste the n'th number from the YankRing.
576
576
d Removes the element from the yankring. In visual mode all
577
577
elements selected will be removed.
578
578
r Just like "p", but in visual mode if many lines are selected
@@ -598,7 +598,7 @@ through maps against a buffer, instead of commands. This makes it much easier
598
598
to use.
599
599
600
600
601
- 5.1 YRToggle : * YRToggle*
601
+ 5.1 YRToggle *: YRToggle*
602
602
Allows you to enable and disable the YankRing quickly. This
603
603
command will remove the default maps and recreate them.
604
604
@@ -608,12 +608,12 @@ to use.
608
608
:YRToggle 0 " Disables it
609
609
<
610
610
611
- 5.2 YRClear : * YRClear*
611
+ 5.2 YRClear *: YRClear*
612
612
Clears all elements from the yankring.
613
613
See also | YRClear-example | .
614
614
615
615
616
- 5.3 YRShow : * YRShow*
616
+ 5.3 YRShow *: YRShow*
617
617
Similar to | :register | , will display all the entries in the yankring.
618
618
The element at the top will be the next element pasted from the
619
619
yankring.
@@ -630,7 +630,7 @@ to use.
630
630
5 one^@
631
631
<
632
632
633
- 5.5 YRGetElem : * YRGetElem*
633
+ 5.5 YRGetElem *: YRGetElem*
634
634
This command has two modes. If no parameters are provided, it
635
635
becomes interactive. It uses YRShow to display the list and
636
636
allows you to choose which element to paste. If a parameter
@@ -650,7 +650,7 @@ to use.
650
650
:YRGetElem 0 " Error, invalid choice is reported
651
651
652
652
653
- 5.6 YRGetMultiple : * YRGetMultiple*
653
+ 5.6 YRGetMultiple *: YRGetMultiple*
654
654
Will paste many elements from the YankRing in one command.
655
655
If the number specified is 1 or less, it is assumed you want
656
656
just the current element pasted. If the number specified is
@@ -669,7 +669,7 @@ to use.
669
669
:YRGetMultiple 0 " Will paste element 1
670
670
671
671
672
- 5.7 YRPush : * YRPush*
672
+ 5.7 YRPush *: YRPush*
673
673
Allows the user to "push" additional entries into the yankring.
674
674
If you yanked text via a key mapping which does not use the
675
675
YankRing (or there is text on the clipboard) you can use this
@@ -683,7 +683,7 @@ to use.
683
683
< See also | YRPush-example | .
684
684
685
685
686
- 5.8 YRPop : * YRPop*
686
+ 5.8 YRPop *: YRPop*
687
687
Allows you to pop any elements from the yankring. If no parameters
688
688
are provided, the 1st element is removed from the yankring. The
689
689
command optionally takes a second parameter to specify how many
@@ -698,7 +698,7 @@ to use.
698
698
< See also | YRPop-example | .
699
699
700
700
701
- 5.9 YRYankCount : * YRYankCount*
701
+ 5.9 YRYankCount *: YRYankCount*
702
702
This command has the most mappings created for it. If you are
703
703
in normal mode and you are not specifying a range, this command
704
704
will add the text to the yankring.
@@ -740,7 +740,7 @@ to use.
740
740
See also | yankring-tutorial | .
741
741
742
742
743
- 5.10 YRYankRange : * YRYankRange*
743
+ 5.10 YRYankRange *: YRYankRange*
744
744
This command by default is only called in visual mode. All
745
745
visual modes (| characterwise-visual | , | linewise-visual | ,
746
746
| blockwise-visual | ) are supported. Any visually selected text
@@ -762,12 +762,12 @@ to use.
762
762
< See also | YRYankRange-example | .
763
763
764
764
765
- 5.11 YRDeleteRange : * YRDeleteRange*
765
+ 5.11 YRDeleteRange *: YRDeleteRange*
766
766
This command is identical to YRYankRange, except the range is
767
767
also deleted.
768
768
769
769
770
- 5.12 YRPaste : * YRPaste*
770
+ 5.12 YRPaste *: YRPaste*
771
771
This command will paste elements from the yankring. By default it has
772
772
been mapped to p and P to match Vim's native key strokes. The text
773
773
pasted is exactly what was yanked, including newline characters and
@@ -784,7 +784,7 @@ to use.
784
784
See also | yankring-tutorial | .
785
785
786
786
787
- 5.13 YRReplace : * YRReplace*
787
+ 5.13 YRReplace *: YRReplace*
788
788
The purpose of the YankRing is to gain access to previously yanked
789
789
(or deleted) elements. This command will replace the previous
790
790
paste with a different entry from the yankring.
@@ -813,33 +813,33 @@ to use.
813
813
let g:yankring_replace_n_nkey = '<Char-174> '
814
814
endif
815
815
816
- 5.14 YRMapsCreate : * YRMapsCreate*
816
+ 5.14 YRMapsCreate *: YRMapsCreate*
817
817
This public function is responsible for creating the maps which
818
818
enable the yankring. This function is called by the YRToggle
819
819
command.
820
820
821
821
822
- 5.15 YRMapsDelete : * YRMapsDelete*
822
+ 5.15 YRMapsDelete *: YRMapsDelete*
823
823
This public function removes the YankRing maps and disables
824
824
the yankring. This function is called by the YRToggle command.
825
825
826
826
827
- 5.16 YRSearch : * YRSearch*
827
+ 5.16 YRSearch *: YRSearch*
828
828
This command is similar to | YRGetElem | . The command takes
829
829
one parameter which is a regular expression. Similar to
830
830
YRGetElem, it will display all items in the YankRing that match
831
831
the regular expression. It is also interactive, and will
832
832
prompt you to enter which match you wish pasted.
833
833
See also | YRSearch-example | .
834
834
835
- 5.17 YRCheckClipboard : * YRCheckClipboard*
835
+ 5.17 YRCheckClipboard *: YRCheckClipboard*
836
836
Normally the GUI Vims will automatically (via autocmds)
837
837
check for changes to the system clipboard and add any new
838
838
changes to the YankRing. Most console Vim's do not fire
839
839
the required autocmds. This command will perform the check
840
840
manually.
841
841
842
- 5.18 YRRunAfterMaps : * YRRunAfterMaps*
842
+ 5.18 YRRunAfterMaps *: YRRunAfterMaps*
843
843
See the following section | yankring-custom-maps | .
844
844
845
845
@@ -886,7 +886,7 @@ mapping: >
886
886
887
887
You do not need to interact with the YankRing using the YankRing window.
888
888
Using the window makes many tasks must easier, but for speed using some
889
- of the other maps can be preferrable if you know what you have yanked /
889
+ of the other maps can be preferable if you know what you have yanked /
890
890
deleted recently. It was designed to work with Vim in the usual manner.
891
891
You can press, 'p', to paste the last item in yanked or deleted.
892
892
@@ -902,7 +902,7 @@ mapping: >
902
902
five
903
903
five
904
904
<
905
- Assume you did not want ' five", but a different entry from within the
905
+ Assume you did not want " five", but a different entry from within the
906
906
yankring. <C-P> moves backwards through the yankring, it will replace
907
907
the previous pasted text with a different item from the yankring. This
908
908
allows you to quickly iterate through different elements. <C-P> is the
@@ -1220,6 +1220,40 @@ mapping: >
1220
1220
==============================================================================
1221
1221
7. History *yankring-history*
1222
1222
1223
+ 15.0: January 2, 2013
1224
+ NF: Automatically turn off relativenumber for the YankRing
1225
+ window (Emma Tramp).
1226
+ NF: Automatically turn off relativenumber for the YankRing
1227
+ window (Emma Tramp).
1228
+ NF: The YankRing window supports 1-9 to choose to paste those
1229
+ items for quicker access to the top 9 items.
1230
+ BF: When re-executing a macro using @<letter> and the macro
1231
+ used f, F, t, T, a "Press ENTER to continue" prompt
1232
+ was displayed (Greg Sexton).
1233
+ BF: Some documentation updates and script tweaks (Dominique Pellé).
1234
+ BF: The 0 register was updated during delete operations
1235
+ (Christian Brabandt).
1236
+ BF: When running a macro (@a), pressing @ displays a YankRing prompt
1237
+ (YR:Enter character:) to choose which macro name to run. This
1238
+ prompt was displayed twice leading to a "Press ENTER or type
1239
+ command to continue" Vim message. This change suppresses
1240
+ the "Press ENTER" message (Greg Sexton).
1241
+ BF: The YankRing prevented you from re-running the last macro
1242
+ using @@.
1243
+ BF: YRToggle (to disable / enable the YankRing) did not
1244
+ unmap @.
1245
+ BF: When prompted for a macro to run, if an invalid value was
1246
+ provided, Vim could report "E354: Invalid register name".
1247
+ BF: When using a Vim instance with < 80 columns and using a
1248
+ horizontal YankRing window after opening and closing the
1249
+ YankRing window the Vim window did not shrink back to
1250
+ its original size (Eric Weir).
1251
+ BF: Updated documented values of yankring_window_height and
1252
+ yankring_window_width (Paul).
1253
+ BF: It was not possible to paste from the * register if the
1254
+ clipboard option contains unnamedplus before unnamed
1255
+ (Marcin Szamotulski).
1256
+
1223
1257
14.0: April 1, 2012
1224
1258
NF: The YankRing window supports 1-9 to choose to paste those
1225
1259
items for quicker access to the top 9 items.
@@ -1286,7 +1320,7 @@ mapping: >
1286
1320
NF: When displaying the YankRing using YRShow, a new command "R"
1287
1321
has been added to display all of Vim's registers [0-9a-z] .
1288
1322
BF: YRMapsDelete did not remove the normal mode @ map, which
1289
- interfers with recorded macros (Philippe Vaucher).
1323
+ interferes with recorded macros (Philippe Vaucher).
1290
1324
1291
1325
11.0: August 09, 2010
1292
1326
NF: Documented the global variables to customize the location
@@ -1439,7 +1473,7 @@ mapping: >
1439
1473
NF: Prior to this version only yanks and deletes were registered
1440
1474
in the yankring. Changes are now also captured into the
1441
1475
yankring.
1442
- NF: The YankRing will also capture the system cliboard when focus is
1476
+ NF: The YankRing will also capture the system clipboard when focus is
1443
1477
returned to the vim window. This is useful if you copy text
1444
1478
between applications.
1445
1479
NF: The YankRing window always opened bottom horizontal. Now it
@@ -1449,7 +1483,7 @@ mapping: >
1449
1483
of Vim by storing the values in global variables within
1450
1484
the viminfo. This has led to some unusual ordering of
1451
1485
items in the ring from conflicts between instances.
1452
- This option has been turn off by default.
1486
+ This option has been turned off by default.
1453
1487
BF: Their was an issue with yanking using y$.
1454
1488
1455
1489
3.1: September 10, 2007:
0 commit comments