argra****@users*****
argra****@users*****
2011年 3月 21日 (月) 04:05:05 JST
Index: docs/modules/libwww-perl-5.813/Net/HTTP.pod diff -u docs/modules/libwww-perl-5.813/Net/HTTP.pod:1.1 docs/modules/libwww-perl-5.813/Net/HTTP.pod:1.2 --- docs/modules/libwww-perl-5.813/Net/HTTP.pod:1.1 Fri Mar 11 00:53:13 2011 +++ docs/modules/libwww-perl-5.813/Net/HTTP.pod Mon Mar 21 04:05:05 2011 @@ -143,10 +143,9 @@ =end original I<keep-alive> の値を取得/設定できます。 -この値が TRUE の場合、 -リクエストは will be sent with headers indicating that the server should try -to keep the connection open so that multiple requests can be sent. -(TBT) +この値が TRUE の場合、サーバは接続を開いたまま維持しようとするので +複数のリクエストを送ることができることを示すヘッダを付けてリクエストが +送られます。 =begin original @@ -170,12 +169,11 @@ =end original -Get/set the a value indicating if the request will be sent with a "TE" -header to indicate the transfer encodings that the server can choose to -use. If the C<Compress::Zlib> module is installed then this will -announce that this client accept both the I<deflate> and I<gzip> -encodings. -(TBT) +サーバが使うことを選べる転送エンコーディングを示す "TE" ヘッダ付きで +リクエストが送られるかどうかを示す値を取得/設定します。 +C<Compress::Zlib> モジュールがインストールされている場合は、この +クライアントは I<deflate> と I<gzip> のエンコーディングの両方を +受け付けることを通知します。 =item $s->http_version @@ -395,13 +393,13 @@ =end original -The C<laxed> option will make read_response_headers() more forgiving -towards servers that have not learned how to speak HTTP properly. The -C<laxed> option is a boolean flag, and is enabled by passing in a TRUE -value. The C<junk_out> option can be used to capture bad header lines -when C<laxed> is enabled. The value should be an array reference. -Bad header lines will be pushed onto the array. -(TBT) +C<laxed> オプションは、read_response_headers() を、 +HTTP の正しい話し方を学んでいないサーバに対してより寛容ににします。 +C<laxed> オプションは真偽値フラグで、TRUE 値を渡すことで有効になります。 +C<junk_out> オプションは、C<laxed> が有効の時に間違ったヘッダ行を +捕捉するのに使われます。 +値は配列リファレンスです。 +間違ったヘッダ行はこの配列に push されます。 =begin original @@ -413,12 +411,10 @@ =end original -The C<laxed> option must be specified in order to communicate with -pre-HTTP/1.0 servers that don't describe the response outcome or the -data they send back with a header block. For these servers -peer_http_version is set to "0.9" and this method returns (200, -"Assumed OK"). -(TBT) +C<laxed> オプションは、レスポンスやヘッダブロックを返さない、HTTP/1.0 以前の +サーバと通信するために指定しなければなりません。 +これらのサーバのために peer_http_version は "0.9" に設定され、 +このメソッドは (200, "Assumed OK") を返します。 =begin original @@ -431,13 +427,12 @@ =end original -The method will raise an exception (die) if the server does not speak -proper HTTP or if the C<max_line_length> or C<max_header_length> -limits are reached. If the C<laxed> option is turned on and -C<max_line_length> and C<max_header_length> checks are turned off, -then no exception will be raised and this method will always -return a response code. -(TBT) +このメソッドは、サーバが適切な HTTP を話さなかったり +C<max_line_length> や C<max_header_length> の制限に達した場合に +例外を発生させます (die します)。 +C<laxed> オプションを有効にして C<max_line_length> と +C<max_header_length> のチェックを無効にすると、例外が発生することは +なくなり、このメソッドは常にレスポンスコードが返されます。 =item $n = $s->read_entity_body($buf, $size); @@ -450,11 +445,11 @@ =end original -Reads chunks of the entity body content. Basically the same interface -as for read() and sysread(), but the buffer offset argument is not -supported yet. This method should only be called after a successful -read_response_headers() call. -(TBT) +エンティティボディの内容のチャンクを読み込みます。 +基本的に read() および sysread() と同じインターフェースですが、バッファ +オフセット引数はまだ対応していません。 +このメソッドは、read_response_headers() 呼び出しに成功した後にのみ +呼び出されるべきです。 =begin original @@ -464,10 +459,9 @@ =end original -The return value will be C<undef> on read errors, 0 on EOF, -1 if no data -could be returned this time, otherwise the number of bytes assigned -to $buf. The $buf is set to "" when the return value is -1. -(TBT) +返り値は、読み込みエラー時は C<undef>、EOF なら 0、今回データが +返されなければ -1、それ以外は $buf に代入されたバイト数を示します。 +返り値が -1 の場合は $buf には "" が設定されます。 =begin original @@ -478,11 +472,10 @@ =end original -You normally want to retry this call if this function returns either --1 or C<undef> with C<$!> as EINTR or EAGAIN (see L<Errno>). EINTR -can happen if the application catches signals and EAGAIN can happen if -you made the socket non-blocking. -(TBT) +この関数が -1 を返すか、C<undef> が返されて C<$!> が EINTR か +EAGAIN (L<Errno> 参照) の場合、普通はこの呼び出しを繰り返したいはずです。 +EINTR はアプリケーションがシグナルを受けたときに起こることがあり、 +EAGAIN はソケットを非ブロッキングにしたときに起こることがあります。 =begin original @@ -491,9 +484,9 @@ =end original -This method will raise exceptions (die) if the server does not speak -proper HTTP. This can only happen when reading chunked data. -(TBT) +このメソッドは、サーバが適切な HTTP を話さない場合は例外を +起こします(die します)。 +これはデータの塊を読み込み中にのみ起こることがあります。 =item %headers = $s->get_trailers @@ -504,9 +497,9 @@ =end original -After read_entity_body() has returned 0 to indicate end of the entity -body, you might call this method to pick up any trailers. -(TBT) +エンティティボディの終わりを示すために read_entity_body() が 0 を +返した後、末尾に付けるヘッダを取得するためにこのメソッドを呼び出すかも +しれません。 =item $s->_rbuf @@ -519,11 +512,10 @@ =end original -Get/set the read buffer content. The read_response_headers() and -read_entity_body() methods use an internal buffer which they will look -for data before they actually sysread more from the socket itself. If -they read too much, the remaining data will be left in this buffer. -(TBT) +読み込みバッファ内容を取得/設定します。 +read_response_headers() メソッドと read_entity_body() メソッドは +実際にソケット地震から sysread する前にデータを探す内部バッファを使います。 +もし読み込みすぎた場合、残りのデータはこのバッファに残ります。 =item $s->_rbuf_length @@ -561,10 +553,10 @@ =end original -The read_response_headers() and read_entity_body() will invoke the -sysread() method when they need more data. Subclasses might want to -override this method to control how reading takes place. -(TBT) +read_response_headers() と read_entity_body() は、もっとデータが必要な +場合は sysread() メソッドを起動します。 +サブクラスは、読み込みをどのように行うかを制御するためにこのメソッドを +オーバーライドしたいかもしれません。 =begin original
