[Python-checkins] cpython (2.7): Issue #16194: document imp.load_dynamic problems

[andrew.svetlov]

http://hg.python.org/cpython/rev/94de77bd0b4b
changeset:   80661:94de77bd0b4b
branch:      2.7
parent:      80651:ea4bdf5a2e69
user:        Andrew Svetlov <andrew.svetlov at gmail.com>
date:        Thu Nov 29 19:51:28 2012 +0200
summary:
  Issue #16194: document imp.load_dynamic problems
when read several extension modules from the same binary object file.

files:
  Doc/library/imp.rst |  11 +++++++++++
  1 files changed, 11 insertions(+), 0 deletions(-)


diff --git a/Doc/library/imp.rst b/Doc/library/imp.rst
--- a/Doc/library/imp.rst
+++ b/Doc/library/imp.rst
@@ -237,6 +237,17 @@
    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])
 

-- 
Repository URL: http://hg.python.org/cpython