[Python-checkins] [3.11] gh-103886: Improve `builtins.__doc__` (GH-104179) (#104257)

[JelleZijlstra]

https://github.com/python/cpython/commit/8f23cadc4ca0c56e18c32985ae0c087e79633c0f
commit: 8f23cadc4ca0c56e18c32985ae0c087e79633c0f
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: JelleZijlstra <jelle.zijlstra at gmail.com>
date: 2023-05-07T02:28:04Z
summary:

[3.11] gh-103886: Improve `builtins.__doc__` (GH-104179) (#104257)

gh-103886: Improve `builtins.__doc__` (GH-104179)
(cherry picked from commit b35711d17a90251bdd57d255090e07daafe89f6c)

Co-authored-by: Tomas R <tomas.roun8 at gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra at gmail.com>

files:
M Python/bltinmodule.c

diff --git a/Python/bltinmodule.c b/Python/bltinmodule.c
index 6c8725f98231..e20bd5396bf5 100644
--- a/Python/bltinmodule.c
+++ b/Python/bltinmodule.c
@@ -2999,9 +2999,16 @@ static PyMethodDef builtin_methods[] = {
 };
 
 PyDoc_STRVAR(builtin_doc,
-"Built-in functions, exceptions, and other objects.\n\
+"Built-in functions, types, exceptions, and other objects.\n\
 \n\
-Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.");
+This module provides direct access to all 'built-in'\n\
+identifiers of Python; for example, builtins.len is\n\
+the full name for the built-in function len().\n\
+\n\
+This module is not normally accessed explicitly by most\n\
+applications, but can be useful in modules that provide\n\
+objects with the same name as a built-in value, but in\n\
+which the built-in of that name is also needed.");
 
 static struct PyModuleDef builtinsmodule = {
     PyModuleDef_HEAD_INIT,