gh-103886: Improve builtins.__doc__

[tomasr8]

I basically took the explanation from the docs since the module's already explained very well there.

I thought it wasn't necessary to point out Ellipsis specifically while not mentioning any other objects (and you can always use ... instead of Ellipsis anyway..)

• Issue: Improve builtins.__doc__ #103886

[JelleZijlstra]

Looks pretty good, thanks! I'll ask for some more feedback from others.

[ghost]

All commit authors signed the Contributor License Agreement.

[erlend-aasland]

@tomasr8: note that we do not use force-push in our workflow. Force-pushing does not play well with the GitHub UI, and it can be frustrating for the reviewer. So, for the reviewers convenience, please use git merge --no-ff main in the future :)

[erlend-aasland]

See also: https://devguide.python.org/getting-started/pull-request-lifecycle/

[tomasr8]

I accidentally committed with the wrong email 😄 (not under CLA) so force pushing was necessary to fix that.. sorry about that

[AlexWaygood]

This looks great!

On current main:

>>> import builtins
>>> help(builtins)
Help on built-in module builtins:

NAME
    builtins - Built-in functions, exceptions, and other objects.

DESCRIPTION
    Noteworthy: None is the `nil' object; Ellipsis represents `...' in slices.

(etc. for many lines)

With this PR (after rebuilding Python):

>>> import builtins
>>> help(builtins)
Help on built-in module builtins:

NAME
    builtins - Built-in functions, types, exceptions, and other objects.

DESCRIPTION
    This module provides direct access to all 'built-in'
    identifiers of Python; for example, builtins.open is
    the full name for the built-in function open().

    This module is not normally accessed explicitly by most
    applications, but can be useful in modules that provide
    objects with the same name as a built-in value, but in
    which the built-in of that name is also needed.

The new version is far more helpful.

[erlend-aasland]

BTW, we don't need a NEWS entry for this. Can you please remove it?

[miss-islington]

Thanks @tomasr8 for the PR, and @JelleZijlstra for merging it 🌮🎉.. I'm working now to backport this PR to: 3.11.
🐍🍒⛏🤖

[bedevere-bot]

GH-104257 is a backport of this pull request to the 3.11 branch.