From bc1a02b7cfb3025d09565cb4b032327cd54a4e5b Mon Sep 17 00:00:00 2001
From: akr <akr@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Mon, 24 Jan 2005 11:43:12 +0000
Subject: fix IO#read docment.

git-svn-id: http://svn.ruby-lang.org/repos/ruby/branches/ruby_1_8@7819 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 io.c | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/io.c b/io.c
index 1085e81c5..b8e25c19e 100644
--- a/io.c
+++ b/io.c
@@ -1223,14 +1223,20 @@ io_readpartial(int argc, VALUE *argv, VALUE io)
 
 /*
  *  call-seq:
- *     ios.read([integer [, buffer]])    => string, buffer, or nil
- *  
- *  Reads at most <i>integer</i> bytes from the I/O stream, or to the
- *  end of file if <i>integer</i> is omitted or is <code>nil</code>.
+ *     ios.read([length [, buffer]])    => string, buffer, or nil
+ *
+ *  Reads at most <i>length</i> bytes from the I/O stream, or to the
+ *  end of file if <i>length</i> is omitted or is <code>nil</code>.
+ *  <i>length</i> must be a non-negative integer or nil.
  *  If the optional <i>buffer</i> argument is present, it must reference
- *  a String, which will receive the data. Returns <code>nil</code>
- *  if called at end of file.
- *     
+ *  a String, which will receive the data.
+ *
+ *  At end of file, it returns <code>nil</code> or <code>""</code>
+ *  depend on <i>length</i>.
+ *  <code><i>ios</i>.read()</code> and
+ *  <code><i>ios</i>.read(nil)</code> returns <code>""</code>.
+ *  <code><i>ios</i>.read(<i>positive-integer</i>)</code> returns nil.
+ *
  *     f = File.new("testfile")
  *     f.read(16)   #=> "This is line one"
  */
-- 
cgit