Merge pull request #250 from mnishz/map_for_Vim_8.1

Update map from Vim 8.0 to 8.1

Author: h-east

doc/map.jax

@@ -1,4 +1,4 @@
-*map.txt*       For Vim バージョン 8.0.  Last change: 2017 Mar 10
+*map.txt*       For Vim バージョン 8.1.  Last change: 2018 May 13
 
 
 		  VIMリファレンスマニュアル	  by Bram Moolenaar
@@ -53,6 +53,7 @@
 :im[ap]	{lhs} {rhs}		|mapmode-i|		*:im* *:imap*
 :lm[ap]	{lhs} {rhs}		|mapmode-l|		*:lm* *:lmap*
 :cm[ap]	{lhs} {rhs}		|mapmode-c|		*:cm* *:cmap*
+:tma[p]	{lhs} {rhs}		|mapmode-t|		*:tma* *:tmap*
 			キー入力 {lhs} を {rhs} に割り当てます。作成したマップ
 			は、マップコマンドに対応したモードで使用できます。マッ
 			プが使用されたときに {rhs} が調べられ、再マップされま
@@ -69,6 +70,7 @@
 :ino[remap] {lhs} {rhs}		|mapmode-i|	*:ino* *:inoremap*
 :ln[oremap] {lhs} {rhs}		|mapmode-l|	*:ln*  *:lnoremap*
 :cno[remap] {lhs} {rhs}		|mapmode-c|	*:cno* *:cnoremap*
+:tno[remap] {lhs} {rhs}		|mapmode-t|	*:tno* *:tnoremap*
 			キー入力 {lhs} を {rhs} に割り当てます。作成したマッ
 			プ、はマップコマンドに対応したモードで使用できます。
 			{rhs} は再マップされないので、マップが入れ子になったり
@@ -87,6 +89,7 @@
 :iu[nmap] {lhs}			|mapmode-i|		*:iu*   *:iunmap*
 :lu[nmap] {lhs}			|mapmode-l|		*:lu*   *:lunmap*
 :cu[nmap] {lhs}			|mapmode-c|		*:cu*   *:cunmap*
+:tunma[p] {lhs}			|mapmode-t|		*:tunma* *:tunmap*
 			マップコマンドに対応したモードの {lhs} というマップを
 			削除します。他のモードのマップは残ります。
 			Note: 末尾の空白は {lhs} に含まれます。次の unmap コマ
@@ -104,6 +107,7 @@
 :imapc[lear]			|mapmode-i|		*:imapc*  *:imapclear*
 :lmapc[lear]			|mapmode-l|		*:lmapc*  *:lmapclear*
 :cmapc[lear]			|mapmode-c|		*:cmapc*  *:cmapclear*
+:tmapc[lear]			|mapmode-t|		*:tmapc*  *:tmapclear*
 			マップコマンドに対応したモードのすべてのマップを削除し
 			ます。{Vi にはありません}
 			バッファローカルなマップを削除するには <buffer> 引数を
@@ -120,6 +124,7 @@
 :im[ap]				|mapmode-i|
 :lm[ap]				|mapmode-l|
 :cm[ap]				|mapmode-c|
+:tma[p]				|mapmode-t|
 			マップコマンドに対応したモードのすべてのマップを一覧表
 			示します。Note: ":map" と ":map!" は複数のモードを表示
 			できるのでよく使われます。
@@ -134,6 +139,7 @@
 :im[ap] {lhs}			|mapmode-i|		*:imap_l*
 :lm[ap] {lhs}			|mapmode-l|		*:lmap_l*
 :cm[ap] {lhs}			|mapmode-c|		*:cmap_l*
+:tma[p] {lhs}			|mapmode-t|		*:tmap_l*
 			マップコマンドに対応したモードの {lhs} で始まるマップ
 			を一覧表示します。
 			{Vi にはありません}
@@ -313,6 +319,7 @@ Note: 特殊キーが機能するようにしたり、テキスト中の CSI バ
 :imap  :inoremap :iunmap    挿入
 :lmap  :lnoremap :lunmap    挿入、コマンドライン、Lang-Arg
 :cmap  :cnoremap :cunmap    コマンドライン
+:tmap  :tnoremap :tunmap    端末ジョブ
 
 {訳注: Lang-Argについては |language-mapping| を参照}
 
@@ -359,6 +366,10 @@ NOTE: 選択モードで印字可能文字にマップを定義するとユー
 Vim では ":nmap"、":vmap"、":omap"、":cmap"、":imap" を使い分けることで、それ
 ぞれのモード別にマップを設定することができます。
 
+							*mapmode-t*
+端末マップは、端末ウィンドウの中で動作しているジョブに対してキーが入力されたと
+きに機能します。|terminal-typing| を参照してください。
+
 							*omap-info*
 オペレータ待機マップを使うと、移動コマンドを定義できます。そして、オペレータと
 組み合わせて使うことができます。簡単な例: ":omap { w" を定義した場合、"y{"
@@ -417,6 +428,7 @@ CTRL-U (<C-U>) を使って (Vimによって挿入される) 範囲指定を削
 	i		挿入
 	l		挿入、コマンドライン、Lang-Argでの ":lmap" マップ
 	c		コマンドライン
+	t		端末ジョブ
 
 {訳注: Lang-Argについては |language-mapping| を参照}
 
@@ -890,7 +902,9 @@ non-id	  "non-id" タイプは非キーワード文字で終わります。他
 
 full-id   マッチした場所の前が非キーワード文字、行頭、挿入を開始した場所、であ
 	  ること。例外: 短縮入力が1文字の場合、その前の文字がスペース、タブ、
-	  以外の非キーワード文字なら短縮入力は展開されません。
+	  以外の非キーワード文字なら短縮入力は展開されません。ただし、コマンド
+	  ラインにおける "'<,'>" (もしくはその他のマーク) は無視され、コマンド
+	  ラインがその後から始まっているように動作します。
 
 end-id	  マッチした場所の前が非キーワード文字、スペース、タブ、行頭、挿入を開
 	  始した場所、であること。
@@ -1243,6 +1257,7 @@ script2.vimを実行すると "None" が表示されます。期待した結果
 属性を指定しない場合、ユーザー定義コマンドの入力時に引数は補完されません。下記
 の属性のうちいずれか1つを指定することで、引数が補完されるようになります。
 
+	-complete=arglist	引数リスト内のファイル名
 	-complete=augroup	オートコマンドのグループ
 	-complete=buffer	バッファ
 	-complete=behave	|:behave| サブオプション
@@ -1262,6 +1277,7 @@ script2.vimを実行すると "None" が表示されます。期待した結果
 	-complete=highlight	強調グループ
 	-complete=history	|:history| サブオプション
 	-complete=locale	ロケール名 (locale -a の出力)
+	-complete=mapclear	バッファ引数
 	-complete=mapping	マップ
 	-complete=menu		メニュー
 	-complete=messages	|:messages| サブオプション
@@ -1393,6 +1409,8 @@ Note これらの引数は省略できますが、これは廃止される機能
 	<line1>	コマンド範囲の最初の行
 						*<line2>*
 	<line2>	コマンド範囲の最後の行
+						*<range>*
+	<range>	コマンド範囲を指定するために使われた要素の数: 0, 1 もしくは 2
 						*<count>*
 	<count>	与えられたカウント('-range' と '-count' 属性で記述されている)
 						*<bang>*

en/map.txt

@@ -1,4 +1,4 @@
-*map.txt*       For Vim version 8.0.  Last change: 2017 Mar 10
+*map.txt*       For Vim version 8.1.  Last change: 2018 May 13
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -29,7 +29,7 @@ manual.
 1. Key mapping				*key-mapping* *mapping* *macro*
 
 Key mapping is used to change the meaning of typed keys.  The most common use
-is to define a sequence commands for a function key.  Example: >
+is to define a sequence of commands for a function key.  Example: >
 
 	:map <F2> a<C-R>=strftime("%c")<CR><Esc>
 
@@ -55,6 +55,7 @@ modes.
 :im[ap]	{lhs} {rhs}		|mapmode-i|		*:im* *:imap*
 :lm[ap]	{lhs} {rhs}		|mapmode-l|		*:lm* *:lmap*
 :cm[ap]	{lhs} {rhs}		|mapmode-c|		*:cm* *:cmap*
+:tma[p]	{lhs} {rhs}		|mapmode-t|		*:tma* *:tmap*
 			Map the key sequence {lhs} to {rhs} for the modes
 			where the map command applies.  The result, including
 			{rhs}, is then further scanned for mappings.  This
@@ -71,6 +72,7 @@ modes.
 :ino[remap] {lhs} {rhs}		|mapmode-i|	*:ino* *:inoremap*
 :ln[oremap] {lhs} {rhs}		|mapmode-l|	*:ln*  *:lnoremap*
 :cno[remap] {lhs} {rhs}		|mapmode-c|	*:cno* *:cnoremap*
+:tno[remap] {lhs} {rhs}		|mapmode-t|	*:tno* *:tnoremap*
 			Map the key sequence {lhs} to {rhs} for the modes
 			where the map command applies.  Disallow mapping of
 			{rhs}, to avoid nested and recursive mappings.  Often
@@ -87,6 +89,7 @@ modes.
 :iu[nmap] {lhs}			|mapmode-i|		*:iu*   *:iunmap*
 :lu[nmap] {lhs}			|mapmode-l|		*:lu*   *:lunmap*
 :cu[nmap] {lhs}			|mapmode-c|		*:cu*   *:cunmap*
+:tunma[p] {lhs}			|mapmode-t|		*:tunma* *:tunmap*
 			Remove the mapping of {lhs} for the modes where the
 			map command applies.  The mapping may remain defined
 			for other modes where it applies.
@@ -105,6 +108,7 @@ modes.
 :imapc[lear]			|mapmode-i|		*:imapc*  *:imapclear*
 :lmapc[lear]			|mapmode-l|		*:lmapc*  *:lmapclear*
 :cmapc[lear]			|mapmode-c|		*:cmapc*  *:cmapclear*
+:tmapc[lear]			|mapmode-t|		*:tmapc*  *:tmapclear*
 			Remove ALL mappings for the modes where the map
 			command applies.  {not in Vi}
 			Use the <buffer> argument to remove buffer-local
@@ -121,6 +125,7 @@ modes.
 :im[ap]				|mapmode-i|
 :lm[ap]				|mapmode-l|
 :cm[ap]				|mapmode-c|
+:tma[p]				|mapmode-t|
 			List all key mappings for the modes where the map
 			command applies.  Note that ":map" and ":map!" are
 			used most often, because they include the other modes.
@@ -135,6 +140,7 @@ modes.
 :im[ap] {lhs}			|mapmode-i|		*:imap_l*
 :lm[ap] {lhs}			|mapmode-l|		*:lmap_l*
 :cm[ap] {lhs}			|mapmode-c|		*:cmap_l*
+:tma[p] {lhs}			|mapmode-t|		*:tmap_l*
 			List the key mappings for the key sequences starting
 			with {lhs} in the modes where the map command applies.
 			{not in Vi}
@@ -185,7 +191,7 @@ that starts with ",".  Then you need to type another character for Vim to know
 whether to use the "," mapping or the longer one.  To avoid this add the
 <nowait> argument.  Then the mapping will be used when it matches, Vim does
 not wait for more characters to be typed.  However, if the characters were
-already type they are used.
+already typed they are used.
 
 						*:map-<silent>* *:map-silent*
 To define a mapping which will not be echoed on the command line, add
@@ -318,6 +324,7 @@ Overview of which map command works in which mode.  More details below.
 :imap  :inoremap :iunmap    Insert
 :lmap  :lnoremap :lunmap    Insert, Command-line, Lang-Arg
 :cmap  :cnoremap :cunmap    Command-line
+:tmap  :tnoremap :tunmap    Terminal-Job
 
 
     COMMANDS				      MODES ~
@@ -358,6 +365,10 @@ Therefore the ":map" and ":map!" commands enter and display mappings for
 several modes.  In Vim you can use the ":nmap", ":vmap", ":omap", ":cmap" and
 ":imap" commands to enter mappings for each mode separately.
 
+							*mapmode-t*
+The terminal mappings are used in a terminal window, when typing keys for the
+job running in the terminal.  See |terminal-typing|.
+
 							*omap-info*
 Operator-pending mappings can be used to define a movement command that can be
 used with any operator.  Simple example: ":omap { w" makes "y{" work like "yw"
@@ -418,6 +429,7 @@ When listing mappings the characters in the first two columns are:
 	i	Insert
 	l	":lmap" mappings for Insert, Command-line and Lang-Arg
 	c	Command-line
+	t	Terminal-Job
 
 Just before the {rhs} a special character can appear:
 	*	indicates that it is not remappable
@@ -530,9 +542,9 @@ scenario: >
 	:imap <M-C> foo
 	:set encoding=utf-8
 The mapping for <M-C> is defined with the latin1 encoding, resulting in a 0xc3
-byte.  If you type the character á (0xe1 <M-a>) in UTF-8 encoding this is the
+byte.  If you type the character á (0xe1 <M-a>) in UTF-8 encoding this is the
 two bytes 0xc3 0xa1.  You don't want the 0xc3 byte to be mapped then or
-otherwise it would be impossible to type the á character.
+otherwise it would be impossible to type the á character.
 
 					*<Leader>* *mapleader*
 To define a mapping which uses the "mapleader" variable, the special string
@@ -682,7 +694,7 @@ option).  After that it assumes that the 'q' is to be interpreted as such.  If
 you type slowly, or your system is slow, reset the 'timeout' option.  Then you
 might want to set the 'ttimeout' option.
 
-                            				*map-precedence*
+			      				*map-precedence*
 Buffer-local mappings (defined using |:map-<buffer>|) take precedence over
 global mappings.  When a buffer-local mapping is the same as a global mapping,
 Vim will use the buffer-local mapping.  In addition, Vim will use a complete
@@ -798,7 +810,7 @@ Bear in mind that convert-meta has been reported to have troubles when used in
 UTF-8 locales.  On terminals like xterm, the "metaSendsEscape" resource can be
 toggled on the fly through the "Main Options" menu, by pressing Ctrl-LeftClick
 on the terminal; that's a good last resource in case you want to send ESC when
-using other applications but not when inside VIM.
+using other applications but not when inside Vim.
 
 
 1.11 MAPPING AN OPERATOR				*:map-operator*
@@ -905,7 +917,9 @@ an additional rule:
 full-id	  In front of the match is a non-keyword character, or this is where
 	  the line or insertion starts.  Exception: When the abbreviation is
 	  only one character, it is not recognized if there is a non-keyword
-	  character in front of it, other than a space or a tab.
+	  character in front of it, other than a space or a tab. However, for
+	  the command line "'<,'>" (or any other marks) is ignored, as if the
+	  command line starts after it.
 
 end-id	  In front of the match is a keyword character, or a space or a tab,
 	  or this is where the line or insertion starts.
@@ -1260,6 +1274,7 @@ By default, the arguments of user defined commands do not undergo completion.
 However, by specifying one or the other of the following attributes, argument
 completion can be enabled:
 
+	-complete=arglist	file names in argument list
 	-complete=augroup	autocmd groups
 	-complete=buffer	buffer names
 	-complete=behave	:behave suboptions
@@ -1279,6 +1294,7 @@ completion can be enabled:
 	-complete=highlight	highlight groups
 	-complete=history	:history suboptions
 	-complete=locale	locale names (as output of locale -a)
+	-complete=mapclear	buffer argument
 	-complete=mapping	mapping name
 	-complete=menu		menus
 	-complete=messages	|:messages| suboptions
@@ -1414,6 +1430,8 @@ The valid escape sequences are
 	<line1>	The starting line of the command range.
 						*<line2>*
 	<line2>	The final line of the command range.
+						*<range>*
+	<range> The number of items in the command range: 0, 1 or 2
 						*<count>*
 	<count>	Any count supplied (as described for the '-range'
 		and '-count' attributes).