Kernel#require documentation is incomplete
The documentation for Kernel#require could benefit from additional description.
It does not describe what a return method of false means. Many people initially think that a return value of false means that the require method was unsuccessful. See, for example, http://stackoverflow.com/q/1250329/38765 and http://stackoverflow.com/q/1793693/38765 . So explaining that it merely means that the library has already been loaded would be useful.
Mentioning that a LoadError is raised if unsuccessful would also be nice.
As a side issue, "it's" is used when it should be "its". The former means "it is", while the latter mean "something belonging to it".
- load.c (rb_f_require): Improve documentation of Kernel#require. [Ruby 1.9 - Bug #5210]
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@33027 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Updated by drbrain (Eric Hodel) over 7 years ago
- Status changed from Open to Closed
- % Done changed from 0 to 100