Issue #16194: document imp.load_dynamic problems

when read several extension modules from the same binary object file.

diff --git a/Doc/library/imp.rst b/Doc/library/imp.rst
index 02c2cf98837adb06e2179906ad43af0be9b41b64..04bc6f58775c2b14f7e29d4b600db93fc445e9ec 100644 (file)
--- a/Doc/library/imp.rst
+++ b/Doc/library/imp.rst
@@ -237,6 +237,17 @@ around for backward compatibility:
    using shared libraries is highly system dependent, and not all systems support
    it.)
 
+   .. impl-detail::
+
+    The import internals identify extension modules by filename, so doing
+    ``foo = load_dynamic("foo", "mod.so")`` and
+    ``bar = load_dynamic("bar", "mod.so")`` will result in both foo and bar
+    referring to the same module, regardless of whether or not
+    ``mod.so`` exports an ``initbar`` function. On systems which
+    support them, symlinks can be used to import multiple modules from
+    the same shared library, as each reference to the module will use
+    a different file name.
+
 
 .. function:: load_source(name, pathname[, file])