summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2021-12-11 00:32:13 (GMT)
committerGitHub <noreply@github.com>2021-12-11 00:32:13 (GMT)
commit1f7000808e8385e2a29ffd0ef6aac9a6139d3d92 (patch)
tree976ae5adb5cf61e9cd7fa40d4392df84afdb9801
parent0f21bac6ce1c688bbe82fcb055e0a59926e43249 (diff)
downloadcpython-1f7000808e8385e2a29ffd0ef6aac9a6139d3d92.zip
cpython-1f7000808e8385e2a29ffd0ef6aac9a6139d3d92.tar.gz
cpython-1f7000808e8385e2a29ffd0ef6aac9a6139d3d92.tar.bz2
bpo-19737: Improved the documentation for globals (GH-29823) (GH-30041)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com> Co-authored-by: Ɓukasz Langa <lukasz@langa.pl> (cherry picked from commit 4fe5585240f64c3d14eb635ff82b163f92074b3a) Co-authored-by: 180909 <734461790@qq.com>
-rw-r--r--Doc/library/functions.rst6
-rw-r--r--Misc/NEWS.d/next/Documentation/2021-11-28-22-43-21.bpo-19737.cOOubB.rst1
2 files changed, 4 insertions, 3 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 307d679..a117d30 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -733,9 +733,9 @@ are always available. They are listed here in alphabetical order.
.. function:: globals()
- Return a dictionary representing the current global symbol table. This is always
- the dictionary of the current module (inside a function or method, this is the
- module where it is defined, not the module from which it is called).
+ Return the dictionary implementing the current module namespace. For code within
+ functions, this is set when the function is defined and remains the same
+ regardless of where the function is called.
.. function:: hasattr(object, name)
diff --git a/Misc/NEWS.d/next/Documentation/2021-11-28-22-43-21.bpo-19737.cOOubB.rst b/Misc/NEWS.d/next/Documentation/2021-11-28-22-43-21.bpo-19737.cOOubB.rst
new file mode 100644
index 0000000..a3e16c9
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2021-11-28-22-43-21.bpo-19737.cOOubB.rst
@@ -0,0 +1 @@
+Update the documentation for the :func:`globals` function.