3 files changed, 13 insertions, 0 deletions
diff --git a/dmydln.c b/dmydln.c
index b1516937d3..35824ebec8 100644
--- a/dmydln.c
+++ b/dmydln.c
@@ -1,3 +1,6 @@
+// This file is used by miniruby, not ruby.
+// ruby uses dln.c.
+
 #include "ruby/ruby.h"
 
 NORETURN(void *dln_load(const char *));
diff --git a/dmyenc.c b/dmyenc.c
index 75b8a2da43..d00ad80a6f 100644
--- a/dmyenc.c
+++ b/dmyenc.c
@@ -1,3 +1,8 @@
+// This file is used only by ruby.
+// miniruby does not use this Init_enc. Instead, "miniinit.c" provides Init_enc, which defines only the builtin encodings.
+// Dynamically-linked ruby uses this Init_enc, which requires "enc/encdb.so" to load the builtin encodings and set up the optional encodings.
+// Statically-linked ruby does not use this Init_enc. Instead, "enc/encinit.c" (which is a generated file) defines Init_enc, which activates the encodings.
+
 #define require(name) ruby_require_internal(name, (unsigned int)sizeof(name)-1)
 int ruby_require_internal(const char *, int);
 
diff --git a/dmyext.c b/dmyext.c
index 4d273f7faf..0020246529 100644
--- a/dmyext.c
+++ b/dmyext.c
@@ -1,3 +1,8 @@
+// This file is used by dynamically-linked ruby and miniruby.
+// miniruby uses this Init_ext, which does nothing. It does not support require'ing extension libraries.
+// Dynamically-linked ruby uses this Init_ext, which does nothing. It loads extension libraries by dlopen, etc.
+// Statically-linked ruby does not use this Init_ext. Instead, "ext/extinit.c" (which is a generated file) defines Init_ext, which activates the (statically-linked) extension libraries.
+
 void
 Init_ext(void)
 {