Merge pull request #1460 from vim-jp/hh-update-map

Update map.{txt,jax}

Author: h-east

doc/map.jax

@@ -1,4 +1,4 @@
-*map.txt*       For Vim バージョン 9.1.  Last change: 2023 May 28
+*map.txt*       For Vim バージョン 9.1.  Last change: 2024 Jan 25
 
 
 		  VIMリファレンスマニュアル	  by Bram Moolenaar
@@ -20,9 +20,10 @@
    1.9 マップを使う				|map-typing|
    1.10 Altキーを使ったマップ			|:map-alt-keys|
    1.11 Metaキーを使ったマップ			|:map-meta-keys|
-   1.12 modifyOtherKeys モードのマップ		|modifyOtherKeys|
-   1.13 Kitty キーボードプロトコルを使ったマップ |kitty-keyboard-protocol|
-   1.14 オペレータの作成			|:map-operator|
+   1.12 superキーまたはcommandキーのマップ	|:map-super-keys|
+   1.13 modifyOtherKeys モードのマップ		|modifyOtherKeys|
+   1.14 Kitty キーボードプロトコルを使ったマップ |kitty-keyboard-protocol|
+   1.15 オペレータの作成			|:map-operator|
 2. 短縮入力			|abbreviations|
 3. ローカルマップとローカル関数	|script-local|
 4. ユーザー定義コマンド		|user-commands|
@@ -396,7 +397,8 @@ Note:
 
 							*E1255* *E1136*
 <Cmd> と <ScriptCmd> コマンドではマッピング定義の {rhs} が <CR> で終わる必要が
-あります。|Command-line| に入ることはありません。
+あります。|Command-line| に入ることはありません。{rhs} でリテラル <CR> を使用
+するには、|<lt>| を使用します。
 
 
 1.3 マップとモード					*:map-modes*
@@ -582,10 +584,12 @@ Note: ビジュアルモードのマップでは "'<" マークが使えます
 グを追加したりクリアすることはできません。 *E1309*
 
 							*:map-verbose*
-'verbose' がゼロ以外のときにマップ一覧を表示すると、どこで定義されたのかも表示
-されます。例: >
+'verbose' がゼロ以外の場合、検出および使用された 'keyprotocol' の値が最初の行
+に表示されます。また、キーマップには、最後に定義された場所も表示されます。
+例: >
 
 	:verbose map <C-W>*
+	Kitty keyboard protocol: Cleared
 	n  <C-W>*      * <C-W><C-S>*
 		Last set from /home/abcd/.vimrc
 
@@ -971,7 +975,17 @@ Meta 修飾子には文字 "T" が使われます。例えば挿入モードで
 	:imap <T-b> terrible
 
 
-1.12 modifyOtherKeys モードのマップ			*modifyOtherKeys*
+1.12 SuperキーまたはCommandキーのマップ		*:map-super-keys* *:map-cmd-key*
+
+Super 修飾子は、Linux 上の GVim および Mac OS 上の MacVim の GUI モード
+(|gui_running| が 1 の場合) で使用できます。Mac を使用している場合、これは
+Command キーを表し、GTK GUI を使用する Linux では、Super キーを表します。
+文字 "D" は、Super / Command 修飾子に使用されます。
+
+例えば、挿入モードで Command-b をマップするには: >
+	:imap <D-b> barritone
+
+1.13 modifyOtherKeys モードのマップ			*modifyOtherKeys*
 
 xterm と他のいくつかの端末は、修飾子付きのキーが特別なエスケープコードで送信さ
 れるモードにすることができます。Vim はこれらのコードを認識し、Backspace が文字
@@ -1035,7 +1049,7 @@ Note xterm の version 376 までは Shift-Esc が通常の Esc を送信し、S
 るのを防ぐため、挿入モードで modifyOtherKeys は無効化されます。
 
 
-1.13 Kitty キーボードプロトコルを使ったマップ	 *kitty-keyboard-protocol*
+1.14 Kitty キーボードプロトコルを使ったマップ	 *kitty-keyboard-protocol*
 
 'term' の値が "kitty" を含んでいる場合、Vim は Kitty キーボードプロトコルを有
 効化するエスケープシーケンスを送出します。これは 'keyprotocol' オプションで変
@@ -1061,7 +1075,7 @@ Vim はステータス要求 (これは |t_TI| termcap エントリの一部の
 			以前の状態は不明
 
 
-1.14 オペレータの作成					*:map-operator*
+1.15 オペレータの作成					*:map-operator*
 
 オペレータは {motion} コマンドと合わせて使われます。独自のオペレータを定義する
 には、最初に 'operatorfunc' を設定し、そして、|g@| オペレータを呼びます。ユー
@@ -1608,6 +1622,7 @@ script2.vimを実行すると "None" が表示されます。期待した結果
 	-complete=help		ヘルプの主題
 	-complete=highlight	ハイライトグループ
 	-complete=history	|:history| サブオプション
+	-complete=keymap	キーボードマッピング
 	-complete=locale	ロケール名 (locale -a の出力)
 	-complete=mapclear	バッファ引数
 	-complete=mapping	マップ

en/map.txt

@@ -1,4 +1,4 @@
-*map.txt*       For Vim version 9.1.  Last change: 2023 May 28
+*map.txt*       For Vim version 9.1.  Last change: 2024 Jan 25
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -21,9 +21,10 @@ manual.
    1.9 Using mappings				|map-typing|
    1.10 Mapping alt-keys			|:map-alt-keys|
    1.11 Mapping meta-keys			|:map-meta-keys|
-   1.12 Mapping in modifyOtherKeys mode		|modifyOtherKeys|
-   1.13 Mapping with Kitty keyboard protocol	|kitty-keyboard-protocol|
-   1.14 Mapping an operator			|:map-operator|
+   1.12 Mapping super-keys or command keys	|:map-super-keys|
+   1.13 Mapping in modifyOtherKeys mode		|modifyOtherKeys|
+   1.14 Mapping with Kitty keyboard protocol	|kitty-keyboard-protocol|
+   1.15 Mapping an operator			|:map-operator|
 2. Abbreviations		|abbreviations|
 3. Local mappings and functions	|script-local|
 4. User-defined commands	|user-commands|
@@ -406,7 +407,7 @@ Note:
 							*E1255* *E1136*
 <Cmd> and <ScriptCmd> commands must terminate, that is, they must be followed
 by <CR> in the {rhs} of the mapping definition.  |Command-line| mode is never
-entered.
+entered.  To use a literal <CR> in the {rhs}, use |<lt>|.
 
 
 1.3 MAPPING AND MODES					*:map-modes*
@@ -586,10 +587,12 @@ While mappings are being listed, it is not possible to add or clear mappings,
 e.g. from a timer callback. *E1309*
 
 							*:map-verbose*
-When 'verbose' is non-zero, listing a key map will also display where it was
+When 'verbose' is non-zero, the detected and used 'keyprotocol' value will be
+displayed in the first line. Also a key map will also display where it was
 last defined.  Example: >
 
 	:verbose map <C-W>*
+	Kitty keyboard protocol: Cleared
 	n  <C-W>*      * <C-W><C-S>*
 		Last set from /home/abcd/.vimrc
 
@@ -983,8 +986,17 @@ For the Meta modifier the "T" character is used.  For example, to map Meta-b
 in Insert mode: >
 	:imap <T-b> terrible
 
+1.12 MAPPING SUPER-KEYS or COMMAND-KEYS		*:map-super-keys* *:map-cmd-key*
 
-1.12 MAPPING IN modifyOtherKeys mode			*modifyOtherKeys*
+The Super modifier is available in GUI mode (when |gui_running| is 1) for
+GVim on Linux and MacVim on Mac OS. If you're on a Mac, this represents the
+Command key, on Linux with the GTK GUI it represents the Super key.
+The character "D" is used for the Super / Command modifier.
+
+For example, to map Command-b in Insert mode: >
+	:imap <D-b> barritone
+
+1.13 MAPPING IN modifyOtherKeys mode			*modifyOtherKeys*
 
 Xterm and a few other terminals can be put in a mode where keys with modifiers
 are 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
 Insert mode to avoid every key with a modifier causing Insert mode to end.
 
 
-1.13 MAPPING WITH KITTY KEYBOARD PROTOCOL	 *kitty-keyboard-protocol*
+1.14 MAPPING WITH KITTY KEYBOARD PROTOCOL	 *kitty-keyboard-protocol*
 
 If the value of 'term' contains "kitty" then Vim will send out an escape
 sequence to enable the Kitty keyboard protocol.  This can be changed with the
@@ -1073,7 +1085,7 @@ translated).  The meaning of {value}:
 			previous state is unknown
 
 
-1.14 MAPPING AN OPERATOR				*:map-operator*
+1.15 MAPPING AN OPERATOR				*:map-operator*
 
 An operator is used before a {motion} command.  To define your own operator
 you must create a mapping that first sets the 'operatorfunc' option and then
@@ -1629,6 +1641,7 @@ completion can be enabled:
 	-complete=help		help subjects
 	-complete=highlight	highlight groups
 	-complete=history	:history suboptions
+	-complete=keymap	keyboard mappings
 	-complete=locale	locale names (as output of locale -a)
 	-complete=mapclear	buffer argument
 	-complete=mapping	mapping name