为什么File.read('/ path/to/file')不在Ruby文档中？

Question

为什么该File.read方法在http://ruby-doc.org/core-2.3.3/File.html中没有记录,当它明确存在时:

$ irb
irb(main):001:0> File.read('readme.md')
=> "hello world"

Answer 1

记录如下:

http://ruby-doc.org/core-2.3.3/IO.html#method-c-read

该方法继承自IO.

Answer 2

使用Ruby来调查:

File.methods.include? :read
 #=> true 
File.methods(false).include? :read                                                                    
 #=> false 
File.ancestors
 #=> [File, IO, File::Constants, Enumerable, Object, Kernel, BasicObject] 
IO.methods(false).include? :read
 #=> true