Change until just before *E1004*

Author: h-east

doc/vim9.jax

@@ -584,115 +584,112 @@ function() の省略 ~
 	var Lambda = (arg) => expression
 	var Lambda = (arg): type => expression
 <							*E1157*
-"=>" まで含めて、ラムダ式の引数の定義の中では改行することはできません (Vim が
-丸カッコで囲まれた式とラムダ式の引数の区別をつけられるようにするため)。これは
-OKです: >
+ラムダ式の引数では、"=>" まで改行は許可されない (Vim が括弧内の式とラムダ式の
+引数を区別できるようにするため)。これは OK である: >
 	filter(list, (k, v) =>
 			v > 0)
-以下のように記述することはできません: >
+これは動作しない: >
 	filter(list, (k, v)
 			=> v > 0)
-以下のように記述することもできません: >
+これも動作しない: >
 	filter(list, (k,
 			v) => v > 0)
-ただし、バックスラッシュを使ってパースする前に行をつなげることができます: >
+ただし、パースする前にバックスラッシュを使用して行を連結することができる: >
 	filter(list, (k,
 		\	v)
 		\	=> v > 0)
 <					*vim9-lambda-arguments* *E1172*
-旧来の Vim script においては、ラムダ関数はいくつもの余分な引数を与えて呼ぶこと
-ができ、そしてその余分な引数を使わないことに対しての警告をする方法がありません
-でした。Vim9 script では引数の数は必ず一致しなければなりません。もし任意の
-引数、またはその他の引数を受け入れたい場合は、関数が |vim9-variable-arguments|
-を受け入れられるようにする "..._" を使ってください。例: >
+旧来の Vim scripy では、ラムダ式は任意の数の追加引数で呼び出すことができ、引数
+を指定しなかった場合の警告を出す方法がなかった。Vim9 script では、引数の数は一
+致している必要がある。任意の引数、あるいは追加の引数を受け入れたい場合は、
+"..._" を使用する。これにより、関数は |vim9-variable-arguments| を受け入れるよ
+うになる。例: >
 	var Callback = (..._) => 'anything'
 	echo Callback(1, 2, 3)  # "anything" を表示する
 
 <						*inline-function* *E1171*
-加えて、ラムダ式には {} に複数のステートメントを含むことができます: >
+さらに、ラムダ式には {} 内のステートメント群を含めることができる: >
 	var Lambda = (arg) => {
 		g:was_called = 'yes'
 		return expression
 	    }
-これはタイマーに便利です。例えば: >
+これはタイマーに役立つ。例えば: >
 	var count = 0
 	var timer = timer_start(500, (_) => {
 		 count += 1
 		 echom 'Handler called ' .. count
 	     }, {repeat: 3})
 
-閉じの "}" は行の先頭にこなければなりません。後ろに他の文字が続いても良いで
-す。例: >
+終わりの "}" は行頭になければならない。その後に他の文字を続けることもできる。
+例: >
 	var d = mapnew(dict, (k, v): string => {
 	     return 'value'
 	   })
-いかなるコマンドも "{" の後ろに続いてはいけません。コメントのみが利用可能で
-す。
+"{" の後にコマンドは使用できない。コメントのみ使用できる。
 
 						*command-block* *E1026*
-ブロックはユーザーコマンドを定義するのにも使えます。ブロックの内側では Vim9
-script の文法が使われます。
+このブロックはユーザーコマンドの定義にも使用できる。ブロック内では Vim9 script
+の構文が使用される。
 
-これはヒアドキュメントの使用例です: >
+以下はヒアドキュメントの使用例である: >
     com SomeCommand {
         g:someVar =<< trim eval END
           ccc
           ddd
         END
       }
 
-もしブロックが辞書を含むのであれば、辞書の閉じカッコは行頭に書かれてはいけませ
-ん。さもなくば閉じカッコがブロックの終了としてパースされてしまいます。これは動
-作しません: >
+文に辞書が含まれる場合、その閉じ括弧を行頭に記述してはいけない。そうしないと、
+ブロックの終わりとして解釈されてしまう。これは動作しない: >
 	command NewCommand {
 	     g:mydict = {
 	       'key': 'value',
 	       }  # エラー: ブロックの終了として認識される
 	   }
-これを避けるには、'}' を最後の要素の後ろにおいてください: >
+これを回避するには、最後の項目の後に '}' を配置する: >
 	command NewCommand {
 	     g:mydict = {
 	       'key': 'value' }
 	   }
 
-根拠: "}" がコマンドの後にきてはならないのは、ブロックの閉じカッコを見つけるの
-にコマンドのパースが必要だろうからです。一貫性のために、いかなるコマンドも "{"
-に続けることはできません。残念ながら、これは "() => { command }" が動作せず、
-常に改行が必要であることを意味します。
+理由: コマンドの後に "}" を置くことはできない。コマンドをパースして "}" を見つ
+ける必要があるためである。一貫性を保つため、"{" の後にコマンドを置くことはでき
+ない。残念ながら、これは "() => { command }" という表現が機能しないことを意味
+する。常に改行が必要である。
 
 							*vim9-curly*
-辞書リテラルの "{" がステートメントブロックと認識されてしまうのを回避するため
-には、括弧で包みます: >
+辞書リテラルの "{" がステートメントブロックとして認識されるのを避けるには、そ
+れを括弧で囲む: >
 	var Lambda = (arg) => ({key: 42})
 
-さらに、コマンドブロックの開始と混同してしまう場合: >
+また、コマンドブロックの開始と混同された場合: >
 	({
 	    key: value
 	 })->method()
 
 
 自動行継続 ~
 					*vim9-line-continuation* *E1097*
-多くの場合、式が次の行に続くことは明らかです。継続行の先頭に行継続のためのバッ
-クスラッシュ (|line-continuation| 参照) を置く必要はありません。例えば、複数行
-にまたぐリストの場合: >
+多くの場合、式が次の行に続くことは明らかである。そのような場合、行頭にバックス
+ラッシュ (|line-continuation| を参照) を付ける必要はない。例えば、リストが複数
+行にまたがる場合: >
 	var mylist = [
 		'one',
 		'two',
 		]
-辞書の場合: >
+辞書が複数行にまたがる場合: >
 	var mydict = {
 		one: 1,
 		two: 2,
 		}
-関数の呼び出しで: >
+関数呼び出しの場合: >
 	var result = Func(
 			arg1,
 			arg2
 			)
 
-角カッコ []、波カッコ {}、または丸カッコの中‘以外で’二項演算子御使用する場
-合、その前後で改行することができます。例: >
+[]、{}、() 以外の式における二項演算子については、演算子の直前または直後で改行
+が可能である。例: >
 	var text = lead
 		   .. middle
 		   .. end
@@ -703,110 +700,108 @@ script の文法が使われます。
 			? PosFunc(arg)
 			: NegFunc(arg)
 
-"->" を使用したメソッド呼び出し、そしてドット (.) を使用したメンバー参照の場
-合、その前に改行を置くことができます: >
+"->" を使用するメソッド呼び出しとドットを使用するメンバーの場合、その前に改行
+が許可される: >
 	var result = GetBuilder()
 			->BuilderSetWidth(333)
 			->BuilderSetHeight(777)
 			->BuilderBuild()
 	var result = MyDict
 			.member
 
-複数のコマンドのリストを引数に持つコマンドでは、行の先頭に置かれた文字 | は行
-継続を表します: >
+コマンドリストを引数として持つコマンドの場合、行の先頭の | 文字は行の継続を示
+す: >
 	autocmd BufNewFile *.match if condition
 		|   echo 'match'
 		| endif
 
-Note これはヒアドキュメントの最初の行は | で始めることができないことを意味しま
-す: >
+Note これは、ヒアドキュメントの最初の行をバーで始めることができないことを意味
+することに注意: >
 	var lines =<< trim END
 	   | これは動作しない
 	END
-ヒアドキュメントの先頭行を空行にする、あるいはヒアドキュメントを使わないように
-してください。あるいは一時的にフラグ "C" を 'cpoptions' に追加してください: >
+先頭に空行を入れるか、ヒアドキュメントを使わないようにすること。あるいは、一時
+的に 'cpoptions' に "C" フラグを追加する: >
 	set cpo+=C
 	var lines =<< trim END
 	   | これは動作する
 	END
 	set cpo-=C
-もしヒアドキュメントが関数の中で使われているのであれば、'cpoptions' は :def の
-前で変更され、かつ :enddef の後ろで元に戻されなければなりません。
+ヒアドキュメントが関数内にある場合、'cpoptions' は :def の前に設定し、:enddef
+の後に復元する必要がある。
 
-例えば長い Ex コマンドを分割しているときのような、依然として行連結にバックス
-ラッシュが必要な場所では、'#\ ' でコメントを開始することができます: >
+長い Ex コマンドを分割するなど、バックスラッシュによる行継続が必要な場所では、
+コメントを '#\ ' で開始することができる: >
 	syn region Text
 	      \ start='foo'
 	      #\ コメント
 	      \ end='bar'
-これは旧来の Vim script で '"\ ' が使われているのと似ています。またこれはバッ
-クスラッシュ抜きで行連結が使用され、かつ行が | で開始しているときにも必要で
-す: >
+旧来の Vim script と同様に、'"\ ' が使用される。これは、バックスラッシュなしで
+行継続が使用され、行がバーで始まる場合にも必要である: >
 	au CursorHold * echom 'BEFORE bar'
 	      #\ 何かのコメント
 	      | echom 'AFTER bar'
 <
 							*E1050*
-行頭の演算子と識別できるようにするために、範囲指定の前にはコロンを置きます。
-"start" と "print" をつなげる例: >
+行頭の演算子を認識できるようにするには、範囲の前にコロンを置く必要がある。次の
+例では、"start" と "print" を追加する: >
 	var result = start
 	+ print
-これは以下の記述と同じです: >
+以下と同様: >
 	var result = start + print
 
-次のように書くと、"start" を代入して、1行表示します: >
+これにより、"start" が割り当てられ、1 行表示する: >
 	var result = start
 	:+ print
 
-「範囲」の後ろには必ず Ex コマンドが続かなければなりません。コロンを付けてい
-ない時は `:call` 抜きで関数を呼ぶことができますが、「範囲」の後ろではそれが必
-要です: >
+範囲指定の後には Ex コマンドが必要である。コロンがなくても `:call` なしで関数
+を呼び出すことができるが、範囲指定の後には `:call` が必要である: >
 	MyFunc()
 	:% call MyFunc()
 
-Note |+cmd| の引数にはコロンは不要です: >
+Note |+cmd| 引数にはコロンは不要であることに注意: >
 	edit +6 fname
 
-関数の定義部においても、引数の間で改行をおくことができます: >
+関数冒頭を引数間で複数行に分割することもできる: >
 	def MyFunc(
 		text: string,
 		separator = '-'
 		): string
 
-継続行を識別することは容易ではないため、コマンドの解析はより厳格化されていま
-す。例えば、一行目のエラーにより、2行目は別のコマンドとみなされます: >
+継続行は容易に認識できないため、コマンドのパースはより厳密になった。例えば、1
+行目のエラーのため、2 行目は別のコマンドとして認識される: >
 	popup_create(some invalid expression, {
 	   exit_cb: Func})
-ここで "exit_cb: Func})" は実際に有効なコマンドです: 変更をファイル
-"_cb: Func})" に保存して閉じます。Vim9 script の中ではこの種のミスを回避するた
-めに、コマンド名と引数の間にはスペースを置かなくてはなりません。
+これで "exit_cb: Func})" は実際に有効なコマンドになった。つまり、"_cb: Func})"
+ファイルへの変更を保存して終了する。Vim9 script でこのような間違いを避けるに
+は、ほとんどのコマンド名と引数の間に空白を入れる必要がある。
 *E1144*
 
-ただし、コマンドの引数に置いたコマンドは認識されません。例えば、"windo echo
-expr" に続く "expr" の式の中で改行しても認識されません。
+ただし、コマンドの引数がコマンドである場合は認識されない。例えば、"windo echo
+expr" の後では、"expr" 内の改行は認識されない。
 
 
 Notes:
-- "enddef" は継続行の先頭に置くことはできません。それは関数の終端を意味します。
-- 代入式の左辺を複数の行に分割できません。特にリストのアンパック |:let-unpack|
-  を使用する場合は注意が必要です。これはOKです: >
+- "enddef" は継続行の先頭では使用できない。現在の関数を終了させるためである。
+- 代入の左辺では改行は許可されない。特にリストを展開する場合に当てはまる
+  |:let-unpack|。これは OK である: >
 	[var1, var2] =
 		Func()
-<  以下のように記述することはできません: >
+<  これは動作しない: >
 	[var1,
 	    var2] =
 		Func()
-- `:echo` や `:execute` のようなコマンドの引数は複数の行に分割できません。これ
-  はOKです: >
+- `:echo`、`:execute`、および類似のコマンドの引数の間には改行を入れることはで
+  きない。これは OK である: >
 	echo [1,
 		2] [3,
 			4]
-<  以下のように記述することはできません: >
+<  これは動作しない: >
 	echo [1, 2]
 		[3, 4]
-- いくつかの場合、特に `:windo` のようなコマンドが他のコマンドの引数として使わ
-  れるような場合では、Vim にとってコマンドのパースが困難です。このような場合で
-  では、バックスラッシュを使った行継続を使わなければなりません。
+- Vim では、コマンドのパースが困難な場合がある。特に、`:windo` のようにコマン
+  ドが別のコマンドの引数として使用されている場合には、その傾向が顕著である。そ
+  のような場合は、バックスラッシュによる行継続を使用する必要がある。
 
 
 ホワイトスペース ~