usr_52.jax: Update Translate

Author: tsuyoshicho

doc/usr_52.jax

@@ -139,120 +139,118 @@ Vim は "lib" を識別せず、ここに任意のスクリプトを置くこと
 ンポート済みスクリプトをロードします。これはエラーが早急に見付かるけれども、時
 間もかかります。この機能をよく使うのでなければ役に立ちません。
 
-Instead of having `import` load the script immediately, it can be postponed
-until needed.  Using the example above, only one change needs to be made in
-the plugin/theplugin.vim script: >
+代わりに `import` で必要になるまで遅延させその時にスクリプトを即時にロードする
+手段を持ちます。上の例を使い、plugin/theplugin.vim スクリプト内を1箇所だけ変更
+してしています: >
 	import autoload "../lib/getmessage.vim"
 
-Nothing in the rest of the script needs to change.  However, the types will
-not be checked.  Not even the existence of the GetMessage() function is
-checked until it is used.  You will have to decide what is more important for
-your script: fast startup or getting errors early.  You can also add the
-"autoload" argument later, after you have checked everything works.
+スクリプトの残りの部分は何も変更する必要はありません。 ただし、型はチェックさ
+れません。既存の GetMessage() 関数と同等ではなく、使用されるまでチェックされま
+せん。スクリプトでより重要なのかを決定する必要があります: 高速な初期化か早期に
+エラーが分るか。また、全部がうまく動くかチェックした後に、 "autoload" 引数を後
+で追加することもできます。
 
 
-AUTOLOAD DIRECTORY
+オートロード ディレクトリ
 
-Another form is to use autoload with a script name that is not an absolute or
-relative path: >
+もう1つの形式は絶対パスでも相対パスでもないスクリプト名で autoload を使用する
+ことです: >
 	import autload "monthlib.vim"
 
-This will search for the script "monthlib.vim" in the autoload directories of
-'runtimepath'.  With Unix one of the directories often is "~/.vim/autoload".
+これはスクリプト "monthlib.vim" を 'runtimepath' のオートロード ディレクトリの
+中から検索します。Unix ではディレクトリの1つとして "~/.vim/autoload" がよくあ
+ります。
 
-The main advantage of this is that this script can be easily shared with other
-scripts.  You do need to make sure that the script name is unique, since Vim
-will search all the "autoload" directories in 'runtimepath', and if you are
-using several plugins with a plugin manager, it may add a directory to
-'runtimepath', each of which might have an "autoload" directory.
+この方法の主要な利点として、このスクリプトを他のスクリプトと共有するのが容易で
+あることです。Vim が 'runtimepath' 内の "autoload" ディレクトリから検索するた
+め、スクリプト名は一意である必要があり、プラグインはいくつかのプラグインマネー
+ジャとともに利用される場合では、'runtimepath' にディレクトリを追加されることが
+あり、それぞれが  "autoload" ディレクトリを持っているためです。
 
-Without autoload: >
+オートロードなしは: >
 	import "monthlib.vim"
 
-Vim will search for the script "monthlib.vim" in the import directories of
-'runtimepath'.  Note that in this case adding or removing "autoload" changes
-where the script is found.  With a relative or absolute path the location does
-not change.
+Vim は 'runtimepath' のディレクトリ内からスクリプト "monthlib.vim" をインポー
+トします。"autoload" の追加や削除する場合はスクリプトが見付かる場所が変わるこ
+とに注意してください。位置が相対および絶対のパスであるなら変化はありません。
 
 ==============================================================================
-*52.3*	Autoloading without import/export
+*52.3*	インポート/エクスポートなしのオートロード
 
 						*write-library-script*
-A mechanism from before import/export is still useful and some users may find
-it a bit simpler.  The idea is that you call a function with a special name.
-That function is then in an autoload script.  We will call that one script a
-library script.
+インポート/エクスポート以前のメカニズムは依然として利用でき一部ユーザーは多少
+単純であると感じるかもしれません。それは特別な名前によって関数を呼ぶというアイ
+デアです。その関数はオートロードスクリプト内にあります。そのスクリプトのことを
+ライブラリスクリプトと呼びます。
 
-The autoload mechanism is based on a function name that has "#" characters: >
+オートロードのメカニズムは関数名が "#" 文字を持っているというのが基礎になって
+います: >
 
 	mylib#myfunction(arg)
 
-Vim will recognize the function name by the embedded "#" character and when
-it is not defined yet search for the script "autoload/mylib.vim" in
-'runtimepath'.  That script must define the "mylib#myfunction()" function.
-Obviously the name "mylib" is the part before the "#" and is used as the name
-of the script, adding ".vim".
+Vim は埋め込まれた "#" 文字によって関数名を認識し、まだ定義がないのであれば
+'runtimepath' 内のスクリプト "autoload/mylib.vim" を検索します。そのスクリプト
+は "mylib#myfunction()" 関数を定義する必要があります。名前 "mylib" を "#" の前
+部分と ".vim" を追加して、スクリプトの名前に使用するというのが一目瞭然です。
 
-You can put many other functions in the mylib.vim script, you are free to
-organize your functions in library scripts.  But you must use function names
-where the part before the '#' matches the script name.  Otherwise Vim would
-not know what script to load.  This is where it differs from the import/export
-mechanism.
+mylib.vim スクリプト内に他に多数の関数を置ことができ、ライブラリスクリプト内の
+構成が自由です。しかし '#' の前部分がスクリプト名に一致する関数名を使用する必
+要があります。そうでないと、Vim はロードするスクリプトが何であるか分らなくなり
+ます。この点がインポート/エクスポートメカニズムとの違いになります。
 
-If you get really enthusiastic and write lots of library scripts, you may
-want to use subdirectories.  Example: >
+実際に夢中になり多数のライブラリスクリプトを書くのであれば、サブディレクトリを
+使用したいでしょう。例: >
 
 	netlib#ftp#read('somefile')
 
-Here the script name is taken from the function name up to the last "#". The
-"#" in the middle are replaced by a slash, the last one by ".vim".  Thus you
-get "netlib/ftp.vim".  For Unix the library script used for this could be:
+関数名の最後の "#" より上からスクリプト名が取れます。途中にある "#" はスラッ
+シュに置き換え、最後の1つは ".vim" にします。つまり、"netlib/ftp.vim" が得られ
+ます。Unix の場合、これに使用されるライブラリスクリプトは次のようになります:
 
 	~/.vim/autoload/netlib/ftp.vim
 
-Where the function is defined like this: >
+ここで関数の定義はこうなります: >
 
 	def netlib#ftp#read(fname: string)
 		#  Read the file fname through ftp
 	enddef
 
-Notice that the name the function is defined with is exactly the same as the
-name used for calling the function.  And the part before the last '#'
-exactly matches the subdirectory and script name.
+関数の名前は呼び出して利用する関数の名前と厳密に同じに定義されていることに注意
+しましょう。そして最後の '#' の前部分がサブディレクトリとスクリプト名と厳密に
+一致します。
 
-You can use the same mechanism for variables: >
+変数にも同じメカニズムが使用できます: >
 
 	var weekdays = dutch#weekdays
 
-This will load the script "autoload/dutch.vim", which should contain something
-like: >
+これにより スクリプト "autoload/dutch.vim" がロードされ、次のような内容が含ま
+れる必要があります: >
 
 	var dutch#weekdays = ['zondag', 'maandag', 'dinsdag', 'woensdag',
 		\ 'donderdag', 'vrijdag', 'zaterdag']
 
-Further reading: |autoload|.
+参考文献: |autoload|。
 
 ==============================================================================
-*52.4*	Other mechanisms to use
+*52.4*	使用する他のメカニズム
 
-Some may find the use of several files a hassle and prefer to keep everything
-together in one script.  To avoid this resulting in slow startup there is a
-mechanism that only defines a small part and postpones the rest to when it is
-actually used.  *write-plugin-quickload*
+複数のファイルを使用するのが面倒で、すべてを1つのスクリプトにまとめておくのを
+好む人もいます。その結果として起動が遅くなるのを回避するため、小さく一部を定義
+し残りを実際に使用するまで遅延するメカニズムがあります。
+						*write-plugin-quickload*
 
-The basic idea is that the plugin is loaded twice.  The first time user
-commands and mappings are defined that offer the functionality.  The second
-time the functions that implement the functionality are defined.
+基本的なアイデアはプラグインを2回ロードするというものです。初回は機能を呼び出
+すユーザーコマンドとマッピングを定義します。2回目では機能を実装している関数を
+定義する。
 
-It may sound surprising that quickload means loading a script twice.  What we
-mean is that it loads quickly the first time, postponing the bulk of the
-script to the second time, which only happens when you actually use it.  When
-you always use the functionality it actually gets slower!
+高速ロードがスクリプトの2回ロードを意味するのは意外に思えるかもしません。これ
+は初回は素早く、2回目は延期したスクリプトのかたまりのロードを意味し、実際に使
+用する時のみ起きます。常に機能を使用のであれば実際のところ遅くなってしまいます!
 
-This uses a FuncUndefined autocommand.  This works differently from the
-|autoload| functionality explained above.
+これには FuncUndefined 自動コマンドを使用します。これは上で説明した |autoload|
+の機能とは違った動きです。
 
-The following example shows how it's done: >
+如何の例ではどのようにすべきかを示しています: >
 
 	" Vim global plugin for demonstrating quick loading
 	" Last Change:	2005 Feb 25
@@ -278,36 +276,35 @@ The following example shows how it's done: >
 		" write functionality here
 	endfunction
 
-When the script is first loaded "s:did_load" is not set.  The commands between
-the "if" and "endif" will be executed.  This ends in a |:finish| command, thus
-the rest of the script is not executed.
+スクリプトの初回ロード時は "s:did_load" は未設定です。"if" と "endif" の間のコ
+マンドが実行されます。これは |:finish| コマンドで終わり、残りのスクリプトは実
+行されません。
 
-The second time the script is loaded "s:did_load" exists and the commands
-after the "endif" are executed.  This defines the (possible long)
-BufNetRead() and BufNetWrite() functions.
+スクリプトの2回目ロード時は "s:did_load" は存在し "endif" 以降のコマンドが実行
+されます。これは(長い可能性のある) BufNetRead() と BufNetWrite() 関数を定義し
+ます。
 
-If you drop this script in your plugin directory Vim will execute it on
-startup.  This is the sequence of events that happens:
+あなたのプラグインディレクト内にスクリプトを置くと Vim は初期化時に実行します。
+このような流れでイベントが発生します:
 
-1. The "BNRead" command is defined and the <F19> key is mapped when the script
-   is sourced at startup.  A |FuncUndefined| autocommand is defined.  The
-   ":finish" command causes the script to terminate early.
+1. スクリプトが初期化時にソースされ "BNRead" コマンドが定義され <F19> キーに
+   マッピングされます。|FuncUndefined| 自動コマンドが定義されます。":finish"
+   コマンドによりスクリプトは早期に終了します。
 
-2. The user types the BNRead command or presses the <F19> key.  The
-   BufNetRead() or BufNetWrite() function will be called.
+2. ユーザーが BNRead コマンドをタイプするか <F19> キーを押します。 BufNetRead()
+   かBufNetWrite() 関数が呼ばれます。
 
-3. Vim can't find the function and triggers the |FuncUndefined| autocommand
-   event.  Since the pattern "BufNet*" matches the invoked function, the
-   command "source fname" will be executed.  "fname" will be equal to the name
-   of the script, no matter where it is located, because it comes from
-   expanding "<sfile>" (see |expand()|).
+3. Vim は関数を見付けることができず、|FuncUndefined| 自動コマンドイベントが発
+   生します。関数呼び出しが "BufNet*" パターンにマッチしたのなら、コマンドとし
+   て "source fname" が実行されます。"fname" はスクリプトの名前に等しく、どこ
+   にあるかは問題ないです、なぜなら "<sfile>" を展開して取っているからです
+   (|expand()| を参照)。
 
-4. The script is sourced again, the "s:did_load" variable exists and the
-   functions are defined.
+4. スクリプトは再度ソースされて、"s:did_load" 変数は存在し関数が定義されます。
 
-Notice that the functions that are loaded afterwards match the pattern in the
-|FuncUndefined| autocommand.  You must make sure that no other plugin defines
-functions that match this pattern.
+ロードされた後の関数が |FuncUndefined| 自動コマンドのパターンにマッチすること
+に注意してください。他のプラグインで定義するパターンにマッチする関数がないよう
+にしないといけません。
 
 ==============================================================================
 *52.5*	旧来のスクリプトから Vim9 script を使う		*source-vim9-script*