Warn people away from PyModule_GetDict(), but not too strongly.

freddrake · freddrake · commit f495ef7466e1 · 2002-04-12T19:32:07.000Z
(The real issue is whether modules can benefit from an alternate
implementation strategy rather than using a dictionary.  We should migrate
away from direct dictionary manipulation to allow more room for Jeremy to
flex the implementation with changes in globals lookup.)
diff --git a/Doc/api/concrete.tex b/Doc/api/concrete.tex
@@ -2111,6 +2111,9 @@ \subsection{Module Objects \label{moduleObjects}}
   namespace; this object is the same as the \member{__dict__}
   attribute of the module object.  This function never fails.
   \withsubitem{(module attribute)}{\ttindex{__dict__}}
+  It is recommended extensions use other \cfunction{PyModule_*()}
+  and \cfunction{PyObject_*()} functions rather than directly
+  manipulate a module's \member{__dict__}.
 \end{cfuncdesc}
 
 \begin{cfuncdesc}{char*}{PyModule_GetName}{PyObject *module}
