From a096a2e6a29a6232c72965f179bb4f0c9f762c6a Mon Sep 17 00:00:00 2001
From: Guido van Rossum <guido@python.org>
Date: Mon, 2 Nov 1998 17:02:42 +0000
Subject: 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 48da118..95b3158 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}
-- 
cgit v0.12

