Merge pull request #1107 from tsuyoshicho/update/20220612/map

Update map.{txt,jax}

Author: h-east

doc/map.jax

@@ -1,4 +1,4 @@
-*map.txt*       For Vim バージョン 9.0.  Last change: 2022 May 09
+*map.txt*       For Vim バージョン 9.0.  Last change: 2022 Jun 18
 
 
 		  VIMリファレンスマニュアル	  by Bram Moolenaar
@@ -61,6 +61,7 @@
 			す。マップを入れ子にしたり再帰的にすることができます。
 			Note: 空白は有効なノーマルモードのコマンドであるため、
 			末尾の空白は {rhs} に含まれます。
+			|map-trailing-white| を参照。
 
 						*:nore* *:norem*
 :no[remap]  {lhs} {rhs}		|mapmode-nvo|	*:no*  *:noremap* *:nor*
@@ -99,10 +100,8 @@
 			削除します。他のモードのマップは残ります。
 			{lhs} がマッピングの {rhs} にマッチするときも機能しま
 			す。これは略語が適用された場合に使用します。
-			Note: 末尾の空白は {lhs} に含まれます。次の unmap コマ
-			ンドは機能しません: >
-				:map @@ foo
-				:unmap @@ | print
+			Note: 末尾の空白は {lhs} に含まれます。
+			|map-trailing-white| を参照。
 
 :mapc[lear]			|mapmode-nvo|		*:mapc*   *:mapclear*
 :nmapc[lear]			|mapmode-n|		*:nmapc*  *:nmapclear*
@@ -167,14 +166,36 @@
 れず、次の入力まで待機状態になります。例えば空白文字を入力すれば "foo" と空白
 文字が挿入されます。"a" を入力すれば "bar" が挿入されます。
 
+末尾空白 ~
+							*map-trailing-white*
+このunmapコマンドは動作しません: >
+	:map @@ foo
+	:unmap @@ | print
+
+なぜなら unmap "@@ " を試行するとき、コマンド区切りの "|" の前の空白を含んでい
+るためです。他の末尾空白の例として: >
+	unmap @@ 
+	unmap @@     # Vim9 script コメント
+	unmap @@     " 旧来のスクリプトのコメント
+
+`unmap @@ ` の末尾が空白文字のためエラーになりますが、これは見えないので特定す
+るのが非常に困難です。
+
+一般的な解決策はマップしたキーの後の右にコマンド区切りの "|" を置くことです。
+その後に空白とコメントを続けます: >
+
+	unmap @@|    # Vim9 script コメント
+	unmap @@|    " 旧来のスクリプトのコメント
+
 
 1.2 特別な引数						*:map-arguments*
 
 引数に "<buffer>"、"<nowait>"、"<silent>"、"<special>"、"<script>"、"<expr>"、
 "<unique>" を指定できます。マップコマンドの直後 (他の引数の前) に置いてくださ
 い。
 
-			*:map-local* *:map-<buffer>* *:map-buffer* *E224* *E225*
+				    *:map-local* *:map-<buffer>* *:map-buffer*
+				    *E224* *E225*
 カレントバッファだけで使用できるマップを作成するには、マップコマンドの引数に
 "<buffer>" を指定します。例: >
 	:map <buffer>  ,w  /[.,;]<CR>
@@ -365,8 +386,6 @@ Note:
   りません。
 - ビジュアルモードでは、`line('v')` と `col('v')` を使って、ビジュアルエリアの
   一端を取得でき、カーソルは反対の端にいます。
-- 選択モードでは、|:map| と |:vmap| コマンドでのマッピングがビジュアルモード内
-  で実行されます。|:smap| を使う選択モードとは別の方法で処理します。
 
 							*E1255* *E1136*
 <Cmd> と <ScriptCmd> コマンドではマッピング定義の {rhs} が <CR> で終わる必要が
@@ -698,6 +717,7 @@ Note: 変数 "mapleader" はマップを定義するときに使用されます
 							*<MouseMove>*
 特別な文字列 "<MouseMove>" を使ってマウスの移動を取り扱えます。そのためには
 'mousemoveevent' が有効になっている必要があります。現在、GUI でのみ動作します。
+|getmousepos()| 関数がマウスの位置を取得するのに使えます。
 
 							*<Char>* *<Char->*
 <Char> を使って、文字を10進数、8進数、16進数の数値指定でマップできます:

en/map.txt

@@ -1,4 +1,4 @@
-*map.txt*       For Vim version 9.0.  Last change: 2022 May 09
+*map.txt*       For Vim version 9.0.  Last change: 2022 Jun 18
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -63,6 +63,7 @@ modes.
 			allows for nested and recursive use of mappings.
 			Note: Trailing spaces are included in the {rhs},
 			because space is a valid Normal mode command.
+			See |map-trailing-white|.
 
 						*:nore* *:norem*
 :no[remap]  {lhs} {rhs}		|mapmode-nvo|	*:no*  *:noremap* *:nor*
@@ -100,10 +101,8 @@ modes.
 			for other modes where it applies.
 			It also works when {lhs} matches the {rhs} of a
 			mapping. This is for when an abbreviation applied.
-			Note: Trailing spaces are included in the {lhs}.  This
-			unmap does NOT work: >
-				:map @@ foo
-				:unmap @@ | print
+			Note: Trailing spaces are included in the {lhs}.
+			See |map-trailing-white|.
 
 :mapc[lear]			|mapmode-nvo|		*:mapc*   *:mapclear*
 :nmapc[lear]			|mapmode-n|		*:nmapc*  *:nmapclear*
@@ -168,14 +167,36 @@ that mapping won't get expanded yet, Vim is waiting for another character.
 If you type a space, then "foo" will get inserted, plus the space.  If you
 type "a", then "bar" will get inserted.
 
+Trailing white space ~
+							*map-trailing-white*
+This unmap command does NOT work: >
+	:map @@ foo
+	:unmap @@ | print
+
+Because it tries to unmap "@@ ", including the white space before the command
+separator "|".  Other examples with trailing white space: >
+	unmap @@ 
+	unmap @@     # Vim9 script comment
+	unmap @@     " legacy script comment
+
+An error will be issued, which is very hard to identify, because the ending
+whitespace character in `unmap @@ ` is not visible.
+
+A generic solution is to put the command separator "|" right after the mapped
+keys.  After that white space and a comment may follow: >
+
+	unmap @@|    # Vim9 script comment
+	unmap @@|    " legacy script comment
+
 
 1.2 SPECIAL ARGUMENTS					*:map-arguments*
 
 "<buffer>", "<nowait>", "<silent>", "<special>", "<script>", "<expr>" and
 "<unique>" can be used in any order.  They must appear right after the
 command, before any other arguments.
 
-			*:map-local* *:map-<buffer>* *:map-buffer* *E224* *E225*
+				    *:map-local* *:map-<buffer>* *:map-buffer*
+				    *E224* *E225*
 If the first argument to one of these commands is "<buffer>" the mapping will
 be effective in the current buffer only.  Example: >
 	:map <buffer>  ,w  /[.,;]<CR>
@@ -374,8 +395,6 @@ Note:
   mapping is recursive.
 - In Visual mode  you can use `line('v')` and `col('v')` to get one end of the
   Visual area, the cursor is at the other end.
-- In Select mode, |:map| and |:vmap| command mappings are executed in
-  Visual mode.  Use |:smap| to handle Select mode differently.
 
 							*E1255* *E1136*
 <Cmd> and <ScriptCmd> commands must terminate, that is, they must be followed
@@ -701,6 +720,7 @@ not to be matched with any key sequence.  This is useful in plugins
 							*<MouseMove>*
 The special key name "<MouseMove>" can be used to handle mouse movement.  It
 needs to be enabled with 'mousemoveevent'.  Currently only works in the GUI.
+The |getmousepos()| function can be used to obtain the mouse position.
 
 							*<Char>* *<Char->*
 To map a character by its decimal, octal or hexadecimal number the <Char>