usr_52.jax: Apply many suggestions

Co-authored-by: h_east <[email protected]>

Author: tsuyoshicho

doc/usr_52.jax

@@ -141,16 +141,16 @@ Vim9 script は大きな Vim script を容易に書けるようにデザイン
 とですが、同時に時間もかかります。そのため、その機能があまり使用されない場合
 は、無駄な時間がかかってしまいます。
 
-代わりに `import` で必要になるまで遅延させその時にスクリプトを即時にロードする
-手段を持ちます。上の例を使い、plugin/theplugin.vim スクリプト内を1箇所だけ変更
-してしています: >
+`import` でスクリプトをすぐにロードするのではなく、必要になるまで延期すること
+ができます。上記の例を使用すると、plugin/theplugin.vim スクリプトで行う必要が
+ある変更は1箇所だけです: >
 	import autoload "../lib/getmessage.vim"
 
-スクリプトの残りの部分は何も変更する必要はありません。 ただし、型はチェックさ
-れません。既存の GetMessage() 関数と同等ではなく、使用されるまでチェックされま
-せん。スクリプトでより重要なのかを決定する必要があります: 高速な初期化か早期に
-エラーが分るか。また、全部がうまく動くかチェックした後に、 "autoload" 引数を後
-で追加することもできます。
+スクリプトの残りの部分は何も変更する必要はありません。ただし、型はチェックされ
+ません。GetMessage() 関数が使用されるまで、その存在すらチェックされません。ス
+クリプトにとってどちらがより重要かを決定する必要があります: 高速な起動か早期に
+エラーが分かるか。すべての動作を確認した後で、"autoload" 引数を追加することも
+できます。
 
 
 ☆オートロード ディレクトリ
@@ -160,8 +160,8 @@ Vim9 script は大きな Vim script を容易に書けるようにデザイン
 	import autload "monthlib.vim"
 
 これはスクリプト "monthlib.vim" を 'runtimepath' のオートロード ディレクトリの
-中から検索します。Unix ではディレクトリの1つとして "~/.vim/autoload" がよくあ
-ります。
+中から検索します。Unix では、ディレクトリの1つが "~/.vim/autoload" であること
+が多いです。
 
 この方法の主要な利点として、このスクリプトを他のスクリプトと共有するのが容易で
 あることです。Vim が 'runtimepath' 内の "autoload" ディレクトリから検索するた
@@ -172,54 +172,56 @@ Vim9 script は大きな Vim script を容易に書けるようにデザイン
 オートロードなしは: >
 	import "monthlib.vim"
 
-Vim は 'runtimepath' のディレクトリ内からスクリプト "monthlib.vim" をインポー
-トします。"autoload" の追加や削除する場合はスクリプトが見付かる場所が変わるこ
-とに注意してください。位置が相対および絶対のパスであるなら変化はありません。
+Vim は 'runtimepath' のインポートディレクトリ内からスクリプト "monthlib.vim"
+を検索します。Note この場合、"autoload" を追加または削除すると、スクリプトが見
+つかる場所が変わります。相対パスまたは絶対パスでは、場所は変わりません。
 
 ==============================================================================
 *52.3*	インポート/エクスポートなしのオートロード
 
 						*write-library-script*
-インポート/エクスポート以前のメカニズムは依然として利用でき一部ユーザーは多少
-単純であると感じるかもしれません。それは特別な名前によって関数を呼ぶというアイ
-デアです。その関数はオートロードスクリプト内にあります。そのスクリプトのことを
-ライブラリスクリプトと呼びます。
+インポート/エクスポート以前のメカニズムは依然として使用でき一部ユーザーは多少
+単純であると感じるかもしれません。それは特別な名前によって関数を呼び出すという
+アイデアです。その関数はオートロードスクリプト内にあります。そのスクリプトのこ
+とをライブラリスクリプトと呼びます。
 
-オートロードのメカニズムは関数名が "#" 文字を持っているというのが基礎になって
-います: >
+オートロードのメカニズムは、関数名が "#" 文字を含んでいることが前提となってい
+ます: >
 
 	mylib#myfunction(arg)
 
-Vim は埋め込まれた "#" 文字によって関数名を認識し、まだ定義がないのであれば
-'runtimepath' 内のスクリプト "autoload/mylib.vim" を検索します。そのスクリプト
-は "mylib#myfunction()" 関数を定義する必要があります。名前 "mylib" を "#" の前
-部分と ".vim" を追加して、スクリプトの名前に使用するというのが一目瞭然です。
+Vim は埋め込まれた "#" 文字によって関数名を認識し、まだ定義されていない場合は
+"autoload/mylib.vim" というスクリプトを 'runtimepath' から探します。そのスクリ
+プトは "mylib#myfunction()" 関数を定義している必要があります。言うまでもなく、
+"mylib" という名前は "#" の前の部分であり、".vim" を追加してスクリプト名として
+使用されます。
 
-mylib.vim スクリプト内に他に多数の関数を置ことができ、ライブラリスクリプト内の
-構成が自由です。しかし '#' の前部分がスクリプト名に一致する関数名を使用する必
-要があります。そうでないと、Vim はロードするスクリプトが何であるか分らなくなり
-ます。この点がインポート/エクスポートメカニズムとの違いになります。
+mylib.vim スクリプト内に他の多くの関数を置ことができ、ライブラリスクリプト内の
+構成は自由です。ただし、'#' の前部分がスクリプト名に一致する関数名を使用する必
+要があります。そうしないと、Vim はロードするスクリプトを認識できません。この点
+がインポート/エクスポートのメカニズムとの違いになります。
 
 実際に夢中になり多数のライブラリスクリプトを書くのであれば、サブディレクトリを
 使用したいでしょう。例: >
 
 	netlib#ftp#read('somefile')
 
-関数名の最後の "#" より上からスクリプト名が取れます。途中にある "#" はスラッ
-シュに置き換え、最後の1つは ".vim" にします。つまり、"netlib/ftp.vim" が得られ
-ます。Unix の場合、これに使用されるライブラリスクリプトは次のようになります:
+ここでは、スクリプト名は、関数名から最後の "#" までが取得されます。途中の "#"
+はスラッシュで置き換えられ、最後の "#" は."vim" で置き換えられます。したがっ
+て、"netlib/ftp.vim" となります。Unixの場合、これに使われるライブラリスクリプ
+トは次のようになります:
 
 	~/.vim/autoload/netlib/ftp.vim
 
-ここで関数の定義はこうなります: >
+ここで、関数はこのように定義されています: >
 
 	def netlib#ftp#read(fname: string)
 		#  Read the file fname through ftp
 	enddef
 
-関数の名前は呼び出して利用する関数の名前と厳密に同じに定義されていることに注意
-しましょう。そして最後の '#' の前部分がサブディレクトリとスクリプト名と厳密に
-一致します。
+関数が定義されている名前は、関数を呼び出すときに使われる名前と全く同じであるこ
+とに注意してください。また、最後の '#' の前の部分は、サブディレクトリとスクリ
+プト名に完全に一致しています。
 
 変数にも同じメカニズムが使用できます: >
 
@@ -237,22 +239,23 @@ mylib.vim スクリプト内に他に多数の関数を置ことができ、ラ
 *52.4*	使用する他のメカニズム
 
 複数のファイルを使用するのが面倒で、すべてを1つのスクリプトにまとめておくのを
-好む人もいます。その結果として起動が遅くなるのを回避するため、小さく一部を定義
-し残りを実際に使用するまで遅延するメカニズムがあります。
+好む人もいます。その結果として、起動が遅くなるのを回避するため、小さな部分のみ
+を定義し、残りは実際に使用されるまで延期するメカニズムがあります。
 						*write-plugin-quickload*
 
-基本的なアイデアはプラグインを2回ロードするというものです。初回は機能を呼び出
-すユーザーコマンドとマッピングを定義します。2回目では機能を実装している関数を
-定義する。
+基本的な考え方は、プラグインは2回ロードされるということです。初回は、機能を提
+供するためのユーザーコマンドとマッピングが定義されます。2回目は、その機能を実
+装する関数が定義されます。
 
-高速ロードがスクリプトの2回ロードを意味するのは意外に思えるかもしません。これ
-は初回は素早く、2回目は延期したスクリプトのかたまりのロードを意味し、実際に使
-用する時のみ起きます。常に機能を使用のであれば実際のところ遅くなってしまいます!
+高速ロードがスクリプトを2回ロードすることを意味するのは意外に思われるかもしれ
+ません。つまり、初回は素早く読み込み、2回目にスクリプトの大部分を読み込ませる
+ということです。この機能は、実際に使用するときにのみ発生します。常に機能を使用
+する場合、実際には遅くなります!
 
-これには FuncUndefined 自動コマンドを使用します。これは上で説明した |autoload|
-の機能とは違った動きです。
+これは、FuncUndefined 自動コマンドを使用しています。上で説明した |autoload| 機
+能とは異なる動作をします。
 
-如何の例ではどのようにすべきかを示しています: >
+以下の例は、その方法を示しています: >
 
 	" Vim global plugin for demonstrating quick loading
 	" Last Change:	2005 Feb 25
@@ -282,27 +285,27 @@ mylib.vim スクリプト内に他に多数の関数を置ことができ、ラ
 マンドが実行されます。これは |:finish| コマンドで終わり、残りのスクリプトは実
 行されません。
 
-スクリプトの2回目ロード時は "s:did_load" は存在し "endif" 以降のコマンドが実行
-されます。これは(長い可能性のある) BufNetRead() と BufNetWrite() 関数を定義し
-ます。
+スクリプトの2回目ロード時は "s:did_load" は存在し、"endif" 以降のコマンドが実
+行されます。これは(長い可能性のある) BufNetRead() と BufNetWrite() 関数を定義
+します。
 
 あなたのプラグインディレクト内にスクリプトを置くと Vim は初期化時に実行します。
 このような流れでイベントが発生します:
 
-1. スクリプトが初期化時にソースされ "BNRead" コマンドが定義され <F19> キーに
-   マッピングされます。|FuncUndefined| 自動コマンドが定義されます。":finish"
-   コマンドによりスクリプトは早期に終了します。
+1. 起動時にスクリプトがソースされた時、"BNRead" コマンドが定義され、<F19> キー
+   がマッピングされる。|FuncUndefined| 自動コマンドが定義される。":finish" コ
+   マンドは、スクリプトを早期に終了させる。
 
-2. ユーザーが BNRead コマンドをタイプするか <F19> キーを押します。 BufNetRead()
-   かBufNetWrite() 関数が呼ばれます。
+2. ユーザーが BNRead コマンドをタイプするか <F19> キーを押す。BufNetRead()
+   か BufNetWrite() 関数が呼ばれる。
 
-3. Vim は関数を見付けることができず、|FuncUndefined| 自動コマンドイベントが発
-   生します。関数呼び出しが "BufNet*" パターンにマッチしたのなら、コマンドとし
-   て "source fname" が実行されます。"fname" はスクリプトの名前に等しく、どこ
-   にあるかは問題ないです、なぜなら "<sfile>" を展開して取っているからです
-   (|expand()| を参照)。
+3. Vim は関数を見つけることができず、|FuncUndefined| 自動コマンドイベントが発
+   生する。パターン "BufNet*" は呼び出された関数と一致するため、コマンド
+   "source fname" が実行される。"fname" は、"<sfile>" (|expand()| を参照) を展
+   開したものであるため、スクリプトがどこにあるかに関係なく、スクリプトの名前
+   と等しくなる。
 
-4. スクリプトは再度ソースされて、"s:did_load" 変数は存在し関数が定義されます。
+4. スクリプトは再度ソースされ、"s:did_load" 変数は存在し、関数が定義される。
 
 ロードされた後の関数が |FuncUndefined| 自動コマンドのパターンにマッチすること
 に注意してください。他のプラグインで定義するパターンにマッチする関数がないよう
@@ -318,11 +321,11 @@ mylib.vim スクリプト内に他に多数の関数を置ことができ、ラ
 	import 'myNicePlugin.vim'
 	call myNicePlugin.NiceInit('today')
 
-これは Vim9 script からエクスポートされた "NiceInit" 関数を見付けそれをスクリ
-プトローカルなアイテム "myNicePlugin.NiceInit" として利用可能にします。"s:" を
-指定しなくても `:import` は常にスクリプトの名前空間を使います。もし
-"myNicePlugin.vim" がすでに読み込み済みであれば再度読み込まれることはありませ
-ん。
+これは、Vim9 script ファイル内でエクスポートされた関数 "NiceInit" を見つけ、ス
+クリプトローカルな項目 "myNicePlugin.NiceInit" として使用できるようにします。
+`:import` は、"s:" が指定されていない場合でも、常にスクリプトの名前空間を使用
+します。"myNicePlugin.vim" がすでに読み込まれていた場合、再度読み込まれること
+はありません。
 
 その上アイテムがグローバルの名前空間に置かれるのを防ぎ (名前の衝突が不測の問題
 になり得ます)、そしてたとえ何度もアイテムをインポートしても、スクリプトの読み