From a096a2e6a29a6232c72965f179bb4f0c9f762c6a Mon Sep 17 00:00:00 2001 From: Guido van Rossum Date: Mon, 2 Nov 1998 17:02:42 +0000 Subject: [PATCH] Warn that AddModule doesn't import the module. --- Doc/api/api.tex | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/Doc/api/api.tex b/Doc/api/api.tex index 48da118962a..95b31587bd7 100644 --- a/Doc/api/api.tex +++ b/Doc/api/api.tex @@ -983,7 +983,12 @@ Return the module object corresponding to a module name. The check the modules dictionary if there's one there, and if not, create a new one and insert in in the modules dictionary. Because the former action is most common, this does not return a new reference, and you -do not own the returned reference. Return \NULL{} with an +do not own the returned reference. +Warning: this function does not load or import the module; if the +module wasn't already loaded, you will get an empty module object. +Use \cfunction{PyImport_ImportModule()} or one of its variants to +import a module. +Return \NULL{} with an exception set on failure. \strong{Note:} this function returns a ``borrowed'' reference. \end{cfuncdesc}