Repository navigation
Update signatures of builtins in the documentation #137609
Description
Activity
- added 3 commits that reference this issue
on Aug 10, 2025 And #137611 changes the names of some positional-only parameters to match the documentation if the names in the documentation look better.
I recall why
str.index()etc did not have machine-readable signatures.- They support
Noneas the range limits. Theindex()`` methods in other sequences only accept integers. I was not sure whether acceptingNone` is an official feature or an implementation detail. - The parameter for the upper index in str-like classes has name
end, but in other sequences it has namestop.
- They support
- added a commit that references this issue
on Aug 25, 2025 - added a commit that references this issue
on Aug 27, 2025 - marked Fix/update missing parameters in function signatures for Built-in Functions documentation #90250 as a duplicate of this issue
on Aug 20, 2026
The following PR updates signatures for all functions and classes in the
builtinsmodule. They now match the actual signatures or signatures after solving #73536.abs(x)->abs(number, /).[...]with Python signatures or multiple signatures. For example,str.center(width[, fillchar])->str.center(width, fillchar= ' ', /)andstr.count(sub[, start[, end]])->str.count(sub, start=0, stop=None, /).Linked PRs