Skip to content

Commit

Permalink
Version 15.0
Browse files Browse the repository at this point in the history 
NF: Automatically turn off relativenumber for the YankRing window (Emma Tramp).

NF: The YankRing window supports 1-9 to choose to paste those items for quicker access to the top 9 items.

BF: When re-executing a macro using @<letter> and the macro used f, F, t, T, a "Press ENTER to continue" prompt was displayed (Greg Sexton).

BF: Some documentation updates and script tweaks (Dominique Pellé).

BF: The 0 register was updated during delete operations (Christian Brabandt).

BF: When running a macro (@A), pressing @ displays a YankRing prompt (YR:Enter character:) to choose which macro name to run.  This prompt was displayed twice leading to a "Press ENTER or type command to continue" Vim message.  This change suppresses the "Press ENTER" message (Greg Sexton).

BF: The YankRing prevented you from re-running the last macro using @@.

BF: YRToggle (to disable / enable the YankRing) did not unmap @.

BF: When prompted for a macro to run, if an invalid value was provided, Vim could report "E354: Invalid register name".

BF: When using a Vim instance with < 80 columns and using a horizontal YankRing window after opening and closing the YankRing window the Vim window did not shrink back to its original size (Eric Weir).

BF: Updated documented values of yankring_window_height and yankring_window_width (Paul).

BF: It was not possible to paste from the * register if the clipboard option contains unnamedplus before unnamed (Marcin Szamotulski).
  • Loading branch information
@dfishburn @vim-scripts
dfishburn authored and vim-scripts committed Jan 5, 2013
1 parent 8ebc225 commit 7551d5e
Show file tree
Hide file tree
Showing 2 changed files with 205 additions and 117 deletions.
94 changes: 64 additions & 30 deletions doc/yankring.txt
View file
@@ -1,7 +1,7 @@
*yankring.txt* For Vim version 7.0.

Author: David Fishburn April 1, 2011
Version: 14.0
Author: David Fishburn Jnauary 2, 2013
Version: 15.0

For instructions on installing this file, type
:help add-local-help |add-local-help| inside Vim.
Expand Down Expand Up @@ -196,12 +196,12 @@ your |.vimrc|.
setting this option to 0. >
let g:yankring_window_use_horiz = 0 " Use vertical split
yankring_window_height
< Default: 1
< Default: 8
If using a horizontal split, this option controls how high to make
the window. >
let g:yankring_window_height = 8
yankring_window_width
< Default: 1
< Default: 30
If using a vertical split, this option controls how wide to make the
window. >
let g:yankring_window_width = 30
Expand Down Expand Up @@ -282,7 +282,7 @@ your |.vimrc|.
GUI is not running, this option will be enabled by default.
To disable this feature you can put the following in your |vimrc| >
let g:yankring_manual_clipboard_check = 0
yankring_paste_check_default_buffer
yankring_paste_check_default_register
< Default: 1
If the default register has changed without the YankRing registering
the change the YankRing will paste the top item from the history
Expand All @@ -291,7 +291,7 @@ your |.vimrc|.
intentionally change the default buffer which the YankRing has
no way to noticing. To disable this feature you can put the following
in your |vimrc| >
let g:yankring_paste_check_default_buffer = 0
let g:yankring_paste_check_default_register = 0
yankring_default_menu_mode
< - Menus are useful for a number of reasons:
See a list of available commands.
Expand Down Expand Up @@ -535,7 +535,7 @@ specific maps that allow you to operate over the various elements from
within the yankring.

To display the YankRing buffer you can issue the :YRShow command. For
convience you can map a key, <F11>, to this command: >
convenience you can map a key, <F11>, to this command: >
:nnoremap <silent> <F11> :YRShow<CR>
Status line~
Expand Down Expand Up @@ -572,7 +572,7 @@ 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.
1-9 Shortcut 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
Expand All @@ -598,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 @@ -608,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 @@ -630,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 @@ -650,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 @@ -669,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 @@ -683,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 @@ -698,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 @@ -740,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 @@ -762,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 @@ -784,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 @@ -813,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 @@ -886,7 +886,7 @@ mapping: >

You do not need to interact with the YankRing using the YankRing window.
Using the window makes many tasks must easier, but for speed using some
of the other maps can be preferrable if you know what you have yanked /
of the other maps can be preferable if you know what you have yanked /
deleted recently. It was designed to work with Vim in the usual manner.
You can press, 'p', to paste the last item in yanked or deleted.

Expand All @@ -902,7 +902,7 @@ mapping: >
five
five
<
Assume you did not want 'five", but a different entry from within the
Assume you did not want "five", but a different entry from within the
yankring. <C-P> moves backwards through the yankring, it will replace
the previous pasted text with a different item from the yankring. This
allows you to quickly iterate through different elements. <C-P> is the
Expand Down Expand Up @@ -1220,6 +1220,40 @@ mapping: >
==============================================================================
7. History *yankring-history*

15.0: January 2, 2013
NF: Automatically turn off relativenumber for the YankRing
window (Emma Tramp).
NF: Automatically turn off relativenumber for the YankRing
window (Emma Tramp).
NF: The YankRing window supports 1-9 to choose to paste those
items for quicker access to the top 9 items.
BF: When re-executing a macro using @<letter> and the macro
used f, F, t, T, a "Press ENTER to continue" prompt
was displayed (Greg Sexton).
BF: Some documentation updates and script tweaks (Dominique Pellé).
BF: The 0 register was updated during delete operations
(Christian Brabandt).
BF: When running a macro (@a), pressing @ displays a YankRing prompt
(YR:Enter character:) to choose which macro name to run. This
prompt was displayed twice leading to a "Press ENTER or type
command to continue" Vim message. This change suppresses
the "Press ENTER" message (Greg Sexton).
BF: The YankRing prevented you from re-running the last macro
using @@.
BF: YRToggle (to disable / enable the YankRing) did not
unmap @.
BF: When prompted for a macro to run, if an invalid value was
provided, Vim could report "E354: Invalid register name".
BF: When using a Vim instance with < 80 columns and using a
horizontal YankRing window after opening and closing the
YankRing window the Vim window did not shrink back to
its original size (Eric Weir).
BF: Updated documented values of yankring_window_height and
yankring_window_width (Paul).
BF: It was not possible to paste from the * register if the
clipboard option contains unnamedplus before unnamed
(Marcin Szamotulski).

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.
Expand Down Expand Up @@ -1286,7 +1320,7 @@ mapping: >
NF: When displaying the YankRing using YRShow, a new command "R"
has been added to display all of Vim's registers [0-9a-z].
BF: YRMapsDelete did not remove the normal mode @ map, which
interfers with recorded macros (Philippe Vaucher).
interferes with recorded macros (Philippe Vaucher).

11.0: August 09, 2010
NF: Documented the global variables to customize the location
Expand Down Expand Up @@ -1439,7 +1473,7 @@ mapping: >
NF: Prior to this version only yanks and deletes were registered
in the yankring. Changes are now also captured into the
yankring.
NF: The YankRing will also capture the system cliboard when focus is
NF: The YankRing will also capture the system clipboard when focus is
returned to the vim window. This is useful if you copy text
between applications.
NF: The YankRing window always opened bottom horizontal. Now it
Expand All @@ -1449,7 +1483,7 @@ mapping: >
of Vim by storing the values in global variables within
the viminfo. This has led to some unusual ordering of
items in the ring from conflicts between instances.
This option has been turn off by default.
This option has been turned off by default.
BF: Their was an issue with yanking using y$.

3.1: September 10, 2007:
Expand Down

0 comments on commit 7551d5e

Please sign in to comment.