Ellipsis documentation

[adorilson]

Explanation

The Ellipsis built-in constant’s documentation says:

The same as the ellipsis literal “...”. Special value used mostly in conjunction with extended slicing syntax for user-defined container data types. Ellipsis is the sole instance of the types.EllipsisType type.

The snippet Special value used mostly in conjunction with extended slicing syntax for user-defined container data types isn’t too helpful.

I think using Ellipsis instead of pass is more common, simple and, mainly, it is built-in.

I suggest adding an Ellipsis’ reference to the pass documentation on the tutorial and replacing the snippet above with a pass reference that includes a link.

PR

I opened a discuss thread some weeks ago. After some discussion, I opened the PR #138306.

Linked PRs

• gh-138307: Update the Ellipsis documentation #138306
• [3.13] gh-138307: Update the Ellipsis documentation (GH-138306) #138439
• [3.14] gh-138307: Update the Ellipsis documentation (GH-138306) #138440