Updated vim plugins

sources_non_forked/vim-multiple-cursors/doc/multiple_cursors.txt

@@ -61,36 +61,68 @@ CTRL-X in Visual mode will remove the current virtual cursor and skip to the
 next virtual cursor location. This is useful if you don't want the current
 selection to be a candidate to operate on later.
 
-**NOTE**: The plugin is still somewhat buggy, if at any time you have
-lingering cursors on screen, you can press CTRL-N in Normal mode and it will
-remove all prior cursors before starting a new one.
+You can also add multiple cursors using a regular expression. The command
+*MultipleCursorsFind* accepts a range and a pattern, and it will create a
+virtual cursor at the end of every match within the range. If no range is
+passed in, then it defaults to the entire buffer.
+
+NOTE: If at any time you have lingering cursors on screen, you can press
+CTRL-N in Normal mode and it will remove all prior cursors before starting a
+new one.
 
 ==============================================================================
 3. Mappings                                        *multiple-cursors-mappings* 
 
 *g:multi_cursor_use_default_mapping* (Default: 1)
 
-Out of the box, CTRL-N, CTRL-P, and CTRL-X are mapped by default. If you don't
-like the plugin taking over your favorite key bindings, then turn off the
-default with >
+Out of the box, only the single key CTRL-N is mapped in regular Vim's Normal
+mode and Visual mode to provide the functionality mentioned above. CTRL-N,
+CTRL-P, CTRL-X, and <ESC> are mapped in the special multicursor mode once
+you've added at least one virtual cursor to the buffer. If you don't like the
+plugin taking over your favorite key bindings, you can turn off the default
+with >
 
     let g:multi_cursor_use_default_mapping=0
 <
 
-*g:multi_cursor_next_key* (Default: "\<C-n>")
-*g:multi_cursor_prev_key* (Default: "\<C-p>")
-*g:multi_cursor_skip_key* (Default: "\<C-x>")
-*g:multi_cursor_exit_key* (Default: "\<Esc>")
+*g:multi_cursor_next_key* (Default: '<C-n>')
+*g:multi_cursor_prev_key* (Default: '<C-p>')
+*g:multi_cursor_skip_key* (Default: '<C-x>')
+*g:multi_cursor_quit_key* (Default: '<Esc>')
 You can map the 'next', 'previous', 'skip', and 'exit' keys like the
 following: >
 
     " Default mapping
-    let g:multi_cursor_next_key="\<C-n>"
-    let g:multi_cursor_prev_key="\<C-p>"
-    let g:multi_cursor_skip_key="\<C-x>"
-    let g:multi_cursor_exit_key="\<Esc>"
+    let g:multi_cursor_next_key='<C-n>'
+    let g:multi_cursor_prev_key='<C-p>'
+    let g:multi_cursor_skip_key='<C-x>'
+    let g:multi_cursor_quit_key='<Esc>'
 <
 
+*g:multi_cursor_start_key* (Default: 'g:multi_cursor_next_key')
+By default, the same key is used to enter multicursor mode as to select the
+next cursor location.  If you want to use a different key to start multicursor
+mode than for selecting the next location, do like the following: >
+
+    " Map start key separately from next key
+    let g:multi_cursor_start_key='<F6>'
+<
+
+IMPORTANT: Please note that currently only single keystroes and special
+keys can be mapped. This contraint is also the reason why multikey commands
+such as `ciw` do not work and cause unexpected behavior in Normal mode. This
+means that a mapping like `<Leader>n` will NOT work correctly. For a list of
+special keys that are supported, see |key-notation|
+
+NOTE: Please make sure to always map something to |g:multi_cursor_quit_key|,
+otherwise you'll have a tough time quitting from multicursor mode.
+
+NOTE: Prior to version 1.3, the recommended way to map the keys is using the
+expressoin quote syntax in Vim, using something like `"\<C-n>"` or `"\<Esc>"`
+(see h: expr-quote). After 1.3, the recommended way is to use a raw string
+like above. If your key mappings don't appear to work, give the new syntax a
+try.
+
 ==============================================================================
 4. Global Options                            *multiple-cursors-global-options* 
 
@@ -98,14 +130,14 @@ Currently there're two additional global settings one can tweak:
 
 *g:multi_cursor_exit_from_visual_mode* (Defaut: 1)
 
-If set to 0, then pressing |g:multi_cursor_exit_key| in Visual mode will not
+If set to 0, then pressing |g:multi_cursor_quit_key| in Visual mode will not
 quit and delete all existing cursors. This is useful if you want to press
 Escape and go back to Normal mode, and still be able to operate on all the
 cursors.
 
 *g:multi_cursor_exit_from_insert_mode* (Default: 1)
 
-If set to 0, then pressing |g:multi_cursor_exit_key| in Insert mode will not
+If set to 0, then pressing |g:multi_cursor_quit_key| in Insert mode will not
 quit and delete all existing cursors. This is useful if you want to press
 Escape and go back to Normal mode, and still be able to operate on all the
 cursors.
@@ -128,15 +160,8 @@ like the following in your vimrc: >
   cursors is lost. This is a implementation decision to keep the input
   perfectly synced in all locations, at the cost of potentially losing user
   input.
-- Single key commands that do not terminate properly cause unexpected
-  behavior. For example, if the cursor is on the first character in the buffer
-  and 'b' is pressed.
-- Undo behavior is unpredictable
 - Performance in terminal vim degrades significantly with more cursors
 - Select mode is not implemented
-- Buggy when wrap is turned on
-- Cursor highlighting is off. The last column on the same row as Vim's cursor
-  is not highlighted incorrectly. Setting virtualedit=all might help
 
 ==============================================================================
 6. Contributing                                *multiple-cursors-contributing* 

sources_non_forked/vim-multiple-cursors/doc/tags

@@ -1,9 +1,11 @@
+MultipleCursorsFind	multiple_cursors.txt	/*MultipleCursorsFind*
 g:multi_cursor_exit_from_insert_mode	multiple_cursors.txt	/*g:multi_cursor_exit_from_insert_mode*
 g:multi_cursor_exit_from_visual_mode	multiple_cursors.txt	/*g:multi_cursor_exit_from_visual_mode*
-g:multi_cursor_exit_key	multiple_cursors.txt	/*g:multi_cursor_exit_key*
 g:multi_cursor_next_key	multiple_cursors.txt	/*g:multi_cursor_next_key*
 g:multi_cursor_prev_key	multiple_cursors.txt	/*g:multi_cursor_prev_key*
+g:multi_cursor_quit_key	multiple_cursors.txt	/*g:multi_cursor_quit_key*
 g:multi_cursor_skip_key	multiple_cursors.txt	/*g:multi_cursor_skip_key*
+g:multi_cursor_start_key	multiple_cursors.txt	/*g:multi_cursor_start_key*
 g:multi_cursor_use_default_mapping	multiple_cursors.txt	/*g:multi_cursor_use_default_mapping*
 multiple-cursors-contents	multiple_cursors.txt	/*multiple-cursors-contents*
 multiple-cursors-contributing	multiple_cursors.txt	/*multiple-cursors-contributing*