RubyGems' `Kernel#require` overrides original documentation

[peterzhu2118]

The documentation for RubyGems' Kernel#require documentation overrides the original Kernel#require defined in load.c. This can be seem here. What's the best way to ignore RubyGems' Kernel#require in the Ruby docs so that the original Kernel#require documentation is used instead?

[nobu]

Exclude kernel_require.rb?

diff --git a/common.mk b/common.mk
index 8891b65ed9b..a6af7aa0628 100644
--- a/common.mk
+++ b/common.mk
@@ -75,6 +75,7 @@ HTMLOUT       = $(EXTOUT)/html
 CAPIOUT       = doc/capi
 INSTALL_DOC_OPTS = --rdoc-output="$(RDOCOUT)" --html-output="$(HTMLOUT)"
 RDOC_GEN_OPTS = --no-force-update \
+	--exclude '^lib/rubygems/core_ext/kernel_require.rb$$' \
 	$(empty)
 
 INITOBJS      = dmyext.$(OBJEXT) dmyenc.$(OBJEXT)

[nobu]

Another way is to move that doc from load.c to kernel.rb.

[peterzhu2118]

Another way is to move that doc from load.c to kernel.rb.

I like this approach more since it fixes it for both using the rdoc command and using the make target. I opened a PR at ruby/ruby#16040.

[nobu]

It depends on that kernel.rb happens to come before lib/, so it's a bit questionable.