-
-
Notifications
You must be signed in to change notification settings - Fork 32.8k
Closed
Labels
docsDocumentation in the Doc dirDocumentation in the Doc dir
Description
The following PR updates signatures for all functions and classes in the builtins
module. They now match the actual signatures or signatures after solving #73536.
- Consistently add the positional-only parameter mark. It is only used in some signatures, but in others it is not clear whether keyword arguments are accepted for all parameters or all parameters are positional-only.
- Changed the names of some positional-only parameters, for example
abs(x)
->abs(number, /)
. - Replace non-Python signatures that use
[...]
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
- gh-137609: Update signatures of builtins in the documentation #137610
- gh-137609: Change names of some positional-only parameters in builtins #137611
- [3.14] gh-137609: Update signatures of builtins in the documentation (GH-137610) #138137
- [3.13] gh-137609: Update signatures of builtins in the documentation (GH-137610) #138138
terryjreedy, Eclips4 and mpkocher
Metadata
Metadata
Assignees
Labels
docsDocumentation in the Doc dirDocumentation in the Doc dir
Projects
Status
Todo