Update README: Version 2.0
This commit is contained in:
parent
e537df8cb0
commit
e8590d5a58
47
README.md
47
README.md
@ -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)
|
||||
=====
|
||||
|
||||
![Animated demonstration](https://f.cloud.github.com/assets/3797062/2039359/a8e938d6-899f-11e3-8789-60025ea83656.gif)
|
||||
|
||||
About authors
|
||||
=====
|
||||
- Kim Silkebækken (https://github.com/Lokaltog)
|
||||
@ -9,7 +11,7 @@ About authors
|
||||
Now, EasyMotion project revived!
|
||||
======
|
||||
[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.
|
||||
|
||||
Now, EasyMotion is completely
|
||||
@ -37,7 +39,7 @@ EasyMotion is triggered by one of the provided mappings.
|
||||
Important notes
|
||||
=====
|
||||
|
||||
## About the default bindings
|
||||
### About the default bindings
|
||||
**The default leader has been changed to `<Leader><Leader>` to avoid
|
||||
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:
|
||||
@ -49,10 +51,11 @@ map <Leader> <Plug>(easymotion-prefix)
|
||||
All motions are now triggered with `<Leader>` by default, e.g.
|
||||
`<Leader>s`, `<Leader>gE`.
|
||||
|
||||
## About SelectLines & SelectPhrase for fork version user
|
||||
These feature are not **motion**, so these features are separated as different plugins.
|
||||
### About SelectLines & SelectPhrase for fork version user
|
||||
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
|
||||
=====
|
||||
@ -78,12 +81,8 @@ Press `b` to jump to the second "o":
|
||||
|
||||
Jeffrey Way of Nettuts+ has also [written
|
||||
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
|
||||
-----
|
||||
@ -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)`)
|
||||
|
||||
![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
|
||||
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
|
||||
|
||||
## Repeat motion
|
||||
`<Plug>(easymotion-repeat)`
|
||||
: Repeat last motion
|
||||
**Repeat last motion:** `<Plug>(easymotion-repeat)`
|
||||
|
||||
**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)`
|
||||
: Jump to next/previous much even off-screen.
|
||||
|
||||
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.
|
||||
**Dot repeat support:**
|
||||
|
||||
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)
|
||||
|
||||
@ -207,5 +216,7 @@ let g:EasyMotion_smartcase = 1
|
||||
let g:EasyMotion_use_smartsign_us = 1
|
||||
```
|
||||
|
||||
See `:help easymotion.txt` for more detail!
|
||||
|
||||
Pull requests are welcome including my English check! :)
|
||||
|
||||
|
@ -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*
|
||||
|
||||
1. Introduction ....................... |easymotion-introduction|
|
||||
2. Usage .............................. |easymotion-usage|
|
||||
2.1 Default mappings ............... |easymotion-default-mappings|
|
||||
2.2 More mappings .................. |easymotion-more-mappings|
|
||||
2.3 Special mappings ............... |easymotion-special-mappings|
|
||||
3. Requirements ....................... |easymotion-requirements|
|
||||
4. Configuration ...................... |easymotion-configuration|
|
||||
4.1 EasyMotion_keys ................ |EasyMotion_keys|
|
||||
4.2 EasyMotion_do_shade ............ |EasyMotion_do_shade|
|
||||
4.3 EasyMotion_do_mapping .......... |EasyMotion_do_mapping|
|
||||
4.4 EasyMotion_grouping ............ |EasyMotion_grouping|
|
||||
4.5 EasyMotion_smartcase ........... |EasyMotion_smartcase|
|
||||
4.6 EasyMotion_smartsign ........... |EasyMotion_smartsign|
|
||||
4.7 EasyMotion_use_migemo .......... |EasyMotion_use_migemo|
|
||||
4.8 EasyMotion_use_upper .......... |EasyMotion_use_upper|
|
||||
4.9 Custom highlighting ............ |easymotion-custom-hl|
|
||||
4.10 Custom mappings ............... |easymotion-custom-mappings|
|
||||
4.10.1 Leader key .............. |easymotion-leader-key|
|
||||
4.10.2 Custom keys ............. |easymotion-custom-keys|
|
||||
4.11 Easymotion special functions .. |easymotion-special-mappings|
|
||||
4.11.1 Select Line ............. |easymotion-select-line|
|
||||
4.11.2 Select Phrase ........... |easymotion-select-phrase|
|
||||
4.12 EasyMotion_enter_jump_first ... |EasyMotion_enter_jump_first|
|
||||
4.13 EasyMotion_prompt ............. |EasyMotion_prompt|
|
||||
4.14 EasyMotion_highlight .......... |EasyMotion_highlight|
|
||||
4.15 EasyMotion_add_search_history.. |EasyMotion_add_search_history|
|
||||
5. License ............................ |easymotion-license|
|
||||
6. Known bugs ......................... |easymotion-known-bugs|
|
||||
7. Contributing ....................... |easymotion-contributing|
|
||||
8. Credits ............................ |easymotion-credits|
|
||||
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|
|
||||
|
||||
==============================================================================
|
||||
1. Introduction *easymotion* *easymotion-introduction*
|
||||
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
|
||||
@ -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.
|
||||
|
||||
==============================================================================
|
||||
2. Usage *easymotion-usage*
|
||||
Usage *easymotion-usage*
|
||||
|
||||
EasyMotion is triggered by one of the provided mappings (see
|
||||
|easymotion-default-mappings| for details).
|
||||
@ -87,7 +83,7 @@ Press "b" to jump to the second "o": >
|
||||
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,
|
||||
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.
|
||||
|
||||
@ -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-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
|
||||
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
|
||||
|
||||
==============================================================================
|
||||
4. Configuration *easymotion-configuration*
|
||||
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|
|
||||
@ -556,8 +523,8 @@ Example (this will change the target keys and disable shading): >
|
||||
let g:EasyMotion_do_shade = 0
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
4.1 EasyMotion_keys *EasyMotion_keys*
|
||||
*g:EasyMotion_keys*
|
||||
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
|
||||
@ -566,8 +533,8 @@ keys are available.
|
||||
Default: 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
4.2 EasyMotion_do_shade *EasyMotion_do_shade*
|
||||
*g:EasyMotion_do_shade*
|
||||
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
|
||||
@ -576,8 +543,8 @@ more visible. Set this option to 0 if you want to disable text shading.
|
||||
Default: 1
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
4.3 EasyMotion_do_mapping *EasyMotion_do_mapping*
|
||||
*g:EasyMotion_do_mapping*
|
||||
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.
|
||||
@ -588,8 +555,8 @@ Note: If you disable this option, you'll have to map the motions yourself.
|
||||
Default: 1
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
4.4 EasyMotion_grouping *EasyMotion_grouping*
|
||||
*g:EasyMotion_grouping*
|
||||
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
|
||||
@ -633,8 +600,8 @@ you want to use. There are two grouping algorithms available:
|
||||
Default: 1
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
4.5 Smartcase *EasyMotion_smartcase*
|
||||
*g:EasyMotion_smartcase*
|
||||
Smartcase *EasyMotion_smartcase*
|
||||
*g:EasyMotion_smartcase*
|
||||
|
||||
Matching target keys by smartcase. You can type target keys more lazily.
|
||||
|
||||
@ -645,9 +612,9 @@ Add following description in your vimrc: >
|
||||
Default:0
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
4.6 Smartsign *EasyMotion_smartsign*
|
||||
*g:EasyMotion_use_smartsign_us*
|
||||
*g:EasyMotion_use_smartsign_ja*
|
||||
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.
|
||||
@ -670,8 +637,8 @@ How to discriminate:
|
||||
Default: 0
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
4.7 Migemo *EasyMotion_use_migemo*
|
||||
*g:EasyMotion_use_migemo*
|
||||
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 'あ'.
|
||||
@ -692,8 +659,8 @@ which can be downloaded here:
|
||||
https://github.com/rhysd/clever-f.vim
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
4.8 Show target key by upper letter *EasyMotion_use_upper*
|
||||
*g:EasyMotion_use_upper*
|
||||
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.
|
||||
@ -726,7 +693,92 @@ This feature is inspired by t9md's vim-smalls, which can be downloaded here:
|
||||
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
|
||||
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
|
||||
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.
|
||||
|
||||
4.10.1 Leader key *EasyMotion_leader_key* *easymotion-leader-key*
|
||||
Leader key *EasyMotion_leader_key* *easymotion-leader-key*
|
||||
*<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>'
|
||||
|
||||
4.10.2 Custom Keys *easymotion-custom-keys*
|
||||
Custom Keys *easymotion-custom-keys*
|
||||
|
||||
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
|
||||
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
|
||||
|
||||
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
|
||||
and
|
||||
https://github.com/Lokaltog/vim-easymotion/issues
|
||||
(@haya14busa and others fix some bugs in this issues)
|
||||
See: https://github.com/Lokaltog/vim-easymotion/issues
|
||||
|
||||
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
|
||||
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
|
||||
|
||||
|
||||
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
|
||||
- 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
|
||||
- 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
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
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:~
|
||||
|
||||
Easymotion migemo function is based on rhysd(@Linda_pp)'s clever-f script,
|
||||
which can be downloaded here:
|
||||
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
|
||||
|
||||
@ -1042,5 +927,12 @@ 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:
|
||||
|
Loading…
Reference in New Issue
Block a user