diff options
Diffstat (limited to 'doc/paste_insert.txt')
-rw-r--r-- | doc/paste_insert.txt | 22 |
1 files changed, 8 insertions, 14 deletions
diff --git a/doc/paste_insert.txt b/doc/paste_insert.txt index d9b2bb2..68f1ef9 100644 --- a/doc/paste_insert.txt +++ b/doc/paste_insert.txt @@ -2,13 +2,14 @@ DESCRIPTION *paste_insert* -This small plugin provides a simple "one shot paste" method, with a command or -mapping to prefix opening an insert, with the 'paste' option automatically set -after the insert ends, to avoid the annoyances caused by forgetting to do so. +This plugin implements a method for setting paste mode with the 'paste' option +for only the duration of the next insert operation, to avoid the hassle of +forgetting to unset the option after inserting. It includes a timeout if insert mode isn't entered within 'updatetime' seconds, or if the user navigates away from the buffer or window. It can also -be cancelled with keys in normal mode, by default CTRL-C or Escape. +be cancelled in normal mode with CTRL-C or Escape. These keys can be changed +if they are already mapped or otherwise unsuitable. REQUIREMENTS *paste_insert-requirements* @@ -38,10 +39,9 @@ Set `g:paste_insert_cancel` to a |List| of the special codes for keys you want to cancel the pending paste in normal mode. `['<C-C>', '<Esc>']` is the default, for CTRL-C and Escape. -The plugin will overwrite any existing normal mode maps for these keys during -the normal mode phase of the operation, but will try to restore them -afterwards. If you don't want your mappings touched at all, set this to the -empty list, and the plugin will leave them alone. +The plugin will complain on starting a paste operation if either of the keys +are already mapped, globally or locally, so pick keys you never remap, or set +this option to a blank |List| `[]` to disable it. CAVEATS *paste_insert-caveats* @@ -51,12 +51,6 @@ with CTRL-C, the |InsertLeave| event doesn't fire, and you'll still be in window should fix it. Friends don't let friends use CTRL-C to break insert mode! -The map restoration for your chosen cancel keys works well in Vim v7.3.032 or -newer, but before that patch, recursive maps and flags like <expr> or <silent> -won't be restored correctly, although <buffer> should still work. If it's -mangling your mappings and you don't want to change keys, your only option is -to upgrade Vim. - AUTHOR *paste_insert-author* Written and maintained by Tom Ryder <tom@sanctum.geek.nz>. |