Version 13.0

NF: [p, ]p, [P, ]P are now supported within the YankRing window (Alexandre Provencio).

NF: When using the console version of Vim the yankring was not detecting the "+ register automatically as the FocusGained event does not fire in console mode.  When new elements are added or the YankRing is shown the clipboard will be checked for new values (Giuseppe Rota).

NF: Added a new option, g:yankring_manual_clipboard_check which when enabled will manually check for clipboard changes at certain times within the YankRing.  This option is not used if the GUI is running as the FocusGained will perform checks at appropriate times (Erik Westrup).

BF: With clipboard=unnamed replacing the previous paste with a different value from the YankRing did not work in all cases (Chris Lott).

BF: Under certain conditions the YankRing would still check the system clipboard even if g:yankring_clipboard_monitor == 0.  This can lead to delays when attempting to access the clipboard when running in console mode.  Starting Vim with the -X switch removes the delay (Erik Westrup).

BF: Incorrect syntax setting cpoptions (Thilo Six).

Author: dfishburn

doc/yankring.txt

@@ -1,7 +1,7 @@
 *yankring.txt*      For Vim version 7.0. 
 
-Author:	        David Fishburn                             September 16, 2011
-Version:        12.0
+Author:	        David Fishburn                             February 5, 2011
+Version:        13.0
 
 For instructions on installing this file, type
 	:help add-local-help |add-local-help| inside Vim.
@@ -36,7 +36,8 @@ Homepage: http://vim.sourceforge.net/script.php?script_id=1234
        5.14 YRMapsCreate......................: |YRMapsCreate|
        5.15 YRMapsDelete......................: |YRMapsDelete|
        5.16 YRSearch..........................: |YRSearch|
-       5.17 YRRunAfterMaps....................: |yankring-custom-maps|
+       5.17 YRCheckClipboard..................: |YRCheckClipboard|
+       5.18 YRRunAfterMaps....................: |YRRunAfterMaps|
     6. Tutorial...............................: |yankring-tutorial|
        6.1  YRShow............................: |YRShow-example|
        6.2  YRReplace.........................: |YRReplace-example|
@@ -261,9 +262,26 @@ your |.vimrc|.
         want to use the same text later on.  By default, the YankRing
         will detect when Vim regains focus and check if the clipboard
         has changed since it last checked.  If so, it will add the contents
-        of the clipboard to the YankRing.  To disable this feature 
+        of the clipboard to the YankRing.  This is accomplished by the 
+        use of the FocusGained Vim event for the GUI Vim.  For console 
+        Vims, the FocusGained event does not fire, so additional logic 
+        is added to deal with it.  To disable this feature 
         you can put the following in your |vimrc| >
             let g:yankring_clipboard_monitor = 0
+    yankring_manual_clipboard_check
+<       Default: 0
+        If running in console mode, Vim's FocusGained event will not
+        fire as we flip back and forth between windows.  This normally
+        instructs the YankRing to check for updates to the system
+        clipboard.  When this option is set, the YankRing will check
+        the clipboard under many different circumstances:
+            Adding a new entry to the YankRing 
+            Replacing a previous paste 
+            Showing the YankRing window
+        If the YankRing is setup to check the clipboard and the 
+        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
 <       Default: 1
         If the default register has changed without the YankRing registering
@@ -767,15 +785,32 @@ to use.
 
 5.13 YRReplace                                   *YRReplace*
         The purpose of the YankRing is to gain access to previously yanked
-        (or deleted) elements.  This command will replace the previously 
-        paste  with a different entry from the yankring.
+        (or deleted) elements.  This command will replace the previous
+        paste with a different entry from the yankring.
         By default, I choose <C-P> (P for previous) to replace the last paste
         while moving backwards through the yankring.  <C-N> (N for next)
         replaces the last paste while moving forward through the yankring. 
 
         Examples:
             See the |yankring-tutorial| for examples.
 
+        On the Windows platform, I use ALT-< and ALT-> to move back and 
+        forwards through the yankring instead of C-P and C-N. ALT-< is
+        actually ALT-, since I do not press the Shift key to get the <.
+
+        To do this, I added the following to my .vimrc:
+            " Do not map the default <C-N> and <C-P> keys
+            " These two characters are the ALT-< and ALT->.
+            " To determine what character # these are go into insert mode
+            " in a new buffer.  Press CTRL-V then ALT and the > key.
+            " Leave insert mode, move the cursor onto the character
+            " and press ga.  This will display the decimal, hex and octal
+            " representation of the character.  In this case, they are
+            " 172 and 174.
+            if has('win32')
+                let g:yankring_replace_n_pkey = '<Char-172>'
+                let g:yankring_replace_n_nkey = '<Char-174>'
+            endif
 
 5.14 YRMapsCreate                                *YRMapsCreate*
         This public function is responsible for creating the maps which
@@ -796,6 +831,16 @@ to use.
         prompt you to enter which match you wish pasted.
         See also |YRSearch-example|.
 
+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*
+        See the following section |yankring-custom-maps|.
+
 
 ==============================================================================
 6. Tutorial                                      *yankring-tutorial*
@@ -1170,13 +1215,55 @@ mapping: >
 ==============================================================================
 7. History                                       *yankring-history*
 
+  13.0: February 5, 2012
+         NF: [p, ]p, [P, ]P are now supported within the YankRing 
+             window (Alexandre Provencio).
+         NF: When using the console version of Vim the yankring was not
+             detecting the "+ register automatically as the FocusGained
+             event does not fire in console mode.  When new elements are
+             added or the YankRing is shown the clipboard will be
+             checked for new values (Giuseppe Rota).
+         NF: Added a new option, g:yankring_manual_clipboard_check which 
+             when enabled will manually check for clipboard changes at 
+             certain times within the YankRing.  This option is not used 
+             if the GUI is running as the FocusGained will perform checks 
+             at appropriate times (Erik Westrup).
+         BF: With clipboard=unnamed replacing the previous paste with a 
+             different value from the YankRing did not work in all cases 
+             (Chris Lott).
+         BF: Under certain conditions the YankRing would still check
+             the system clipboard even if g:yankring_clipboard_monitor == 0.
+             This can lead to delays when attempting to access the 
+             clipboard when running in console mode.  Starting Vim with
+             the -X switch removes the delay (Erik Westrup).
+         BF: Incorrect syntax setting cpoptions (Thilo Six).
+
+  12.0: October 15, 2011
+         NF: A console Vim does not necessarily react to a FocusGained event
+             which means as you switch Focus back and forth between a 
+             console Vim, the YankRing's feature to automatically gather 
+             changes to the system clipboard is not triggered.  Now special 
+             processing takes place in various spots when you are not running 
+             Vim with a GUI, to check for changes to the clipboard.  Those 
+             already running a GUI Vim, are unaffected by this change
+             (Giuseppe Rota).
+         NF: New command, YRCheckClipboard, which allows you to force 
+             the YankRing to check the system clipboard and if the 
+             value is not present already in the YankRing, it will add it.
+             This is typically done automatically, but certain console 
+             Vim's do not receive the necessary events for automation.
+         BF: Some additional changes were required for the "unnamedplus"
+             support.
+         BF: YRGetMultiple reported an error, though typically you would
+             use YRShow to paste the items.
+
   12.0: September 16, 2011
          NF: Added support for the clipboard option "unnamedplus" which was
              added after 7.3 (Hong Xu).
          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 ).
+             interfers with recorded macros (Philippe Vaucher).
 
   11.0: August 09, 2010
          NF: Documented the global variables to customize the location