Merge pull request #246 from mnishz/insert_for_Vim_8.1

Update insert from Vim 8.0 to 8.1

Author: h-east

doc/insert.jax

@@ -1,4 +1,4 @@
-*insert.txt*    For Vim バージョン 8.0.  Last change: 2017 May 30
+*insert.txt*    For Vim バージョン 8.1.  Last change: 2018 Feb 10
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -425,10 +425,10 @@ CTRL-G U の使用例: >
 
    Lorem ipsum (dolor)
 
-CTRL-O は undo 位置を分割する。つまり、その前後に入力したテキストが別々にundo 
+CTRL-O は undo 位置を分割する。つまり、その前後に入力したテキストが別々にundo
 されるようになる。これを避けたい場合(マッピングの中などで)は CTRL-R =
 |i_CTRL-R| が使えるだろう。例: 関数を呼ぶ: >
-	:imap <F2> <C-R>=MyFunc()<CR> 
+	:imap <F2> <C-R>=MyFunc()<CR>
 
 'whichwrap' オプションが適切に設定されているならば、行の先頭/末尾での<Left>と
 <Right>キーは、カーソルを上の行や下の行へ移動させる。
@@ -1037,6 +1037,8 @@ CTRL-P			カーソルの直前と同じキーワードで始まる単語を、
 	dup		0 でないならば、すでに同じ候補があってもこの候補を追加
 			する。
 	empty		0 でないならば、空文字であってもこの候補を追加する。
+	user_data	この要素に関連付けられた |v:completed_item| で使用可能
+			なカスタムデータ
 
 これらのうち "icase"、"dup"、"empty" 以外は文字列でなければならない。これらの
 要件が満たされない場合はエラーメッセージが表示され、リスト中のそれ以降の要素は
@@ -1129,6 +1131,8 @@ CTRL-P			カーソルの直前と同じキーワードで始まる単語を、
 
 ポップアップメニューの高さの最大値はオプション 'pumheight' で設定できる。既
 定値は利用可能なスペースをすべて使うようになっている。
+ポップアップメニューの幅の最小値はオプション 'pumwidth' で設定できる。既定値は
+15 文字である。
 
 ポップアップメニューには 3 つの状態がある:
 1. 候補が挿入された状態。例えば CTRL-N や CTRL-P の後。
@@ -1161,7 +1165,7 @@ CTRL-L		 現在の候補から1文字を挿入する。候補の数は少なく
 印字可能で空白文字でない任意の文字:
 		 その文字を挿入する。候補の数は少なくなる。
 
-以上すべての状態で以下のキーが使える: 
+以上すべての状態で以下のキーが使える:
 CTRL-Y		  Yes: 現在選択されている候補に決定し、補完を終了する。
 CTRL-E		  補完を終了し、候補を選択する前の状態(タイプした状態または最
 		  長共通文字列)へ戻る。
@@ -1222,15 +1226,16 @@ ctags はこのサイトからダウンロードできる: http://ctags.sourcefo
 ること:
 	ftp://ftp.vim.org/pub/vim/unstable/patches/ctags-5.5.4.patch
 MS-Windows 用の exe ファイルは次のサイトからダウンロードできる:
-	http://georgevreilly.com/vim/ctags.html
+	http://ctags.sourceforge.net/
+	https://github.com/universal-ctags/ctags-win32
 
 システム関数を補完するには、次のような方法がある。ctags を使って全システムヘッ
 ダーファイルの tags ファイルを作る: >
 	% ctags -R -f ~/.vim/systags /usr/include /usr/local/include
 そして .vimrc で 'tags' オプションにこの tags ファイルを追加する: >
 	set tags+=~/.vim/systags
 
-カーソル前の単語が "." や "->" を含まないとき、CTRL-X CTRL-O を押すと tags 
+カーソル前の単語が "." や "->" を含まないとき、CTRL-X CTRL-O を押すと tags
 ファイルから直接補完される。これはすべての識別子、関数名に対して有効である。
 tags ファイルに含まれないローカル変数名を補完するには CTRL-P を使うしかない。
 
@@ -1366,7 +1371,7 @@ Note: 最初に補完を行うとき、必要なデータがすべてメモリ
 秒かかる場合があるが、次回からの補完は気になるほどではなくなるだろう。
 
 補完スクリプトは、カーソルが<?php ?>の中にあるかどうかを検出する。もしカーソル
-がこのタグの外側にあれば、自動的に HMTL/CSS/JavaScript 補完に切り替わる。Note: 
+がこのタグの外側にあれば、自動的に HMTL/CSS/JavaScript 補完に切り替わる。Note:
 元の HTML とは異なり、タグの補完が文脈依存ではなくなる。
 
 RUBY							*ft-ruby-omni*
@@ -1491,17 +1496,17 @@ syntaxcomplete プラグインは単語文字の区切りを使わなくなる:
 イテムのリストを得るために使うことができる。例えば SQL ファイルを開いていると
 きに (:e syntax.sql) ":syntax list" コマンドを実行してグループと構文アイテムを
 確認してみる。例: >
-    syntax list 
-
-次のような出力が表示される: >
-    sqlOperator    xxx some prior all like and any escape exists in is not 
-                       or intersect minus between distinct
-                       links to Operator
-    sqlType        xxx varbit varchar nvarchar bigint int uniqueidentifier 
-                       date money long tinyint unsigned xml text smalldate 
-                       double datetime nchar smallint numeric time bit char 
-                       varbinary binary smallmoney
-                       image float integer timestamp real decimal
+    syntax list
+
+次のような出力が表示される:
+    sqlOperator    xxx some prior all like and any escape exists in is not ~
+                       or intersect minus between distinct ~
+                       links to Operator ~
+    sqlType        xxx varbit varchar nvarchar bigint int uniqueidentifier ~
+                       date money long tinyint unsigned xml text smalldate ~
+                       double datetime nchar smallint numeric time bit char ~
+                       varbinary binary smallmoney ~
+                       image float integer timestamp real decimal ~
 
 二つの構文グループ sqlOperator と sqlType がある。構文アイテムのリストを得るた
 めに OmniSyntaxList をいくつかの方法で呼び出すことができる。構文グループを限定

en/insert.txt

@@ -1,4 +1,4 @@
-*insert.txt*    For Vim version 8.0.  Last change: 2017 May 30
+*insert.txt*    For Vim version 8.1.  Last change: 2018 Feb 10
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -433,7 +433,7 @@ An example for using CTRL-G U: >
 	inoremap ( ()<C-G>U<Left>
 
 This makes it possible to use the cursor keys in Insert mode, without breaking
-the undo sequence and therefore using |.| (redo) will work as expected. 
+the undo sequence and therefore using |.| (redo) will work as expected.
 Also entering a text like (with the "(" mapping from above): >
 
    Lorem ipsum (dolor
@@ -1103,6 +1103,8 @@ items:
 			item with the same word is already present.
 	empty		when non-zero this match will be added even when it is
 			an empty string
+	user_data 	custom data which is associated with the item and
+			available in |v:completed_item|
 
 All of these except "icase", "dup" and "empty" must be a string.  If an item
 does not meet these requirements then an error message is given and further
@@ -1196,6 +1198,8 @@ The menu is used when:
 
 The 'pumheight' option can be used to set a maximum height.  The default is to
 use all space available.
+The 'pumwidth' option can be used to set a minimum width.  The default is 15
+characters.
 
 There are three states:
 1. A complete match has been inserted, e.g., after using CTRL-N or CTRL-P.
@@ -1296,7 +1300,8 @@ it here: http://ctags.sourceforge.net/  Version 5.6 or later is recommended.
 For version 5.5.4 you should add a patch that adds the "typename:" field:
 	ftp://ftp.vim.org/pub/vim/unstable/patches/ctags-5.5.4.patch
 A compiled .exe for MS-Windows can be found at:
-	http://georgevreilly.com/vim/ctags.html
+	http://ctags.sourceforge.net/
+	https://github.com/universal-ctags/ctags-win32
 
 If you want to complete system functions you can do something like this.  Use
 ctags to generate a tags file for all the system header files: >
@@ -1472,7 +1477,7 @@ The completions provided by CTRL-X CTRL-O are sensitive to the context:
 
 Notes:
  - Vim will load/evaluate code in order to provide completions.  This may
-   cause some code execution, which may be a concern. This is no longer 
+   cause some code execution, which may be a concern. This is no longer
    enabled by default, to enable this feature add >
      let g:rubycomplete_buffer_loading = 1
 <- In context 1 above, Vim can parse the entire buffer to add a list of
@@ -1528,15 +1533,15 @@ that begin with the filetype, "php", in this case.  For example these syntax
 groups are included by default with the PHP: phpEnvVar, phpIntVar,
 phpFunctions.
 
-If you wish non-filetype syntax items to also be included, you can use a 
-regular expression syntax (added in version 13.0 of autoload\syntaxcomplete.vim)
-to add items.  Looking at the output from ":syntax list" while editing a PHP file 
-I can see some of these entries: >
+If you wish non-filetype syntax items to also be included, you can use a
+regular expression syntax (added in version 13.0 of
+autoload\syntaxcomplete.vim) to add items.  Looking at the output from
+":syntax list" while editing a PHP file I can see some of these entries: >
     htmlArg,htmlTag,htmlTagName,javaScriptStatement,javaScriptGlobalObjects
 
 To pick up any JavaScript and HTML keyword syntax groups while editing a PHP
-file, you can use 3 different regexs, one for each language.  Or you can 
-simply restrict the include groups to a particular value, without using 
+file, you can use 3 different regexs, one for each language.  Or you can
+simply restrict the include groups to a particular value, without using
 a regex string: >
     let g:omni_syntax_group_include_php = 'php\w\+,javaScript\w\+,html\w\+'
     let g:omni_syntax_group_include_php = 'phpFunctions,phpMethods'
@@ -1549,9 +1554,9 @@ highlight.  These items will be available within the omni completion list.
 
 Some people may find this list unwieldy or are only interested in certain
 items.  There are two ways to prune this list (if necessary).  If you find
-certain syntax groups you do not wish displayed you can use two different 
-methods to identify these groups.  The first specifically lists the syntax 
-groups by name.  The second uses a regular expression to identify both 
+certain syntax groups you do not wish displayed you can use two different
+methods to identify these groups.  The first specifically lists the syntax
+groups by name.  The second uses a regular expression to identify both
 syntax groups.  Simply add one the following to your vimrc: >
     let g:omni_syntax_group_exclude_php = 'phpCoreConstant,phpConstant'
     let g:omni_syntax_group_exclude_php = 'php\w*Constant'
@@ -1574,22 +1579,22 @@ vimrc: >
 
 For plugin developers, the plugin exposes a public function OmniSyntaxList.
 This function can be used to request a List of syntax items.  When editing a
-SQL file (:e syntax.sql) you can use the ":syntax list" command to see the 
+SQL file (:e syntax.sql) you can use the ":syntax list" command to see the
 various groups and syntax items.  For example: >
-    syntax list 
-
-Yields data similar to this: >
-    sqlOperator    xxx some prior all like and any escape exists in is not 
-                       or intersect minus between distinct
-                       links to Operator
-    sqlType        xxx varbit varchar nvarchar bigint int uniqueidentifier 
-                       date money long tinyint unsigned xml text smalldate 
-                       double datetime nchar smallint numeric time bit char 
-                       varbinary binary smallmoney
-                       image float integer timestamp real decimal
+    syntax list
+
+Yields data similar to this:
+    sqlOperator    xxx some prior all like and any escape exists in is not ~
+                       or intersect minus between distinct ~
+                       links to Operator ~
+    sqlType        xxx varbit varchar nvarchar bigint int uniqueidentifier ~
+                       date money long tinyint unsigned xml text smalldate ~
+                       double datetime nchar smallint numeric time bit char ~
+                       varbinary binary smallmoney ~
+                       image float integer timestamp real decimal ~
 
 There are two syntax groups listed here: sqlOperator and sqlType.  To retrieve
-a List of syntax items you can call OmniSyntaxList a number of different 
+a List of syntax items you can call OmniSyntaxList a number of different
 ways.  To retrieve all syntax items regardless of syntax group:  >
     echo OmniSyntaxList( [] )
 
@@ -1606,7 +1611,6 @@ From within a plugin, you would typically assign the output to a List: >
     let myKeywords = []
     let myKeywords = OmniSyntaxList( ['sqlKeyword'] )
 
-    
 
 SQL							*ft-sql-omni*