1 files changed, 3 insertions, 2 deletions
diff --git a/io.c b/io.c
index b789e9f78d..116d3aa8f6 100644
--- a/io.c
+++ b/io.c
@@ -1351,8 +1351,9 @@ io_getpartial(int argc, VALUE *argv, VALUE io, int nonblock)
  *  The later means that readpartial is nonblocking-flag insensitive.
  *  It blocks on the situation IO#sysread causes Errno::EAGAIN as if the fd is blocking mode.
  *
- *  Since readpartial bypass internal stdio buffering mechanism,
- *  IO#pos may return wrong value after readpartial.
+ *  Since readpartial uses read system call directly,
+ *  the stdio buffering mechanism may confuse the file offset.
+ *  So IO#pos may return wrong value after readpartial.
  *  This problem is fixed by Ruby 1.9 which doesn't use stdio.
  */