Merge pull request #2582 from h-east/change-style-to-normal-part-of_vim9

Change style to normal part of vim9.jax

Author: h-east

doc/vim9.jax

@@ -1160,19 +1160,19 @@ null との比較テストに関する詳細は、|null-compare| を参照。
 インデックスが範囲外の場合、結果は空文字列になる。
 
 旧来のスクリプトでは、"++var" と "--var" は何も表示されずにそのまま受け入れら
-れ効果がない。これは Vim9 script ではのエラーである。
+れ効果がない。これは Vim9 script ではエラーである。
 
 0 で始まる数値は 8 進数とはみなされず、"0o" で始まる数値のみが 8 進数として扱
 われる: "0o744"。|scriptversion-4|
 
 
 気をつけるべきこと ~
 							*vim9-gotchas*
-Vim9 は、一般的なプログラミング言語に近づくように設計されていますが、同時に旧
-来の Vim コマンドをサポートしようとしています。そのため、いくつかの妥協をしな
-ければなりませんでした。ここでは、意外と知られていないことをまとめてみました。
+Vim9 は、広く使われているプログラミング言語に近い設計となっているが、旧来の
+Vim コマンドもサポートしようとしている。そのため、いくつかの妥協点が生じた。以
+下に、予期せぬ変更点についてまとめた。
 
-Exコマンドの範囲指定にはコロンを前置する必要があります。 >
+Ex コマンドの範囲指定にはコロンを前置する必要がある。 >
 	->		  旧来の Vim: 前の行を右にシフト
 	->func()	  Vim9: 継続行におけるメソッド呼び出し
 	:->		  Vim9: 前の行を右にシフト
@@ -1185,40 +1185,40 @@ Exコマンドの範囲指定にはコロンを前置する必要があります
 	'text'->func()	  Vim9: メソッド呼び出し
 	:'t		  Vim9: マーク t へのジャンプ
 
-いくつかのExコマンドは Vim9 script の代入式と紛らわしくなります: >
+いくつかの Ex コマンドの中には、Vim9 script の代入と混同されるものがある: >
 	g:name = value    # 代入
 	:g:pattern:cmd	  # :グローバルコマンド
 
-コマンド `:global` や `:substitute` と式や代入文が紛らわしくなるのを避けるた
-め、これらのコマンドが一文字に省略されているとき、一部のセパレータは使うことが
-できません: ':'、'-' と '.' が利用不可です。: >
+`:global` コマンドや `:substitute` コマンドと式や代入との混同を避けるため、こ
+れらのコマンドを 1 文字に省略する場合、一部の区切り文字 ':'、'-'、'.' は使用で
+きない。 >
 	g:pattern:cmd	  # 無効なコマンド - エラー
 	s:pattern:repl	  # 無効なコマンド - エラー
 	g-pattern-cmd	  # 無効なコマンド - エラー
 	s-pattern-repl	  # 無効なコマンド - エラー
 	g.pattern.cmd	  # 無効なコマンド - エラー
 	s.pattern.repl	  # 無効なコマンド - エラー
 
-同様に、コマンドとセパレータの間にスペースがあってはいけません: >
+また、コマンドとセパレータの間にスペースを入れることはできない: >
 	g /pattern/cmd	  # 無効なコマンド - エラー
 	s /pattern/repl	  # 無効なコマンド - エラー
 
-`:def` で定義した関数はすべてコンパイルされます。旧来の関数は途中で脱出するこ
-とができ、それ以降の行はパースされません: >
+`:def`で定義された関数は、関数全体をコンパイルする。旧来の関数は途中で脱出する
+ことができ、以降の行はパースされない: >
 	func Maybe()
 	  if !has('feature')
 	    return
 	  endif
 	  use-feature
 	endfunc
-Vim9 関数はすべてコンパイルされます: >
+Vim9 の関数は全体がコンパイルされる: >
 	def Maybe()
 	  if !has('feature')
 	    return
 	  endif
 	  use-feature  # コンパイルエラーが発生する可能性がある
 	enddef
-応急的に、2つの関数に分けることができます: >
+回避策として、それを 2 つの関数に分割する: >
 	func Maybe()
 	  if has('feature')
 	    call MaybeInner()
@@ -1229,57 +1229,59 @@ Vim9 関数はすべてコンパイルされます: >
 	    use-feature
 	  enddef
 	endif
-また、偽として評価される定数式の条件をもった `if` の配下にサポート外のコードを
-置くことができます: >
+または、サポートされていないコードを、偽と評価される定数式を含む `if` 文の中に
+記述する: >
 	def Maybe()
 	  if has('feature')
 	    use-feature
 	  endif
 	enddef
-これには `exists_compiled()` 関数も同様に使えます。
+これには `exists_compiled()` 関数も同様に使える。
 							*vim9-user-command*
-関数のコンパイルによる他の副作用として、ユーザーコマンドの存在がコンパイルの時
-点でチェックされます。ユーザーコマンドが後で定義されている場合、エラーとなりま
-す。これはOKです: >
+関数をコンパイルする際のもう一つの副作用は、コンパイル時にユーザーコマンドの存
+在がチェックされることである。ユーザーコマンドが後から定義されている場合、エ
+ラーが発生する。これは動作する: >
 	command -nargs=1 MyCommand echom <q-args>
 	def Works()
 	  MyCommand 123
 	enddef
-これは "MyCommand" が定義されていないというエラーが発生します: >
+これは "MyCommand" が定義されていないというエラーになる: >
 	def Works()
 	  command -nargs=1 MyCommand echom <q-args>
 	  MyCommand 123
 	enddef
-回避策は、`:execute` を使用して間接的にコマンドを呼び出すことです: >
+回避策は、`:execute` を使用してコマンドを間接的に呼び出すことである: >
 	def Works()
 	  command -nargs=1 MyCommand echom <q-args>
 	  execute 'MyCommand 123'
 	enddef
 
-Note 認識されていないコマンドを "|" でつなぐと、その後のコマンドは認識されませ
-ん。次のような記述は `endif` がないというエラーになります: >
+Note 認識されないコマンドの場合、"|" とそれに続くコマンドのチェックは行われな
+いことに注意。そのため、`endif` が欠落しているというエラーが発生する: >
 	def Maybe()
 	  if has('feature') | use-feature | endif
 	enddef
 
 その他の変更点 ~
 
-パターンは、明示的に上書きされない限り 'magic' が設定されている状態と同様に作
-用します。
-オプション 'edcompatible' の値は使用されません。
-オプション 'gdefault' の値は使用されません。
+パターンは、明示的に上書きされない限り 'magic' が設定されているかのように作用
+する。
+'edcompatible' オプションの値は使用されない。
+'gdefault' オプションの値は使用されない。
 
-また、このwikiも参考になるでしょう。これは Vim9 script のアーリーアダプターに
-よって書かれました: https://github.com/lacygoill/wiki/blob/master/vim/vim9.md
+こちらの Wiki も参考になるかもしれない。これは Vim9 script のアーリーアダプター
+によって書かれたものである:
+https://github.com/lacygoill/wiki/blob/master/vim/vim9.md
 
 							*:++* *:--*
-++ と -- コマンドが追加されました。1 を足し引きするのとそっくりです: >
+++ と -- コマンドが追加された。これらは、1 を足したり引いたりするのと非常によ
+く似ている: >
 		++var
 		var += 1
 		--var
 		var -= 1
 
-式中で ++var や --var を使うことはまだサポートされていません。
+式中で ++var や --var を使うことはまだサポートされていない。
 
 
 ==============================================================================