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

Thu Nov 29 18:52:32 CET 2012

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
