From c08c01e427f33de5bf5cbee68bcee2717f35118c Mon Sep 17 00:00:00 2001 From: Zachary Ware Date: Mon, 30 Jun 2025 14:27:09 -0500 Subject: [PATCH 1/4] gh-136145: Define 'standard library' and 'stdlib' in the glossary --- Doc/glossary.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index c5c7994f1262a9..2bd6132510eb16 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -1280,6 +1280,16 @@ Glossary and ending with double underscores. Special methods are documented in :ref:`specialnames`. + standard library + The collection of :term:`packages `, :term:`modules ` + and :term:`extension modules ` distributed as a part + of the official Python interpreter package, or an individual member of + that collection. The exact membership of the collection may vary based + on platform, available system packages, or other criteria. + + stdlib + A synonym for :term:`standard library`. + statement A statement is part of a suite (a "block" of code). A statement is either an :term:`expression` or one of several constructs with a keyword, such From a4a09f1a61f3a25972b2c29d8fd08e2fc408699e Mon Sep 17 00:00:00 2001 From: Zachary Ware Date: Mon, 30 Jun 2025 14:39:04 -0500 Subject: [PATCH 2/4] Correct glossary ordering --- Doc/glossary.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index 2bd6132510eb16..10c2f60cad8cd8 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -1287,9 +1287,6 @@ Glossary that collection. The exact membership of the collection may vary based on platform, available system packages, or other criteria. - stdlib - A synonym for :term:`standard library`. - statement A statement is part of a suite (a "block" of code). A statement is either an :term:`expression` or one of several constructs with a keyword, such @@ -1300,6 +1297,9 @@ Glossary issues such as incorrect types. See also :term:`type hints ` and the :mod:`typing` module. + stdlib + A synonym for :term:`standard library`. + strong reference In Python's C API, a strong reference is a reference to an object which is owned by the code holding the reference. The strong From 4b5f182ea820f92808c7b1dfed9f309e6d809d69 Mon Sep 17 00:00:00 2001 From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Date: Mon, 30 Jun 2025 15:28:49 -0500 Subject: [PATCH 3/4] Reword stdlib entry --- Doc/glossary.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index 10c2f60cad8cd8..2ff99542ecbf7b 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -1298,7 +1298,7 @@ Glossary and the :mod:`typing` module. stdlib - A synonym for :term:`standard library`. + An abbreviation of :term:`standard library`. strong reference In Python's C API, a strong reference is a reference to an object From c51e13c49e6d46063493a39610fed6cba52aba52 Mon Sep 17 00:00:00 2001 From: Zachary Ware Date: Thu, 3 Jul 2025 13:00:20 -0500 Subject: [PATCH 4/4] Rewording --- Doc/glossary.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index 2ff99542ecbf7b..4151406a174eaa 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -1283,9 +1283,12 @@ Glossary standard library The collection of :term:`packages `, :term:`modules ` and :term:`extension modules ` distributed as a part - of the official Python interpreter package, or an individual member of - that collection. The exact membership of the collection may vary based - on platform, available system packages, or other criteria. + of the official Python interpreter package. The exact membership of the + collection may vary based on platform, available system packages, or + other criteria. Documentation can be found at :ref:`library-index`. + + See also :data:`sys.stdlib_module_names` for a list of all possible + standard library module names. statement A statement is part of a suite (a "block" of code). A statement is either