From f3d9a0cc213f8b09155f063e057afb576178557e Mon Sep 17 00:00:00 2001
From: aamine <aamine@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Sun, 30 Dec 2001 19:18:45 +0000
Subject: aamine * lib/net/protocol.rb: Protocol#start returns the return value
 of block. * lib/net/protocol.rb: set timeout limit by default. *
 lib/net/protocol.rb: new methods WriteAdapter#write, puts, print, printf. *
 lib/net/http.rb: rename HTTP#get2 to request_get, post2 to request_post ... *
 lib/net/smtp.rb: should not resolve HELO domain automatically.

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@1951 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 doc/net/http.rd.ja | 60 ++++++++++++++++++++++++++----------------------------
 1 file changed, 29 insertions(+), 31 deletions(-)

(limited to 'doc/net/http.rd.ja')

diff --git a/doc/net/http.rd.ja b/doc/net/http.rd.ja
index 3de2c3611a..7569f98f72 100644
--- a/doc/net/http.rd.ja
+++ b/doc/net/http.rd.ja
@@ -204,15 +204,16 @@ Ruby 1.6 
     プロクシ経由で接続する HTTP オブジェクトならプロクシのポート。
     そうでないなら nil。
 
-: get( path, header = nil, dest = '' )
+: get( path, header = nil )
 : get( path, header = nil ) {|str| .... }
-    サーバ上の path にあるエンティティを取得し、dest に << メソッドを
-    使って書きこみます。また header が nil でなければリクエストを送る
-    ときにその内容を HTTP ヘッダとして書きこみます。header はハッシュで、
-    「ヘッダ名 => 内容」のような形式でなければいけません。
+    サーバ上の path にあるエンティティを取得します。また header が nil
+    でなければ、リクエストを送るときにその内容を HTTP ヘッダとして書き
+    こみます。header はハッシュで、「ヘッダ名 => 内容」のような形式で
+    なければいけません。
 
-    返り値は、バージョン 1.1 では HTTPResponse と dest 二要素の配列です。
-    1.2 では HTTPResponse ただひとつのみです。
+    返り値は、バージョン 1.1 では HTTPResponse とエンティティボディ文字列の
+    二要素の配列です。1.2 では HTTPResponse ただひとつのみです。この場合、
+    エンティティボディは response.body で得られます。
 
     ブロックとともに呼ばれた時はエンティティボディを少しづつブロックに
     与えます。
@@ -237,10 +238,6 @@ Ruby 1.6 
               f.write str
             end
         }
-        # same effect
-        File.open( 'save.txt', 'w' ) {|f|
-            http.get '/~foo/', nil, f
-        }
 
 : head( path, header = nil )
     サーバ上の path にあるエンティティのヘッダのみを取得します。
@@ -260,7 +257,7 @@ Ruby 1.6 
         }
         p response['content-type']
 
-: post( path, data, header = nil, dest = '' )
+: post( path, data, header = nil )
 : post( path, data, header = nil ) {|str| .... }
     サーバ上の path にあるエンティティに対し文字列 data を
     送ります。レスポンスは << メソッドを使って dest に書き
@@ -275,55 +272,54 @@ Ruby 1.6 
     一方 1.2 では全く例外を発生しません。
 
         # version 1.1
-        response, body = http.post( '/cgi-bin/search.rb', 'querytype=subject&target=ruby' )
+        response, body = http.post( '/cgi-bin/search.rb', 'query=subject&target=ruby' )
+
         # version 1.2
-        response = http.post( '/cgi-bin/search.rb', 'querytype=subject&target=ruby' )
-        # compatible for both version
-        response , = http.post( '/cgi-bin/search.rb', 'querytype=subject&target=ruby' )
+        response = http.post( '/cgi-bin/search.rb', 'query=subject&target=ruby' )
+
+        # compatible in both version
+        response , = http.post( '/cgi-bin/search.rb', 'query=subject&target=ruby' )
 
         # using block
         File.open( 'save.html', 'w' ) {|f|
-            http.post( '/cgi-bin/search.rb', 'querytype=subject&target=ruby' ) do |str|
+            http.post( '/cgi-bin/search.rb',
+                       'query=subject&target=ruby' ) do |str|
               f.write str
             end
         }
-        # same effect
-        File.open( 'save.html', 'w' ) {|f|
-            http.post '/cgi-bin/search.rb', 'querytype=subject&target=ruby', nil, f
-        }
 
-: get2( path, header = nil )
-: get2( path, header = nil ) {|response| .... }
+: request_get( path, header = nil )
+: request_get( path, header = nil ) {|response| .... }
     path にあるエンティティを取得します。HTTPResponse
     オブジェクトを返します。
 
     ブロックとともに呼び出されたときは、ブロック実行中は接続を
     維持したまま HTTPResponse オブジェクトをブロックに渡します。
 
-    このメソッドはステータスに関らず例外を発生させません。
+    このメソッドは HTTP プロトコルに関連した例外は発生させません。
 
         # example
-        response = http.get2( '/index.html' )
+        response = http.request_get( '/index.html' )
         p response['content-type']
         puts response.body          # body is already read
 
         # using block
-        http.get2( '/index.html' ) {|response|
+        http.request_get( '/index.html' ) {|response|
             p response['content-type']
             response.read_body do |str|   # read body now
               print str
             end
         }
 
-: post2( path, header = nil )
-: post2( path, header = nil ) {|response| .... }
+: request_post( path, data, header = nil )
+: request_post( path, data, header = nil ) {|response| .... }
     path にあるエンティティを取得します。HTTPResponse
     オブジェクトを返します。
 
     ブロックとともに呼び出されたときは、ボディを読みこむ前に
     HTTPResponse オブジェクトをブロックに渡します。
 
-    このメソッドはステータスに関らず例外を発生させません。
+    このメソッドは HTTP プロトコルに関連した例外は発生させません。
 
         # example
         response = http.post2( '/cgi-bin/nice.rb', 'datadatadata...' )
@@ -341,12 +337,14 @@ Ruby 1.6 
 
 : request( request [, data] )
 : request( request [, data] ) {|response| .... }
-    リクエストオブジェクト request を送信します。POST の時は data も
-    与えられます。(POST 以外で data を与えると ArgumentError を発生します)
+    HTTPResquest オブジェクト request を送信します。POST/PUT の時は data も
+    与えられます (POST/PUT 以外で data を与えると ArgumentError を発生します)。
 
     ブロックとともに呼びだされたときはボディを読みこまずに HTTPResponse
     オブジェクトをブロックに与えます。
 
+    このメソッドは HTTP プロトコルに関連した例外は発生させません。
+
 == class Net::HTTP::Get, Head, Post
 
 HTTP リクエストを抽象化するクラス。key はすべて大文字小文字を
-- 
cgit v1.2.3