Fix documented TextCalendar.format{week,monthname}() signatures

[abhishekacharya200]

The documented signatures of TextCalendar.formatweek() and TextCalendar.formatmonthname() don't match the code. In both methods width is a required argument:

def formatweek(self, theweek, width): ...
def formatmonthname(self, theyear, themonth, width, withyear=True): ...

The docs show formatweek(theweek, w=0) and formatmonthname(theyear, themonth, width=0, withyear=True). If you follow them, you get errors:

>>> import calendar
>>> c = calendar.TextCalendar()
>>> week = c.monthdays2calendar(2026, 10)[0]
>>> c.formatweek(week)
TypeError: TextCalendar.formatweek() missing 1 required positional argument: 'width'
>>> c.formatweek(week, w=3)
TypeError: TextCalendar.formatweek() got an unexpected keyword argument 'w'
>>> c.formatmonthname(2026, 10)
TypeError: TextCalendar.formatmonthname() missing 1 required positional argument: 'width'

This PR changes the two signatures to match the code and rewords the formatweek() description to use width. It only touches the docs, so I think it needs the "skip news" label.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #35189190 | 📁 Comparing 3a162e2 against main (21a36aa)

  🔍 Preview build  

1 file changed

± library/calendar.html

[miss-islington-app]

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

[miss-islington-app]

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

[bedevere-app]

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

[bedevere-app]

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