1- *map.txt* For Vim version 9.1. Last change: 2023 May 28
1+ *map.txt* For Vim version 9.1. Last change: 2024 Jan 25
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -21,9 +21,10 @@ manual.
2121 1.9 Using mappings | map-typing |
2222 1.10 Mapping alt-keys | :map-alt-keys |
2323 1.11 Mapping meta-keys | :map-meta-keys |
24- 1.12 Mapping in modifyOtherKeys mode | modifyOtherKeys |
25- 1.13 Mapping with Kitty keyboard protocol | kitty-keyboard-protocol |
26- 1.14 Mapping an operator | :map-operator |
24+ 1.12 Mapping super-keys or command keys | :map-super-keys |
25+ 1.13 Mapping in modifyOtherKeys mode | modifyOtherKeys |
26+ 1.14 Mapping with Kitty keyboard protocol | kitty-keyboard-protocol |
27+ 1.15 Mapping an operator | :map-operator |
27282. Abbreviations | abbreviations |
28293. Local mappings and functions | script-local |
29304. User-defined commands | user-commands |
@@ -406,7 +407,7 @@ Note:
406407 *E1255* *E1136*
407408<Cmd> and <ScriptCmd> commands must terminate, that is, they must be followed
408409by <CR> in the {rhs} of the mapping definition. | Command-line | mode is never
409- entered.
410+ entered. To use a literal <CR> in the {rhs} , use | <lt> | .
410411
411412
4124131.3 MAPPING AND MODES *:map-modes*
@@ -586,10 +587,12 @@ While mappings are being listed, it is not possible to add or clear mappings,
586587e.g. from a timer callback. *E1309*
587588
588589 *:map-verbose*
589- When 'verbose' is non-zero, listing a key map will also display where it was
590+ When 'verbose' is non-zero, the detected and used 'keyprotocol' value will be
591+ displayed in the first line. Also a key map will also display where it was
590592last defined. Example: >
591593
592594 :verbose map <C-W>*
595+ Kitty keyboard protocol: Cleared
593596 n <C-W>* * <C-W><C-S>*
594597 Last set from /home/abcd/.vimrc
595598
@@ -983,8 +986,17 @@ For the Meta modifier the "T" character is used. For example, to map Meta-b
983986in Insert mode: >
984987 :imap <T-b> terrible
985988
989+ 1.12 MAPPING SUPER-KEYS or COMMAND-KEYS *:map-super-keys* *:map-cmd-key*
986990
987- 1.12 MAPPING IN modifyOtherKeys mode *modifyOtherKeys*
991+ The Super modifier is available in GUI mode (when | gui_running | is 1) for
992+ GVim on Linux and MacVim on Mac OS. If you're on a Mac, this represents the
993+ Command key, on Linux with the GTK GUI it represents the Super key.
994+ The character "D" is used for the Super / Command modifier.
995+
996+ For example, to map Command-b in Insert mode: >
997+ :imap <D-b> barritone
998+
999+ 1.13 MAPPING IN modifyOtherKeys mode *modifyOtherKeys*
9881000
9891001Xterm and a few other terminals can be put in a mode where keys with modifiers
9901002are sent with a special escape code. Vim recognizes these codes and can then
@@ -1046,7 +1058,7 @@ When the 'esckeys' option is off, then modifyOtherKeys will be disabled in
10461058Insert mode to avoid every key with a modifier causing Insert mode to end.
10471059
10481060
1049- 1.13 MAPPING WITH KITTY KEYBOARD PROTOCOL *kitty-keyboard-protocol*
1061+ 1.14 MAPPING WITH KITTY KEYBOARD PROTOCOL *kitty-keyboard-protocol*
10501062
10511063If the value of 'term' contains "kitty" then Vim will send out an escape
10521064sequence to enable the Kitty keyboard protocol. This can be changed with the
@@ -1073,7 +1085,7 @@ translated). The meaning of {value}:
10731085 previous state is unknown
10741086
10751087
1076- 1.14 MAPPING AN OPERATOR *:map-operator*
1088+ 1.15 MAPPING AN OPERATOR *:map-operator*
10771089
10781090An operator is used before a {motion} command. To define your own operator
10791091you must create a mapping that first sets the 'operatorfunc' option and then
@@ -1629,6 +1641,7 @@ completion can be enabled:
16291641 -complete=help help subjects
16301642 -complete=highlight highlight groups
16311643 -complete=history :history suboptions
1644+ -complete=keymap keyboard mappings
16321645 -complete=locale locale names (as output of locale -a)
16331646 -complete=mapclear buffer argument
16341647 -complete=mapping mapping name
0 commit comments