From 1f7000808e8385e2a29ffd0ef6aac9a6139d3d92 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Fri, 10 Dec 2021 16:32:13 -0800 Subject: bpo-19737: Improved the documentation for globals (GH-29823) (GH-30041) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Alex Waygood Co-authored-by: Łukasz Langa (cherry picked from commit 4fe5585240f64c3d14eb635ff82b163f92074b3a) Co-authored-by: 180909 <734461790@qq.com> --- Doc/library/functions.rst | 6 +++--- .../next/Documentation/2021-11-28-22-43-21.bpo-19737.cOOubB.rst | 1 + 2 files changed, 4 insertions(+), 3 deletions(-) create mode 100644 Misc/NEWS.d/next/Documentation/2021-11-28-22-43-21.bpo-19737.cOOubB.rst 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. -- cgit v0.12