Merge pull request #1634 from vim-jp/hh-update-insert

Update insert.{txt,jax}

Author: h-east

doc/insert.jax

@@ -1,4 +1,4 @@
-*insert.txt*    For Vim バージョン 9.1.  Last change: 2024 Jan 04
+*insert.txt*    For Vim バージョン 9.1.  Last change: 2024 Jul 25
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -1119,6 +1119,11 @@ Note 最初の呼び出し以降にカーソルが移動した可能性があり
 	user_data	この要素に関連付けられた |v:completed_item| で使用可能
 			なカスタムデータ。任意の型が使用できる。既定は空文字
 			列。
+	hl_group	追加のハイライトグループを指定して、ポップアップメ
+			ニューの補完項目に追加の属性を適用できる。
+			|hl-PmenuSel| および|hl-Pmenu| のハイライト属性と組み
+			合わせて、取り消し線などの cterm および GUI プロパティ
+			を補完項目に適用する。
 
 これらのうち "icase", "equal", "dup" および "empty" 以外は文字列でなければなら
 ない。これらの要件が満たされない場合はエラーメッセージが表示され、リスト中のそ
@@ -1905,13 +1910,26 @@ O			カーソルのある行の上に新しい行を作り、そこにテキス
 待ちつづける。バックスラッシュで始まる行には警戒すべし。|line-continuation|参
 照。
 
-Ex モード (|-e| 参照) では行末にバックスラッシュを置くことで NUL 文字を挿入で
-きる。行末にバックスラッシュを挿入したいときはバックスラッシュを2重にすること。
-バックスラッシュが行末にある場合は実際に挿入される数は半分になる。
-
-NOTE: これらのコマンドは |:global| または |:vglobal| と組み合わせて使うことは
-できない。":append" と ":insert" は ":if" と ":endif"、":for" と ":endfor"、
-":while" と ":endwhile" の間では機能しない。
+"|" コマンド区切り文字の後に入力されたテキストが最初に使用される。したがって、
+ex モードの以下のコマンドは: >
+	:a|one
+	two
+	.
+	:visual
+カーソル行の後に以下のテキストを追加する: >
+	one
+	two
+<
+|Ex-mode| では、これらのコマンドが |:global| または |:vglobal| とともに使用さ
+れると、行はコマンドに続くテキストから取得される。行はバックスラッシュでエス
+ケープされた NL で区切る: >
+	:global/abc/insert\
+	one line\
+	another line
+その場合、最後の "." は必要ない。
+
+NOTE: ":append" と ":insert" は、":if" と ":endif"、":for" と ":endfor"、
+":while" と ":endwhile" の間では正しく動作しない。
 
 							*:start* *:startinsert*
 :star[tinsert][!]	このコマンドの実行直後に挿入モードを開始する。ノーマル

en/insert.txt

@@ -1,4 +1,4 @@
-*insert.txt*    For Vim version 9.1.  Last change: 2024 Jan 04
+*insert.txt*    For Vim version 9.1.  Last change: 2024 Jul 25
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -1183,6 +1183,12 @@ items:
 	user_data	custom data which is associated with the item and
 			available in |v:completed_item|; it can be any type;
 			defaults to an empty string
+	hl_group	allows specifying an additional highlight group to
+			apply extra attributes to completion items in the
+			popupmenu. Is combined with |hl-PmenuSel| and
+			|hl-Pmenu| highlighting attributes to apply cterm and
+			gui properties, such as strikethrough to the
+			completion items.
 
 All of these except "icase", "equal", "dup" and "empty" must be a string.  If
 an item does not meet these requirements then an error message is given and
@@ -1995,13 +2001,25 @@ These two commands will keep on asking for lines, until you type a line
 containing only a ".".  Watch out for lines starting with a backslash, see
 |line-continuation|.
 
-When in Ex mode (see |-e|) a backslash at the end of the line can be used to
-insert a NUL character.  To be able to have a line ending in a backslash use
-two backslashes.  This means that the number of backslashes is halved, but
-only at the end of the line.
-
-NOTE: These commands cannot be used with |:global| or |:vglobal|.
-":append" and ":insert" don't work properly in between ":if" and
+Text typed after a "|" command separator is used first. So the following
+command in ex mode: >
+	:a|one
+	two
+	.
+	:visual
+<appends the following text, after the cursor line: >
+	one
+	two
+<
+In |Ex-mode|, when these commands are used with |:global| or |:vglobal| then
+the lines are obtained from the text following the command.  Separate lines
+with a NL escaped with a backslash: >
+	:global/abc/insert\
+	one line\
+	another line
+The final "." is not needed then.
+
+NOTE: ":append" and ":insert" don't work properly in between ":if" and
 ":endif", ":for" and ":endfor", ":while" and ":endwhile".
 
 							*:start* *:startinsert*