170 lines
6.5 KiB
Plaintext
170 lines
6.5 KiB
Plaintext
*easymotion.txt* Version 1.0.10. Last change: 2011 Mar 30
|
|
|
|
|
|
______ __ ___ __ _
|
|
/ ____/____ ________ __/ |/ /____ / /_(_)____ ____
|
|
/ __/ / __ `/ ___/ / / / /|_/ // __ \/ __/ // __ \/ __ \
|
|
/ /___ / /_/ (__ ) /_/ / / / // /_/ / /_/ // /_/ / / / /
|
|
/_____/ \__,_/____/\__, /_/ /_/ \____/\__/_/ \____/_/ /_/
|
|
/____/
|
|
- Vim motions on speed!
|
|
|
|
|
|
==============================================================================
|
|
CONTENTS *easymotion-contents*
|
|
|
|
1. Introduction ....................... |easymotion-introduction|
|
|
2. Usage .............................. |easymotion-usage|
|
|
3. Requirements ....................... |easymotion-requirements|
|
|
4. Configuration ...................... |easymotion-configuration|
|
|
4.1 EasyMotion_keys ................ |EasyMotion_keys|
|
|
4.2 EasyMotion_target_hl ........... |EasyMotion_target_hl|
|
|
4.3 EasyMotion_shade_hl ............ |EasyMotion_shade_hl|
|
|
4.4 EasyMotion_do_shade ............ |EasyMotion_do_shade|
|
|
4.5 EasyMotion_do_mapping .......... |EasyMotion_do_mapping|
|
|
5. License ............................ |easymotion-license|
|
|
6. Known bugs ......................... |easymotion-known-bugs|
|
|
7. Contributing ....................... |easymotion-contributing|
|
|
8. Credits ............................ |easymotion-credits|
|
|
|
|
==============================================================================
|
|
1. 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.
|
|
|
|
==============================================================================
|
|
2. Usage *easymotion-usage*
|
|
|
|
EasyMotion is triggered manually or by one of the provided mappings (see
|
|
|EasyMotion_do_mapping| for details).
|
|
|
|
Example: >
|
|
|
|
<cursor>Lorem ipsum dolor sit amet.
|
|
|
|
If the word motion |w| is triggered with the default mapping <Leader>w, the
|
|
text is updated like this (no braces are actually added, the letters are
|
|
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.
|
|
|
|
And that's it!
|
|
|
|
==============================================================================
|
|
3. 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.
|
|
|
|
==============================================================================
|
|
4. Configuration *easymotion-configuration*
|
|
|
|
Set the configuration variables globally in your vimrc file.
|
|
|
|
Example: >
|
|
|
|
let g:EasyMotion_keys = '1234567890'
|
|
let g:EasyMotion_do_shade = 0
|
|
|
|
------------------------------------------------------------------------------
|
|
4.1 EasyMotion_keys *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 with many
|
|
keys available.
|
|
|
|
Default: 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
|
|
|
|
------------------------------------------------------------------------------
|
|
4.2 EasyMotion_target_hl *EasyMotion_target_hl*
|
|
|
|
Set the highlighting group for motion targets.
|
|
|
|
Default: 'EasyMotionTarget'
|
|
|
|
------------------------------------------------------------------------------
|
|
4.3 EasyMotion_shade_hl *EasyMotion_shade_hl*
|
|
|
|
Set the highlighting group for shaded text.
|
|
|
|
Default: 'EasyMotionShade'
|
|
|
|
------------------------------------------------------------------------------
|
|
4.4 EasyMotion_do_shade *EasyMotion_do_shade*
|
|
|
|
Set this to 0 if you want to disable text shading.
|
|
|
|
Default: 1
|
|
|
|
------------------------------------------------------------------------------
|
|
4.5 EasyMotion_do_mapping *EasyMotion_do_mapping*
|
|
|
|
Set this to 0 if you want to disable the default mappings. The default
|
|
configuration provides the following mappings in both normal and visual
|
|
mode:
|
|
|
|
Mapping Details
|
|
--------------------------
|
|
<Leader>f{char} See |f|
|
|
<Leader>F{char} See |F|
|
|
<Leader>t{char} See |t|
|
|
<Leader>T{char} See |T|
|
|
<Leader>w See |w|
|
|
<Leader>e See |e|
|
|
<Leader>b See |b|
|
|
<Leader>ge See |ge|
|
|
<Leader>j See |j|
|
|
<Leader>k See |k|
|
|
|
|
Default: 1
|
|
|
|
Note: If you disable this option, you'll have to map the motions yourself. See
|
|
the plugin source code for mapping details.
|
|
|
|
==============================================================================
|
|
5. License *easymotion-license*
|
|
|
|
Creative Commons Attribution-ShareAlike 3.0 Unported
|
|
|
|
http://creativecommons.org/licenses/by-sa/3.0/
|
|
|
|
==============================================================================
|
|
6. Known bugs *easymotion-known-bugs*
|
|
|
|
- Lines jump to the left when usin j/k motions when a line is prepended
|
|
by a hard tab due to the tab being replaced with the marker character.
|
|
|
|
==============================================================================
|
|
7. 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>
|
|
Source repository: https://github.com/Lokaltog/vim-easymotion
|
|
|
|
==============================================================================
|
|
8. Credits *easymotion-credits*
|
|
|
|
- Ben Boeckel: ge motion
|
|
|
|
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
|
|
|
|
==============================================================================
|
|
vim:tw=78:sw=4:ts=8:ft=help:norl:
|