Repository navigation
calendar.setfirstweekday() documented parameter name does not match the implementation #153853
Description
Documentation
https://docs.python.org/3/library/calendar.html#calendar.setfirstweekday documents the module-level function as setfirstweekday(weekday), but the implementation in Lib/calendar.py is def setfirstweekday(firstweekday). The parameter can be passed by keyword, so the documented signature fails:
>>> import calendar
>>> calendar.setfirstweekday(weekday=calendar.SUNDAY)
Traceback (most recent call last):
...
TypeError: setfirstweekday() got an unexpected keyword argument 'weekday'
>>> calendar.setfirstweekday(firstweekday=calendar.SUNDAY) # OKThe fix is to change the documented signature to setfirstweekday(firstweekday), matching the code and the already-correct Calendar.setfirstweekday(firstweekday) entry in the same document. I have a PR ready: #153851.
Linked PRs
- gh-153853: Fix parameter name of calendar.setfirstweekday() in docs #153851
- [3.15] gh-153853: Fix parameter name of calendar.setfirstweekday() in docs (GH-153851) #153859
- [3.13] gh-153853: Fix parameter name of calendar.setfirstweekday() in docs (GH-153851) #153861
- [3.14] gh-153853: Fix parameter name of calendar.setfirstweekday() in docs (GH-153851) #153860
Activity
gh-153853: Fix parameter name of calendar.setfirstweekday() in docs (#…
brettcannon commentedon Jul 17, 2026
Thanks!
[3.13] gh-153853: Fix parameter name of calendar.setfirstweekday() in…
[3.14] gh-153853: Fix parameter name of calendar.setfirstweekday() in…
[3.15] gh-153853: Fix parameter name of calendar.setfirstweekday() in…