calendar.setfirstweekday() documented parameter name does not match the implementation

[IbrahimShaqqou]

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)  # OK

The 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

[brettcannon]

Thanks!