argra****@users*****
argra****@users*****
2009年 4月 9日 (木) 00:48:09 JST
Index: docs/modules/libwww-perl-5.813/LWP/UserAgent.pod
diff -u docs/modules/libwww-perl-5.813/LWP/UserAgent.pod:1.3 docs/modules/libwww-perl-5.813/LWP/UserAgent.pod:1.4
--- docs/modules/libwww-perl-5.813/LWP/UserAgent.pod:1.3 Sat Apr 4 01:35:15 2009
+++ docs/modules/libwww-perl-5.813/LWP/UserAgent.pod Thu Apr 9 00:48:08 2009
@@ -783,12 +783,12 @@
=end original
-This method will dispatch a C<GET> request on the given $url. Further
-arguments can be given to initialize the headers of the request. These
-are given as separate name/value pairs. The return value is a
-response object. See L<HTTP::Response> for a description of the
-interface it provides.
-(TBT)
+このメソッドは、与えられた $url に C<GET> リクエストを発行します。
+リクエストのヘッダを初期化するために追加の引数を与えることもできます。
+これらは別々の名前/値の組で与えられます。
+返り値はレスポンスオブジェクトです。
+これが提供するインターフェースの説明については L<HTTP::Response> を
+参照してください。
=begin original
@@ -798,10 +798,10 @@
=end original
-Fields names that start with ":" are special. These will not
-initialize headers of the request but will determine how the response
-content is treated. The following special field names are recognized:
-(TBT)
+":" で始まるフィールド名は特殊です。
+これらはリクエストのヘッダの初期化はせず、レスポンスオブジェクトが
+どのように扱われるかを決定します。
+以下の特殊フィールド名を認識します:
:content_file => $filename
:content_cb => \&callback
@@ -823,18 +823,17 @@
=end original
-If a $filename is provided with the C<:content_file> option, then the
-response content will be saved here instead of in the response
-object. If a callback is provided with the C<:content_cb> option then
-this function will be called for each chunk of the response content as
-it is received from the server. If neither of these options are
-given, then the response content will accumulate in the response
-object itself. This might not be suitable for very large response
-bodies. Only one of C<:content_file> or C<:content_cb> can be
-specified. The content of unsuccessful responses will always
-accumulate in the response object itself, regardless of the
-C<:content_file> or C<:content_cb> options passed in.
-(TBT)
+C<:content_file> オプションで $filename が指定されると、レスポンスの内容は
+レスポンスオブジェクトの代わりにこのファイルに保存されます。
+C<:content_cb> オプションでコールバック関数が指定されると、
+レスポンスの内容の塊ををサーバから受信する毎にこの関数が呼び出されます。
+これらのオプションのどちらも指定されなかった場合、レスポンスの内容は
+レスポンスオブジェクト自身に蓄積されます。
+これはレスポンスボディがとても大きい場合には向いていません。
+C<:content_file> と C<:content_cb> のどちらか一つのみが指定できます。
+失敗したレスポンスの内容は、C<:content_file> や C<:content_cb> の
+オプションが指定されているかどうかに関わらず
+常にレスポンスオブジェクト自身に蓄積されます。
=begin original
@@ -845,11 +844,10 @@
=end original
-The C<:read_size_hint> option is passed to the protocol module which
-will try to read data from the server in chunks of this size. A
-smaller value for the C<:read_size_hint> will result in a higher
-number of callback invocations.
-(TBT)
+C<:read_size_hint> オプションは、このサイズの塊でサーバからデータを
+読み込もうとするようにプロトコルモジュールに渡されます。
+C<:read_size_hint> の値を小さくすると、コールバックの起動回数は
+多くなります。
=begin original
@@ -861,12 +859,12 @@
=end original
-The callback function is called with 3 arguments: a chunk of data, a
-reference to the response object, and a reference to the protocol
-object. The callback can abort the request by invoking die(). The
-exception message will show up as the "X-Died" header field in the
-response returned by the get() function.
-(TBT)
+コールバック関数は 3 引数で呼び出されます: データの塊、
+レスポンスオブジェクトへのリファレンス、プロトコルオブジェクトへの
+リファレンス、です。
+コールバックは die() を起動することでリクエストを中断できます。
+例外メッセージは、get() 関数で返されるレスポンスの中の
+"X-Died" ヘッダフィールドで得られます。
=item $ua->head( $url )
@@ -879,9 +877,8 @@
=end original
-This method will dispatch a C<HEAD> request on the given $url.
-Otherwise it works like the get() method described above.
-(TBT)
+このメソッドは、与えられた $url に C<HEAD> リクエストを発行します。
+その他は上述の get() メソッドと同様に動作します。
=item $ua->post( $url, \%form )
@@ -904,11 +901,10 @@
=end original
-This method will dispatch a C<POST> request on the given $url, with
-%form or @form providing the key/value pairs for the fill-in form
-content. Additional headers and content options are the same as for
-the get() method.
-(TBT)
+このメソッドは、与えられた $url に、フォームの内容として
+%form または @form で与えられるキー/値の組を使って
+C<POST> リクエストを発行します。
+追加のヘッダと内容のオプションは get() メソッドと同じです。
=begin original
@@ -918,10 +914,10 @@
=end original
-This method will use the POST() function from C<HTTP::Request::Common>
-to build the request. See L<HTTP::Request::Common> for a details on
-how to pass form content and other advanced features.
-(TBT)
+このメソッドは、リクエストを構築するために
+C<HTTP::Request::Common> の POST() 関数を使います。
+フォームの内容の渡し方とその他の高度な機能に関する詳細については
+L<HTTP::Request::Common> を参照してください。
=item $ua->mirror( $url, $filename )
@@ -937,14 +933,12 @@
=end original
-This method will get the document identified by $url and store it in
-file called $filename. If the file already exists, then the request
-will contain an "If-Modified-Since" header matching the modification
-time of the file. If the document on the server has not changed since
-this time, then nothing happens. If the document has been updated, it
-will be downloaded again. The modification time of the file will be
-forced to match that of the server.
-(TBT)
+このメソッドは $url で識別されるドキュメントを取得し、$filename で
+指定されるファイルに保管します。
+ファイルが既に存在する場合、リクエストにはそのファイルの修正時刻に一致する
+"If-Modified-Since" ヘッダが含まれます。
+ドキュメントが更新されている場合は、再びダウンロードされます。
+ファイルの修正時刻はサーバ上での修正時刻と同じになります。
=begin original
@@ -952,8 +946,7 @@
=end original
-The return value is the the response object.
-(TBT)
+返り値はレスポンスオブジェクトです。
=item $ua->request( $request )
@@ -973,12 +966,12 @@
=end original
-This method will dispatch the given $request object. Normally this
-will be an instance of the C<HTTP::Request> class, but any object with
-a similar interface will do. The return value is a response object.
-See L<HTTP::Request> and L<HTTP::Response> for a description of the
-interface provided by these classes.
-(TBT)
+このメソッドは与えられた $request オブジェクトを発行します。
+通常これは C<HTTP::Request> クラスの実体ですが、似たような
+インターフェースを持つどのようなオブジェクトでも動作します。
+返り値はレスポンスオブジェクトです。
+これらのクラスによって提供されるインターフェースの記述については
+L<HTTP::Request> と L<HTTP::Response> を参照してください。
=begin original
@@ -988,10 +981,9 @@
=end original
-The request() method will process redirects and authentication
-responses transparently. This means that it may actually send several
-simple requests via the simple_request() method described below.
-(TBT)
+request() メソッドはリダイレクトと認証を透過的に処理します。
+これは、実際には後述する simple_request() メソッドを使って単純な
+リクエストを複数回送信するかもしれないことを意味します。
=begin original
@@ -1002,11 +994,10 @@
=end original
-The request methods described above; get(), head(), post() and
-mirror(), will all dispatch the request they build via this method.
-They are convenience methods that simply hides the creation of the
-request object for you.
-(TBT)
+上述のリクエストメソッド: get(), head(), post(), mirror() は全て
+構築したリクエストをこのメソッド経由で発行します。
+これらは単にリクエストメソッドの作成をあなたから隠すための
+便利メソッドです。
=begin original
@@ -1015,9 +1006,8 @@
=end original
-The $content_file, $content_cb and $read_size_hint all correspond to
-options described with the get() method above.
-(TBT)
+$content_file, $content_cb, $read_size_hint は全て上述の
+get() メソッドで記述したオプションに対応します。
=begin original
@@ -1029,12 +1019,11 @@
=end original
-You are allowed to use a CODE reference as C<content> in the request
-object passed in. The C<content> function should return the content
-when called. The content can be returned in chunks. The content
-function will be invoked repeatedly until it return an empty string to
-signal that there is no more content.
-(TBT)
+リクエストオブジェクトに渡す C<content> としてコードリファレンスも使えます。
+C<content> 関数は、呼び出されたときに内容を返すようにします。
+内容は塊で返すこともできます。
+content 関数は、もう内容がないことを示すために空文字列が返されるまで
+繰り返し起動されます。
=item $ua->simple_request( $request )