Change until just before *E1157*

Author: h-east

doc/vim9.jax

@@ -492,29 +492,28 @@ Vim9 script では`:let` は使用できない。既存の変数にコマンド
 
 定数 ~
 						*vim9-const* *vim9-final*
-定数の働きは言語によって異なります。別の値を代入できない変数を定数とする場合も
-あります。JavaScript がその一例です。また、値そのものを不変にすることもあり、
-例えばリスト定数の内容を変更することができないとしている場合もあります。
-Vim9ではこのどちらも定義することができます。
+定数の扱い方は言語によって異なる。ある言語では、別の値を代入できない変数を定数
+とみす。JavaScript がその一例である。また、他の言語では値を不変とするため、定
+数がリストを使用している場合は、リストを変更できない。Vim9 では、どちらも使用
+できる。
 							*E1021* *E1307*
-変数とその値、両方を定数とするには、`:const` を使用します。何らかの複合的な値
-が変更できないようにする際に使用します。例: >
+`:const` は、変数と値の両方を定数にするために使用される。これは、変更されない
+ことを確実にしたい複合構造に使用する。例: >
 	const myList = [1, 2]
 	myList = [3, 4]		# エラー!
 	myList[0] = 9		# エラー!
 	myList->add(3)		# エラー!
 <							*:final* *E1125*
-変数の変更のみを禁止するには、`:final` を使用します。この場合は、中の値自体を
-変えることはできます。Java でよく知られるものです。例: >
+`:final` は変数を定数にするために使用され、値は変更可能である。これは Java で
+よく知られている。例: >
 	final myList = [1, 2]
 	myList = [3, 4]		# エラー!
 	myList[0] = 9		# OK
 	myList->add(3)		# OK
 
-一般に、定数はすべて大文字 (例: ALL_CAPS) で書かれますが、必ずしもそうしなくて
-も構いません。
+定数は ALL_CAPS (すべて大文字) で書くのが一般的であるが、必須ではない。
 
-定数宣言は値そのものにのみ適用され、参照先の変数には影響しません。 >
+この定数は値自体にのみ適用され、それが参照するものには適用されない。 >
 	final females = ["Mary"]
 	const NAMES = [["John", "Peter"], females]
 	NAMES[0] = ["Jack"]     # エラー!
@@ -523,15 +522,15 @@ Vim9ではこのどちらも定義することができます。
 	NAMES[1][0] = "Emma"    # OK, females[0] == "Emma"
 
 
-:call と :eval は不要に ~
+:call と :eval の省略 ~
 							*E1190*
-関数は `:call` なしで呼ぶことができます: >
+関数は `:call` なしで呼ぶことができる: >
 	writefile(lines, 'file')
-`:call` は引き続き使用できますが、やめたほうが良いでしょう。
+`:call` の使用はまだ可能だが、推奨されない。
 
-メソッド呼び出しには `eval` は必要ありません。Exコマンドと同名の識別子ではない
-限り、直接に識別子から呼び出すことができます。関数の場合は、"(" または "->"の
-どちらかを改行せずに続けなければなりません。例: >
+`eval` なしのメソッド呼び出しは、先頭が識別子であるか、Ex コマンドでない限り可
+能である。関数の場合は、改行なしで "(" または "->" のいずれかが続く必要がある。
+例: >
 	myList->add(123)
 	g:myList->add(123)
 	[1, 2, 3]->Process()
@@ -541,45 +540,46 @@ Vim9ではこのどちらも定義することができます。
 	'foobar'->Process()
 	('foobar')->Process()
 
-一部の関数と Ex コマンドが紛らわしい場合、コロン (:) を前置することでそれが Ex
-コマンドであることを明示することができます。例えば、`:substitute` コマンドと
-`substitute()` が該当します。`substitute(` で始まる場合は関数呼び出しですが、
-コロンを前置することでコマンドを代わりに使用することができます: >
+関数名と Ex コマンドが曖昧になる稀なケースでは、Ex コマンドを使用することを明
+確にするために、先頭に ":" を付ける。例えば、`:substitute` コマンドと
+`substitute()` 関数の両方がある。行が `substitute(` で始まる場合は関数が使用さ
+れる。代わりにコマンドを使用する場合は、先頭にコロンを付ける: >
 	:substitute(pattern (replacement (
 
-もし式が "!" で始まっているのであれば、それは条件の否定ではなくシェルコマンド
-であると解釈されます。したがって、これはシェルコマンドとなります: >
+式が "!" で始まる場合、これは条件の否定ではなくシェルコマンドとして解釈される。
+つまり、これはシェルコマンドである: >
 	!shellCommand->something
-"!" を否定として用いるには、式を丸カッコで囲んでください: >
+否定を表す "!" を使用するには、式を括弧で囲む: >
 	(!expression)->Method()
 
-Note 変数は使用する前に宣言する必要がありますが、関数は宣言するより前に使用で
-きます。これは関数の循環参照を可能にするためです。関数を名前で探さなければなら
-ないので、少し効率が悪いです。また、関数名のタイプミスは、関数が呼び出されると
-きまで見つかりません。
+Note 変数は使用する前に定義する必要があるが、関数は定義前に呼び出すことができ
+る。これは、関数間の循環的な依存関係を可能にするために必要である。関数を名前で
+検索する必要があるため、効率は少し悪くなる。また、関数名のタイプミスは、関数が
+呼び出されたときにのみ検出される。
 
 
-function() は不要に ~
+function() の省略 ~
 
-ユーザー定義の関数は、`function()` を使わずとも関数リファレンスとして使用する
-ことができます。引数の型と戻り値の型がチェックされます。関数はすでに定義されて
-いる必要があります。 >
+ユーザー定義関数は、`function()` を使わずに式の中で関数参照として使用できる。
+その場合、引数の型と戻り値の型がチェックされる。関数は事前に定義されている必要
+がある。 >
 
 	var Funcref = MyFunction
 
-`function()` を使って "func" 型のリファレンスを得た場合、その関数は任意の個数
-の引数と任意の戻り値の型 (void を含めて) を持つものとされます。この場合、もし
-関数名がクォートで囲まれてるなら、その関数は後から宣言できます。
+`function()` を使用すると、結果の型は "func" になる。これは、任意の数の引数と
+任意の戻り値 (void を含む) を持つ関数である。引数をクォートで囲めば、関数は後
+で定義できる。
 
 
-ラムダ式には -> の代わりに => を使う ~
+ラムダ式は -> の代わりに => を使う ~
 							*vim9-lambda*
-旧来のスクリプトでは "->" はメソッド呼び出しとラムダ式で混同するおそれがありま
-す。また、"{" が見つかったとき、パーサーはラムダ式と辞書の開始を見分けねばなら
-ず、そしてそれは引数の型指定により複雑になっています。
+旧来のスクリプトでは、メソッド呼び出しとラムダ式で "->" を使用することが混乱を
+招く可能性がある。また、"{" が見つかった場合、パーサーはそれがラムダ式の開始な
+のか辞書の開始なのかを判断する必要があるが、引数の型が使用されるようになったた
+め、この判断はより複雑になっている。
 
-この問題を回避するため、Vim9 script ではラムダ式のために違う書式を使用し、それ
-は JavaScript に似ています: >
+これらの問題を回避するために、Vim9 script は JavaScript に似たラムダ式の異なる
+構文を使用する: >
 	var Lambda = (arg) => expression
 	var Lambda = (arg): type => expression
 <							*E1157*