Japanized Perl Resources Project[凍結]

[perldocjp-cvs 1096] CVS update: docs/modules/Furl-0.24/lib/Furl

ktats****@users***** ktats****@users*****
2011年 2月 12日 (土) 11:58:02 JST

• 前の記事 [perldocjp-cvs 1095] CVS update: docs/modules/CGI-3.49
• 次の記事 [perldocjp-cvs 1097] CVS update: docs/modules/Furl-0.24/lib/Furl
• 記事の並び順: [ 日付 ] [ スレッド ] [ 件名 ] [ 著者 ]

Index: docs/modules/Furl-0.24/lib/Furl/HTTP.pod
diff -u docs/modules/Furl-0.24/lib/Furl/HTTP.pod:1.1 docs/modules/Furl-0.24/lib/Furl/HTTP.pod:1.2
--- docs/modules/Furl-0.24/lib/Furl/HTTP.pod:1.1	Thu Feb 10 11:33:30 2011
+++ docs/modules/Furl-0.24/lib/Furl/HTTP.pod	Sat Feb 12 11:58:02 2011
@@ -69,19 +69,30 @@
 
 =end original
 
+新しいFurlクライアントをI<%args>で作ります。エラーがあると死にます。
 
-
+=begin original
 
 I<%args> might be:
 
+=end original
+
+I<%args> は:
+
 =over
 
 =item agent :Str = "Furl/$VERSION"
 
 =item timeout :Int = 10
 
+=begin original
+
 Seconds until the call to $furl->request returns a timeout error (as an internally generated 500 error). The timeout might not be accurate since some underlying modules / built-ins function may block longer than the specified timeout. See the FAQ for how to support timeout during name resolution.
 
+=end original
+
+$furl->request の呼出がタイムアウトえらーを返すまでの秒数(内部的に500エラー)。基礎となるモジュール/組込の関数が指定の時間より長くブロックするかもしれないので、タイムアウトは正確ではないかもせいれません。名前解決時のタイムアウトサポートする方法はFAQを見てください。
+
 =item max_redirects :Int = 7
 
 =item proxy :Str
@@ -92,39 +103,101 @@
 
 =item header_format :Int = HEADERS_AS_ARRAYREF
 
+=begin original
+
 This option choose return value format of C<< $furl->request >>.
 
+=end original
+
+このオプションではC<<$furl->request>>の返す値のフォーマットを選びます。
+
+=begin original
+
 This option allows HEADERS_NONE or HEADERS_AS_ARRAYREF.
 
+=end original
+
+HEADERS_NONE か HEADERS_AS_ARRAYREF を使えます。
+
+=begin original
+
 B<HEADERS_AS_ARRAYREF> is a default value. This makes B<$headers> as ArrayRef.
 
+=end original
+
+B<HEADERS_AS_ARRAYREF>> はデフォルト値です。B<$headers>をArrayRefとして作ります。
+
+=begin original
+
 B<HEADERS_NONE> makes B<$headers> as undef. Furl does not return parsing result of headers. You should take needed headers from B<special_headers>.
 
+=end original
+
+B<HEADERS_NONE> B<$headers> を undef にします。Furlヘッダを解析した結果を返しません。 B<special_headers>から必要なヘッダ受けとるべきです。
+
 =item connection_pool
 
+=begin original
+
 This is the connection pool object for keep-alive requests. By default, it is a instance of L<Furl::ConnectionCache>.
 
+=end original
+
+keep-aliveリクエスト用のコネクションプールオブジェクトです。デフォルトではL<Furl::ConnectionCache>のインスタンスです。
+
+=begin original
+
 You may not customize this variable otherwise to use L<Coro>. This attribute requires a duck type object. It has two methods, C<< $obj->steal($host, $port >> and C<< $obj->push($host, $port, $sock) >>.
 
+=end original
+
+L<Coro> を使う以外の方法でこの値をカスタマイズできないでしょう。このアトリビュートはダックタイプオブジェクトを必要とします。2つのメソッド、C<< $obj->steal($host, $port >> と C<< $obj->push($host, $port, $sock) >> があります。
+
 =item stop_if
 
+=begin original
+
 A callback function that is called by Furl after when a blocking function call returns EINTR. Furl will abort the HTTP request and return immediately if the callback returns true. Otherwise the operation is continued (the default behaviour).
 
+=end original
+
+ブロッキング関数がEINTRを呼んだ後にFurlが呼ぶコールバック関数です。コールバックが真なら、FurlはHTTPリクエストを中断し、即座に戻ります。そうでなければ、オペレーションは続行されます(デフォルトの挙動)。
+
 =item inet_aton
 
+=begin original
+
 A callback function to customize name resolution. Takes two arguments: ($hostname, $timeout_in_seconds). If omitted, Furl calls L<Socket::inet_aton>.
 
+=end original
+
+名前解決をカスタマイズするためのコールバック関数です。2つの引数を取ります:  ($hostname, $timeout_in_seconds)。省略すると、FurlはL<Socket::inet_aton>を呼びます。
+
 =back
 
 =head2 Instance Methods
 
 =head3 C<< $furl->request(%args) :($protocol_minor_version, $code, $msg, \@headers, $body) >>
 
+=begin original
+
 Sends an HTTP request to a specified URL and returns a protocol minor version,
 status code, status message, response headers, response body respectively.
 
+=end original
+
+HTTPリクエストを指定したURLへ送り、プロトコルのマイナーバージョン、ステータスコード、
+ステータースメッセージ、レスポンスヘッダー、レスポンスボディーをそれぞれ返します。
+
+
+=begin original
+
 I<%args> might be:
 
+=end original
+
+I<%args> は:
+
 =over
 
 =item scheme :Str = "http"
@@ -349,14 +422,14 @@
 
 Net::SSL はドキュメントが貧弱です。
 
+=item env_proxy はなぜオプショナルなのですか?
+
 =begin original
 
 =item Why is env_proxy optional?
 
 =end original
 
-=item env_proxy はなぜオプショナルなのですか?
-
 =begin original
 
 Environment variables are highly dependent on each users' environment,
@@ -367,14 +440,14 @@
 環境変数はユーザーの環境に強く依存します。
 うまく動かないときにユーザーを混乱させます。
 
+=item サポートしているオペレーティングシステムは?
+
 =begin original
 
 =item What operating systems are supported?
 
 =end original
 
-=item どのオペレーティングシステムをサポートしますか?
-
 =begin original
 
 Linux 2.6 or higher, OSX Tiger or higher, Windows XP or higher.
@@ -391,14 +464,14 @@
 
 あなたがパッチを送れば、他のオペレーティングシステムもサポートされるでしょう。
 
+=item なぜFurlはチャンクされたアップロードをサポートしないのですか?
+
 =begin original
 
 =item Why doesn't Furl support chunked upload?
 
 =end original
 
-=item なぜFurlはチャンクされたアップロードをサポートしないのですか?
-
 =begin original
 
 There are reasons why chunked POST/PUTs should not be used in general.
@@ -430,7 +503,10 @@
 
 =end original
 
-These facts together makes using chunked requests virtually impossible (unless you _know_ that the server supports HTTP/1.1), and this is why we decided that supporting the feature is NOT of high priority.
+これらの要因でチャンクされたリクエストを使うのは事実上不可能です(サーバがHTTP/1.1をサポートしているとわかっていなければ)。
+そのため、この機能のサポートは高いプライオリティではありません。
+
+=item 到達したレスポンスの内容をどのように作れますか?
 
 =begin original
 
@@ -438,8 +514,6 @@
 
 =end original
 
-=item 到達したレスポンスの内容をどのように作れますか?
-
 =begin original
 
 You can use L<IO::Callback> for this purpose.
@@ -459,14 +533,14 @@
       $furl->put( "http://127.0.0.1:$port/", [ 'Content-Length' => $len ], $fh,
       );
 
+=item gzip/deflate 圧縮されたコミュニケーションを使えますか?
+
 =begin original
 
 =item How do you use gzip/deflate compressed communication?
 
 =end original
 
-=item gzip/deflate 圧縮されたコミュニケーションを使えますか?
-
 =begin original
 
 Add an B<Accept-Encoding> header to your request. Furl inflates response bodies transparently according to the B<Content-Encoding> response header.
@@ -475,14 +549,14 @@
 
 B<Accept-Encoding>ヘッダをリクエストに追加してください。FurlレスポンスボディーをB<Content-Encoding>レスポンスヘッダに従って透過的にインフレートします。
 
+=item mutipart/form-data を使うには?
+
 =begin original
 
 =item How do you use mutipart/form-data?
 
 =end original
 
-=item mutipart/form-data を使うには?
-
 =begin original
 
 You can use multipart/form-data with L<HTTP::Request::Common>.
@@ -513,14 +587,14 @@
 
 パッチを送ることができるなら、L<Furl>でネイティブのmultipart/form-dataサポートは利用可能です。
 
+=item Kee-Alive をどうやって使うのかとHEADメソッドでは何が起きるのか?
+
 =begin original
 
 =item How do you use Keep-Alive and what happens on the HEAD method?
 
 =end original
 
-=item Kee-Alive をどうやって使うのかとHEADメソッドでは何が起きるのか?
-
 =begin original
 
 Furl supports HTTP/1.1, hence C<Keep-Alive>. However, if you use the HEAD
@@ -571,16 +645,14 @@
 いずれにせよ、HEADメソッドは、今日では、そんなに有用ではありません。GETメソッドと
 C<If-Modified-Sinse>のほうがHTTPコンテンツをキャッシュするのに合っています。
 
+=item なぜFurlはタイムアウトエラーを返すまで指定より長くかかるのですか?
+
 =begin original
 
 =item Why does Furl take longer than specified until it returns a timeout error?
 
 =end original
 
-=item Why does Furl take longer than specified until it returns a timeout error?
-
-なぜFurlはタイムアウトエラーを返すまで指定より長くかかるのですか?
-
 =begin original
 
 Although Furl itself supports timeout, some underlying modules / functions do not. And the most noticeable one is L<Socket::inet_aton>, the function used for name resolution (a function that converts hostnames to IP addresses). If you need accurate and short timeout for name resolution, the use of L<Net::DNS::Lite> is recommended. The following code snippet describes how to use the module in conjunction with Furl.
@@ -673,8 +745,14 @@
 
 =head2 貢献するには
 
+=begin original
+
 Please send the pull-req via L<http://github.com/tokuhirom/p5-Furl/>.
 
+=end original
+
+L<http://github.com/tokuhirom/p5-Furl/>にpull-reqを送ってください。
+
 =head1 参照
 
 L<LWP>

• 前の記事 [perldocjp-cvs 1095] CVS update: docs/modules/CGI-3.49
• 次の記事 [perldocjp-cvs 1097] CVS update: docs/modules/Furl-0.24/lib/Furl
• 記事の並び順: [ 日付 ] [ スレッド ] [ 件名 ] [ 著者 ]