[Python-checkins] python/dist/src/Doc/api utilities.tex,1.3.8.1,1.3.8.2

[fdrake@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/api
In directory usw-pr-cvs1:/tmp/cvs-serv5410

Modified Files:
      Tag: release22-maint
	utilities.tex 
Log Message:
Clarify that PyImport_AddModule() and PyImport_ExecCodeModule() don't
add any package support structure even if a dotted-name is passed for
the module.
Closes SF bug #424106.


Index: utilities.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/utilities.tex,v
retrieving revision 1.3.8.1
retrieving revision 1.3.8.2
diff -C2 -d -r1.3.8.1 -r1.3.8.2
*** utilities.tex	17 Jun 2002 15:45:21 -0000	1.3.8.1
--- utilities.tex	13 Nov 2002 15:15:11 -0000	1.3.8.2
***************
*** 149,156 ****
    First check the modules dictionary if there's one there, and if not,
    create a new one and insert in in the modules dictionary.
    \note{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.}
  \end{cfuncdesc}
  
--- 149,158 ----
    First check the modules dictionary if there's one there, and if not,
    create a new one and insert in in the modules dictionary.
+   Return \NULL{} with an exception set on failure.
    \note{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.  Package structures implied by a dotted name for
!   \var{name} are not created if not already present.}
  \end{cfuncdesc}
  
***************
*** 161,166 ****
    the module.  Return a new reference to the module object, or \NULL{}
    with an exception set if an error occurred (the module may still be
!   created in this case).  (This function would reload the module if it
!   was already imported.)
  \end{cfuncdesc}
  
--- 163,170 ----
    the module.  Return a new reference to the module object, or \NULL{}
    with an exception set if an error occurred (the module may still be
!   created in this case).  This function would reload the module if it
!   was already imported.  If \var{name} points to a dotted name of the
!   form \code{package.module}, any package structures not already
!   created will still not be created.
  \end{cfuncdesc}