Change until just before *E1034*

Author: h-east

doc/vim9.jax

@@ -599,11 +599,11 @@ function() の省略 ~
 		\	v)
 		\	=> v > 0)
 <					*vim9-lambda-arguments* *E1172*
-旧来の Vim scripy では、ラムダ式は任意の数の追加引数で呼び出すことができ、引数
-を指定しなかった場合の警告を出す方法がなかった。Vim9 script では、引数の数は一
-致している必要がある。任意の引数、あるいは追加の引数を受け入れたい場合は、
-"..._" を使用する。これにより、関数は |vim9-variable-arguments| を受け入れるよ
-うになる。例: >
+旧来のスクリプトでは、ラムダ式は任意の数の追加引数で呼び出すことができ、引数を
+指定しなかった場合の警告を出す方法がなかった。Vim9 script では、引数の数は一致
+している必要がある。任意の引数、あるいは追加の引数を受け入れたい場合は、"..._"
+を使用する。これにより、関数は |vim9-variable-arguments| を受け入れるようにな
+る。例: >
 	var Callback = (..._) => 'anything'
 	echo Callback(1, 2, 3)  # "anything" を表示する
 
@@ -736,8 +736,8 @@ Note これは、ヒアドキュメントの最初の行をバーで始めるこ
 	      \ start='foo'
 	      #\ コメント
 	      \ end='bar'
-旧来の Vim script と同様に、'"\ ' が使用される。これは、バックスラッシュなしで
-行継続が使用され、行がバーで始まる場合にも必要である: >
+旧来のスクリプトと同様に、'"\ ' が使用される。これは、バックスラッシュなしで行
+継続が使用され、行がバーで始まる場合にも必要である: >
 	au CursorHold * echom 'BEFORE bar'
 	      #\ 何かのコメント
 	      | echom 'AFTER bar'
@@ -804,30 +804,28 @@ Notes:
   のような場合は、バックスラッシュによる行継続を使用する必要がある。
 
 
-ホワイトスペース ~
+空白 ~
 			*E1004* *E1068* *E1069* *E1074* *E1127* *E1202*
-Vim9 script ではホワイトスペースの適切な使用を強制します。これはもはや許可され
-ません: >
+Vim9 script では空白の適切な使用を強制する。これはもう許可されていない: >
 	var name=234	# エラー!
 	var name= 234	# エラー!
 	var name =234	# エラー!
-"=" の前後にホワイトスペースがなければいけません: >
+"=" の前後には空白が必要である: >
 	var name = 234	# OK
-コマンドの後ろでコメントを開始する # の前にもホワイトスペースが置かれなければ
-なりません: >
+コマンドの後ろのコメントを開始する # の前にも空白を入れる必要がある: >
 	var name = 234# エラー!
 	var name = 234 # OK
 
-ホワイトスペースは大抵の演算子の周りで必須です。
+ほとんどの演算子の周囲には空白が必要である。
 
-始まりと終わりと除いて、サブリスト (リストのスライス) の ":" の周りにホワイト
-スペースが必要です: >
+サブリスト (リストスライス) では先頭と末尾を除き、":" の前後に空白が必要である:
+>
 	otherlist = mylist[v : count]	# v:count は異なる意味を持つ
 	otherlist = mylist[:]		# リストのコピーを作る
 	otherlist = mylist[v :]
 	otherlist = mylist[: v]
 
-ホワイトスペースは許可されません:
+空白は許可されない:
 - 関数名と "(" の間: >
 	Func (arg)	   # エラー!
 	Func
@@ -841,134 +839,131 @@ Vim9 script ではホワイトスペースの適切な使用を強制します
 	      arg	   # OK
 	      )
 <							*E1205*
-`:set` コマンドでのオプション名と続く "&"、"!"、"<"、"="、"+="、"-=" や "^="
-の間にはホワイトスペースは許可されません。
+`:set` コマンドではオプション名とそれに続く "&"、"!"、"<"、"="、"+="、"-=" ま
+たは "^=" の間に空白は許可されていない。
 
 
-波括弧変数の廃止 ~
+波括弧の展開の禁止 ~
 
-波括弧変数 |curly-braces-names| は使用できません。
+波括弧変数 |curly-braces-names| は使用できない。
 
 
 コマンド修飾子は無視されない ~
 								*E1176*
-コマンド修飾子を使わないコマンドにコマンド修飾子を使うとエラーになります。
+コマンド修飾子を使用しないコマンドにコマンド修飾子を使用するとエラーが発生す
+る。
 								*E1082*
-同様に、続くコマンドなしにコマンド修飾子を使うことも今はエラーになります。
+また、後続のコマンドなしでコマンド修飾子を使用するとエラーになるようになった。
 
 
 辞書リテラル ~
 						*vim9-literal-dict* *E1014*
-従来、Vim は波括弧 {} で辞書リテラルの表記をサポートしてきました: >
+従来、Vim は {} 構文を使用して辞書リテラルをサポートしてきた: >
 	let dict = {'key': value}
 
-後に、辞書にシンプルなキーを使用することが非常に一般的であることが明らかになっ
-たため、キーをクォーテーションなしで指定できる表記が後方互換的に導入されまし
-た: >
+その後、単純なテキストのキーの使用が非常に一般的であることが明らかになったた
+め、後方互換性のある形でリテラル辞書が導入された: >
 	let dict = #{key: value}
 
-しかし、この #{} という表記は他の言語に比べて異色なものです。キーには式よりも
-リテラルを使うほうが一般的で、JavaScript が使っている構文を考えると、辞書リテ
-ラルに {} の表記を使うほうがずっと便利です: >
+しかし、この #{} 構文は既存の言語とは異なる。リテラルキーの使用は式の使用より
+もはるかに一般的であり、JavaScript でもこの構文が使用されていることを考慮する
+と、辞書リテラルに {} 形式を使用する方がはるかに便利な構文であると考えられる。
+Vim9 script では、{} 形式はリテラルキーを使用する: >
 	var dict = {key: value}
 
-これは英数字、アンダースコアとダッシュのキーで利用できます。異なる文字を使用す
-る場合は、シングルクォートまたはダブルクォートで囲まれた文字列を使用します: >
+これは英数字、アンダースコアおよびダッシュに有効である。他の文字を使用する場合
+は、シングルクォートまたはダブルクォートで囲んだ文字列を使用する: >
 	var dict = {'key with space': value}
 	var dict = {"key\twith\ttabs": value}
 	var dict = {'': value}			# 空のキー
 <							*E1139*
-キーに式を使用する必要がある場合は、JavaScript と同様に角括弧を使用することが
-できます: >
+キーに式を使用する必要がある場合は、JavaScript と同様に角括弧を使用できる: >
 	var dict = {["key" .. nr]: value}
 
-キーの型には、文字列、数値、真偽値、浮動小数点のいずれかを指定できます。その他
-の型の場合はエラーが発生します。[] を使わない場合は文字列として扱われ、先頭の
-0 を保持します。[] を使って式が与えられた場合は、式を評価し、文字列に変換しま
-す。先頭の 0 は省かれます: >
+キーの型は文字列、数値、真偽値、または浮動小数点数である。その他の型はエラーに
+なる。[] を使用しない場合、値は先頭のゼロを保持した文字列として扱われる。[] で
+指定された式は評価され文字列に変換される。その際、先頭のゼロは削除される: >
 	var dict = {000123: 'without', [000456]: 'with'}
 	echo dict
 	{'456': 'with', '000123': 'without'}
-[] 外ではドットは受け入れられないので、浮動小数点数は [] の中でのみ動作しま
-す: >
+ドットは他の場所では受け入れられないため、浮動小数点数は [] 内でのみ動作する: >
 	var dict = {[00.013]: 'float'}
 	echo dict
 	{'0.013': 'float'}
 
 
-:xit、:t、:k、:append、:change、:insert の廃止 ~
+:xit、:t、:k、:append、:change、:insert の禁止 ~
 							*E1100*
-これらのコマンドは容易にローカル変数の名前と混同します。
-`:x` や `:xit` の代わりに `:exit` を使用できます。
-`:t` の代わりに `:copy` を使用できます。
-`:k` の代わりに `:mark` を使用できます。
+これらのコマンドは、ローカル変数名と混同されやすい。
+`:x` や `:xit` の代わりに `:exit` を使用できる。
+`:t` の代わりに `:copy` を使用できる。
+`:k` の代わりに `:mark` を使用できる。
 
-比較 ~
 
-オプション 'ignorecase' は文字列の比較には作用しません。なので、"=~" は "=~#"
-と同じように動作します。
+比較演算子 ~
 
-現状では、"is" と "isnot" (|expr-is| と |expr-isnot|) を文字列に対して使うと
-常に偽を返します。旧来の Vim script では文字列の比較を行うだけでしたが、Vim9
-script ではそれらは文字列オブジェクトが同一であることをチェックします。文字列
-は使われるときに複製されるので、二つの文字列は同一と判定されることはありませ
-ん。(いつか、もし文字列が複製されるのではなく参照カウントで管理されるようにな
-ると、この挙動は変更されるかもしれません)
+'ignorecase' オプションは、文字列を使用する比較演算子では使用されない。
+したがって、"=~" は "=~#" のように動作する。
+
+文字列に対して "is" と "isnot" (|expr-is| と |expr-isnot|) を使用すると、偽を
+返すようになった。旧来のスクリプトでは文字列の比較のみだったが、|Vim9| script
+では文字列の同一性を確認し、使用時に文字列がコピーされるため、2 つの文字列が同
+一になることはない (文字列がコピーされず参照カウントされるようになれば、将来的
+には変更される可能性がある)。
 
 
 エラー後の中断 ~
 
-旧来の Vim script では、エラーに遭遇したとき、Vim は後続の行の実行を続けます。
-これは長いエラーの列を生みかねず、そしてそのエラーを止めるための CTRL-C の入力
-が必要になります。Vim9 script ではコマンドの実行は最初のエラーに遭遇した段階で
-終了します。例: >
+旧来のスクリプトではエラーが発生すると、Vim は次の行の実行を継続する。これによ
+り、長いエラーシーケンスが発生し停止するには Ctrl-C を入力する必要がある。Vim9
+script では、コマンドの実行は最初のエラーで停止する。例: >
 	vim9script
 	var x = does-not-exist
 	echo 'not executed'
 
 
 For ループ ~
 							*E1254*
-ループ変数は先に宣言されていてはいけません: >
+ループ変数は宣言されていてはいけない: >
 	var i = 1
 	for i in [1, 2, 3]   # エラー!
 
-ただ、グローバル変数を使うことは可能です: >
+ただし、グローバル変数を使用することは可能である: >
 	g:i = 1
 	for g:i in [1, 2, 3]
 	  echo g:i
 	endfor
 
-旧来の Vim script では、リストのループ内で現在または前の項目を削除するための
-for ループをつくるために幾つかのトリックがあります。Vim9 script では、単純にイ
-ンデックスを使用することで、リストから削除された場合はスキップされます。
-旧来のスクリプトの例: >
+旧来の Vim script には、リストハンドルに対してforループを実行し、現在位置また
+は前の項目を削除するトリックがいくつかある。Vim9 script ではインデックスのみを
+使用し、項目が削除された場合はリスト内の項目をスキップする。旧来のスクリプトの
+例: >
 	let l = [1, 2, 3, 4]
 	for i in l
 	   echo i
 	   call remove(l, index(l, i))
 	endfor
-出力は以下の通り:
+以下が出力される:
 	1
 	2
 	3
 	4
-コンパイルされた Vim9 script での出力は以下の通り:
+コンパイルされた Vim9 script では以下のようになる:
 	1
 	3
-一般的に、反復しているリストを変更してはいけません。必要であれば最初にコピーを
-作ります。
-リストのリストをループする場合、ネストされたリストを変更できます。ループ変数は
-"final" であり、変更することはできませんが、その値は変更できます。
+一般的に、反復処理するリストは変更してはならない。必要であれば事前にコピーを作
+成する。
+リストのリストをループ処理する場合、ネストされたリストは変更できる。ループ変数
+は "final" であり変更できないが、その値は変更できる。
 							*E1306*
-:for ループと :while ループを合わせたループの深さは、10 を超えることはできませ
-ん。
+:for ループと :while ループを合わせたループの深さは、10 を超えることはできな
+い。
 
 
 条件と式 ~
 						*vim9-boolean*
-条件と式は、他の言語とおよそ同じように扱われます。いくつかの値は旧来の Vim
-script と扱いが異なります:
+条件と式は他の言語とほぼ同じように動作する。ただし、一部の値は旧来の Vim scipt
+と異なる:
 	値		旧来の Vim script	Vim9 script ~
 	0		falsy			falsy
 	1		truthy			truthy
@@ -977,28 +972,27 @@ script と扱いが異なります:
 	"99"		truthy			エラー!
 	"text"		falsy			エラー!
 
-"??" 演算子か "!" を使用している場合はエラーとなることはなく、すべての値は
-falsy か truthy として評価されます。これは JavaScript とほぼ同じですが、空の
-リストと辞書は falsy として評価されます:
+"??" 演算子や "!" 演算子を使用する場合エラーは発生せず、すべての値は偽値か真値
+のいずれかになる。これは JavaScript とほぼ同じだが、空のリストと辞書は偽値にな
+る:
 
-	型		真と評価される値 ~
+	型		真値となるとき ~
 	bool		true, v:true または 1
 	number		非0
 	float		非0
-	string		空文字列以外
-	blob		空 blob 以外
-	list		空リスト以外 (JavaScript とは異なる)
-	tuple		空 tuple 以外 (JavaScript とは異なる)
-	dictionary	空辞書以外 (JavaScript とは異なる)
+	string		空以外
+	blob		空以外
+	list		空以外 (JavaScript とは異なる)
+	tuple		空以外 (JavaScript とは異なる)
+	dictionary	空以外 (JavaScript とは異なる)
 	func		関数名があるとき
 	special		true または v:true
 	job		非 NULL
 	channel		非 NULL
 	class		非 NULL
 	object		非 NULL (TODO: isTrue() が true を返すとき)
 
-真偽値演算子 "||" と "&&" は、値が真偽値、0または1であることを期待します:
->
+真偽値演算子 "||" と "&&" は、値が真偽値、0 または 1 であることを期待する: >
 	1 || false   == true
 	0 || 1       == true
 	0 || false   == false
@@ -1008,19 +1002,18 @@ falsy か truthy として評価されます。これは JavaScript とほぼ同
 	'yes' && 0   エラー!
 	[] || 99     エラー!
 
-"!" を使って論理否定をすると、どのような型に対しても結果は真偽値になります。
-"!!" と二重論理否定をすることで、あらゆる型を真偽値に変換することができます: >
+論理否定に "!" を使用する場合、どの型を使用してもエラーは発生せず、結果は真偽
+値になる。"!!" を使用すると、任意の値を真偽値に変換できる: >
 	!'yes'			== false
 	!![]			== false
 	!![1, 2, 3]		== true
 
-文字列の結合に `..` を使用すると、すべての単純型の被演算子は常に文字列に変換さ
-れます: >
+文字列の連結に `..` を使用する場合、単純型の引数は常に文字列に変換される: >
 	'hello ' .. 123  == 'hello 123'
 	'hello ' .. v:true  == 'hello true'
 
-単純型とは、文字列 (string)、数値 (float)、特殊値 (special) と真偽値 (bool) で
-す。他の型では |string()| を使う必要があります。
+単純型は Number、Float、Special、Bool である。その他の型には |string()| を使用
+すべきである。
 			*false* *true* *null* *null_blob* *null_channel*
 			*null_class* *null_dict* *null_function* *null_job*
 			*null_list* *null_object* *null_partial* *null_string*