hsbt	2013-03-31 10:47:47 +0900 (Sun, 31 Mar 2013)

  New Revision: 40014

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=40014

  Log:
    Document the default Net timeout values by @toolmantim [GH fixes #269]
    
     * lib/net/{ftp,http,pop,smtp}.rb: added documentation for default values.

  Modified files:
    trunk/lib/net/ftp.rb
    trunk/lib/net/http.rb
    trunk/lib/net/pop.rb
    trunk/lib/net/smtp.rb

Index: lib/net/pop.rb
===================================================================
--- lib/net/pop.rb	(revision 40013)
+++ lib/net/pop.rb	(revision 40014)
@@ -496,12 +496,12 @@ module Net https://github.com/ruby/ruby/blob/trunk/lib/net/pop.rb#L496
 
     # Seconds to wait until a connection is opened.
     # If the POP3 object cannot open a connection within this time,
-    # it raises a Net::OpenTimeout exception.
+    # it raises a Net::OpenTimeout exception. The default value is 30 seconds.
     attr_accessor :open_timeout
 
     # Seconds to wait until reading one block (by one read(1) call).
     # If the POP3 object cannot complete a read() within this time,
-    # it raises a Net::ReadTimeout exception.
+    # it raises a Net::ReadTimeout exception. The default value is 60 seconds.
     attr_reader :read_timeout
 
     # Set the read timeout.
Index: lib/net/http.rb
===================================================================
--- lib/net/http.rb	(revision 40013)
+++ lib/net/http.rb	(revision 40014)
@@ -701,13 +701,13 @@ module Net   #:nodoc: https://github.com/ruby/ruby/blob/trunk/lib/net/http.rb#L701
     # Number of seconds to wait for the connection to open. Any number
     # may be used, including Floats for fractional seconds. If the HTTP
     # object cannot open a connection in this many seconds, it raises a
-    # Net::OpenTimeout exception.
+    # Net::OpenTimeout exception. The default value is +nil+.
     attr_accessor :open_timeout
 
     # Number of seconds to wait for one block to be read (via one read(2)
     # call). Any number may be used, including Floats for fractional
     # seconds. If the HTTP object cannot read data in this many seconds,
-    # it raises a Net::ReadTimeout exception.
+    # it raises a Net::ReadTimeout exception. The default value is 60 seconds.
     attr_reader :read_timeout
 
     # Setter for the read_timeout attribute.
@@ -716,8 +716,9 @@ module Net   #:nodoc: https://github.com/ruby/ruby/blob/trunk/lib/net/http.rb#L716
       @read_timeout = sec
     end
 
-    # Seconds to wait for 100 Continue response.  If the HTTP object does not
-    # receive a response in this many seconds it sends the request body.
+    # Seconds to wait for 100 Continue response. If the HTTP object does not
+    # receive a response in this many seconds it sends the request body. The
+    # default value is +nil+.
     attr_reader :continue_timeout
 
     # Setter for the continue_timeout attribute.
Index: lib/net/smtp.rb
===================================================================
--- lib/net/smtp.rb	(revision 40013)
+++ lib/net/smtp.rb	(revision 40014)
@@ -362,12 +362,12 @@ module Net https://github.com/ruby/ruby/blob/trunk/lib/net/smtp.rb#L362
 
     # Seconds to wait while attempting to open a connection.
     # If the connection cannot be opened within this time, a
-    # Net::OpenTimeout is raised.
+    # Net::OpenTimeout is raised. The default value is 30 seconds.
     attr_accessor :open_timeout
 
     # Seconds to wait while reading one block (by one read(2) call).
     # If the read(2) call does not complete within this time, a
-    # Net::ReadTimeout is raised.
+    # Net::ReadTimeout is raised. The default value is 60 seconds.
     attr_reader :read_timeout
 
     # Set the number of seconds to wait until timing-out a read(2)
Index: lib/net/ftp.rb
===================================================================
--- lib/net/ftp.rb	(revision 40013)
+++ lib/net/ftp.rb	(revision 40014)
@@ -97,13 +97,13 @@ module Net https://github.com/ruby/ruby/blob/trunk/lib/net/ftp.rb#L97
     # Number of seconds to wait for the connection to open. Any number
     # may be used, including Floats for fractional seconds. If the FTP
     # object cannot open a connection in this many seconds, it raises a
-    # Net::OpenTimeout exception.
+    # Net::OpenTimeout exception. The default value is +nil+.
     attr_accessor :open_timeout
 
     # Number of seconds to wait for one block to be read (via one read(2)
     # call). Any number may be used, including Floats for fractional
     # seconds. If the FTP object cannot read data in this many seconds,
-    # it raises a TimeoutError exception.
+    # it raises a TimeoutError exception. The default value is 60 seconds.
     attr_reader :read_timeout
 
     # Setter for the read_timeout attribute.

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/