mirror of
https://github.com/fish-shell/fish-shell.git
synced 2026-04-28 16:01:15 -03:00
bbb2f0de8d
- The behavior of `{,d}{w,W}`, `{,d}{,g}{e,E}` bindings in vi-mode is
now more compatible with vim, except that the underscore is not a
keyword (which can be achieved by setting `set iskeyword-=_` in vim).
- Add commands `{forward,kill}-{word,bigword}-vi`,
`{forward,backward,kill,backward-kill}-{word,bigword}-end` and
`kill-{a,inner}-{word,bigword}` corresponding to above-mentioned
bindings.
- Closes #10393.
Closes #12269
Co-authored-by: Johannes Altmanninger <aclopte@gmail.com>
48 lines
1.8 KiB
ReStructuredText
48 lines
1.8 KiB
ReStructuredText
fish_vi_key_bindings - set vi key bindings for fish
|
|
===============================================================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
.. synopsis::
|
|
|
|
fish_vi_key_bindings
|
|
fish_vi_key_bindings [--no-erase] [INIT_MODE]
|
|
|
|
Description
|
|
-----------
|
|
|
|
``fish_vi_key_bindings`` sets the vi key bindings for ``fish`` shell.
|
|
|
|
If a valid *INIT_MODE* is provided (insert, default, visual), then that mode will become the default
|
|
. If no *INIT_MODE* is given, the mode defaults to insert mode.
|
|
|
|
The following parameters are available:
|
|
|
|
**--no-erase**
|
|
Does not clear previous set bindings
|
|
|
|
Further information on how to use :ref:`vi mode <vi-mode>`.
|
|
|
|
Differences from Vim
|
|
--------------------
|
|
|
|
Fish's vi mode aims to be familiar to vim users, but there are some differences:
|
|
|
|
**Word character handling**
|
|
In vim, underscore (``_``) is treated as a keyword character by default, so word motions like ``w``, ``b``, and ``e`` treat ``foo_bar`` as a single word. In fish, underscore is treated as punctuation, so word motions stop at underscores. For example, pressing ``w`` on ``foo_bar`` in fish stops at the ``_``, while in vim it would jump past the entire identifier.
|
|
|
|
**The** ``cw`` **command**
|
|
In vim, ``cw`` has special behavior: when the cursor is on a non-space character, it behaves like ``ce`` (change to end of word), but when the cursor is on a space, it behaves like ``dwi`` (delete word then insert).
|
|
|
|
In fish, ``cw`` always behaves like ``dwi`` - it deletes to the start of the next word (including trailing whitespace), then enters insert mode. To get vim's ``cw`` behavior in fish, use ``ce`` instead.
|
|
|
|
Examples
|
|
--------
|
|
|
|
To start using vi key bindings::
|
|
|
|
fish_vi_key_bindings
|
|
|
|
or ``set -g fish_key_bindings fish_vi_key_bindings`` in :ref:`config.fish <configuration>`.
|