Merge pull request #1442 from mityu/update-eval

Update eval.{txt,jax}

Author: h-east

doc/eval.jax

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim バージョン 9.1.  Last change: 2024 Jan 14
+*eval.txt*	For Vim バージョン 9.1.  Last change: 2024 Feb 08
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -296,10 +296,15 @@ Note 関数の辞書へのバインドは、その関数が辞書のメンバー
 							*list-concatenation*
 2つのリストを連結するには演算子 "+" を使う: >
 	:let longlist = mylist + [5, 6]
-	:let mylist += [7, 8]
+	:let longlist = [5, 6] + mylist
+1個の要素を先頭または末尾に付け加えるには、[]で囲んでリストにして連結する。
 
-1個の要素を先頭または末尾に付け加えるには、[]で囲んでリストにして連結する。リ
-ストの特定の要素を変更するには後述の|list-modification|を参照。
+リストは |:let+=| もしくは |extend()| を使うことで、他のリストとその場で連結す
+ることができる: >
+	:let mylist += [7, 8]
+	:call extend(mylist, [7, 8])
+<
+リストをその場で変更する他の方法については |list-modification| を参照。
 
 
 部分リスト ~
@@ -410,6 +415,19 @@ Note リストの比較について注意: 2つのリストは、同じ長さを
 とも削除する範囲の要素数と同じ数だけ必要である: >
 	:let list[3:5] = [3, 4, 5]
 
+リストに要素をその場で追加するには、|:let+=| (|list-concatenation|) を使うこと
+ができる: >
+	:let listA = [1, 2]
+	:let listA += [3, 4]
+<
+2 つのリストが同じリストを参照している時は、片方のリストをその場で変更すると、
+他方のリストもその場で変更される: >
+	:let listA = [1, 2]
+	:let listB = listA
+	:let listB += [3, 4]
+	:echo listA
+	[1, 2, 3, 4]
+<
 リストに要素を追加したり削除するには関数を使う。いくつか例を示す: >
 	:call insert(list, 'a')		" 先頭に要素 'a' を挿入する
 	:call insert(list, 'a', 3)	" 要素 'a' をlist[3]の前に挿入する
@@ -722,12 +740,15 @@ Blobの繰り返し ~
 
 
 Blobの連結 ~
-
+							*blob-concatenation*
 2つのBlobは "+" 演算子で連結できる: >
 	:let longblob = myblob + 0z4455
+	:let longblob = 0z4455 + myblob
+<
+Blob は |:let+=| を使うことで、他の Blob とその場で連結することができる: >
 	:let myblob += 0z6677
-
-Blobの決まった場所を変更するには、下記の |blob-modification| を参照。
+<
+Blob をその場で変更する他の方法については、|blob-modification| を参照。
 
 
 Blobの一部 ~
@@ -769,6 +790,19 @@ Blobの一部を変更するには、変更する最初と最後のバイトを
 イト数は同じでなければならない: >
 	:let blob[3:5] = 0z334455
 
+Blob に要素をその場で追加するには、|:let+=| (|blob-concatenation|)を使うことが
+できる: >
+	:let blobA = 0z1122
+	:let blobA += 0z3344
+<
+2 つの Blob が同じ Blob を参照している時は、片方の Blob をその場で変更すると、
+他方の Blob もその場で変更される: >
+	:let blobA = 0z1122
+	:let blobB = blobA
+	:let blobB += 0z3344
+	:echo blobA
+	0z11223344
+<
 関数 |add()|, |remove()| および |insert()| も使用できる。
 
 
@@ -1945,10 +1979,15 @@ v:collate	現在のロケール設定での実行環境の照合順序。これ
 								*v:colornames*
 v:colornames    カラー名を16進数カラー文字列に対応付ける辞書。これらのカラー名
 		は、|highlight-guifg|, |highlight-guibg|, |highlight-guisp| の
-		パラメーターで使用できる。v:colornames のエントリを更新しても、
-		構文ハイライトにすぐに作用することはない。更新されたカラー値を
-		使用するには、highlight コマンド(おそらくカラースキームスクリ
-		プト内)を再評価する必要がある。例: >
+		パラメーターで使用できる。
+
+		Vim は色を小文字の色名で探すので、辞書のキーの値 (色名) は小文
+		字であるべきである。
+
+		v:colornames のエントリを更新しても、構文ハイライトにすぐに作
+		用することはない。更新されたカラー値を使用するには、highlight
+		コマンド(おそらくカラースキームスクリプト内)を再評価する必要が
+		ある。例: >
 
 		    :let v:colornames['fuscia'] = '#cf3ab4'
 		    :let v:colornames['mauve'] = '#915f6d'
@@ -2729,6 +2768,8 @@ Note: |Vim9| script では、`:let` は使用されない。`:var` は変数宣
 :let {var} ..= {expr1}	":let {var} = {var} .. {expr1}" と同様。
 			{var}がセットされていないときや、{var}と{expr1}の型が
 			演算子に合わないときは失敗する。
+			`+=` は新たなリスト |List| や |Blob| を作る代わりにそ
+			の場で変更する。
 			`.=` はVim scriptバージョン2以降ではサポートされていな
 			い。|vimscript-version| を参照。
 

en/eval.txt

@@ -1,4 +1,4 @@
-*eval.txt*	For Vim version 9.1.  Last change: 2024 Jan 14
+*eval.txt*	For Vim version 9.1.  Last change: 2024 Feb 08
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -303,10 +303,15 @@ List concatenation ~
 							*list-concatenation*
 Two lists can be concatenated with the "+" operator: >
 	:let longlist = mylist + [5, 6]
-	:let mylist += [7, 8]
+	:let longlist = [5, 6] + mylist
+To prepend or append an item, turn it into a list by putting [] around it.
 
-To prepend or append an item, turn the item into a list by putting [] around
-it.  To change a list in-place, refer to |list-modification| below.
+A list can be concatenated with another one in-place using |:let+=| or
+|extend()|: >
+	:let mylist += [7, 8]
+	:call extend(mylist, [7, 8])
+<
+See |list-modification| below for more about changing a list in-place.
 
 
 Sublist ~
@@ -425,6 +430,18 @@ To change part of a list you can specify the first and last item to be
 modified.  The value must at least have the number of items in the range: >
 	:let list[3:5] = [3, 4, 5]
 
+To add items to a List in-place, you can use |:let+=| (|list-concatenation|): >
+	:let listA = [1, 2]
+	:let listA += [3, 4]
+<
+When two variables refer to the same List, changing one List in-place will
+cause the referenced List to be changed in-place: >
+	:let listA = [1, 2]
+	:let listB = listA
+	:let listB += [3, 4]
+	:echo listA
+	[1, 2, 3, 4]
+<
 Adding and removing items from a list is done with functions.  Here are a few
 examples: >
 	:call insert(list, 'a')		" prepend item 'a'
@@ -745,12 +762,15 @@ This calls Doit() with 0x11, 0x22 and 0x33.
 
 
 Blob concatenation ~
-
+							*blob-concatenation*
 Two blobs can be concatenated with the "+" operator: >
 	:let longblob = myblob + 0z4455
+	:let longblob = 0z4455 + myblob
+<
+A blob can be concatenated with another one in-place using |:let+=|: >
 	:let myblob += 0z6677
-
-To change a blob in-place see |blob-modification| below.
+<
+See |blob-modification| below for more about changing a blob in-place.
 
 
 Part of a blob ~
@@ -793,6 +813,18 @@ To change part of a blob you can specify the first and last byte to be
 modified.  The value must have the same number of bytes in the range: >
 	:let blob[3:5] = 0z334455
 
+To add items to a Blob in-place, you can use |:let+=| (|blob-concatenation|): >
+	:let blobA = 0z1122
+	:let blobA += 0z3344
+<
+When two variables refer to the same Blob, changing one Blob in-place will
+cause the referenced Blob to be changed in-place: >
+	:let blobA = 0z1122
+	:let blobB = blobA
+	:let blobB += 0z3344
+	:echo blobA
+	0z11223344
+<
 You can also use the functions |add()|, |remove()| and |insert()|.
 
 
@@ -2005,9 +2037,14 @@ v:collate	The current locale setting for collation order of the runtime
 								*v:colornames*
 v:colornames    A dictionary that maps color names to hex color strings. These
 		color names can be used with the |highlight-guifg|,
-		|highlight-guibg|, and |highlight-guisp| parameters. Updating
-		an entry in v:colornames has no immediate effect on the syntax
-		highlighting. The highlight commands (probably in a
+		|highlight-guibg|, and |highlight-guisp| parameters.
+
+		The key values in the dictionary (the color names) should be
+		lower cased, because Vim looks up a color by its lower case
+		name.
+
+		Updating an entry in v:colornames has no immediate effect on
+		the syntax highlighting. The highlight commands (probably in a
 		colorscheme script) need to be re-evaluated in order to use
 		the updated color values. For example: >
 
@@ -2804,6 +2841,8 @@ declarations and assignments do not use a command.  |vim9-declaration|
 :let {var} ..= {expr1}	Like ":let {var} = {var} .. {expr1}".
 			These fail if {var} was not set yet and when the type
 			of {var} and {expr1} don't fit the operator.
+			`+=` modifies a |List| or a |Blob| in-place instead of
+			creating a new one.
 			`.=` is not supported with Vim script version 2 and
 			later, see |vimscript-version|.