934 lines
37 KiB
Plaintext
934 lines
37 KiB
Plaintext
*easymotion.txt* Version 2.0 Last change:31 Jan 2014.
|
|
|
|
|
|
______ __ ___ __ _
|
|
/ ____/____ ________ __/ |/ /____ / /_(_)____ ____
|
|
/ __/ / __ `/ ___/ / / / /|_/ // __ \/ __/ // __ \/ __ \
|
|
/ /___ / /_/ (__ ) /_/ / / / // /_/ / /_/ // /_/ / / / /
|
|
/_____/ \__,_/____/\__, /_/ /_/ \____/\__/_/ \____/_/ /_/
|
|
/____/
|
|
- Vim motions on speed!
|
|
|
|
|
|
==============================================================================
|
|
CONTENTS *easymotion-contents*
|
|
|
|
Introduction ....................... |easymotion-introduction|
|
|
Usage .............................. |easymotion-usage|
|
|
Default mappings ................ |easymotion-default-mappings|
|
|
More mappings ................... |easymotion-more-mappings|
|
|
Requirements ....................... |easymotion-requirements|
|
|
Configuration ...................... |easymotion-configuration|
|
|
EasyMotion_keys ................. |EasyMotion_keys|
|
|
EasyMotion_do_shade ............. |EasyMotion_do_shade|
|
|
EasyMotion_do_mapping ........... |EasyMotion_do_mapping|
|
|
EasyMotion_grouping ............. |EasyMotion_grouping|
|
|
EasyMotion_smartcase ............ |EasyMotion_smartcase|
|
|
EasyMotion_smartsign ............ |EasyMotion_smartsign|
|
|
EasyMotion_use_migemo ........... |EasyMotion_use_migemo|
|
|
EasyMotion_use_upper ........... |EasyMotion_use_upper|
|
|
EasyMotion_enter_jump_first ..... |EasyMotion_enter_jump_first|
|
|
EasyMotion_prompt ............... |EasyMotion_prompt|
|
|
EasyMotion_highlight ............ |EasyMotion_highlight|
|
|
EasyMotion_add_search_history.... |EasyMotion_add_search_history|
|
|
Custom highlighting ............. |easymotion-custom-hl|
|
|
Custom mappings ................. |easymotion-custom-mappings|
|
|
Leader key .................. |easymotion-leader-key|
|
|
Custom keys ................. |easymotion-custom-keys|
|
|
License ............................ |easymotion-license|
|
|
Known bugs ......................... |easymotion-known-bugs|
|
|
Contributing ....................... |easymotion-contributing|
|
|
Credits ............................ |easymotion-credits|
|
|
|
|
==============================================================================
|
|
Introduction *easymotion* *easymotion-introduction*
|
|
|
|
EasyMotion provides a much simpler way to use some motions in vim. It takes
|
|
the <number> out of <number>w or <number>f{char} by highlighting all possible
|
|
choices and allowing you to press one key to jump directly to the target.
|
|
|
|
When one of the available motions is triggered, all visible text preceding or
|
|
following the cursor is faded, and motion targets are highlighted.
|
|
|
|
==============================================================================
|
|
Usage *easymotion-usage*
|
|
|
|
EasyMotion is triggered by one of the provided mappings (see
|
|
|easymotion-default-mappings| for details).
|
|
|
|
Example: >
|
|
|
|
<cursor>Lorem ipsum dolor sit amet.
|
|
|
|
Type <Leader><Leader>w to trigger the word motion |w|. See
|
|
|easymotion-leader-key| for details about the leader key. When the
|
|
motion is triggered, the text is updated (no braces are actually added,
|
|
the text is highlighted in red by default): >
|
|
|
|
<cursor>Lorem {a}psum {b}olor {c}it {d}met.
|
|
|
|
Press "c" to jump to the beginning of the word "sit": >
|
|
|
|
Lorem ipsum dolor <cursor>sit amet.
|
|
|
|
Similarly, if you're looking for an "o", you can use the |f| motion.
|
|
Type <Leader><Leader>fo, and all "o" characters are highlighted: >
|
|
|
|
<cursor>L{a}rem ipsum d{b}l{c}r sit amet.
|
|
|
|
Press "b" to jump to the second "o": >
|
|
|
|
Lorem ipsum d<cursor>olor sit amet.
|
|
|
|
And that's it!
|
|
|
|
------------------------------------------------------------------------------
|
|
Default mappings *easymotion-default-mappings*
|
|
|
|
The default configuration defines the following mappings in normal,
|
|
visual and operator-pending mode if |g:EasyMotion_do_mapping| is on:
|
|
|
|
Note: The default leader has been changed to <Leader><Leader> to avoid
|
|
conflicts with other plugins you may have installed
|
|
|
|
Default Mapping | Details
|
|
---------------------|----------------------------------------------
|
|
<Leader>f{char} | Find {char} to the right. See |f|.
|
|
<Leader>F{char} | Find {char} to the left. See |F|.
|
|
<Leader>t{char} | Till before the {char} to the right. See |t|.
|
|
<Leader>T{char} | Till after the {char} to the left. See |T|.
|
|
<Leader>w | Beginning of word forward. See |w|.
|
|
<Leader>W | Beginning of WORD forward. See |W|.
|
|
<Leader>b | Beginning of word backward. See |b|.
|
|
<Leader>B | Beginning of WORD backward. See |B|.
|
|
<Leader>e | End of word forward. See |e|.
|
|
<Leader>E | End of WORD forward. See |E|.
|
|
<Leader>ge | End of word backward. See |ge|.
|
|
<Leader>gE | End of WORD backward. See |gE|.
|
|
<Leader>j | Line downward. See |j|.
|
|
<Leader>k | Line upward. See |k|.
|
|
<Leader>n | Jump to latest "/" or "?" forward. See |n|.
|
|
<Leader>N | Jump to latest "/" or "?" backward. See |N|.
|
|
<Leader>s | Find(Search) {char} forward and backward.
|
|
| See |f| and |F|.
|
|
<Leader>S | Beginning of word forward and backward.
|
|
| See |w| and |b|.
|
|
|
|
See |easymotion-leader-key| and |mapleader| for details about the leader key.
|
|
See |easymotion-custom-mappings| for customizing the default mappings.
|
|
|
|
EasyMotion <Plug> table *easymotion-plug-table*
|
|
|
|
<Plug> Mapping Table | Default
|
|
---------------------|----------------------------------------------
|
|
<Plug>(easymotion-f) | <Leader>f{char}
|
|
<Plug>(easymotion-F) | <Leader>F{char}
|
|
<Plug>(easymotion-t) | <Leader>t{char}
|
|
<Plug>(easymotion-T) | <Leader>T{char}
|
|
<Plug>(easymotion-w) | <Leader>w
|
|
<Plug>(easymotion-W) | <Leader>W
|
|
<Plug>(easymotion-b) | <Leader>b
|
|
<Plug>(easymotion-B) | <Leader>B
|
|
<Plug>(easymotion-e) | <Leader>e
|
|
<Plug>(easymotion-E) | <Leader>E
|
|
<Plug>(easymotion-ge)| <Leader>ge
|
|
<Plug>(easymotion-gE)| <Leader>gE
|
|
<Plug>(easymotion-j) | <Leader>j
|
|
<Plug>(easymotion-k) | <Leader>k
|
|
<Plug>(easymotion-n) | <Leader>n
|
|
<Plug>(easymotion-N) | <Leader>N
|
|
<Plug>(easymotion-s) | <Leader>s
|
|
<Plug>(easymotion-S) | <Leader>S
|
|
|
|
More <Plug> Mapping Table | (No assignment by default)
|
|
----------------------------------|---------------------------------
|
|
(<Plug>(easymotion-bd-f)) | See |<Plug>(easymotion-s)|
|
|
<Plug>(easymotion-bd-t) | See |<Plug>(easymotion-bd-t)|
|
|
<Plug>(easymotion-bd-w) | See |<Plug>(easymotion-bd-w)|
|
|
<Plug>(easymotion-bd-W) | See |<Plug>(easymotion-bd-W)|
|
|
<Plug>(easymotion-bd-e) | See |<Plug>(easymotion-bd-e)|
|
|
<Plug>(easymotion-bd-E) | See |<Plug>(easymotion-bd-E)|
|
|
<Plug>(easymotion-bd-jk) | See |<Plug>(easymotion-bd-jk)|
|
|
<Plug>(easymotion-bd-n) | See |<Plug>(easymotion-bd-n)|
|
|
<Plug>(easymotion-jumptoanywhere) | See |<Plug>(easymotion-jumptoanywhere)|
|
|
<Plug>(easymotion-repeat) | See |<Plug>(easymotion-repeat)|
|
|
<Plug>(easymotion-next) | See |<Plug>(easymotion-next)|
|
|
<Plug>(easymotion-previous) | See |<Plug>(easymotion-previous)|
|
|
<Plug>(easymotion-sol-j) | See |<Plug>(easymotion-sol-j)|
|
|
<Plug>(easymotion-eol-j) | See |<Plug>(easymotion-eol-j)|
|
|
|
|
|
Within Line Motion | See |easymotion-within-line|
|
|
----------------------------------|---------------------------------
|
|
<Plug>(easymotion-sl) | See |<Plug>(easymotion-sl)|
|
|
<Plug>(easymotion-fl) | See |<Plug>(easymotion-fl)|
|
|
<Plug>(easymotion-Fl) | See |<Plug>(easymotion-Fl)|
|
|
<Plug>(easymotion-tl) | See |<Plug>(easymotion-tl)|
|
|
<Plug>(easymotion-Tl) | See |<Plug>(easymotion-Tl)|
|
|
<Plug>(easymotion-bd-tl) | See |<Plug>(easymotion-bd-tl)|
|
|
<Plug>(easymotion-wl) | See |<Plug>(easymotion-wl)|
|
|
<Plug>(easymotion-bl) | See |<Plug>(easymotion-bl)|
|
|
<Plug>(easymotion-bd-wl) | See |<Plug>(easymotion-bd-wl)|
|
|
<Plug>(easymotion-el) | See |<Plug>(easymotion-el)|
|
|
<Plug>(easymotion-gel) | See |<Plug>(easymotion-gel)|
|
|
<Plug>(easymotion-bd-el) | See |<Plug>(easymotion-bd-el)|
|
|
<Plug>(easymotion-lineforward) | See |<Plug>(easymotion-lineforward)|
|
|
<Plug>(easymotion-linebackward) | See |<Plug>(easymotion-linebackward)|
|
|
<Plug>(easymotion-lineanywhere) | See |<Plug>(easymotion-lineanywhere)|
|
|
|
|
|
Multi Input Find Motion | See |easymotion-multi-input|
|
|
----------------------------------|---------------------------------
|
|
<Plug>(easymotion-s2) | See |<Plug>(easymotion-s2)|
|
|
<Plug>(easymotion-f2) | See |<Plug>(easymotion-f2)|
|
|
<Plug>(easymotion-F2) | See |<Plug>(easymotion-F2)|
|
|
<Plug>(easymotion-t2) | See |<Plug>(easymotion-t2)|
|
|
<Plug>(easymotion-T2) | See |<Plug>(easymotion-T2)|
|
|
<Plug>(easymotion-bd-t2) | See |<Plug>(easymotion-bd-t2)|
|
|
|
|
|
<Plug>(easymotion-sl2) | See |<Plug>(easymotion-sl2)|
|
|
<Plug>(easymotion-fl2) | See |<Plug>(easymotion-fl2)|
|
|
<Plug>(easymotion-Fl2) | See |<Plug>(easymotion-Fl2)|
|
|
<Plug>(easymotion-tl2) | See |<Plug>(easymotion-tl2)|
|
|
<Plug>(easymotion-Tl2) | See |<Plug>(easymotion-Tl2)|
|
|
|
|
|
<Plug>(easymotion-sn) | See |<Plug>(easymotion-sn)|
|
|
<Plug>(easymotion-fn) | See |<Plug>(easymotion-fn)|
|
|
<Plug>(easymotion-Fn) | See |<Plug>(easymotion-Fn)|
|
|
<Plug>(easymotion-tn) | See |<Plug>(easymotion-tn)|
|
|
<Plug>(easymotion-Tn) | See |<Plug>(easymotion-Tn)|
|
|
<Plug>(easymotion-bd-tn) | See |<Plug>(easymotion-bd-tn)|
|
|
|
|
|
<Plug>(easymotion-sln) | See |<Plug>(easymotion-sln)|
|
|
<Plug>(easymotion-fln) | See |<Plug>(easymotion-fln)|
|
|
<Plug>(easymotion-Fln) | See |<Plug>(easymotion-Fln)|
|
|
<Plug>(easymotion-tln) | See |<Plug>(easymotion-tln)|
|
|
<Plug>(easymotion-Tln) | See |<Plug>(easymotion-Tln)|
|
|
|
|
|
|
------------------------------------------------------------------------------
|
|
More mappings *easymotion-more-mappings*
|
|
|
|
These mappings are not mapped by Default.
|
|
|
|
Bidirection ~
|
|
|
|
Note: bd is short for bidirectional
|
|
|
|
<Plug>(easymotion-s) *<Plug>(easymotion-s)*
|
|
*<Plug>(easymotion-bd-f)* (doesn't exist)
|
|
Find {char} to bidirection(forward and backward at the same
|
|
time.) See |f| & |F|.
|
|
|
|
<Plug>(easymotion-bd-t) *<Plug>(easymotion-bd-t)*
|
|
Till before & after the {char}. See |t| & |T|.
|
|
|
|
<Plug>(easymotion-bd-w) *<Plug>(easymotion-bd-w)*
|
|
Beginning of word forward and backward. See |w| & |b|.
|
|
|
|
<Plug>(easymotion-bd-W) *<Plug>(easymotion-bd-W)*
|
|
Beginning of WORD forward and backward. See |W| & |B|.
|
|
|
|
<Plug>(easymotion-bd-e) *<Plug>(easymotion-bd-e)*
|
|
End of word forward and backward. See |e| & |ge|.
|
|
|
|
<Plug>(easymotion-bd-E) *<Plug>(easymotion-bd-E)*
|
|
End of WORD forward and backward. See |e| & |ge|.
|
|
|
|
<Plug>(easymotion-bd-jk) *<Plug>(easymotion-bd-jk)*
|
|
Line downward and upward. See |j| & |k|.
|
|
|
|
<Plug>(easymotion-bd-n) *<Plug>(easymotion-bd-n)*
|
|
Jump to latest "/" or "?" forward. See |n| & |N|.
|
|
|
|
Jump To Anywhere ~
|
|
|
|
<Plug>(easymotion-jumptoanywhere) *<Plug>(easymotion-jumptoanywhere)*
|
|
JumpToAnywhere motion!
|
|
Default: Beginning and End of word, Camelcase, after '_',
|
|
and after '#'.
|
|
You can modify this motion behavior by vimrc
|
|
|
|
|g:EasyMotion_re_anywhere|: *g:EasyMotion_re_anywhere*
|
|
>
|
|
let g:EasyMotion_re_anywhere = '\v' .
|
|
\ '(<.|^$)' . '|' .
|
|
\ '(.>|^$)' . '|' .
|
|
\ '(\l)\zs(\u)' . '|' .
|
|
\ '(_\zs.)' . '|' .
|
|
\ '(#\zs.)'
|
|
<
|
|
Modified example:
|
|
>
|
|
let g:EasyMotion_re_anywhere = '\v' .
|
|
\ '(<.|^)' . '|' .
|
|
\ '(<.|.$)' . '|' .
|
|
\ '(\l)\zs(\u)' . '|' .
|
|
<
|
|
Repeat ~
|
|
|
|
<Plug>(easymotion-repeat) *<Plug>(easymotion-repeat)*
|
|
Repeat last motion!
|
|
|
|
Repeat last motion type including input target character.
|
|
Nothing will happen when previous motion doesn't exist.
|
|
|
|
Last Find Motion~
|
|
In Find motion (e.g. |<Plug>(easymotion-s)| ), to type `<CR>`
|
|
without input characters invoke last find motion. This
|
|
does not repeat motion type (e.g. Other word motion,
|
|
<Plug>(easymotion-j) etc...) but only repeat input
|
|
characters.
|
|
|
|
<Plug>(easymotion-next) *<Plug>(easymotion-next)*
|
|
<Plug>(easymotion-prev) *<Plug>(easymotion-prev)*
|
|
|
|
Jump to next/previous much. Only this motion can be move to off-screen
|
|
match. This motion wrap around the end of the file if you set
|
|
|'wrapscan'| in your vimrc. During this motion, matched text is
|
|
highlighted. If you don't want to highlight them, set
|
|
|g:EasyMotion_move_highlight| option to 0.
|
|
|
|
Example:
|
|
>
|
|
nmap <Leader>; <Plug>(easymotion-next)
|
|
nmap <Leader>, <Plug>(easymotion-prev)
|
|
<
|
|
|
|
EasyMotion dot repeat~
|
|
*easymotion-dotrepeat* *easymotion-textobjct*
|
|
|
|
This feature requires tpope/vim-repeat
|
|
https://github.com/tpope/vim-repeat
|
|
|
|
All motion type support '.' repeat.
|
|
|
|
Example:
|
|
>
|
|
" vimrc:
|
|
omap z <Plug>(easymotion-t)
|
|
let g:EasyMotion_keys='hklyuiopnm,qwertzxcvbasdgjf;'
|
|
<
|
|
Text sample:
|
|
>
|
|
{cursor}Lorem ipsum dolor sit ame*t*, consectetur adipisicing eli*t*,
|
|
sed do eiusmod tempor
|
|
<
|
|
type `dzt` and type first target marker(in this case, `h`)
|
|
>
|
|
{cursor}*t*, consectetur adipisicing eli*t,* sed do eiusmod tempor
|
|
<
|
|
just type '`.`'
|
|
>
|
|
*t,* sed do eiusmod tempor
|
|
<
|
|
|
|
JK Motion ~
|
|
*easymotion-jk-motion*
|
|
|
|
JK motion option *<Plug>(easymotion-j)* *<Plug>(easymotion-k)*
|
|
*g:EasyMotion_startofline*
|
|
|
|
When using the |j| or |k| motion, the cursor can be configured to stay in
|
|
the current column instead of start of line by setting this option to
|
|
0. If you want to use both keep cursor colum JK motion and start of
|
|
line JK motion, set g:EasyMotion_startofline to 0 to keep cursor
|
|
colum JK motion and map |<Plug>(easymotion-sol-j)| &
|
|
|<Plug>(easymotion-sol-k)| to use start of line JK motion.
|
|
>
|
|
let g:EasyMotion_startofline = 0 # keep cursor colum JK motion
|
|
map <Leader>J <Plug>(easymotion-sol-j)
|
|
map <Leader>K <Plug>(easymotion-sol-k)
|
|
<
|
|
Default: 1
|
|
|
|
Start of Line JK motion *<Plug>(easymotion-sol-j)* *<Plug>(easymotion-sol-k)*
|
|
*<Plug>(easymotion-sol-bd-jk)*
|
|
|
|
Match start of line JK motion
|
|
Example:
|
|
>
|
|
map <Leader>J <Plug>(easymotion-sol-j)
|
|
map <Leader>K <Plug>(easymotion-sol-k)
|
|
<
|
|
End of Line JK motion *<Plug>(easymotion-eol-j)* *<Plug>(easymotion-eol-k)*
|
|
*<Plug>(easymotion-eol-bd-jk)*
|
|
|
|
Match End of line JK motion
|
|
Example:
|
|
>
|
|
map <Leader>J <Plug>(easymotion-eol-j)
|
|
map <Leader>K <Plug>(easymotion-eol-K)
|
|
|
|
Within line motion ~
|
|
*easymotion-within-line*
|
|
|
|
<Plug>(easymotion-sl) *<Plug>(easymotion-sl)*
|
|
This function is same as |<Plug>(easymotion-s)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-fl) *<Plug>(easymotion-fl)*
|
|
This function is same as |<Plug>(easymotion-f)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-Fl) *<Plug>(easymotion-Fl)*
|
|
This function is same as |<Plug>(easymotion-F)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-tl) *<Plug>(easymotion-tl)*
|
|
This function is same as |<Plug>(easymotion-t)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-Tl) *<Plug>(easymotion-Tl)*
|
|
This function is same as |<Plug>(easymotion-T)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-bd-tl) *<Plug>(easymotion-bd-tl)*
|
|
This function is same as |<Plug>(easymotion-bd-t)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-wl) *<Plug>(easymotion-wl)*
|
|
This function is same as |<Plug>(easymotion-w)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-bl) *<Plug>(easymotion-bl)*
|
|
This function is same as |<Plug>(easymotion-b)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-bd-wl) *<Plug>(easymotion-bd-wl)*
|
|
This function is same as |<Plug>(easymotion-bd-w)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-el) *<Plug>(easymotion-el)*
|
|
This function is same as |<Plug>(easymotion-e)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-gel) *<Plug>(easymotion-gel)*
|
|
This function is same as |<Plug>(easymotion-ge)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-bd-el) *<Plug>(easymotion-bd-el)*
|
|
This function is same as |<Plug>(easymotion-bd-e)|, except range
|
|
is within current cursor line.
|
|
|
|
<Plug>(easymotion-lineforward) *<Plug>(easymotion-lineforward)*
|
|
This function is a little same as
|
|
|<Plug>(easymotion-jumptoanywhere)|, except range is within
|
|
current cursor line and direction is forward.
|
|
|
|
<Plug>(easymotion-linebackward) *<Plug>(easymotion-linebackward)*
|
|
This function is a little same as
|
|
|<Plug>(easymotion-jumptoanywhere)|, except range is within
|
|
current cursor line and direction is backward.
|
|
|
|
<Plug>(easymotion-lineanywhere) *<Plug>(easymotion-lineanywhere)*
|
|
This function is same as |<Plug>(easymotion-jumptoanywhere)|,
|
|
except range is within current cursor line.(bidirectional)
|
|
|
|
You can customize the behavior of this function by vimrc.
|
|
|
|
|g:EasyMotion_re_line_anywhere|: *g:EasyMotion_re_line_anywhere*
|
|
|
|
Default:
|
|
>
|
|
let g:EasyMotion_re_line_anywhere = '\v' .
|
|
\ '(<.|^$)' . '|' .
|
|
\ '(.>|^$)' . '|' .
|
|
\ '(\l)\zs(\u)' . '|' .
|
|
\ '(_\zs.)' . '|' .
|
|
\ '(#\zs.)'
|
|
<
|
|
Modified example:
|
|
>
|
|
let g:EasyMotion_re_line_anywhere = '\v' .
|
|
\ '(<.|^)' . '|' .
|
|
\ '(>.|.$)' . '|' .
|
|
\ '(\l)\zs(\u)' . '|' .
|
|
|
|
Multi Input Find Motion!~
|
|
*easymotion-multi-input*
|
|
*easymotion-two-key*
|
|
*easymotion-{find}n*
|
|
*<Plug>(easymotion-{find}n)*
|
|
*<Plug>(easymotion-{find}2)*
|
|
|
|
EasyMotion provide another find motion by multi input target.
|
|
|
|
Example:
|
|
>
|
|
nmap s <Plug>(easymotion-s2)
|
|
xmap s <Plug>(easymotion-s2)
|
|
omap z <Plug>(easymotion-s2)
|
|
nmap <Leader>s <Plug>(easymotion-sn)
|
|
xmap <Leader>s <Plug>(easymotion-sn)
|
|
omap <Leader>z <Plug>(easymotion-sn)
|
|
<
|
|
If you like typing two or above characters as target similar to vim-smalls or
|
|
vim-sneak, |EasyMotion| also provide this feature. With above keymapping,
|
|
|
|
Invoke EasyMotion by two character:
|
|
|
|
s{char}{char} (Type s{char}<CR> to use just one {char} is also allowed)
|
|
|
|
And you can use as much target char as you like:
|
|
|
|
<Leader>s{char}{char}{char}...<CR>
|
|
|
|
You can use <C-h> to delete while typing.
|
|
|
|
Note: 'n' key motion provide incremental highlighting feature. If you
|
|
don't want to highlight incrementally, set
|
|
|g:EasyMotion_inc_highlight| option to 0.
|
|
|
|
All Find motion (s,f,F,t,T,sl,fl,Fl,tl,Tl) support this feature!
|
|
(|l| means within line motion)
|
|
|
|
*<Plug>(easymotion-sn)* *<Plug>(easymotion-fn)* *<Plug>(easymotion-Fn)*
|
|
*<Plug>(easymotion-tn)* *<Plug>(easymotion-Tn)* *<Plug>(easymotion-bd-tn)*
|
|
*<Plug>(easymotion-sln)* *<Plug>(easymotion-fln)* *<Plug>(easymotion-Fln)*
|
|
*<Plug>(easymotion-tln)* *<Plug>(easymotion-Tln)* *<Plug>(easymotion-bd-tln)*
|
|
|
|
|
|
*<Plug>(easymotion-s2)* *<Plug>(easymotion-f2)* *<Plug>(easymotion-F2)*
|
|
*<Plug>(easymotion-t2)* *<Plug>(easymotion-T2)* *<Plug>(easymotion-bd-t2)*
|
|
*<Plug>(easymotion-sl2)* *<Plug>(easymotion-fl2)* *<Plug>(easymotion-Fl2)*
|
|
*<Plug>(easymotion-tl2)* *<Plug>(easymotion-Tl2)* *<Plug>(easymotion-bd-tl2)*
|
|
|
|
==============================================================================
|
|
Requirements *easymotion-requirements*
|
|
|
|
EasyMotion has been developed and tested in vim 7.3, but it should run without
|
|
any problems in vim 7.2.
|
|
|
|
Vi-compatible mode must be disabled.
|
|
|
|
Note: Now @haya14busa maintain EasyMotion in vim 7.4. If there is any
|
|
problems, open an issue or pull requests are welcome.
|
|
|
|
https://github.com/haya14busa/vim-easymotion/issues
|
|
|
|
==============================================================================
|
|
Configuration *easymotion-configuration*
|
|
|
|
EasyMotion will work fine without any configuration, but you can override the
|
|
default behavior by setting configuration variables globally in your |vimrc|
|
|
file.
|
|
|
|
Example (this will change the target keys and disable shading): >
|
|
|
|
let g:EasyMotion_keys = '1234567890'
|
|
let g:EasyMotion_do_shade = 0
|
|
|
|
------------------------------------------------------------------------------
|
|
EasyMotion_keys *EasyMotion_keys*
|
|
*g:EasyMotion_keys*
|
|
|
|
Set the keys which will be used for motion targets. Add as many keys as you
|
|
want. There's a lower chance that the motion targets will be grouped if many
|
|
keys are available.
|
|
|
|
Default: 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
|
|
|
|
------------------------------------------------------------------------------
|
|
EasyMotion_do_shade *EasyMotion_do_shade*
|
|
*g:EasyMotion_do_shade*
|
|
|
|
The default behavior is to shade the text following the cursor (forward
|
|
motions) or preceding the cursor (backward motions) to make the motion targets
|
|
more visible. Set this option to 0 if you want to disable text shading.
|
|
|
|
Default: 1
|
|
|
|
------------------------------------------------------------------------------
|
|
EasyMotion_do_mapping *EasyMotion_do_mapping*
|
|
*g:EasyMotion_do_mapping*
|
|
|
|
Set this option to 0 if you want to disable the default mappings. See
|
|
|easymotion-default-mappings| for details about the default mappings.
|
|
|
|
Note: If you disable this option, you'll have to map the motions yourself.
|
|
See |easymotion-custom-mappings| for customizing the default mappings.
|
|
|
|
Default: 1
|
|
|
|
------------------------------------------------------------------------------
|
|
EasyMotion_grouping *EasyMotion_grouping*
|
|
*g:EasyMotion_grouping*
|
|
|
|
When there are too many possible targets on the screen, the results have to be
|
|
grouped. This configuration option lets you change which grouping algorithm
|
|
you want to use. There are two grouping algorithms available:
|
|
|
|
* Single-key priority (value: 1)
|
|
-------------------
|
|
|
|
This algorithm prioritizes single-key jumps for the targets closest to
|
|
the cursor and only groups the last jump targets to maximize the amount
|
|
of single-key jumps.
|
|
|
|
This algorithm works recursively and will work with as few keys as two.
|
|
|
|
Example (with |EasyMotion_keys| = "abcdef"): >
|
|
|
|
x x x x x x x x x
|
|
<
|
|
The |w| motion is triggered: >
|
|
|
|
a b c d e f f f f
|
|
^ ^ ^ ^ ^ Direct jump to target
|
|
^ ^ ^ ^ Enter group "f"
|
|
<
|
|
* Original (value: 2)
|
|
--------
|
|
|
|
This is the original algorithm which always groups all targets if there
|
|
are too many possible motion targets.
|
|
|
|
Example (with |EasyMotion_keys| = "abcdef"): >
|
|
|
|
x x x x x x x x x
|
|
<
|
|
The |w| motion is triggered: >
|
|
|
|
a a a a a a b b b
|
|
^ ^ ^ ^ ^ ^ Enter group "a"
|
|
^ ^ ^ Enter group "b"
|
|
|
|
Default: 1
|
|
|
|
------------------------------------------------------------------------------
|
|
Smartcase *EasyMotion_smartcase*
|
|
*g:EasyMotion_smartcase*
|
|
|
|
Matching target keys by smartcase. You can type target keys more lazily.
|
|
|
|
Add following description in your vimrc: >
|
|
|
|
let g:EasyMotion_smartcase = 1
|
|
|
|
Default:0
|
|
|
|
------------------------------------------------------------------------------
|
|
Smartsign *EasyMotion_smartsign*
|
|
*g:EasyMotion_use_smartsign_us*
|
|
*g:EasyMotion_use_smartsign_ja*
|
|
|
|
Matching signs target keys by smartcase like. E.g. type '1' and it matches
|
|
both '1' and '!' in Find motion.
|
|
|
|
This feature is depend on keyboard layout, so you must choose which keyboard
|
|
layout you use.
|
|
|
|
How to discriminate:
|
|
Shift-2 = @ -> US layout
|
|
Shift-2 = " -> JP layout
|
|
|
|
>
|
|
let g:EasyMotion_use_smartsign_us = 1
|
|
<
|
|
or
|
|
>
|
|
let g:EasyMotion_use_smartsign_jp = 1
|
|
<
|
|
|
|
Default: 0
|
|
|
|
------------------------------------------------------------------------------
|
|
Migemo *EasyMotion_use_migemo*
|
|
*g:EasyMotion_use_migemo*
|
|
|
|
|Easymotion| can match multibyte Japanese character with a alphabet input.
|
|
For example, '<Leader><Leader>fa' can search 'あ'.
|
|
This feature doesn't require |cmigemo| because |Easymotion| includes regex
|
|
patterns generated by cmigemo.
|
|
|
|
Please see http://0xcc.net/migemo/ if you want to know more about migemo.
|
|
|
|
Add following description in your vimrc: >
|
|
|
|
let g:EasyMotion_use_migemo = 1
|
|
|
|
Default:0
|
|
|
|
This feature is based on rhysd(@Linda_pp)'s clever-f script,
|
|
which can be downloaded here:
|
|
|
|
https://github.com/rhysd/clever-f.vim
|
|
|
|
------------------------------------------------------------------------------
|
|
Show target key by upper letter *EasyMotion_use_upper*
|
|
*g:EasyMotion_use_upper*
|
|
|
|
|Easymotion| shows target labels by uppercase letter, but you can type it as
|
|
lowercase and Easymotion automatically convert it uppercase.
|
|
|
|
This feature improve targets readability.
|
|
|
|
Example: >
|
|
|
|
<cursor>Lorem ipsum dolor sit amet.
|
|
|
|
Type <Leader><Leader>w and the text is updated: >
|
|
|
|
<cursor>Lorem {A}psum {B}olor {C}it {D}met.
|
|
|
|
Press "c" (<- lowercase!) to jump to the beginning of the word "sit": >
|
|
|
|
Lorem ipsum dolor <cursor>sit amet.
|
|
|
|
Add following description in your vimrc: >
|
|
|
|
let g:EasyMotion_use_upper = 1
|
|
let g:EasyMotion_keys = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ;'
|
|
|
|
Default:0
|
|
|
|
Note: Make sure |g:EasyMotion_keys| doesn't include lowercase
|
|
|
|
This feature is inspired by t9md's vim-smalls, which can be downloaded here:
|
|
|
|
https://github.com/t9md/vim-smalls
|
|
|
|
------------------------------------------------------------------------------
|
|
Jump to first match by Enter *EasyMotion_enter_jump_first*
|
|
*g:EasyMotion_enter_jump_first*
|
|
|
|
Type Enter key and jump to first match (first letter of |g:EasyMotion_keys| ).
|
|
|
|
Set this option to 1 if you want to enable this feature.
|
|
|
|
Example:
|
|
>
|
|
let g:EasyMotion_enter_jump_first = 1
|
|
<
|
|
Default: 0
|
|
|
|
|
|
Customize command line prompt *EasyMotion_prompt*
|
|
*g:EasyMotion_prompt*
|
|
|
|
You can customize command line prompt message in find motion.
|
|
`{n}` is how many characters you type, and if {n} == 1 `(s)` will be
|
|
ignored.
|
|
|
|
Sample:
|
|
>
|
|
let g:EasyMotion_prompt = '{n}>>> '
|
|
<
|
|
Default:
|
|
>
|
|
let g:EasyMotion_prompt = 'Search for {n} character(s): '
|
|
<
|
|
This message will be:
|
|
|<Plug>(easymotion-s)| -> 'Search for 1 character: '
|
|
|<Plug>(easymotion-s2)| -> 'Search for 2 characters: '
|
|
|<Plug>(easymotion-sn)| -> 'Search for characters: '
|
|
|
|
Customize highlight behavior *EasyMotion_highlight*
|
|
*g:EasyMotion_inc_highlight*
|
|
|
|
While 'n' key find motion(e.g. |<Plug>(easymotion-sn)|), EasyMotion
|
|
incrementally highlight matched text. If you don't want to this feature,
|
|
set this option to 0
|
|
>
|
|
let g:EasyMotion_inc_highlight = 0
|
|
<
|
|
Default: 1
|
|
|
|
*g:EasyMotion_move_highlight*
|
|
|
|
While moving motion(|<Plug>(easymotion-next)|, |<Plug>(easymotion-prev)|),
|
|
EasyMotion highlight matched text until cursor move, entering insert
|
|
mode, or leaving buffer. If you don't want this feature, set this option
|
|
to 0.
|
|
>
|
|
let g:EasyMotion_move_highlight = 0
|
|
<
|
|
Default: 1
|
|
|
|
*g:EasyMotion_landing_highlight*
|
|
|
|
If you want to highlight matched text temporarily (unhighlight timing
|
|
is same with |g:EasyMotion_move_highlight|) after EasyMotion
|
|
jump(landing), set this option to 0.
|
|
>
|
|
let g:EasyMotion_landing_highlight = 1
|
|
<
|
|
Default: 0
|
|
|
|
EasyMotion_add_search_history *g:EasyMotion_add_search_history*
|
|
|
|
If you set this option to 1, 'n' key find motion add inputed pattern to
|
|
vim default search history.
|
|
>
|
|
let g:EasyMotion_add_search_history = 1
|
|
<
|
|
Default: 0
|
|
|
|
EasyMotion_off_screen_search *g:EasyMotion_off_screen_search*
|
|
|
|
If you set this option to 1, 'n' key find motion could search patterns
|
|
even in off-screen range.
|
|
>
|
|
let g:EasyMotion_off_screen_search = 1
|
|
<
|
|
Default: 0
|
|
|
|
------------------------------------------------------------------------------
|
|
Custom highlighting *easymotion-custom-hl*
|
|
|
|
The default EasyMotion configuration uses two highlighting groups that link
|
|
to groups with default values. The highlighting groups are:
|
|
|
|
* EasyMotionTarget
|
|
|
|
Highlights motion targets, the default value is bold red
|
|
|
|
* EasyMotionTarget2First
|
|
* EasyMotionTarget2Second
|
|
|
|
Highlights motion targets, when target is two keys
|
|
|
|
* EasyMotionShade
|
|
|
|
Highlights shaded text, the default value is dark gray
|
|
|
|
There are two ways to override the default colors:
|
|
|
|
1) Set the highlighting in your color scheme
|
|
|
|
This will only affect a single color scheme. The default red/gray colors
|
|
will be used if you change the color scheme to one that doesn't assign
|
|
any EasyMotion colors.
|
|
|
|
Example: >
|
|
|
|
hi EasyMotionTarget ctermbg=none ctermfg=green
|
|
hi EasyMotionShade ctermbg=none ctermfg=blue
|
|
|
|
hi EasyMotionTarget2First ctermbg=none ctermfg=red
|
|
hi EasyMotionTarget2Second ctermbg=none ctermfg=lightred
|
|
<
|
|
2) Set the highlighting in your vimrc
|
|
|
|
This is ideal if you want to link the colors to highlighting groups that
|
|
are available in almost every color scheme, e.g. |ErrorMsg| (usually
|
|
bright red) and Comment (usually faded). You can be sure that the
|
|
color scheme's colors will be used instead of the default red/gray
|
|
if you choose this option.
|
|
|
|
Example: >
|
|
|
|
hi link EasyMotionTarget ErrorMsg
|
|
hi link EasyMotionShade Comment
|
|
|
|
hi link EasyMotionTarget2First MatchParen
|
|
hi link EasyMotionTarget2Second MatchParen
|
|
<
|
|
|
|
------------------------------------------------------------------------------
|
|
Custom mappings *easymotion-custom-mappings*
|
|
|
|
EasyMotion allows you to customize all default mappings to avoid conflicts
|
|
with existing mappings. It is possible to change the default leader key
|
|
of all mappings to another key or sequence. It is also possible to fine
|
|
tune the plugin to your need by changing every single sequence.
|
|
|
|
Leader key *EasyMotion_leader_key* *easymotion-leader-key*
|
|
*<Plug>(easymotion-prefix)*
|
|
|
|
The default leader key can be changed with the |<Plug>(easymotion-prefix)|
|
|
|
|
Set this keymapping to the key sequence to use as the prefix of the mappings
|
|
described in |easymotion-default-mappings|.
|
|
|
|
Note: The default leader key has been changed to '<Leader><Leader>' to
|
|
avoid conflicts with other plugins. You can revert to the original
|
|
leader by setting this keymapping in your vimrc: >
|
|
|
|
map <Leader> <Plug>(easymotion-prefix)
|
|
<
|
|
Default: '<Leader><Leader>'
|
|
|
|
Custom Keys *easymotion-custom-keys*
|
|
|
|
All custom mappings follow the same format: >
|
|
|
|
<Plug>(easymotion-{motion})
|
|
<
|
|
Example: >
|
|
|
|
map s <Plug>(easymotion-s)
|
|
map _f <Plug>(easymotion-f)
|
|
map <C-T> <Plug>(easymotion-T)
|
|
<
|
|
See |easymotion-plug-table| for a table of motions that can be mapped
|
|
and their default values.
|
|
|
|
==============================================================================
|
|
License *easymotion-license*
|
|
|
|
Creative Commons Attribution-ShareAlike 3.0 Unported
|
|
|
|
http://creativecommons.org/licenses/by-sa/3.0/
|
|
|
|
==============================================================================
|
|
Known bugs *easymotion-known-bugs*
|
|
|
|
See: https://github.com/Lokaltog/vim-easymotion/issues
|
|
|
|
Pull Requests are welcome! :)
|
|
|
|
==============================================================================
|
|
Contributing *easymotion-contributing*
|
|
|
|
If you experience any bugs or have feature requests, please open an issue on
|
|
GitHub. Fork the source repository on GitHub and send a pull request if you
|
|
have any code improvements.
|
|
|
|
Author: Kim Silkebækken <kim.silkebaekken+vim@gmail.com>
|
|
haya14busa <hayabusa1419@gmail.com>
|
|
Source repository: https://github.com/Lokaltog/vim-easymotion
|
|
|
|
|
|
==============================================================================
|
|
Credits *easymotion-credits*
|
|
|
|
- Ben Boeckel: ge and WORD motions
|
|
- Drew Neil: operator-pending mappings
|
|
- Rob O'Dwyer: customizable mappings without giving up all defaults
|
|
- Michel D'Hooge: customizable leader
|
|
- Maxime Bourget: search motion, improved JK motion behavior
|
|
- Kearn Holliday: fix jumplist issues
|
|
- Shougo Matsushita: fix CSApprox issue
|
|
- supasorn: two key combos and bidirectional motion
|
|
- mtth: startofline(keep column)
|
|
- bootleq: fixed bufname bug
|
|
- mattn: fix multibyte handling
|
|
- yuex: fix visual mode selection bug (o command)
|
|
|
|
EasyMotion is based on Bartlomiej Podolak's great PreciseJump script, which
|
|
can be downloaded here:
|
|
|
|
http://www.vim.org/scripts/script.php?script_id=3437
|
|
|
|
Migemo feature:~
|
|
|
|
Easymotion pseudo migemo function is based on rhysd(@Linda_pp)'s clever-f
|
|
script, which can be downloaded here:
|
|
|
|
https://github.com/rhysd/clever-f.vim
|
|
|
|
Show uppercase letter and type it as lowercase:~
|
|
This feature is inspired by t9md's vim-smalls, which can be downloaded here:
|
|
|
|
https://github.com/t9md/vim-smalls
|
|
|
|
Find motion command line: ~
|
|
This feature is inspired by osyo-manga's vim-over script and actually
|
|
EasyMotion use vim-over's command line library. vim-over can be downloaded
|
|
here:
|
|
|
|
https://github.com/osyo-manga/vim-over
|
|
|
|
==============================================================================
|
|
vim:tw=78:sw=4:ts=8:ft=help:norl:
|