https://github.com/python/cpython/commit/d334122d2295a4863384676a3ce313a831b12335
commit: d334122d2295a4863384676a3ce313a831b12335
branch: 3.12
author: Miss Islington (bot) <[email protected]>
committer: encukou <[email protected]>
date: 2024-02-05T10:53:57+01:00
summary:

[3.12] GH-69695: Update ``PyImport_ImportModule`` description (GH-103836) 
GH-114925)

GH-69695: Update ``PyImport_ImportModule`` description (GH-103836)

(cherry picked from commit 9872855a31720f514b84373848b49fca09d66ecd)

Co-authored-by: patenaud <[email protected]>
Co-authored-by: Alex Waygood <[email protected]>
Co-authored-by: Adam Turner <[email protected]>

files:
M Doc/c-api/import.rst

diff --git a/Doc/c-api/import.rst b/Doc/c-api/import.rst
index 3bc256bd08ffe8..5b24ba1dbb70a8 100644
--- a/Doc/c-api/import.rst
+++ b/Doc/c-api/import.rst
@@ -13,20 +13,8 @@ Importing Modules
       single: __all__ (package variable)
       single: modules (in module sys)
 
-   This is a simplified interface to :c:func:`PyImport_ImportModuleEx` below,
-   leaving the *globals* and *locals* arguments set to ``NULL`` and *level* set
-   to 0.  When the *name*
-   argument contains a dot (when it specifies a submodule of a package), the
-   *fromlist* argument is set to the list ``['*']`` so that the return value 
is the
-   named module rather than the top-level package containing it as would 
otherwise
-   be the case.  (Unfortunately, this has an additional side effect when 
*name* in
-   fact specifies a subpackage instead of a submodule: the submodules 
specified in
-   the package's ``__all__`` variable are  loaded.)  Return a new reference to 
the
-   imported module, or ``NULL`` with an exception set on failure.  A failing
-   import of a module doesn't leave the module in :data:`sys.modules`.
-
-   This function always uses absolute imports.
-
+   This is a wrapper around :c:func:`PyImport_Import()` which takes a
+   :c:expr:`const char *` as an argument instead of a :c:expr:`PyObject *`.
 
 .. c:function:: PyObject* PyImport_ImportModuleNoBlock(const char *name)
 

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]

Reply via email to