gh-153853: Fix parameter name of calendar.setfirstweekday() in docs

[IbrahimShaqqou]

The module-level function is documented 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

This also makes the entry consistent with Calendar.setfirstweekday(firstweekday) documented earlier in the same file, and with the Calendar(firstweekday=0) constructor and the calendar.firstweekday() accessor.

Docs-only change; per the contributing guidelines, no issue for trivial fixes (skip issue).

• Issue: calendar.setfirstweekday() documented parameter name does not match the implementation #153853

[python-cla-bot]

All commit authors signed the Contributor License Agreement.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #33637099 | 📁 Comparing 57ac409 against main (9d231cb)

  🔍 Preview build  

1 file changed

± library/calendar.html

[miss-islington-app]

Thanks @IbrahimShaqqou for the PR, and @brettcannon for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14, 3.15.
🐍🍒⛏🤖

[bedevere-app]

GH-153859 is a backport of this pull request to the 3.15 branch.

[bedevere-app]

GH-153861 is a backport of this pull request to the 3.13 branch.

[bedevere-app]

GH-153860 is a backport of this pull request to the 3.14 branch.