Add note about __module__ checking.

1 files changed, 7 insertions, 0 deletions

diff --git a/doc/ext/autodoc.rst b/doc/ext/autodoc.rst
index 4af04555c..1c8d36dd0 100644
--- a/doc/ext/autodoc.rst
+++ b/doc/ext/autodoc.rst
@@ -77,6 +77,13 @@ directive.
 
             Boil the noodle *time* minutes.
 
+   .. note::
+
+      In an :dir:`automodule` directive with the ``members`` option set, only
+      module members whose ``__module__`` attribute is equal to the module name
+      as given to ``automodule`` will be documented.  This is to prevent
+      documentation of imported classes or functions.
+
 
 .. directive:: autofunction
                automethod