git.r.bdr.sh - rbdr/dotfiles/blob - vim/doc/unimpaired.txt

   1 *unimpaired.txt*  Pairs of handy bracket mappings
   2
   3 Author:  Tim Pope <http://tpo.pe/>
   4 License: Same terms as Vim itself (see |license|)
   5
   6 This plugin is only available if 'compatible' is not set.
   7
   8 INTRODUCTION                                    *unimpaired*
   9
  10 This plugin provides several pairs of bracket maps.
  11
  12 NEXT AND PREVIOUS                               *unimpaired-next*
  13
  14 The following maps all correspond to normal mode commands.  If a count is
  15 given, it becomes an argument to the command.  A mnemonic for the "a" commands
  16 is "args" and for the "q" commands is "quickfix".
  17
  18 *[a* |:previous|
  19 *]a* |:next|
  20 *[A* |:first|
  21 *]A* |:last|
  22 *[b* |:bprevious|
  23 *]b* |:bnext|
  24 *[B* |:bfirst|
  25 *]B* |:blast|
  26 *[l* |:lprevious|
  27 *]l* |:lnext|
  28 *[L* |:lfirst|
  29 *]L* |:llast|
  30 *[q* |:cprevious|
  31 *]q* |:cnext|
  32 *[Q* |:cfirst|
  33 *]Q* |:clast|
  34 *[t* |:tprevious|
  35 *]t* |:tnext|
  36 *[T* |:tfirst|
  37 *]T* |:tlast|
  38
  39                                                 *[o*
  40 [o                      Go to the file preceding the current one
  41                         alphabetically in the current file's directory.
  42
  43                                                 *]o*
  44 ]o                      Go to the file succeeding the current one
  45                         alphabetically in the current file's directory.
  46
  47 LINE OPERATIONS                                 *unimpaired-lines*
  48
  49                                                 *[<Space>*
  50 [<Space>                Add [count] blank lines above the cursor.
  51
  52                                                 *]<Space>*
  53 ]<Space>                Add [count] blank lines below the cursor.
  54
  55                                                 *[e* *v_[e*
  56 [e                      Exchange the current line with [count] lines above it.
  57
  58                                                 *]e* *v_]e*
  59 ]e                      Exchange the current line with [count] lines below it.
  60
  61 ENCODING AND DECODING                           *unimpaired-encoding*
  62
  63 Each of these operations has a map that takes a motion, a map that
  64 targets [count] lines, and a visual mode map.  The linewise variant integrates
  65 with repeat.vim.
  66
  67 Mnenomic: encoding always comes before decoding; "[" always comes before "]".
  68
  69                                                 *[x* *[xx* *v_[x*
  70 [x{motion}              XML encode.
  71 [xx                     <foo bar="baz"> => &lt;foo bar=&quot;baz&quot&gt;
  72 {Visual}[x
  73
  74                                                 *]x* *]xx* *v_]x*
  75 ]x{motion}              XML decode.  HTML entities are handled as well.
  76 ]xx
  77 {Visual}]x
  78
  79                                                 *[u* *[uu* *v_[u*
  80 [u{motion}              URL encode.
  81 [uu                     foo bar => foo%20bar
  82 {Visual}[u
  83
  84                                                 *]u* *]uu* *v_]u*
  85 ]u{motion}              URL decode.
  86 ]uu
  87 {Visual}]u
  88
  89                                                 *[y* *[yy* *v_[y*
  90 [y{motion}              C String encode.  Backslash escape control
  91 [yy                     characters, quotation marks, and backslashes.
  92 {Visual}[y
  93
  94                                                 *]y* *]yy* *v_]y*
  95 ]y{motion}              C String decode.
  96 ]yy
  97 {Visual}]y
  98
  99 TODO                                            *unimpaired-todo*
 100
 101 Avoid munging null characters when encoding and decoding.
 102
 103  vim:tw=78:et:ft=help:norl: