vim/vim-easymotion
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Update README: Version 2.0

Browse Source
This commit is contained in:
haya14busa 2014-01-31 09:50:15 +09:00
parent e537df8cb0
commit e8590d5a58
2 changed files with 188 additions and 285 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
README.md
View File

@ -1,6 +1,8 @@
Vim motion on speed! [![Build Status](https://travis-ci.org/haya14busa/vim-easymotion.png?branch=master)](https://travis-ci.org/haya14busa/vim-easymotion) Vim motion on speed! [![Build Status](https://travis-ci.org/haya14busa/vim-easymotion.png?branch=master)](https://travis-ci.org/haya14busa/vim-easymotion)
===== =====
![Animated demonstration](https://f.cloud.github.com/assets/3797062/2039359/a8e938d6-899f-11e3-8789-60025ea83656.gif)
About authors About authors
===== =====
- Kim Silkebækken (https://github.com/Lokaltog) - Kim Silkebækken (https://github.com/Lokaltog)
@ -9,7 +11,7 @@ About authors
Now, EasyMotion project revived! Now, EasyMotion project revived!
====== ======
[haya14busa](https://github.com/haya14busa) took over the project from [haya14busa](https://github.com/haya14busa) took over the project from
version 2.0. Improve default motions, implemented new useful features, version 2.0. Improved default motions, implemented new useful features,
and fixed some bugs. and fixed some bugs.
Now, EasyMotion is completely Now, EasyMotion is completely
@ -37,7 +39,7 @@ EasyMotion is triggered by one of the provided mappings.
Important notes Important notes
===== =====
## About the default bindings ### About the default bindings
**The default leader has been changed to `<Leader><Leader>` to avoid **The default leader has been changed to `<Leader><Leader>` to avoid
conflicts with other plugins you may have installed.** This can easily be conflicts with other plugins you may have installed.** This can easily be
changed back to pre-1.3 behavior by rebinding the leader in your vimrc: changed back to pre-1.3 behavior by rebinding the leader in your vimrc:
@ -49,10 +51,11 @@ map <Leader> <Plug>(easymotion-prefix)
All motions are now triggered with `<Leader>` by default, e.g. All motions are now triggered with `<Leader>` by default, e.g.
`<Leader>s`, `<Leader>gE`. `<Leader>s`, `<Leader>gE`.
## About SelectLines & SelectPhrase for fork version user ### About SelectLines & SelectPhrase for fork version user
These feature are not **motion**, so these features are separated as different plugins. These features are not **motion**, so I separated them as different plugins.
TODO: url - https://github.com/haya14busa/vim-easyoperator-line
- https://github.com/haya14busa/vim-easyoperator-phrase
Usage example Usage example
===== =====
@ -78,12 +81,8 @@ Press `b` to jump to the second "o":
Jeffrey Way of Nettuts+ has also [written Jeffrey Way of Nettuts+ has also [written
a tutorial](http://net.tutsplus.com/tutorials/other/vim-essential-plugin-easymotion/) a tutorial](http://net.tutsplus.com/tutorials/other/vim-essential-plugin-easymotion/)
about EasyMotion(but under version 2.0). about EasyMotion.
Animated demonstration
-----
![Animated demonstration](https://f.cloud.github.com/assets/3797062/2039359/a8e938d6-899f-11e3-8789-60025ea83656.gif)
New feature from 2.0 New feature from 2.0
----- -----
@ -99,6 +98,10 @@ You can jump forward or backward at the same time by `<Leader>s`. One useful tri
EasyMotion provide 2-key find motion like vim-seek/vim-sneak. (e.g. `<Plug>(easymotion-s2)`) EasyMotion provide 2-key find motion like vim-seek/vim-sneak. (e.g. `<Plug>(easymotion-s2)`)
![2-key-find-motion](https://f.cloud.github.com/assets/3797062/2039612/7cafcec8-89a5-11e3-8f2c-5f26a6b83efd.gif) ![2-key-find-motion](https://f.cloud.github.com/assets/3797062/2039612/7cafcec8-89a5-11e3-8f2c-5f26a6b83efd.gif)
```vim
nmap s <Plug>(easymotion-s2)
nmap t <Plug>(easymotion-t2)
```
## 'n' key find motion ## 'n' key find motion
EasyMotion also provide 'n' key find motion like default 'search' motion of Vim. EasyMotion also provide 'n' key find motion like default 'search' motion of Vim.
@ -178,17 +181,23 @@ let g:EasyMotion_use_migemo = 1
Default:0 Default:0
## Repeat motion ## Repeat motion
`<Plug>(easymotion-repeat)` **Repeat last motion:** `<Plug>(easymotion-repeat)`
: Repeat last motion
**Repeat last find motion:**
In find motion(e.g. `<Plug>(easymotion-s)`), to type `<CR>` without
input characters invoke last find motion.
**Jump to next/previous match even off-screen:**
Repeat last find motion
: In find motion(e.g. `<Plug>(easymotion-s)` ), to type `<CR>` without input characters invoke last find motion.
`<Plug>(easymotion-next)` & `<Plug>(easymotion-prev)` `<Plug>(easymotion-next)` & `<Plug>(easymotion-prev)`
: Jump to next/previous much even off-screen.
Dot repeat support **Dot repeat support:**
: Require https://github.com/tpope/vim-repeat
: You can use EasyMotion in operator-pending and press `.` to repeat! It well-behaved, consistent with default behavior of Vim. Require https://github.com/tpope/vim-repeat
You can use EasyMotion in operator-pending and press `.` to repeat!
It is well-behaved, consistent with default behavior of Vim.
![repeat-motion](https://f.cloud.github.com/assets/3797062/2039538/0aef66aa-89a4-11e3-8242-c27a5208cfca.gif) ![repeat-motion](https://f.cloud.github.com/assets/3797062/2039538/0aef66aa-89a4-11e3-8242-c27a5208cfca.gif)
@ -207,5 +216,7 @@ let g:EasyMotion_smartcase = 1
let g:EasyMotion_use_smartsign_us = 1 let g:EasyMotion_use_smartsign_us = 1
``` ```
See `:help easymotion.txt` for more detail!
Pull requests are welcome including my English check! :) Pull requests are welcome including my English check! :)

426
doc/easymotion.txt
View File

@ -1,4 +1,4 @@
*easymotion.txt* Version 2.0 Last change:26 Jan 2014. *easymotion.txt* Version 2.0 Last change:31 Jan 2014.
______ __ ___ __ _ ______ __ ___ __ _
@ -13,39 +13,35 @@
============================================================================== ==============================================================================
CONTENTS *easymotion-contents* CONTENTS *easymotion-contents*
1. Introduction ....................... |easymotion-introduction| Introduction ....................... |easymotion-introduction|
2. Usage .............................. |easymotion-usage| Usage .............................. |easymotion-usage|
2.1 Default mappings ............... |easymotion-default-mappings| Default mappings ................ |easymotion-default-mappings|
2.2 More mappings .................. |easymotion-more-mappings| More mappings ................... |easymotion-more-mappings|
2.3 Special mappings ............... |easymotion-special-mappings| Requirements ....................... |easymotion-requirements|
3. Requirements ....................... |easymotion-requirements| Configuration ...................... |easymotion-configuration|
4. Configuration ...................... |easymotion-configuration| EasyMotion_keys ................. |EasyMotion_keys|
4.1 EasyMotion_keys ................ |EasyMotion_keys| EasyMotion_do_shade ............. |EasyMotion_do_shade|
4.2 EasyMotion_do_shade ............ |EasyMotion_do_shade| EasyMotion_do_mapping ........... |EasyMotion_do_mapping|
4.3 EasyMotion_do_mapping .......... |EasyMotion_do_mapping| EasyMotion_grouping ............. |EasyMotion_grouping|
4.4 EasyMotion_grouping ............ |EasyMotion_grouping| EasyMotion_smartcase ............ |EasyMotion_smartcase|
4.5 EasyMotion_smartcase ........... |EasyMotion_smartcase| EasyMotion_smartsign ............ |EasyMotion_smartsign|
4.6 EasyMotion_smartsign ........... |EasyMotion_smartsign| EasyMotion_use_migemo ........... |EasyMotion_use_migemo|
4.7 EasyMotion_use_migemo .......... |EasyMotion_use_migemo| EasyMotion_use_upper ........... |EasyMotion_use_upper|
4.8 EasyMotion_use_upper .......... |EasyMotion_use_upper| EasyMotion_enter_jump_first ..... |EasyMotion_enter_jump_first|
4.9 Custom highlighting ............ |easymotion-custom-hl| EasyMotion_prompt ............... |EasyMotion_prompt|
4.10 Custom mappings ............... |easymotion-custom-mappings| EasyMotion_highlight ............ |EasyMotion_highlight|
4.10.1 Leader key .............. |easymotion-leader-key| EasyMotion_add_search_history.... |EasyMotion_add_search_history|
4.10.2 Custom keys ............. |easymotion-custom-keys| Custom highlighting ............. |easymotion-custom-hl|
4.11 Easymotion special functions .. |easymotion-special-mappings| Custom mappings ................. |easymotion-custom-mappings|
4.11.1 Select Line ............. |easymotion-select-line| Leader key .................. |easymotion-leader-key|
4.11.2 Select Phrase ........... |easymotion-select-phrase| Custom keys ................. |easymotion-custom-keys|
4.12 EasyMotion_enter_jump_first ... |EasyMotion_enter_jump_first| License ............................ |easymotion-license|
4.13 EasyMotion_prompt ............. |EasyMotion_prompt| Known bugs ......................... |easymotion-known-bugs|
4.14 EasyMotion_highlight .......... |EasyMotion_highlight| Contributing ....................... |easymotion-contributing|
4.15 EasyMotion_add_search_history.. |EasyMotion_add_search_history| Credits ............................ |easymotion-credits|
5. License ............................ |easymotion-license|
6. Known bugs ......................... |easymotion-known-bugs|
7. Contributing ....................... |easymotion-contributing|
8. Credits ............................ |easymotion-credits|
============================================================================== ==============================================================================
1. Introduction *easymotion* *easymotion-introduction* Introduction *easymotion* *easymotion-introduction*
EasyMotion provides a much simpler way to use some motions in vim. It takes 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 the <number> out of <number>w or <number>f{char} by highlighting all possible
@ -55,7 +51,7 @@ When one of the available motions is triggered, all visible text preceding or
following the cursor is faded, and motion targets are highlighted. following the cursor is faded, and motion targets are highlighted.
============================================================================== ==============================================================================
2. Usage *easymotion-usage* Usage *easymotion-usage*
EasyMotion is triggered by one of the provided mappings (see EasyMotion is triggered by one of the provided mappings (see
|easymotion-default-mappings| for details). |easymotion-default-mappings| for details).
@ -87,7 +83,7 @@ Press "b" to jump to the second "o": >
And that's it! And that's it!
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
2.1 Default mappings *easymotion-default-mappings* Default mappings *easymotion-default-mappings*
The default configuration defines the following mappings in normal, The default configuration defines the following mappings in normal,
visual and operator-pending mode if |g:EasyMotion_do_mapping| is on: visual and operator-pending mode if |g:EasyMotion_do_mapping| is on:
@ -214,7 +210,7 @@ EasyMotion <Plug> table *easymotion-plug-table*
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
2.2 More mappings *easymotion-more-mappings* More mappings *easymotion-more-mappings*
These mappings are not mapped by Default. These mappings are not mapped by Default.
@ -501,37 +497,8 @@ All Find motion (s,f,F,t,T,sl,fl,Fl,tl,Tl) support this feature!
*<Plug>(easymotion-sl2)* *<Plug>(easymotion-fl2)* *<Plug>(easymotion-Fl2)* *<Plug>(easymotion-sl2)* *<Plug>(easymotion-fl2)* *<Plug>(easymotion-Fl2)*
*<Plug>(easymotion-tl2)* *<Plug>(easymotion-Tl2)* *<Plug>(easymotion-bd-tl2)* *<Plug>(easymotion-tl2)* *<Plug>(easymotion-Tl2)* *<Plug>(easymotion-bd-tl2)*
But |EasyMotion| is good at simple and fast motion with one or two character.
------------------------------------------------------------------------------
2.3 Special mappings *easymotion-special-mappings*
The default configuration defines the following mappings in visual and
operator-pending mode if |g:EasyMotion_do_special_mapping| is on:
>
let g:EasyMotion_do_special_mapping = 1
<
Default: 0
Special Mapping | Details
---------------------|----------------------------------------------
{operator}<Leader>l | Select, yank, paste, delete, or other operation of
| lines. See |<Plug>(easymotion-special-l)|.
{operator}<Leader>p | Select, yank, paste, delete, or other operation of
| phrase. See |<Plug>(easymotion-special-p)|.
or you can map them by yourself
<Plug> Mapping Table | Details
-----------------------------|--------------------------------------
<Plug>(easymotion-special-l) | See |<Plug>(easymotion-special-l)|
<Plug>(easymotion-special-p) | See |<Plug>(easymotion-special-p)|
See |easymotion-leader-key| and |mapleader| for details about the leader key.
============================================================================== ==============================================================================
3. Requirements *easymotion-requirements* Requirements *easymotion-requirements*
EasyMotion has been developed and tested in vim 7.3, but it should run without EasyMotion has been developed and tested in vim 7.3, but it should run without
any problems in vim 7.2. any problems in vim 7.2.
@ -544,7 +511,7 @@ problems, open an issue or pull requests are welcome.
https://github.com/haya14busa/vim-easymotion/issues https://github.com/haya14busa/vim-easymotion/issues
============================================================================== ==============================================================================
4. Configuration *easymotion-configuration* Configuration *easymotion-configuration*
EasyMotion will work fine without any configuration, but you can override the EasyMotion will work fine without any configuration, but you can override the
default behavior by setting configuration variables globally in your |vimrc| default behavior by setting configuration variables globally in your |vimrc|
@ -556,8 +523,8 @@ Example (this will change the target keys and disable shading): >
let g:EasyMotion_do_shade = 0 let g:EasyMotion_do_shade = 0
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.1 EasyMotion_keys *EasyMotion_keys* EasyMotion_keys *EasyMotion_keys*
*g:EasyMotion_keys* *g:EasyMotion_keys*
Set the keys which will be used for motion targets. Add as many keys as you 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 want. There's a lower chance that the motion targets will be grouped if many
@ -566,8 +533,8 @@ keys are available.
Default: 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ' Default: 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.2 EasyMotion_do_shade *EasyMotion_do_shade* EasyMotion_do_shade *EasyMotion_do_shade*
*g:EasyMotion_do_shade* *g:EasyMotion_do_shade*
The default behavior is to shade the text following the cursor (forward The default behavior is to shade the text following the cursor (forward
motions) or preceding the cursor (backward motions) to make the motion targets motions) or preceding the cursor (backward motions) to make the motion targets
@ -576,8 +543,8 @@ more visible. Set this option to 0 if you want to disable text shading.
Default: 1 Default: 1
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.3 EasyMotion_do_mapping *EasyMotion_do_mapping* EasyMotion_do_mapping *EasyMotion_do_mapping*
*g:EasyMotion_do_mapping* *g:EasyMotion_do_mapping*
Set this option to 0 if you want to disable the default mappings. See Set this option to 0 if you want to disable the default mappings. See
|easymotion-default-mappings| for details about the default mappings. |easymotion-default-mappings| for details about the default mappings.
@ -588,8 +555,8 @@ Note: If you disable this option, you'll have to map the motions yourself.
Default: 1 Default: 1
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.4 EasyMotion_grouping *EasyMotion_grouping* EasyMotion_grouping *EasyMotion_grouping*
*g:EasyMotion_grouping* *g:EasyMotion_grouping*
When there are too many possible targets on the screen, the results have to be 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 grouped. This configuration option lets you change which grouping algorithm
@ -633,8 +600,8 @@ you want to use. There are two grouping algorithms available:
Default: 1 Default: 1
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.5 Smartcase *EasyMotion_smartcase* Smartcase *EasyMotion_smartcase*
*g:EasyMotion_smartcase* *g:EasyMotion_smartcase*
Matching target keys by smartcase. You can type target keys more lazily. Matching target keys by smartcase. You can type target keys more lazily.
@ -645,9 +612,9 @@ Add following description in your vimrc: >
Default:0 Default:0
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.6 Smartsign *EasyMotion_smartsign* Smartsign *EasyMotion_smartsign*
*g:EasyMotion_use_smartsign_us* *g:EasyMotion_use_smartsign_us*
*g:EasyMotion_use_smartsign_ja* *g:EasyMotion_use_smartsign_ja*
Matching signs target keys by smartcase like. E.g. type '1' and it matches Matching signs target keys by smartcase like. E.g. type '1' and it matches
both '1' and '!' in Find motion. both '1' and '!' in Find motion.
@ -670,8 +637,8 @@ How to discriminate:
Default: 0 Default: 0
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.7 Migemo *EasyMotion_use_migemo* Migemo *EasyMotion_use_migemo*
*g:EasyMotion_use_migemo* *g:EasyMotion_use_migemo*
|Easymotion| can match multibyte Japanese character with a alphabet input. |Easymotion| can match multibyte Japanese character with a alphabet input.
For example, '<Leader><Leader>fa' can search 'あ'. For example, '<Leader><Leader>fa' can search 'あ'.
@ -692,8 +659,8 @@ which can be downloaded here:
https://github.com/rhysd/clever-f.vim https://github.com/rhysd/clever-f.vim
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.8 Show target key by upper letter *EasyMotion_use_upper* Show target key by upper letter *EasyMotion_use_upper*
*g:EasyMotion_use_upper* *g:EasyMotion_use_upper*
|Easymotion| shows target labels by uppercase letter, but you can type it as |Easymotion| shows target labels by uppercase letter, but you can type it as
lowercase and Easymotion automatically convert it uppercase. lowercase and Easymotion automatically convert it uppercase.
@ -726,7 +693,92 @@ This feature is inspired by t9md's vim-smalls, which can be downloaded here:
https://github.com/t9md/vim-smalls https://github.com/t9md/vim-smalls
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.9 Custom highlighting *easymotion-custom-hl* 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 The default EasyMotion configuration uses two highlighting groups that link
to groups with default values. The highlighting groups are: to groups with default values. The highlighting groups are:
@ -778,14 +830,14 @@ There are two ways to override the default colors:
< <
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
4.10 Custom mappings *easymotion-custom-mappings* Custom mappings *easymotion-custom-mappings*
EasyMotion allows you to customize all default mappings to avoid conflicts EasyMotion allows you to customize all default mappings to avoid conflicts
with existing mappings. It is possible to change the default leader key 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 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. tune the plugin to your need by changing every single sequence.
4.10.1 Leader key *EasyMotion_leader_key* *easymotion-leader-key* Leader key *EasyMotion_leader_key* *easymotion-leader-key*
*<Plug>(easymotion-prefix)* *<Plug>(easymotion-prefix)*
The default leader key can be changed with the |<Plug>(easymotion-prefix)| The default leader key can be changed with the |<Plug>(easymotion-prefix)|
@ -801,7 +853,7 @@ leader by setting this keymapping in your vimrc: >
< <
Default: '<Leader><Leader>' Default: '<Leader><Leader>'
4.10.2 Custom Keys *easymotion-custom-keys* Custom Keys *easymotion-custom-keys*
All custom mappings follow the same format: > All custom mappings follow the same format: >
@ -816,193 +868,34 @@ Example: >
See |easymotion-plug-table| for a table of motions that can be mapped See |easymotion-plug-table| for a table of motions that can be mapped
and their default values. and their default values.
------------------------------------------------------------------------------
4.11 Easymotion special functions *easymotion-special-function*
4.11.1 Select Line *easymotion-select-line*
*<Plug>(easymotion-special-l)*
SelectLine function which allows you to select any range of lines using two
consecutive easymotion calls.
Default mappings are `c<Leader>l, d<Leader>l, v<Leader>l, y<Leader>l`.
To yank a single line you can either type the same character(s) twice, or use
'.' character.
E.g. `v<Leader>lb.` will select the line with character 'b'.
Note: to promote good Vim habits, you should learn standard movement commands
like `}}, vi(, va(, %, ][, ]], [(, etc.` before resorting to this function.
Set this option to 1 if you want to automatically map this function
Example:
>
let g:EasyMotion_do_special_mapping = 1
Default: 0
or map it by yourself(Recommend)
>
omap <Leader>L <Plug>(easymotion-special-l)
xmap <Leader>L <Plug>(easymotion-special-l)
nmap d<Leader>L <Plug>(easymotion-special-ld)
nmap p<Leader>L <Plug>(easymotion-special-ly)
<
Note: special line function when d & y is a little bit different. So you
should map them individually, don't define omap only.
4.11.2 Select Phrase *easymotion-select-phrase*
*<Plug>(easymotion-special-p)*
(Experimental) SelectPhrase function which allows you to make selection
between any two characters.
Default mapping are `c<Leader>p, d<Leader>p, v<Leader>p, y<Leader>p`.
Example usage: type `v<Leader>p` then press two input characters.
Now the two input characters will be highlight on the same screen, and you can then type two combos to make selection.
Set this option to 1 if you want to automatically map this function
Example: >
let g:EasyMotion_do_special_mapping = 1
Default: 0
or map it by yourself(Recommend)
>
omap <Leader>P <Plug>(easymotion-special-p)
xmap <Leader>P <Plug>(easymotion-special-p)
nmap d<Leader>P <Plug>(easymotion-special-pd)
nmap y<Leader>P <Plug>(easymotion-special-py)
<
Note: special phrase function when d & y is a little bit different. So you
should map them individually, don't define omap only.
------------------------------------------------------------------------------
4.12 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
4.13 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: '
4.14 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
4.15 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
4.15 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
============================================================================== ==============================================================================
5. License *easymotion-license* License *easymotion-license*
Creative Commons Attribution-ShareAlike 3.0 Unported Creative Commons Attribution-ShareAlike 3.0 Unported
http://creativecommons.org/licenses/by-sa/3.0/ http://creativecommons.org/licenses/by-sa/3.0/
============================================================================== ==============================================================================
6. Known bugs *easymotion-known-bugs* Known bugs *easymotion-known-bugs*
See: https://github.com/haya14busa/vim-easymotion/issues See: https://github.com/Lokaltog/vim-easymotion/issues
and
https://github.com/Lokaltog/vim-easymotion/issues
(@haya14busa and others fix some bugs in this issues)
Pull Requests are welcome! :) Pull Requests are welcome! :)
============================================================================== ==============================================================================
7. Contributing *easymotion-contributing* Contributing *easymotion-contributing*
If you experience any bugs or have feature requests, please open an issue on 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 GitHub. Fork the source repository on GitHub and send a pull request if you
have any code improvements. have any code improvements.
Author: Kim Silkebækken <kim.silkebaekken+vim@gmail.com> Author: Kim Silkebækken <kim.silkebaekken+vim@gmail.com>
haya14busa <hayabusa1419@gmail.com>
Source repository: https://github.com/Lokaltog/vim-easymotion Source repository: https://github.com/Lokaltog/vim-easymotion
Forked and modified by haya14busa, currently maintain EasyMotion
Author: haya14busa <hayabusa1419@gmail.com>
Source repository: https://github.com/haya14busa/vim-easymotion
============================================================================== ==============================================================================
8. Credits *easymotion-credits* Credits *easymotion-credits*
- Ben Boeckel: ge and WORD motions - Ben Boeckel: ge and WORD motions
- Drew Neil: operator-pending mappings - Drew Neil: operator-pending mappings
@ -1011,29 +904,21 @@ Source repository: https://github.com/haya14busa/vim-easymotion
- Maxime Bourget: search motion, improved JK motion behavior - Maxime Bourget: search motion, improved JK motion behavior
- Kearn Holliday: fix jumplist issues - Kearn Holliday: fix jumplist issues
- Shougo Matsushita: fix CSApprox issue - 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 EasyMotion is based on Bartlomiej Podolak's great PreciseJump script, which
can be downloaded here: can be downloaded here:
http://www.vim.org/scripts/script.php?script_id=3437 http://www.vim.org/scripts/script.php?script_id=3437
------------------------------------------------------------------------------
Forked and modified by haya14busa~
Author: haya14busa <hayabusa1419@gmail.com>
Source repository: https://github.com/haya14busa/vim-easymotion
Ref:~
- supasorn : two key combos and special function
- mtth : startofline(keep column)
- bootleq : fixed bufname bug
- mattn : fix multibyte handling
- yuex : fix visual mode selection bug (o command)
Migemo feature:~ Migemo feature:~
Easymotion migemo function is based on rhysd(@Linda_pp)'s clever-f script, Easymotion pseudo migemo function is based on rhysd(@Linda_pp)'s clever-f
which can be downloaded here: script, which can be downloaded here:
https://github.com/rhysd/clever-f.vim https://github.com/rhysd/clever-f.vim
@ -1042,5 +927,12 @@ This feature is inspired by t9md's vim-smalls, which can be downloaded here:
https://github.com/t9md/vim-smalls 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: vim:tw=78:sw=4:ts=8:ft=help:norl: